@kernloop/faculty-memory 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 William Zujkowski and Kernloop contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/episodic.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Episodic store (spec §5.2): replayable traces as compressed summary +
+ * pointer to the full trace. Write policy — auto on Outcome, summarized at
+ * write time (spec §8 item 5: digests, not transcripts; the transcript lives
+ * behind `traceRef`). Read policy — summaries, newest first.
+ */
+import type Database from 'better-sqlite3';
+import { type Outcome, type OutcomeStatus } from '@kernloop/contracts';
+/** A stored episodic trace summary. `createdAt` is epoch milliseconds. */
+export interface TraceSummary {
+    taskId: string;
+    summary: string;
+    traceRef: string;
+    status: OutcomeStatus;
+    distillCandidates: string[];
+    createdAt: number;
+}
+/** Default maximum number of summaries a listing returns. */
+export declare const DEFAULT_LIST_LIMIT = 20;
+/**
+ * Record an Outcome as a trace summary (CLM-0024). The Outcome is
+ * zod-validated at the boundary; invalid values throw
+ * {@link InvalidOutcomeError}. Stored: the write-time `summary`, the
+ * `traceRef` pointer, status, and distill candidates — never the full
+ * transcript. One row per task; re-recording a task's Outcome replaces it.
+ */
+export declare function recordOutcome(db: Database.Database, now: number, outcome: Outcome, summary: string): TraceSummary;
+/** Fetch one task's trace summary by id, or `undefined` when absent. */
+export declare function getTraceSummary(db: Database.Database, taskId: string): TraceSummary | undefined;
+/** List trace summaries newest-first (CLM-0024); ties break on later insert. */
+export declare function listSummaries(db: Database.Database, options?: {
+    limit?: number;
+}): TraceSummary[];
+//# sourceMappingURL=episodic.d.ts.map

package/dist/episodic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodic.d.ts","sourceRoot":"","sources":["../src/episodic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGtF,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAsBrC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,YAAY,CAsBd;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAQ/F;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,YAAY,EAAE,CAShB"}

package/dist/episodic.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { OutcomeSchema } from '@kernloop/contracts';
+import { InvalidOutcomeError } from './errors.js';
+/** Default maximum number of summaries a listing returns. */
+export const DEFAULT_LIST_LIMIT = 20;
+function toSummary(row) {
+    return {
+        taskId: row.taskId,
+        summary: row.summary,
+        traceRef: row.traceRef,
+        status: row.status,
+        distillCandidates: JSON.parse(row.distillCandidates),
+        createdAt: row.createdAt,
+    };
+}
+/**
+ * Record an Outcome as a trace summary (CLM-0024). The Outcome is
+ * zod-validated at the boundary; invalid values throw
+ * {@link InvalidOutcomeError}. Stored: the write-time `summary`, the
+ * `traceRef` pointer, status, and distill candidates — never the full
+ * transcript. One row per task; re-recording a task's Outcome replaces it.
+ */
+export function recordOutcome(db, now, outcome, summary) {
+    const parsed = OutcomeSchema.safeParse(outcome);
+    if (!parsed.success) {
+        throw new InvalidOutcomeError(`episodic memory write rejected: ${z.prettifyError(parsed.error)}`);
+    }
+    const { taskId, traceRef, status, distillCandidates } = parsed.data;
+    const row = db
+        .prepare(`INSERT INTO traces (taskId, summary, traceRef, status, distillCandidates, createdAt)
+       VALUES (?, ?, ?, ?, ?, ?)
+       ON CONFLICT(taskId) DO UPDATE SET
+         summary = excluded.summary,
+         traceRef = excluded.traceRef,
+         status = excluded.status,
+         distillCandidates = excluded.distillCandidates,
+         createdAt = excluded.createdAt
+       RETURNING taskId, summary, traceRef, status, distillCandidates, createdAt`)
+        .get(taskId, summary, traceRef, status, JSON.stringify(distillCandidates), now);
+    return toSummary(row);
+}
+/** Fetch one task's trace summary by id, or `undefined` when absent. */
+export function getTraceSummary(db, taskId) {
+    const row = db
+        .prepare(`SELECT taskId, summary, traceRef, status, distillCandidates, createdAt
+       FROM traces WHERE taskId = ?`)
+        .get(taskId);
+    return row === undefined ? undefined : toSummary(row);
+}
+/** List trace summaries newest-first (CLM-0024); ties break on later insert. */
+export function listSummaries(db, options = {}) {
+    const limit = options.limit ?? DEFAULT_LIST_LIMIT;
+    const rows = db
+        .prepare(`SELECT taskId, summary, traceRef, status, distillCandidates, createdAt
+       FROM traces ORDER BY createdAt DESC, rowid DESC LIMIT ?`)
+        .all(limit);
+    return rows.map(toSummary);
+}
+//# sourceMappingURL=episodic.js.map

package/dist/episodic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodic.js","sourceRoot":"","sources":["../src/episodic.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAoC,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAYlD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAWrC,SAAS,SAAS,CAAC,GAAa;IAC9B,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,GAAG,CAAC,MAAuB;QACnC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAa;QAChE,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,EAAqB,EACrB,GAAW,EACX,OAAgB,EAChB,OAAe;IAEf,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,mBAAmB,CAC3B,mCAAmC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACpE,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;;;;;;;iFAQ2E,CAC5E;SACA,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAC;IAClF,OAAO,SAAS,CAAC,GAAe,CAAC,CAAC;AACpC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,MAAc;IACnE,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;oCAC8B,CAC/B;SACA,GAAG,CAAC,MAAM,CAAyB,CAAC;IACvC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAC3B,EAAqB,EACrB,UAA8B,EAAE;IAEhC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC;IAClD,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;+DACyD,CAC1D;SACA,GAAG,CAAC,KAAK,CAAe,CAAC;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Typed errors thrown at the faculty's write boundaries. Callers (the kernel,
+ * at the bus boundary) can discriminate on `name` or `instanceof` — never on
+ * message text.
+ */
+/**
+ * Thrown when a semantic memory write arrives without provenance (spec §5.2:
+ * "provenance mandatory"; CLM-0022). Missing, empty, and whitespace-only
+ * provenance all reject.
+ */
+export declare class ProvenanceRequiredError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Thrown when a semantic memory write is malformed for a reason other than
+ * provenance (empty fact text, out-of-range confidence, wrong types).
+ */
+export declare class InvalidFactError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when `recordOutcome` receives a value that fails `OutcomeSchema`
+ * validation at the boundary (charter: zod-validate at every contract
+ * boundary; CLM-0024).
+ */
+export declare class InvalidOutcomeError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,SAAwE;CAI5F;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,38 @@
+/**
+ * Typed errors thrown at the faculty's write boundaries. Callers (the kernel,
+ * at the bus boundary) can discriminate on `name` or `instanceof` — never on
+ * message text.
+ */
+/**
+ * Thrown when a semantic memory write arrives without provenance (spec §5.2:
+ * "provenance mandatory"; CLM-0022). Missing, empty, and whitespace-only
+ * provenance all reject.
+ */
+export class ProvenanceRequiredError extends Error {
+    constructor(message = 'semantic memory write rejected: provenance is mandatory (spec §5.2)') {
+        super(message);
+        this.name = 'ProvenanceRequiredError';
+    }
+}
+/**
+ * Thrown when a semantic memory write is malformed for a reason other than
+ * provenance (empty fact text, out-of-range confidence, wrong types).
+ */
+export class InvalidFactError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidFactError';
+    }
+}
+/**
+ * Thrown when `recordOutcome` receives a value that fails `OutcomeSchema`
+ * validation at the boundary (charter: zod-validate at every contract
+ * boundary; CLM-0024).
+ */
+export class InvalidOutcomeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidOutcomeError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,GAAG,qEAAqE;QACzF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/export.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Portable memory export/import (spec §7: "intuition travels with git clone";
+ * spec §12.4: the database is gitignored for privacy, so a reviewable JSON
+ * export is the portability path). The exported document is plain
+ * JSON-serializable data — semantic facts plus episodic trace summaries — and
+ * re-imports loss-free over the existing insert paths (provenance still
+ * mandatory; dedup by the existing UNIQUE keys). Faculty isolation holds: this
+ * module imports only zod and the faculty's own stores (CLM-0069).
+ */
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+/** One exported semantic fact — the durable fields, timestamps included. */
+export declare const SemanticFactExportSchema: z.ZodObject<{
+    fact: z.ZodString;
+    provenance: z.ZodString;
+    confidence: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNumber;
+    refreshedAt: z.ZodNumber;
+}, z.core.$strict>;
+export type SemanticFactExport = z.infer<typeof SemanticFactExportSchema>;
+/** One exported episodic trace summary — never the full transcript (spec §8). */
+export declare const TraceSummaryExportSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    summary: z.ZodString;
+    traceRef: z.ZodString;
+    status: z.ZodEnum<{
+        success: "success";
+        partial: "partial";
+        failure: "failure";
+        cancelled: "cancelled";
+    }>;
+    distillCandidates: z.ZodArray<z.ZodString>;
+    createdAt: z.ZodNumber;
+}, z.core.$strict>;
+export type TraceSummaryExport = z.infer<typeof TraceSummaryExportSchema>;
+/** The portable memory document (spec §7). Versioned for forward migration. */
+export declare const MemoryExportSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    facts: z.ZodArray<z.ZodObject<{
+        fact: z.ZodString;
+        provenance: z.ZodString;
+        confidence: z.ZodNullable<z.ZodNumber>;
+        createdAt: z.ZodNumber;
+        refreshedAt: z.ZodNumber;
+    }, z.core.$strict>>;
+    traces: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        summary: z.ZodString;
+        traceRef: z.ZodString;
+        status: z.ZodEnum<{
+            success: "success";
+            partial: "partial";
+            failure: "failure";
+            cancelled: "cancelled";
+        }>;
+        distillCandidates: z.ZodArray<z.ZodString>;
+        createdAt: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type MemoryExport = z.infer<typeof MemoryExportSchema>;
+/**
+ * Export every semantic fact and episodic trace summary as a portable,
+ * JSON-serializable document (CLM-0069). Facts carry their timestamps so a
+ * round-trip preserves the decay clock; traces carry their pointer and status
+ * but never the transcript behind `traceRef`.
+ */
+export declare function exportMemory(db: Database.Database): MemoryExport;
+/**
+ * Import a memory document, upserting through the existing insert paths
+ * (CLM-0069). Provenance stays mandatory and dedup uses the existing UNIQUE
+ * keys (`facts.fact`, `traces.taskId`). Returns the counts written so the
+ * caller can audit the mutation. zod-validates the document at the boundary.
+ */
+export declare function importMemory(db: Database.Database, data: MemoryExport): {
+    facts: number;
+    traces: number;
+};
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB;;;;;;kBAMnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,iFAAiF;AACjF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;kBAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;kBAI7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAmB9D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,YAAY,CA+BhE;AAeD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,YAAY,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAqBnC"}

package/dist/export.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { rememberFact } from './semantic.js';
+import { recordOutcome } from './episodic.js';
+import { OutcomeStatusSchema } from '@kernloop/contracts';
+/** One exported semantic fact — the durable fields, timestamps included. */
+export const SemanticFactExportSchema = z.strictObject({
+    fact: z.string().min(1),
+    provenance: z.string().min(1),
+    confidence: z.number().min(0).max(1).nullable(),
+    createdAt: z.number().int().nonnegative(),
+    refreshedAt: z.number().int().nonnegative(),
+});
+/** One exported episodic trace summary — never the full transcript (spec §8). */
+export const TraceSummaryExportSchema = z.strictObject({
+    taskId: z.string().min(1),
+    summary: z.string(),
+    traceRef: z.string().min(1),
+    status: OutcomeStatusSchema,
+    distillCandidates: z.array(z.string()),
+    createdAt: z.number().int().nonnegative(),
+});
+/** The portable memory document (spec §7). Versioned for forward migration. */
+export const MemoryExportSchema = z.strictObject({
+    version: z.literal('1'),
+    facts: z.array(SemanticFactExportSchema),
+    traces: z.array(TraceSummaryExportSchema),
+});
+/**
+ * Export every semantic fact and episodic trace summary as a portable,
+ * JSON-serializable document (CLM-0069). Facts carry their timestamps so a
+ * round-trip preserves the decay clock; traces carry their pointer and status
+ * but never the transcript behind `traceRef`.
+ */
+export function exportMemory(db) {
+    const factRows = db
+        .prepare('SELECT fact, provenance, confidence, createdAt, refreshedAt FROM facts ORDER BY id ASC')
+        .all();
+    const facts = factRows.map((row) => ({
+        fact: row.fact,
+        provenance: row.provenance,
+        confidence: row.confidence,
+        createdAt: row.createdAt,
+        refreshedAt: row.refreshedAt,
+    }));
+    // Insertion order (rowid ASC) — stable through a round-trip so re-export of
+    // an imported document is byte-identical (the newest-first read order of
+    // listSummaries is for display, not for portability).
+    const traceRows = db
+        .prepare(`SELECT taskId, summary, traceRef, status, distillCandidates, createdAt
+       FROM traces ORDER BY rowid ASC`)
+        .all();
+    const traces = traceRows.map((row) => ({
+        taskId: row.taskId,
+        summary: row.summary,
+        traceRef: row.traceRef,
+        status: row.status,
+        distillCandidates: JSON.parse(row.distillCandidates),
+        createdAt: row.createdAt,
+    }));
+    return { version: '1', facts, traces };
+}
+/** Upsert one exported fact, preserving its original timestamps. */
+function importFact(db, fact) {
+    const record = rememberFact(db, fact.refreshedAt, {
+        fact: fact.fact,
+        provenance: fact.provenance,
+        ...(fact.confidence === null ? {} : { confidence: fact.confidence }),
+    });
+    // rememberFact stamps both clocks to `now`; restore the exported createdAt
+    // so a round-trip is loss-free on a fresh row (UNIQUE(fact) dedup otherwise).
+    db.prepare('UPDATE facts SET createdAt = ? WHERE id = ?').run(fact.createdAt, record.id);
+    return { ...record, createdAt: fact.createdAt };
+}
+/**
+ * Import a memory document, upserting through the existing insert paths
+ * (CLM-0069). Provenance stays mandatory and dedup uses the existing UNIQUE
+ * keys (`facts.fact`, `traces.taskId`). Returns the counts written so the
+ * caller can audit the mutation. zod-validates the document at the boundary.
+ */
+export function importMemory(db, data) {
+    const parsed = MemoryExportSchema.parse(data);
+    return db.transaction(() => {
+        for (const fact of parsed.facts)
+            importFact(db, fact);
+        for (const t of parsed.traces) {
+            recordOutcome(db, t.createdAt, {
+                taskId: t.taskId,
+                status: t.status,
+                signals: [],
+                traceRef: t.traceRef,
+                distillCandidates: t.distillCandidates,
+                cost: { tokens: 0, usd: 0 },
+            }, t.summary);
+        }
+        return { facts: parsed.facts.length, traces: parsed.traces.length };
+    })();
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @kernloop/faculty-memory — Layer 2 memory faculty (spec §5.2).
+ *
+ * P1 surface: the episodic and semantic stores over repo-local SQLite — one
+ * database file per overlay (spec §3.3, §7). The procedural store (SKILL.md
+ * via the `distill` ratification path) lands in P3; absent here by design,
+ * not stubbed (constitutional rule 1). Auditing of memory operations happens
+ * kernel-side at the bus boundary; this faculty imports only
+ * @kernloop/contracts and external dependencies (constitutional rule 5).
+ */
+import type { Outcome } from '@kernloop/contracts';
+import { type FactRecord, type RecallOptions, type RecalledFact, type RememberFactInput } from './semantic.js';
+import { type TraceSummary } from './episodic.js';
+import { type MemoryExport } from './export.js';
+export { ProvenanceRequiredError, InvalidFactError, InvalidOutcomeError } from './errors.js';
+export { SCHEMA_DDL } from './store.js';
+export { DECAY_HALF_LIFE_MS, DEFAULT_RECALL_LIMIT } from './semantic.js';
+export type { FactRecord, RecalledFact, RememberFactInput, RecallOptions } from './semantic.js';
+export { DEFAULT_LIST_LIMIT } from './episodic.js';
+export type { TraceSummary } from './episodic.js';
+export { MemoryExportSchema, SemanticFactExportSchema, TraceSummaryExportSchema, } from './export.js';
+export type { MemoryExport, SemanticFactExport, TraceSummaryExport } from './export.js';
+export { memoryManifest } from './manifest.js';
+/** Options for {@link createMemory}. */
+export interface CreateMemoryOptions {
+    /**
+     * Write-time clock returning epoch ms; defaults to `Date.now`. Injectable
+     * so decay/refresh behavior is deterministic under test.
+     */
+    clock?: () => number;
+}
+/** The memory faculty's API over one overlay database. */
+export interface Memory {
+    /** Semantic write — provenance mandatory (CLM-0022); refresh on re-write. */
+    rememberFact(input: RememberFactInput): FactRecord;
+    /** Semantic read — ranked by relevance × provenance × recency (CLM-0023). */
+    recallFacts(query: string, options?: RecallOptions): RecalledFact[];
+    /** Episodic write — zod-validated Outcome → summary + traceRef (CLM-0024). */
+    recordOutcome(outcome: Outcome, summary: string): TraceSummary;
+    /** Episodic read — one task's summary, or `undefined` when absent. */
+    getTraceSummary(taskId: string): TraceSummary | undefined;
+    /** Episodic read — summaries newest-first (CLM-0024). */
+    listSummaries(options?: {
+        limit?: number;
+    }): TraceSummary[];
+    /** Portable export — facts + trace summaries as a JSON document (CLM-0069). */
+    exportMemory(): MemoryExport;
+    /** Loss-free import — upserts the export over the existing insert paths;
+     * returns the counts written so the caller can audit it (CLM-0069). */
+    importMemory(data: MemoryExport): {
+        facts: number;
+        traces: number;
+    };
+    /** Close the underlying database handle. */
+    close(): void;
+}
+/**
+ * Open (creating and migrating if absent) the overlay memory database at
+ * `dbPath` (spec §7: `.kernloop/memory.sqlite`). Deleting the file and
+ * calling this again yields a functional, empty store (CLM-0025).
+ */
+export declare function createMemory(dbPath: string, options?: CreateMemoryOptions): Memory;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAiD,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,MAAM;IACrB,6EAA6E;IAC7E,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACnD,6EAA6E;IAC7E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE,CAAC;IACpE,8EAA8E;IAC9E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;IAC/D,sEAAsE;IACtE,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC1D,yDAAyD;IACzD,aAAa,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,EAAE,CAAC;IAC5D,+EAA+E;IAC/E,YAAY,IAAI,YAAY,CAAC;IAC7B;2EACuE;IACvE,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,4CAA4C;IAC5C,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAatF"}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { openStore } from './store.js';
+import { rememberFact, recallFacts, } from './semantic.js';
+import { getTraceSummary, listSummaries, recordOutcome } from './episodic.js';
+import { exportMemory, importMemory } from './export.js';
+export { ProvenanceRequiredError, InvalidFactError, InvalidOutcomeError } from './errors.js';
+export { SCHEMA_DDL } from './store.js';
+export { DECAY_HALF_LIFE_MS, DEFAULT_RECALL_LIMIT } from './semantic.js';
+export { DEFAULT_LIST_LIMIT } from './episodic.js';
+export { MemoryExportSchema, SemanticFactExportSchema, TraceSummaryExportSchema, } from './export.js';
+export { memoryManifest } from './manifest.js';
+/**
+ * Open (creating and migrating if absent) the overlay memory database at
+ * `dbPath` (spec §7: `.kernloop/memory.sqlite`). Deleting the file and
+ * calling this again yields a functional, empty store (CLM-0025).
+ */
+export function createMemory(dbPath, options = {}) {
+    const clock = options.clock ?? Date.now;
+    const db = openStore(dbPath);
+    return {
+        rememberFact: (input) => rememberFact(db, clock(), input),
+        recallFacts: (query, opts) => recallFacts(db, query, opts),
+        recordOutcome: (outcome, summary) => recordOutcome(db, clock(), outcome, summary),
+        getTraceSummary: (taskId) => getTraceSummary(db, taskId),
+        listSummaries: (opts) => listSummaries(db, opts),
+        exportMemory: () => exportMemory(db),
+        importMemory: (data) => importMemory(db, data),
+        close: () => db.close(),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,WAAW,GAKZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAgC/C;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAA+B,EAAE;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACxC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO;QACL,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC;QACzD,WAAW,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC;QAC1D,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC;QACjF,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC;QACxD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC;QAChD,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC;QAC9C,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The memory faculty's registration record (spec §4, §5.2). Parsed through
+ * `ManifestSchema` at module load so an invalid manifest fails fast, not at
+ * registry time.
+ */
+import { type Manifest } from '@kernloop/contracts';
+/**
+ * The faculty-memory registration manifest. Tier is `suggest` — the
+ * conservative entry default for anything generative-adjacent (spec §3.2);
+ * tier assignment is under ratification review and the orchestrator may
+ * adjust at integration. Consumes Outcome (episodic auto-write); emits
+ * nothing — recall results travel as Brief fragments compiled elsewhere.
+ */
+export declare const memoryManifest: Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,QAsB3B,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,37 @@
+/**
+ * The memory faculty's registration record (spec §4, §5.2). Parsed through
+ * `ManifestSchema` at module load so an invalid manifest fails fast, not at
+ * registry time.
+ */
+import { ManifestSchema } from '@kernloop/contracts';
+/**
+ * The faculty-memory registration manifest. Tier is `suggest` — the
+ * conservative entry default for anything generative-adjacent (spec §3.2);
+ * tier assignment is under ratification review and the orchestrator may
+ * adjust at integration. Consumes Outcome (episodic auto-write); emits
+ * nothing — recall results travel as Brief fragments compiled elsewhere.
+ */
+export const memoryManifest = ManifestSchema.parse({
+    name: '@kernloop/faculty-memory',
+    version: '0.1.0',
+    kind: 'faculty',
+    capabilities: [
+        { name: 'memory.semantic.write', description: 'Store a typed fact; provenance mandatory' },
+        { name: 'memory.semantic.recall', description: 'Rank facts by relevance, provenance, recency' },
+        { name: 'memory.episodic.write', description: 'Record an Outcome as summary + trace pointer' },
+        { name: 'memory.episodic.read', description: 'Fetch trace summaries, newest first' },
+    ],
+    contracts: {
+        consumes: ['Outcome'],
+        emits: [],
+    },
+    cost: {
+        tokens: 0,
+        usd: 0,
+        latencyMs: 50,
+    },
+    tier: 'suggest',
+    claims: ['CLM-0022', 'CLM-0023', 'CLM-0024', 'CLM-0025'],
+    maturity: 'stable',
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAa,cAAc,CAAC,KAAK,CAAC;IAC3D,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,SAAS;IACf,YAAY,EAAE;QACZ,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,0CAA0C,EAAE;QAC1F,EAAE,IAAI,EAAE,wBAAwB,EAAE,WAAW,EAAE,8CAA8C,EAAE;QAC/F,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,8CAA8C,EAAE;QAC9F,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,qCAAqC,EAAE;KACrF;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,KAAK,EAAE,EAAE;KACV;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC;QACT,GAAG,EAAE,CAAC;QACN,SAAS,EAAE,EAAE;KACd;IACD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IACxD,QAAQ,EAAE,QAAQ;CACnB,CAAC,CAAC"}

package/dist/semantic.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Semantic store (spec §5.2): typed facts in SQLite. Write policy —
+ * provenance mandatory, optional confidence, decay clock (unrefreshed facts
+ * fade). Read policy — ranked by relevance × provenance × recency.
+ * All SQL uses parameterized statements; fact/provenance text is data, never
+ * SQL.
+ */
+import type Database from 'better-sqlite3';
+/** A stored semantic fact. Timestamps are epoch milliseconds. */
+export interface FactRecord {
+    id: number;
+    fact: string;
+    provenance: string;
+    confidence: number | null;
+    createdAt: number;
+    refreshedAt: number;
+}
+/** A recalled fact with its ranking score (see {@link recallFacts}). */
+export interface RecalledFact extends FactRecord {
+    score: number;
+}
+/** Input to {@link rememberFact}. Provenance is mandatory (spec §5.2). */
+export interface RememberFactInput {
+    fact: string;
+    provenance: string;
+    confidence?: number;
+}
+/** Options for {@link recallFacts}. */
+export interface RecallOptions {
+    /** Clock for decay scoring, epoch ms; injectable for deterministic tests. */
+    now?: number;
+    /** Maximum facts returned; default {@link DEFAULT_RECALL_LIMIT}. */
+    limit?: number;
+}
+/** Decay half-life: an unrefreshed fact's recency factor halves every 14 days. */
+export declare const DECAY_HALF_LIFE_MS: number;
+/** Default maximum number of facts a recall returns. */
+export declare const DEFAULT_RECALL_LIMIT = 10;
+/**
+ * Write (or refresh) a fact. Provenance is mandatory: missing, empty, or
+ * whitespace-only provenance throws {@link ProvenanceRequiredError}
+ * (CLM-0022); other malformed input throws {@link InvalidFactError}.
+ * Re-remembering an identical fact does not duplicate it — it updates
+ * provenance/confidence and resets `refreshedAt`, the decay clock (CLM-0023).
+ */
+export declare function rememberFact(db: Database.Database, now: number, input: RememberFactInput): FactRecord;
+/**
+ * Recall facts relevant to `query`, ranked by the score documented on
+ * {@link scoreFact}. Facts with zero relevance are omitted. Ties break on
+ * fresher `refreshedAt`, then insertion order. `now` is injectable for
+ * deterministic decay tests.
+ */
+export declare function recallFacts(db: Database.Database, query: string, options?: RecallOptions): RecalledFact[];
+//# sourceMappingURL=semantic.d.ts.map

package/dist/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../src/semantic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,QAA2B,CAAC;AAE3D,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,iBAAiB,GACvB,UAAU,CAqBZ;AAuCD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,EAAE,CAYhB"}

package/dist/semantic.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { InvalidFactError, ProvenanceRequiredError } from './errors.js';
+const RememberFactSchema = z.strictObject({
+    fact: z.string().min(1, 'fact must be a non-empty string'),
+    provenance: z.string().optional(),
+    confidence: z.number().min(0).max(1).optional(),
+});
+/** Decay half-life: an unrefreshed fact's recency factor halves every 14 days. */
+export const DECAY_HALF_LIFE_MS = 14 * 24 * 60 * 60 * 1000;
+/** Default maximum number of facts a recall returns. */
+export const DEFAULT_RECALL_LIMIT = 10;
+/**
+ * Write (or refresh) a fact. Provenance is mandatory: missing, empty, or
+ * whitespace-only provenance throws {@link ProvenanceRequiredError}
+ * (CLM-0022); other malformed input throws {@link InvalidFactError}.
+ * Re-remembering an identical fact does not duplicate it — it updates
+ * provenance/confidence and resets `refreshedAt`, the decay clock (CLM-0023).
+ */
+export function rememberFact(db, now, input) {
+    const parsed = RememberFactSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new InvalidFactError(`semantic memory write rejected: ${z.prettifyError(parsed.error)}`);
+    }
+    const { fact, provenance, confidence } = parsed.data;
+    if (provenance === undefined || provenance.trim().length === 0) {
+        throw new ProvenanceRequiredError();
+    }
+    const row = db
+        .prepare(`INSERT INTO facts (fact, provenance, confidence, createdAt, refreshedAt)
+       VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT(fact) DO UPDATE SET
+         provenance = excluded.provenance,
+         confidence = COALESCE(excluded.confidence, facts.confidence),
+         refreshedAt = excluded.refreshedAt
+       RETURNING id, fact, provenance, confidence, createdAt, refreshedAt`)
+        .get(fact, provenance, confidence ?? null, now, now);
+    return row;
+}
+/** Lowercased word tokens of a text (split on non-alphanumerics, deduped). */
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}]+/u)
+        .filter((t) => t.length > 0));
+}
+/**
+ * Score one fact against a query (spec §5.2 read policy: relevance ×
+ * provenance × recency). The formula, exactly:
+ *
+ * - **relevance** — token overlap: |query tokens ∩ fact tokens| / |query
+ *   tokens|, over lowercased word tokens. 0 means no shared token.
+ * - **provenance** — 1 when provenance is present, else 0. Writes make
+ *   provenance mandatory, so this factor is 1 for every stored fact; it is
+ *   kept explicit so the spec's ranking contract is visible in code.
+ * - **recency** — exponential decay on the decay clock:
+ *   `2 ** (-(now - refreshedAt) / DECAY_HALF_LIFE_MS)`. A fact refreshed
+ *   "now" scores 1; every 14 unrefreshed days halve it. Re-remembering
+ *   resets `refreshedAt`, so refreshed facts outrank stale ones (CLM-0023).
+ */
+function scoreFact(fact, queryTokens, now) {
+    let overlap = 0;
+    const factTokens = tokenize(fact.fact);
+    for (const token of queryTokens) {
+        if (factTokens.has(token))
+            overlap += 1;
+    }
+    const relevance = queryTokens.size === 0 ? 0 : overlap / queryTokens.size;
+    const provenanceFactor = fact.provenance.trim().length > 0 ? 1 : 0;
+    const ageMs = Math.max(0, now - fact.refreshedAt);
+    const recency = 2 ** (-ageMs / DECAY_HALF_LIFE_MS);
+    return relevance * provenanceFactor * recency;
+}
+/**
+ * Recall facts relevant to `query`, ranked by the score documented on
+ * {@link scoreFact}. Facts with zero relevance are omitted. Ties break on
+ * fresher `refreshedAt`, then insertion order. `now` is injectable for
+ * deterministic decay tests.
+ */
+export function recallFacts(db, query, options = {}) {
+    const now = options.now ?? Date.now();
+    const limit = options.limit ?? DEFAULT_RECALL_LIMIT;
+    const queryTokens = tokenize(query);
+    const rows = db
+        .prepare('SELECT id, fact, provenance, confidence, createdAt, refreshedAt FROM facts')
+        .all();
+    return rows
+        .map((fact) => ({ ...fact, score: scoreFact(fact, queryTokens, now) }))
+        .filter((fact) => fact.score > 0)
+        .sort((a, b) => b.score - a.score || b.refreshedAt - a.refreshedAt || a.id - b.id)
+        .slice(0, limit);
+}
+//# sourceMappingURL=semantic.js.map

package/dist/semantic.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SQLite storage for the memory faculty (spec §3.3, §7): one database file
+ * per overlay, opened and migrated on `createMemory`. Migration is a set of
+ * idempotent `CREATE TABLE IF NOT EXISTS` statements, so deleting the file
+ * and reopening yields a functional, empty store (CLM-0025) and reopening an
+ * existing file preserves state.
+ */
+import Database from 'better-sqlite3';
+/**
+ * The complete schema. Timestamps are epoch milliseconds.
+ *
+ * - `facts` — semantic store (spec §5.2): typed facts with mandatory
+ *   provenance, optional confidence, and the decay clock (`refreshedAt`).
+ *   `fact` is UNIQUE so re-remembering an identical fact refreshes rather
+ *   than duplicates.
+ * - `traces` — episodic store (spec §5.2, §8 item 5): compressed summary +
+ *   pointer to the full trace (`traceRef`), never the transcript itself.
+ *   One row per task; a re-recorded Outcome replaces the row.
+ */
+export declare const SCHEMA_DDL = "\nCREATE TABLE IF NOT EXISTS facts (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  fact TEXT NOT NULL UNIQUE,\n  provenance TEXT NOT NULL,\n  confidence REAL,\n  createdAt INTEGER NOT NULL,\n  refreshedAt INTEGER NOT NULL\n);\nCREATE TABLE IF NOT EXISTS traces (\n  taskId TEXT PRIMARY KEY,\n  summary TEXT NOT NULL,\n  traceRef TEXT NOT NULL,\n  status TEXT NOT NULL,\n  distillCandidates TEXT NOT NULL,\n  createdAt INTEGER NOT NULL\n);\n";
+/** Open (creating if absent) and migrate the overlay database at `dbPath`.
+ * WAL + a busy timeout let a stateless reader (`status`/`observe`/`metrics`)
+ * run concurrently with the resident `serve` writer without a SQLITE_BUSY
+ * (#157): WAL readers do not block on the single writer, and the timeout waits
+ * on genuine lock contention instead of erroring immediately. */
+export declare function openStore(dbPath: string): Database.Database;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,2bAiBtB,CAAC;AAEF;;;;iEAIiE;AACjE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAM3D"}

package/dist/store.js

@@ -0,0 +1,50 @@
+/**
+ * SQLite storage for the memory faculty (spec §3.3, §7): one database file
+ * per overlay, opened and migrated on `createMemory`. Migration is a set of
+ * idempotent `CREATE TABLE IF NOT EXISTS` statements, so deleting the file
+ * and reopening yields a functional, empty store (CLM-0025) and reopening an
+ * existing file preserves state.
+ */
+import Database from 'better-sqlite3';
+/**
+ * The complete schema. Timestamps are epoch milliseconds.
+ *
+ * - `facts` — semantic store (spec §5.2): typed facts with mandatory
+ *   provenance, optional confidence, and the decay clock (`refreshedAt`).
+ *   `fact` is UNIQUE so re-remembering an identical fact refreshes rather
+ *   than duplicates.
+ * - `traces` — episodic store (spec §5.2, §8 item 5): compressed summary +
+ *   pointer to the full trace (`traceRef`), never the transcript itself.
+ *   One row per task; a re-recorded Outcome replaces the row.
+ */
+export const SCHEMA_DDL = `
+CREATE TABLE IF NOT EXISTS facts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  fact TEXT NOT NULL UNIQUE,
+  provenance TEXT NOT NULL,
+  confidence REAL,
+  createdAt INTEGER NOT NULL,
+  refreshedAt INTEGER NOT NULL
+);
+CREATE TABLE IF NOT EXISTS traces (
+  taskId TEXT PRIMARY KEY,
+  summary TEXT NOT NULL,
+  traceRef TEXT NOT NULL,
+  status TEXT NOT NULL,
+  distillCandidates TEXT NOT NULL,
+  createdAt INTEGER NOT NULL
+);
+`;
+/** Open (creating if absent) and migrate the overlay database at `dbPath`.
+ * WAL + a busy timeout let a stateless reader (`status`/`observe`/`metrics`)
+ * run concurrently with the resident `serve` writer without a SQLITE_BUSY
+ * (#157): WAL readers do not block on the single writer, and the timeout waits
+ * on genuine lock contention instead of erroring immediately. */
+export function openStore(dbPath) {
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    db.exec(SCHEMA_DDL);
+    return db;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;CAiBzB,CAAC;AAEF;;;;iEAIiE;AACjE,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACjC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kernloop/faculty-memory",
+  "version": "0.1.0",
+  "description": "Kernloop Layer 2 — the memory faculty (spec §5.2). P1 scope: episodic and semantic stores over repo-local SQLite (one DB file per overlay, spec §3.3, §7). Procedural memory (SKILL.md distillation) arrives in P3; absent here by design.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^12.11.1",
+    "zod": "^4.4.3",
+    "@kernloop/contracts": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kernloop/kernloop.git",
+    "directory": "packages/faculty-memory"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run --coverage"
+  }
+}