@dzhechkov/memory 0.2.0

package/dist/reflexion.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `Reflexion` — the skill-outcome feedback loop.
+ *
+ * Records the outcome of using a skill (`record(skillId, outcome, score)`) and
+ * ranks skills by their most recent score. Reads are **monotonic**: the latest
+ * record for a skill supersedes older ones.
+ *
+ * @packageDocumentation
+ */
+import type { MemoryBackend, MemoryRecord } from './backend.js';
+/** Optional extras for {@link Reflexion.record}. */
+export interface ReflexionInput {
+    /** Free text to store (defaults to `"<skillId> <outcome>"`). */
+    readonly text?: string;
+    /** String-keyed metadata. */
+    readonly metadata?: Record<string, string>;
+}
+/** Records skill outcomes against a {@link MemoryBackend} and ranks skills. */
+export declare class Reflexion {
+    private readonly backend;
+    constructor(backend: MemoryBackend);
+    /**
+     * Record the outcome of using a skill.
+     *
+     * @param score reward score, must be within `[0, 1]`.
+     * @throws if `score` is outside `[0, 1]`.
+     */
+    record(skillId: string, outcome: string, score: number, input?: ReflexionInput): Promise<MemoryRecord>;
+    /** The most recently recorded score for a skill, or `undefined` if none. */
+    scoreOf(skillId: string): Promise<number | undefined>;
+    /** Every skill with a recorded outcome, ranked by most-recent score, descending. */
+    ranking(): Promise<{
+        skillId: string;
+        score: number;
+    }[]>;
+}
+//# sourceMappingURL=reflexion.d.ts.map

package/dist/reflexion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflexion.d.ts","sourceRoot":"","sources":["../src/reflexion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKhE,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,+EAA+E;AAC/E,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;OAKG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,cAAmB,GACzB,OAAO,CAAC,YAAY,CAAC;IAkBxB,4EAA4E;IACtE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQ3D,oFAAoF;IAC9E,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAY/D"}

package/dist/reflexion.js

@@ -0,0 +1,62 @@
+/**
+ * `Reflexion` — the skill-outcome feedback loop.
+ *
+ * Records the outcome of using a skill (`record(skillId, outcome, score)`) and
+ * ranks skills by their most recent score. Reads are **monotonic**: the latest
+ * record for a skill supersedes older ones.
+ *
+ * @packageDocumentation
+ */
+/** Monotonic counter — keeps record ids unique within a process. */
+let sequence = 0;
+/** Records skill outcomes against a {@link MemoryBackend} and ranks skills. */
+export class Reflexion {
+    backend;
+    constructor(backend) {
+        this.backend = backend;
+    }
+    /**
+     * Record the outcome of using a skill.
+     *
+     * @param score reward score, must be within `[0, 1]`.
+     * @throws if `score` is outside `[0, 1]`.
+     */
+    async record(skillId, outcome, score, input = {}) {
+        if (!Number.isFinite(score) || score < 0 || score > 1) {
+            throw new Error(`reflexion: score must be within [0, 1], got ${score}`);
+        }
+        sequence += 1;
+        const record = {
+            id: `reflexion:${skillId}:${Date.now()}:${sequence}`,
+            skillId,
+            text: input.text ?? `${skillId} ${outcome}`,
+            score,
+            outcome,
+            timestamp: new Date().toISOString(),
+            ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),
+        };
+        await this.backend.put(record);
+        return record;
+    }
+    /** The most recently recorded score for a skill, or `undefined` if none. */
+    async scoreOf(skillId) {
+        const records = await this.backend.query({ skillId, limit: Number.MAX_SAFE_INTEGER });
+        if (records.length === 0)
+            return undefined;
+        return records.reduce((latest, record) => record.timestamp >= latest.timestamp ? record : latest).score;
+    }
+    /** Every skill with a recorded outcome, ranked by most-recent score, descending. */
+    async ranking() {
+        const latest = new Map();
+        for (const record of await this.backend.all()) {
+            const current = latest.get(record.skillId);
+            if (current === undefined || record.timestamp > current.timestamp) {
+                latest.set(record.skillId, record);
+            }
+        }
+        return [...latest.values()]
+            .map((record) => ({ skillId: record.skillId, score: record.score }))
+            .sort((a, b) => b.score - a.score);
+    }
+}
+//# sourceMappingURL=reflexion.js.map

package/dist/reflexion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflexion.js","sourceRoot":"","sources":["../src/reflexion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,oEAAoE;AACpE,IAAI,QAAQ,GAAG,CAAC,CAAC;AAUjB,+EAA+E;AAC/E,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAEvD;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAAe,EACf,KAAa,EACb,QAAwB,EAAE;QAE1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,QAAQ,IAAI,CAAC,CAAC;QACd,MAAM,MAAM,GAAiB;YAC3B,EAAE,EAAE,aAAa,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE;YACpD,OAAO;YACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,IAAI,OAAO,EAAE;YAC3C,KAAK;YACL,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACtF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CACvC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACvD,CAAC,KAAK,CAAC;IACV,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC/C,KAAK,MAAM,MAAM,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;gBAClE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;aACxB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;aACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/sqlite-backend.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `SqliteBackend` — production-scale memory backend using better-sqlite3.
+ *
+ * Write-through persistence (every `put` is durable), WAL mode for concurrency,
+ * and indexed columns for efficient queries. Handles 100k+ records where
+ * JsonFileBackend degrades.
+ *
+ * @packageDocumentation
+ */
+import type { MemoryBackend, MemoryQuery, MemoryRecord } from './backend.js';
+/** Options for SqliteBackend. */
+export interface SqliteBackendOptions {
+    /** Path to the SQLite database file. */
+    readonly filePath: string;
+}
+/**
+ * SQLite-backed memory store. Write-through, WAL mode, indexed.
+ *
+ * Requires `better-sqlite3` at runtime — use via {@link SqliteProbe} in the
+ * cascade to gracefully fall back when the native module is unavailable.
+ */
+export declare class SqliteBackend implements MemoryBackend {
+    readonly name = "sqlite";
+    private readonly db;
+    private readonly upsertStmt;
+    private readonly allStmt;
+    private readonly countStmt;
+    private readonly bySkillStmt;
+    private readonly ftsSearchStmt;
+    private readonly ftsSearchSkillStmt;
+    private readonly hasFts5;
+    constructor(db: any);
+    /** Open (or create) a SQLite database at the given path. */
+    static open(filePath: string): SqliteBackend;
+    put(record: MemoryRecord): Promise<void>;
+    query(query: MemoryQuery): Promise<MemoryRecord[]>;
+    all(): Promise<MemoryRecord[]>;
+    count(): Promise<number>;
+    /** Batch insert records within a transaction (for bulk loading). */
+    putMany(records: readonly MemoryRecord[]): void;
+    /** Close the database connection. */
+    close(): void;
+}
+//# sourceMappingURL=sqlite-backend.d.ts.map

package/dist/sqlite-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-backend.d.ts","sourceRoot":"","sources":["../src/sqlite-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAoF7E,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAM;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,EAAE,EAAE,GAAG;IAwBnB,4DAA4D;IAC5D,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa;IAW5C,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgDlD,GAAG,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI9B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,oEAAoE;IACpE,OAAO,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI;IAiB/C,qCAAqC;IACrC,KAAK,IAAI,IAAI;CAGd"}

package/dist/sqlite-backend.js

@@ -0,0 +1,213 @@
+/**
+ * `SqliteBackend` — production-scale memory backend using better-sqlite3.
+ *
+ * Write-through persistence (every `put` is durable), WAL mode for concurrency,
+ * and indexed columns for efficient queries. Handles 100k+ records where
+ * JsonFileBackend degrades.
+ *
+ * @packageDocumentation
+ */
+import { createRequire } from 'node:module';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+const require = createRequire(import.meta.url);
+const DEFAULT_LIMIT = 20;
+/** Split text into lowercase word tokens of length > 1. */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((token) => token.length > 1);
+}
+/** Count how many query terms appear in a record's text/skillId. */
+function relevanceOf(record, terms) {
+    if (terms.length === 0)
+        return 0;
+    const haystack = new Set(tokenize(`${record.text} ${record.skillId}`));
+    let hits = 0;
+    for (const term of terms) {
+        if (haystack.has(term))
+            hits += 1;
+    }
+    return hits;
+}
+/** Schema version for future migrations. */
+const SCHEMA_VERSION = 2;
+const INIT_SQL = `
+  CREATE TABLE IF NOT EXISTS memory_records (
+    id TEXT PRIMARY KEY,
+    skill_id TEXT NOT NULL,
+    text TEXT NOT NULL,
+    score REAL NOT NULL,
+    outcome TEXT NOT NULL,
+    timestamp TEXT NOT NULL,
+    metadata TEXT
+  );
+  CREATE INDEX IF NOT EXISTS idx_skill ON memory_records(skill_id);
+  CREATE INDEX IF NOT EXISTS idx_timestamp ON memory_records(timestamp);
+  PRAGMA user_version = ${SCHEMA_VERSION};
+`;
+/** FTS5 virtual table + triggers for automatic sync. */
+const FTS5_SQL = `
+  CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
+    text, skill_id, content=memory_records, content_rowid=rowid
+  );
+  CREATE TRIGGER IF NOT EXISTS memory_fts_insert AFTER INSERT ON memory_records BEGIN
+    INSERT INTO memory_fts(rowid, text, skill_id) VALUES (new.rowid, new.text, new.skill_id);
+  END;
+  CREATE TRIGGER IF NOT EXISTS memory_fts_delete AFTER DELETE ON memory_records BEGIN
+    INSERT INTO memory_fts(memory_fts, rowid, text, skill_id) VALUES ('delete', old.rowid, old.text, old.skill_id);
+  END;
+  CREATE TRIGGER IF NOT EXISTS memory_fts_update AFTER UPDATE ON memory_records BEGIN
+    INSERT INTO memory_fts(memory_fts, rowid, text, skill_id) VALUES ('delete', old.rowid, old.text, old.skill_id);
+    INSERT INTO memory_fts(rowid, text, skill_id) VALUES (new.rowid, new.text, new.skill_id);
+  END;
+`;
+/** FTS5 query — returns matching record ids ranked by relevance. */
+const FTS5_SEARCH_SQL = `
+  SELECT mr.* FROM memory_fts fts
+  JOIN memory_records mr ON mr.rowid = fts.rowid
+  WHERE memory_fts MATCH ?
+  ORDER BY fts.rank
+`;
+const FTS5_SEARCH_SKILL_SQL = `
+  SELECT mr.* FROM memory_fts fts
+  JOIN memory_records mr ON mr.rowid = fts.rowid
+  WHERE memory_fts MATCH ? AND mr.skill_id = ?
+  ORDER BY fts.rank
+`;
+const UPSERT_SQL = `
+  INSERT OR REPLACE INTO memory_records (id, skill_id, text, score, outcome, timestamp, metadata)
+  VALUES (?, ?, ?, ?, ?, ?, ?)
+`;
+const ALL_SQL = 'SELECT * FROM memory_records';
+const COUNT_SQL = 'SELECT COUNT(*) as cnt FROM memory_records';
+const BY_SKILL_SQL = 'SELECT * FROM memory_records WHERE skill_id = ?';
+/**
+ * SQLite-backed memory store. Write-through, WAL mode, indexed.
+ *
+ * Requires `better-sqlite3` at runtime — use via {@link SqliteProbe} in the
+ * cascade to gracefully fall back when the native module is unavailable.
+ */
+export class SqliteBackend {
+    name = 'sqlite';
+    db; // better-sqlite3 Database instance
+    upsertStmt;
+    allStmt;
+    countStmt;
+    bySkillStmt;
+    ftsSearchStmt;
+    ftsSearchSkillStmt;
+    hasFts5;
+    constructor(db) {
+        this.db = db;
+        db.exec(INIT_SQL);
+        // Try to enable FTS5 — gracefully degrade if unavailable
+        let ftsOk = false;
+        try {
+            db.exec(FTS5_SQL);
+            // Rebuild FTS index from existing data (idempotent)
+            db.exec(`INSERT INTO memory_fts(memory_fts) VALUES ('rebuild')`);
+            this.ftsSearchStmt = db.prepare(FTS5_SEARCH_SQL);
+            this.ftsSearchSkillStmt = db.prepare(FTS5_SEARCH_SKILL_SQL);
+            ftsOk = true;
+        }
+        catch {
+            // FTS5 not compiled in — fall back to keyword overlap
+        }
+        this.hasFts5 = ftsOk;
+        this.upsertStmt = db.prepare(UPSERT_SQL);
+        this.allStmt = db.prepare(ALL_SQL);
+        this.countStmt = db.prepare(COUNT_SQL);
+        this.bySkillStmt = db.prepare(BY_SKILL_SQL);
+    }
+    /** Open (or create) a SQLite database at the given path. */
+    static open(filePath) {
+        mkdirSync(dirname(filePath), { recursive: true });
+        // Dynamic require — better-sqlite3 must be available at runtime
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const Database = require('better-sqlite3');
+        const db = new Database(filePath);
+        db.pragma('journal_mode = WAL');
+        db.pragma('synchronous = NORMAL');
+        return new SqliteBackend(db);
+    }
+    put(record) {
+        this.upsertStmt.run(record.id, record.skillId, record.text, record.score, record.outcome, record.timestamp, record.metadata ? JSON.stringify(record.metadata) : null);
+        return Promise.resolve();
+    }
+    query(query) {
+        const limit = query.limit ?? DEFAULT_LIMIT;
+        // FTS5 path — use SQLite full-text search when available and text query provided
+        if (this.hasFts5 && query.text !== undefined && query.text.trim().length > 0) {
+            try {
+                // FTS5 query syntax: simple terms joined by spaces (implicit AND → OR with ranking)
+                const ftsQuery = tokenize(query.text).join(' OR ');
+                if (ftsQuery.length > 0) {
+                    let rows;
+                    if (query.skillId !== undefined) {
+                        rows = this.ftsSearchSkillStmt.all(ftsQuery, query.skillId);
+                    }
+                    else {
+                        rows = this.ftsSearchStmt.all(ftsQuery);
+                    }
+                    const records = rows.map(rowToRecord);
+                    // FTS5 rank is already applied; tiebreak by score DESC, timestamp DESC
+                    records.sort((a, b) => b.score - a.score || b.timestamp.localeCompare(a.timestamp));
+                    return Promise.resolve(records.slice(0, limit));
+                }
+            }
+            catch {
+                // FTS5 query failed (e.g., special chars) — fall through to keyword approach
+            }
+        }
+        // Keyword overlap fallback
+        const terms = query.text !== undefined ? tokenize(query.text) : [];
+        let rows;
+        if (query.skillId !== undefined) {
+            rows = this.bySkillStmt.all(query.skillId);
+        }
+        else {
+            rows = this.allStmt.all();
+        }
+        const records = rows.map(rowToRecord);
+        const ranked = records
+            .map((record) => ({ record, relevance: relevanceOf(record, terms) }))
+            .sort((a, b) => b.relevance - a.relevance ||
+            b.record.score - a.record.score ||
+            b.record.timestamp.localeCompare(a.record.timestamp));
+        return Promise.resolve(ranked.slice(0, limit).map((entry) => entry.record));
+    }
+    all() {
+        return Promise.resolve(this.allStmt.all().map(rowToRecord));
+    }
+    count() {
+        return Promise.resolve(this.countStmt.get().cnt);
+    }
+    /** Batch insert records within a transaction (for bulk loading). */
+    putMany(records) {
+        const insertMany = this.db.transaction((items) => {
+            for (const record of items) {
+                this.upsertStmt.run(record.id, record.skillId, record.text, record.score, record.outcome, record.timestamp, record.metadata ? JSON.stringify(record.metadata) : null);
+            }
+        });
+        insertMany(records);
+    }
+    /** Close the database connection. */
+    close() {
+        this.db.close();
+    }
+}
+/** Convert a raw SQLite row to a MemoryRecord. */
+function rowToRecord(row) {
+    return {
+        id: row.id,
+        skillId: row.skill_id,
+        text: row.text,
+        score: row.score,
+        outcome: row.outcome,
+        timestamp: row.timestamp,
+        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+    };
+}
+//# sourceMappingURL=sqlite-backend.js.map

package/dist/sqlite-backend.js.map

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

package/dist/sqlite-probe.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `SqliteProbe` — cascade probe for the SQLite backend.
+ *
+ * Attempts to load `better-sqlite3` and open the database. Returns `undefined`
+ * if the native module is unavailable (not installed, build failed, etc.).
+ *
+ * @packageDocumentation
+ */
+import type { BackendProbe } from './cascade.js';
+import type { MemoryBackend } from './backend.js';
+/** Options for SqliteProbe. */
+export interface SqliteProbeOptions {
+    /** Path to the SQLite database file. Default: `.dz/memory.sqlite` */
+    readonly filePath?: string;
+}
+/**
+ * A {@link BackendProbe} that tries to initialise a SQLite backend.
+ * Safe to construct unconditionally — if `better-sqlite3` is not installed,
+ * `create()` returns `undefined` and the cascade moves on.
+ */
+export declare class SqliteProbe implements BackendProbe {
+    readonly name = "sqlite";
+    private readonly filePath;
+    constructor(options?: SqliteProbeOptions);
+    create(): Promise<MemoryBackend | undefined>;
+}
+//# sourceMappingURL=sqlite-probe.d.ts.map

package/dist/sqlite-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-probe.d.ts","sourceRoot":"","sources":["../src/sqlite-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,GAAE,kBAAuB;IAItC,MAAM,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;CAYnD"}

package/dist/sqlite-probe.js

@@ -0,0 +1,34 @@
+/**
+ * `SqliteProbe` — cascade probe for the SQLite backend.
+ *
+ * Attempts to load `better-sqlite3` and open the database. Returns `undefined`
+ * if the native module is unavailable (not installed, build failed, etc.).
+ *
+ * @packageDocumentation
+ */
+/**
+ * A {@link BackendProbe} that tries to initialise a SQLite backend.
+ * Safe to construct unconditionally — if `better-sqlite3` is not installed,
+ * `create()` returns `undefined` and the cascade moves on.
+ */
+export class SqliteProbe {
+    name = 'sqlite';
+    filePath;
+    constructor(options = {}) {
+        this.filePath = options.filePath ?? '.dz/memory.sqlite';
+    }
+    async create() {
+        try {
+            // Attempt to load better-sqlite3 via the SqliteBackend.
+            // If the native module is not installed, this throws and we return undefined.
+            const { SqliteBackend } = await import('./sqlite-backend.js');
+            const backend = SqliteBackend.open(this.filePath);
+            return backend;
+        }
+        catch {
+            // Module not available or build failed — fall through
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=sqlite-probe.js.map

package/dist/sqlite-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-probe.js","sourceRoot":"","sources":["../src/sqlite-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,QAAQ,CAAC;IACR,QAAQ,CAAS;IAElC,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,wDAAwD;YACxD,8EAA8E;YAC9E,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@dzhechkov/memory",
+  "version": "0.2.0",
+  "description": "Harness memory layer - backend cascade, Reflexion feedback, and the host-memory bridge.",
+  "type": "module",
+  "license": "MIT",
+  "author": "dzhechko",
+  "keywords": [
+    "agent-skills",
+    "harness",
+    "memory",
+    "reflexion"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^25.6.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/djd1m/dz-harness-hub.git",
+    "directory": "packages/@dzhechkov/memory"
+  },
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/memory#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/backend.ts

@@ -0,0 +1,47 @@
+/**
+ * The memory storage contract — what every backend implements.
+ *
+ * @packageDocumentation
+ */
+
+/** A single memory entry. */
+export interface MemoryRecord {
+  /** Unique record id. */
+  readonly id: string;
+  /** The skill this record is about. */
+  readonly skillId: string;
+  /** Free text — the content keyword queries match against. */
+  readonly text: string;
+  /** Reward / quality score, in `[0, 1]`. */
+  readonly score: number;
+  /** A short outcome label, e.g. `excellent`, `good`, `imported`. */
+  readonly outcome: string;
+  /** ISO-8601 creation time. */
+  readonly timestamp: string;
+  /** Optional string-keyed metadata. */
+  readonly metadata?: Record<string, string>;
+}
+
+/** A retrieval query. */
+export interface MemoryQuery {
+  /** Keyword text to rank records by relevance. */
+  readonly text?: string;
+  /** Restrict to one skill. */
+  readonly skillId?: string;
+  /** Maximum results (default 20). */
+  readonly limit?: number;
+}
+
+/** A pluggable memory store. */
+export interface MemoryBackend {
+  /** Stable backend name, e.g. `json-file`. */
+  readonly name: string;
+  /** Insert or replace a record (keyed by `record.id`). */
+  put(record: MemoryRecord): Promise<void>;
+  /** Retrieve records ranked by relevance to the query. */
+  query(query: MemoryQuery): Promise<MemoryRecord[]>;
+  /** Every stored record. */
+  all(): Promise<MemoryRecord[]>;
+  /** Number of stored records. */
+  count(): Promise<number>;
+}

package/src/bridge.ts

@@ -0,0 +1,99 @@
+/**
+ * `MemoryBridge` — import host memory files into canonical `MemoryRecord`s.
+ *
+ * The bridge is the anti-corruption layer between a host's memory format
+ * (a Claude Code `MEMORY.md`, a memory note, …) and this package's records.
+ *
+ * @packageDocumentation
+ */
+
+import type { MemoryBackend, MemoryRecord } from './backend.js';
+
+/** Monotonic counter for bridge-generated record ids. */
+let sequence = 0;
+
+/** Options for a bridge import. */
+export interface BridgeOptions {
+  /** A label for where the memory came from, e.g. `claude-code:MEMORY.md`. */
+  readonly source: string;
+  /** Skill id to associate the imported records with. Default `imported`. */
+  readonly skillId?: string;
+  /** Score for imported records, in `[0, 1]`. Default `0.5`. */
+  readonly score?: number;
+}
+
+interface Section {
+  readonly heading: string;
+  readonly body: string;
+}
+
+function slug(text: string): string {
+  return (
+    text
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .slice(0, 48) || 'section'
+  );
+}
+
+/** Split markdown into sections on `##` headings (whole doc if there are none). */
+function splitSections(markdown: string): Section[] {
+  const sections: Section[] = [];
+  let heading = 'document';
+  let body: string[] = [];
+  const flush = (): void => {
+    sections.push({ heading, body: body.join('\n') });
+  };
+  for (const line of markdown.split(/\r?\n/)) {
+    const match = /^##\s+(.+?)\s*$/.exec(line);
+    if (match) {
+      flush();
+      heading = match[1] ?? 'section';
+      body = [];
+    } else {
+      body.push(line);
+    }
+  }
+  flush();
+  return sections;
+}
+
+/**
+ * Parse a host memory markdown document into {@link MemoryRecord}s — one record
+ * per `##` section (or one for the whole document if it has no headings).
+ * Empty sections are dropped. Pure: it does not touch any backend.
+ */
+export function importMemoryMarkdown(markdown: string, options: BridgeOptions): MemoryRecord[] {
+  const skillId = options.skillId ?? 'imported';
+  const score = options.score ?? 0.5;
+  const timestamp = new Date().toISOString();
+  return splitSections(markdown)
+    .map((section): MemoryRecord => {
+      sequence += 1;
+      return {
+        id: `bridge:${slug(options.source)}:${slug(section.heading)}:${sequence}`,
+        skillId,
+        text: section.body.trim(),
+        score,
+        outcome: 'imported',
+        timestamp,
+        metadata: { source: options.source, heading: section.heading },
+      };
+    })
+    .filter((record) => record.text.length > 0);
+}
+
+/** Imports host memory markdown into a {@link MemoryBackend}. */
+export class MemoryBridge {
+  constructor(private readonly backend: MemoryBackend) {}
+
+  /** Parse `markdown` and store each resulting record; returns the records. */
+  async importMarkdown(markdown: string, options: BridgeOptions): Promise<MemoryRecord[]> {
+    const records = importMemoryMarkdown(markdown, options);
+    for (const record of records) {
+      await this.backend.put(record);
+    }
+    return records;
+  }
+}