@getplumb/core 0.1.6 → 0.3.0

package/dist/scorer.test.js

@@ -0,0 +1,169 @@
+/**
+ * scorer.test.ts — decay curve verification for scoreFact() and scoreRawLog().
+ *
+ * Note on the "~0.31 at 49 days medium" reference in the architecture doc:
+ * With lambda=0.012 the correct value at 49 days is ~0.528 (confidence=0.95).
+ * The ~0.31 figure likely derives from an earlier lambda value (~0.023).
+ * These tests assert against the actual computed values for the specified lambdas.
+ */
+import { strict as assert } from 'node:assert';
+import { describe, it } from 'node:test';
+import { DecayRate } from './types.js';
+import { computeDecay, scoreFact, scoreRawLog } from './scorer.js';
+/** Build a minimal Fact for testing. */
+function makeFact(opts) {
+    const now = opts.now ?? new Date('2026-01-01T00:00:00.000Z');
+    const timestamp = new Date(now.getTime() - opts.ageInDays * 24 * 60 * 60 * 1_000);
+    return {
+        fact: {
+            id: 'test-id',
+            subject: 'test subject',
+            predicate: 'test predicate',
+            object: 'test object',
+            confidence: opts.confidence,
+            decayRate: opts.decayRate,
+            timestamp,
+            sourceSessionId: 'session-1',
+        },
+        now,
+    };
+}
+describe('computeDecay', () => {
+    it('returns 1.0 at age 0 regardless of lambda', () => {
+        assert.equal(computeDecay(0.003, 0), 1.0);
+        assert.equal(computeDecay(0.012, 0), 1.0);
+        assert.equal(computeDecay(0.05, 0), 1.0);
+    });
+    it('medium lambda at 49 days matches expected decay', () => {
+        const decay = computeDecay(0.012, 49);
+        // e^(-0.012 * 49) = e^(-0.588) ≈ 0.5557
+        assert.ok(decay > 0.55 && decay < 0.57, `expected ~0.5557, got ${decay}`);
+    });
+    it('fast lambda decays faster than slow at same age', () => {
+        assert.ok(computeDecay(0.05, 30) < computeDecay(0.003, 30));
+    });
+});
+describe('scoreFact — decay curves', () => {
+    it('age=0, slow decay, confidence=0.95 → ~0.95', () => {
+        const { fact, now } = makeFact({
+            confidence: 0.95,
+            decayRate: DecayRate.slow,
+            ageInDays: 0,
+        });
+        const result = scoreFact(fact, now);
+        assert.ok(result.score > 0.949 && result.score <= 0.95, `expected ~0.95, got ${result.score}`);
+        assert.equal(result.isCold, false);
+    });
+    it('age=49 days, medium decay, confidence=0.95 → ~0.528', () => {
+        const { fact, now } = makeFact({
+            confidence: 0.95,
+            decayRate: DecayRate.medium,
+            ageInDays: 49,
+        });
+        const result = scoreFact(fact, now);
+        // 0.95 × e^(-0.012 × 49) ≈ 0.5277
+        assert.ok(result.score > 0.52 && result.score < 0.54, `expected ~0.528, got ${result.score}`);
+        assert.equal(result.isCold, false);
+    });
+    it('age=365 days, medium decay, confidence=0.95 → ~0.012 (near cold)', () => {
+        const { fact, now } = makeFact({
+            confidence: 0.95,
+            decayRate: DecayRate.medium,
+            ageInDays: 365,
+        });
+        const result = scoreFact(fact, now);
+        // 0.95 × e^(-0.012 × 365) ≈ 0.01190
+        assert.ok(result.score > 0.01 && result.score < 0.02, `expected ~0.012, got ${result.score}`);
+        assert.equal(result.isCold, false);
+    });
+    it('age=400 days, medium decay, confidence=0.95 → isCold (score < 0.01)', () => {
+        const { fact, now } = makeFact({
+            confidence: 0.95,
+            decayRate: DecayRate.medium,
+            ageInDays: 400,
+        });
+        const result = scoreFact(fact, now);
+        // 0.95 × e^(-0.012 × 400) ≈ 0.00782
+        assert.ok(result.score < 0.01, `expected score < 0.01, got ${result.score}`);
+        assert.equal(result.isCold, true);
+    });
+    it('age=30 days, fast decay, confidence=0.95 → < 0.25', () => {
+        const { fact, now } = makeFact({
+            confidence: 0.95,
+            decayRate: DecayRate.fast,
+            ageInDays: 30,
+        });
+        const result = scoreFact(fact, now);
+        // 0.95 × e^(-0.05 × 30) ≈ 0.2120
+        assert.ok(result.score < 0.25, `expected < 0.25, got ${result.score}`);
+        assert.equal(result.isCold, false);
+    });
+    it('confidence=0 → score=0, isCold=true', () => {
+        const { fact, now } = makeFact({
+            confidence: 0,
+            decayRate: DecayRate.medium,
+            ageInDays: 49,
+        });
+        const result = scoreFact(fact, now);
+        assert.equal(result.score, 0);
+        assert.equal(result.isCold, true);
+    });
+    it('score is bounded between 0 and 1', () => {
+        const ages = [0, 1, 30, 100, 365, 730];
+        const rates = [DecayRate.slow, DecayRate.medium, DecayRate.fast];
+        for (const ageInDays of ages) {
+            for (const decayRate of rates) {
+                const { fact, now } = makeFact({ confidence: 0.95, decayRate, ageInDays });
+                const { score } = scoreFact(fact, now);
+                assert.ok(score >= 0 && score <= 1, `score out of range: ${score}`);
+            }
+        }
+    });
+    it('uses current time when now is omitted (smoke test)', () => {
+        const fact = {
+            id: 'x',
+            subject: 's',
+            predicate: 'p',
+            object: 'o',
+            confidence: 0.8,
+            decayRate: DecayRate.slow,
+            timestamp: new Date(),
+            sourceSessionId: 'sess',
+        };
+        // Should not throw; score should be close to 0.8 for age≈0
+        const { score } = scoreFact(fact);
+        assert.ok(score > 0.79 && score <= 0.8, `expected ~0.8, got ${score}`);
+    });
+});
+describe('scoreRawLog — medium decay', () => {
+    it('age=0 → score ≈ 1.0, not cold', () => {
+        const now = new Date('2026-01-01T00:00:00.000Z');
+        const chunk = { timestamp: now };
+        const result = scoreRawLog(chunk, now);
+        assert.equal(result.score, 1.0);
+        assert.equal(result.isCold, false);
+    });
+    it('age=49 days → score ~0.557 (medium decay on base 1.0)', () => {
+        const now = new Date('2026-01-01T00:00:00.000Z');
+        const timestamp = new Date(now.getTime() - 49 * 24 * 60 * 60 * 1_000);
+        const result = scoreRawLog({ timestamp }, now);
+        // e^(-0.012 × 49) ≈ 0.5557
+        assert.ok(result.score > 0.54 && result.score < 0.57, `expected ~0.556, got ${result.score}`);
+        assert.equal(result.isCold, false);
+    });
+    it('age=365 days → score ~0.0125, not yet cold', () => {
+        const now = new Date('2026-01-01T00:00:00.000Z');
+        const timestamp = new Date(now.getTime() - 365 * 24 * 60 * 60 * 1_000);
+        const result = scoreRawLog({ timestamp }, now);
+        assert.ok(result.score > 0.01 && result.score < 0.02, `expected ~0.0125, got ${result.score}`);
+        assert.equal(result.isCold, false);
+    });
+    it('age=400 days → isCold', () => {
+        const now = new Date('2026-01-01T00:00:00.000Z');
+        const timestamp = new Date(now.getTime() - 400 * 24 * 60 * 60 * 1_000);
+        const result = scoreRawLog({ timestamp }, now);
+        assert.ok(result.score < 0.01, `expected < 0.01, got ${result.score}`);
+        assert.equal(result.isCold, true);
+    });
+});
+//# sourceMappingURL=scorer.test.js.map

package/dist/scorer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.test.js","sourceRoot":"","sources":["../src/scorer.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnE,wCAAwC;AACxC,SAAS,QAAQ,CAAC,IAKjB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,IAAI,CACxB,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CACtD,CAAC;IACF,OAAO;QACL,IAAI,EAAE;YACJ,EAAE,EAAE,SAAS;YACb,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,gBAAgB;YAC3B,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS;YACT,eAAe,EAAE,WAAW;SAC7B;QACD,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtC,wCAAwC;QACxC,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,EAAE,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;YAC7B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,KAAK,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,EAC5C,uBAAuB,MAAM,CAAC,KAAK,EAAE,CACtC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;YAC7B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,kCAAkC;QAClC,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,EAC1C,wBAAwB,MAAM,CAAC,KAAK,EAAE,CACvC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;YAC7B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,oCAAoC;QACpC,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,EAC1C,wBAAwB,MAAM,CAAC,KAAK,EAAE,CACvC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;YAC7B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,oCAAoC;QACpC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,8BAA8B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;YAC7B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,iCAAiC;QACjC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,wBAAwB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;YAC7B,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjE,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;YAC7B,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;gBAC9B,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC3E,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACvC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,uBAAuB,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,IAAI,GAAG;YACX,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,eAAe,EAAE,MAAM;SACxB,CAAC;QACF,2DAA2D;QAC3D,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,sBAAsB,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,2BAA2B;QAC3B,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,EAC1C,wBAAwB,MAAM,CAAC,KAAK,EAAE,CACvC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,EAC1C,yBAAyB,MAAM,CAAC,KAAK,EAAE,CACxC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,wBAAwB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/store.d.ts

@@ -2,8 +2,10 @@ import type { Fact, IngestResult, MessageExchange, SearchResult, StoreStatus } f
 export interface MemoryStore {
     /**
      * Write a fact to the store. The store generates and returns the id.
+     * @param fact - The fact to store (id will be generated).
+     * @param sourceChunkId - Optional raw_log chunk ID (T-079 processing state machine).
      */
-    store(fact: Omit<Fact, 'id'>): Promise<string>;
+    store(fact: Omit<Fact, 'id'>, sourceChunkId?: string): Promise<string>;
     /**
      * Search for facts matching the query. Returns ranked results with score and age.
      */

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjG,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAExE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1D"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjG,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvE;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAExE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1D"}

package/dist/wasm-db.d.ts

@@ -1,14 +1,69 @@
 /**
- * WASM SQLite database wrapper.
- * Provides the WasmDb type for use across the codebase.
- * The @sqlite.org/sqlite-wasm oo1 API is used directly - this file only exports types.
+ * SQLite database wrapper using better-sqlite3.
+ *
+ * Replaces the previous @sqlite.org/sqlite-wasm implementation which cannot
+ * open real filesystem paths in a Node.js environment.
+ *
+ * Exposes a WasmDb-compatible interface so local-store.ts and schema.ts
+ * require no changes:
+ *   - db.exec(sql: string)
+ *   - db.exec({ sql, rowMode: 'object', returnValue: 'resultRows' }) → rows[]
+ *   - db.prepare(sql) → stmt with .bind([...]), .step(), .get(colOrObj), .finalize()
+ *   - db.selectValue(sql)
+ *   - db.close()
  */
-import type SqliteWasm from '@sqlite.org/sqlite-wasm';
-type Sqlite3Init = typeof SqliteWasm;
-export type WasmDb = InstanceType<Awaited<ReturnType<Sqlite3Init>>['oo1']['DB']>;
+import Database from 'better-sqlite3';
+type ExecOptions = {
+    sql: string;
+    rowMode?: 'object' | 'array';
+    returnValue?: 'resultRows';
+};
 /**
- * Open a WASM SQLite database.
- * @param path Absolute path to the database file
+ * Thin statement wrapper that adapts better-sqlite3's API to the wasm oo1 style
+ * used throughout local-store.ts, fact-search.ts, and raw-log-search.ts.
+ */
+declare class CompatStatement {
+    #private;
+    constructor(stmt: Database.Statement);
+    bind(params: unknown[]): void;
+    /**
+     * Execute the statement. For SELECT statements, caches all rows for get().
+     * For write statements (INSERT/UPDATE/DELETE/PRAGMA writes), runs immediately.
+     */
+    step(): boolean;
+    /**
+     * Get a value from the current row.
+     * - get(colIndex: number) → scalar at that column index
+     * - get({}) → plain object with column names as keys
+     */
+    get(colOrObj: number | Record<string, unknown>): unknown;
+    finalize(): void;
+}
+/**
+ * Thin database wrapper adapting better-sqlite3 to the wasm oo1 API surface
+ * used by local-store.ts and schema.ts.
+ */
+declare class CompatDb {
+    #private;
+    constructor(path: string);
+    /**
+     * Execute SQL.
+     * - exec(sql: string) — plain execution, no return value
+     * - exec({ sql, returnValue: 'resultRows' }) — returns array of row objects
+     */
+    exec(sqlOrOpts: string | ExecOptions): unknown[] | void;
+    prepare(sql: string): CompatStatement;
+    /**
+     * Execute a single-value query and return the first column of the first row.
+     */
+    selectValue(sql: string): unknown;
+    close(): void;
+}
+export type WasmDb = CompatDb;
+/**
+ * Open a SQLite database file.
+ * Creates the file if it doesn't exist.
+ * Returns a promise for API compatibility with the previous wasm implementation.
  */
 export declare function openDb(path: string): Promise<WasmDb>;
 export {};

package/dist/wasm-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-db.d.ts","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,KAAK,WAAW,GAAG,OAAO,UAAU,CAAC;AAarC,MAAM,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEjF;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1D"}
+{"version":3,"file":"wasm-db.d.ts","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,cAAM,eAAe;;gBAOP,IAAI,EAAE,QAAQ,CAAC,SAAS;IAIpC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B;;;OAGG;IACH,IAAI,IAAI,OAAO;IAqBf;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAgBxD,QAAQ,IAAI,IAAI;CAMjB;AAED;;;GAGG;AACH,cAAM,QAAQ;;gBAGA,IAAI,EAAE,MAAM;IAIxB;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,EAAE,GAAG,IAAI;IAYvD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAKrC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKjC,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D"}

package/dist/wasm-db.js

@@ -1,39 +1,132 @@
 /**
- * WASM SQLite database wrapper.
- * Provides the WasmDb type for use across the codebase.
- * The @sqlite.org/sqlite-wasm oo1 API is used directly - this file only exports types.
+ * SQLite database wrapper using better-sqlite3.
+ *
+ * Replaces the previous @sqlite.org/sqlite-wasm implementation which cannot
+ * open real filesystem paths in a Node.js environment.
+ *
+ * Exposes a WasmDb-compatible interface so local-store.ts and schema.ts
+ * require no changes:
+ *   - db.exec(sql: string)
+ *   - db.exec({ sql, rowMode: 'object', returnValue: 'resultRows' }) → rows[]
+ *   - db.prepare(sql) → stmt with .bind([...]), .step(), .get(colOrObj), .finalize()
+ *   - db.selectValue(sql)
+ *   - db.close()
  */
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-// Load sqlite3-node.mjs using require to bypass package.json exports restriction
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const require = createRequire(import.meta.url);
-// Find node_modules path by resolving the package directory
-// We need to use a file that IS exported (sqlite3.wasm) to find the package root
-const wasmFilePath = require.resolve('@sqlite.org/sqlite-wasm/sqlite3.wasm');
-// wasmFilePath = /node_modules/@sqlite.org/sqlite-wasm/sqlite-wasm/jswasm/sqlite3.wasm
-// Go up from jswasm/ to sqlite-wasm/ to package root (3 levels up)
-const packageDir = dirname(dirname(dirname(wasmFilePath)));
-const sqlite3NodePath = join(packageDir, 'sqlite-wasm', 'jswasm', 'sqlite3-node.mjs');
-// Global WASM module singleton (initialized once per process)
-let wasmModule = null;
-async function initWasmModule() {
-    if (!wasmModule) {
-        const { default: sqlite3Init } = await import(sqlite3NodePath);
-        wasmModule = await sqlite3Init();
-    }
-    return wasmModule;
+import Database from 'better-sqlite3';
+/**
+ * Thin statement wrapper that adapts better-sqlite3's API to the wasm oo1 style
+ * used throughout local-store.ts, fact-search.ts, and raw-log-search.ts.
+ */
+class CompatStatement {
+    #stmt;
+    #params = [];
+    #rows = null;
+    #rowIndex = 0;
+    #columnNames = [];
+    constructor(stmt) {
+        this.#stmt = stmt;
+    }
+    bind(params) {
+        this.#params = params;
+    }
+    /**
+     * Execute the statement. For SELECT statements, caches all rows for get().
+     * For write statements (INSERT/UPDATE/DELETE/PRAGMA writes), runs immediately.
+     */
+    step() {
+        if (this.#stmt.reader) {
+            // SELECT — cache all rows on first call
+            if (this.#rows === null) {
+                const raw = this.#stmt.raw(true).all(...this.#params);
+                this.#rows = raw;
+                this.#rowIndex = 0;
+                this.#columnNames = this.#stmt.columns().map((c) => c.name);
+            }
+            if (this.#rowIndex < this.#rows.length) {
+                this.#rowIndex++;
+                return true;
+            }
+            return false;
+        }
+        else {
+            // Write statement
+            this.#stmt.run(...this.#params);
+            return false;
+        }
+    }
+    /**
+     * Get a value from the current row.
+     * - get(colIndex: number) → scalar at that column index
+     * - get({}) → plain object with column names as keys
+     */
+    get(colOrObj) {
+        if (this.#rows === null || this.#rowIndex === 0)
+            return null;
+        const row = this.#rows[this.#rowIndex - 1];
+        if (row === undefined)
+            return null;
+        if (typeof colOrObj === 'number') {
+            return row[colOrObj];
+        }
+        // Object form — zip column names with row values
+        const obj = {};
+        for (let i = 0; i < this.#columnNames.length; i++) {
+            obj[this.#columnNames[i]] = row[i];
+        }
+        return obj;
+    }
+    finalize() {
+        // better-sqlite3 statements don't need explicit finalization
+        this.#rows = null;
+        this.#rowIndex = 0;
+        this.#params = [];
+    }
+}
+/**
+ * Thin database wrapper adapting better-sqlite3 to the wasm oo1 API surface
+ * used by local-store.ts and schema.ts.
+ */
+class CompatDb {
+    #db;
+    constructor(path) {
+        this.#db = new Database(path);
+    }
+    /**
+     * Execute SQL.
+     * - exec(sql: string) — plain execution, no return value
+     * - exec({ sql, returnValue: 'resultRows' }) — returns array of row objects
+     */
+    exec(sqlOrOpts) {
+        if (typeof sqlOrOpts === 'string') {
+            this.#db.exec(sqlOrOpts);
+            return;
+        }
+        // Object form — run as query and return rows
+        const { sql } = sqlOrOpts;
+        const rows = this.#db.prepare(sql).all();
+        return rows;
+    }
+    prepare(sql) {
+        const stmt = this.#db.prepare(sql);
+        return new CompatStatement(stmt);
+    }
+    /**
+     * Execute a single-value query and return the first column of the first row.
+     */
+    selectValue(sql) {
+        const row = this.#db.prepare(sql).raw(true).get();
+        return row ? row[0] : null;
+    }
+    close() {
+        this.#db.close();
+    }
 }
 /**
- * Open a WASM SQLite database.
- * @param path Absolute path to the database file
+ * Open a SQLite database file.
+ * Creates the file if it doesn't exist.
+ * Returns a promise for API compatibility with the previous wasm implementation.
  */
 export async function openDb(path) {
-    const sqlite3 = await initWasmModule();
-    // 'ct' flags: create if not exists, throw on error
-    const db = new sqlite3.oo1.DB(path, 'ct');
-    return db;
+    return new CompatDb(path);
 }
 //# sourceMappingURL=wasm-db.js.map

package/dist/wasm-db.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-db.js","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,iFAAiF;AACjF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,4DAA4D;AAC5D,iFAAiF;AACjF,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;AAC7E,uFAAuF;AACvF,mEAAmE;AACnE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAMtF,8DAA8D;AAC9D,IAAI,UAAU,GAA4C,IAAI,CAAC;AAE/D,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAA6B,CAAC;QAC3F,UAAU,GAAG,MAAM,WAAW,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAID;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,mDAAmD;IACnD,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"wasm-db.js","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@getplumb/core",
-  "version": "0.1.6",
+  "version": "0.3.0",
   "description": "Plumb memory engine — storage abstraction, types, and local SQLite driver",
   "license": "MIT",
+  "author": "Clay Waters <hello@plumb.run>",
+  "homepage": "https://plumb.run",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getplumb/plumb",
+    "directory": "packages/core"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,6 +21,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -25,14 +35,16 @@
     "test": "node --import tsx/esm --test src/**/*.test.ts",
     "lint": "echo \"No lint yet\" && exit 0",
     "clean": "rm -rf dist *.tsbuildinfo",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "pnpm build"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "tsx": "^4.0.0",
     "typescript": "^5.4.0"
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "3.47.2-build1",
+    "better-sqlite3": "^12.6.2",
     "openai": "^4.80.0"
   },
   "optionalDependencies": {