nemoris 0.1.0 → 0.1.2

package/src/memory/active-recall.js

@@ -1,171 +1,171 @@
-/**
- * Active Recall — turn-aware memory scoring and tiered injection.
- *
- * Spec: docs/superpowers/specs/2026-03-16-interaction-layer-design.md § Pillar 1
- */
-
-// ── Scoring ─────────────────────────────────────────────────────
-
-export function computeRecency(lastAccessedOrCreated, now = new Date()) {
-  const ts = new Date(lastAccessedOrCreated);
-  const daysSince = (now.getTime() - ts.getTime()) / (24 * 60 * 60 * 1000);
-  return 1 / (1 + daysSince * 0.1);
-}
-
-export function scoreCandidate({ similarity, topicRelevance, recency, confidence }) {
-  const hasTopicRelevance = topicRelevance > 0;
-  if (hasTopicRelevance) {
-    return (similarity * 0.5) + (topicRelevance * 0.3) + (recency * confidence * 0.2);
-  }
-  return (similarity * 0.7) + (recency * confidence * 0.3);
-}
-
-// ── Tier classification ─────────────────────────────────────────
-
-const FACT_THRESHOLD = 0.85;
-export const ASIDE_THRESHOLD = 0.70;
-
-export function classifyTier(score) {
-  if (score > FACT_THRESHOLD) return "fact";
-  if (score >= ASIDE_THRESHOLD) return "aside";
-  return "silent";
-}
-
-// ── Injection builder ───────────────────────────────────────────
-
-const CHARS_PER_TOKEN = 4;
-
-export function buildInjection(candidates, { tokenBudget = 2000 } = {}) {
-  let remainingChars = tokenBudget * CHARS_PER_TOKEN;
-  const facts = [];
-  const asides = [];
-  const silent = [];
-
-  const sorted = [...candidates].sort((a, b) => b.score - a.score);
-
-  for (const c of sorted) {
-    if (c.tier === "silent") { silent.push(c); continue; }
-    if (c.tier === "fact") {
-      const len = c.content.length;
-      if (len <= remainingChars) {
-        facts.push(c);
-        remainingChars -= len;
-      }
-    }
-  }
-
-  for (const c of sorted) {
-    if (c.tier === "aside") {
-      const len = c.content.length;
-      if (len <= remainingChars) {
-        asides.push(c);
-        remainingChars -= len;
-      }
-    }
-  }
-
-  return { facts, asides, silent };
-}
-
-// ── Orchestrator ────────────────────────────────────────────────
-
-export async function activeRecall({ inboundMessage, memoryStore, tokenBudget = 2000, topicRelevanceFn = null, contextWindow = 0 }) {
-  const budget = contextWindow > 0 ? Math.min(tokenBudget, Math.floor(contextWindow * 0.08)) : tokenBudget;
-
-  // Stage 1: Candidate retrieval (top 20)
-  // queryRetrievalCandidates(query, options) — positional args
-  const raw = memoryStore.queryRetrievalCandidates
-    ? memoryStore.queryRetrievalCandidates(inboundMessage, { limit: 20 })
-    : [];
-
-  // Unwrap nested shape: real store returns { item: { entry_id, content, ... }, embeddingSimilarity }
-  const candidates = raw.map((r) => ({
-    entryId: r.item?.entry_id || r.entryId,
-    content: r.item?.content || r.content,
-    summary: r.item?.summary || r.summary,
-    salience: r.item?.salience ?? r.salience ?? 0.5,
-    embeddingSimilarity: r.embeddingSimilarity ?? 0,
-    last_accessed: r.item?.last_accessed || r.last_accessed || null,
-    created_at: r.item?.timestamp || r.created_at,
-  }));
-
-  // Stage 2: Turn-aware scoring
-  const now = new Date();
-  const scored = candidates.map((c) => {
-    const similarity = c.embeddingSimilarity || c.salience || 0.5;
-    const topicRelevance = topicRelevanceFn ? topicRelevanceFn(inboundMessage, c) : 0;
-    const recency = computeRecency(c.last_accessed || c.created_at || now.toISOString(), now);
-    const confidence = 0.75; // Default — declared memory (MEMORY.md) injected separately at 1.0
-    const score = scoreCandidate({ similarity, topicRelevance, recency, confidence });
-    const tier = classifyTier(score);
-    return { ...c, score, tier };
-  });
-
-  // Stage 3: Tiered injection
-  const injection = buildInjection(scored, { tokenBudget: budget });
-
-  // Stage 4: Access tracking (score >= 0.70)
-  const accessedIds = scored.filter((c) => c.score >= ASIDE_THRESHOLD).map((c) => c.entryId);
-  if (accessedIds.length && memoryStore.updateAccessTime) {
-    memoryStore.updateAccessTime(accessedIds);
-  }
-
-  return injection;
-}
-
-// ── Write discipline ────────────────────────────────────────────
-
-const DEDUP_THRESHOLD = 0.95;
-const CONTRADICTION_LOW = 0.85;
-
-export class WriteBuffer {
-  constructor({ commitFn, similarityFn, updateFn, existingEntries = [] }) {
-    this._pending = [];
-    this._commitFn = commitFn;
-    this._similarityFn = similarityFn;
-    this._updateFn = updateFn || (() => {});
-    this._existingEntries = existingEntries;
-  }
-
-  add(entry) {
-    this._pending.push(entry);
-  }
-
-  flush() {
-    let committed = 0;
-    let deduped = 0;
-    const contradictions = [];
-
-    for (const entry of this._pending) {
-      let dominated = false;
-      for (const existing of this._existingEntries) {
-        const sim = this._similarityFn(entry.content, existing.content);
-        if (sim > DEDUP_THRESHOLD) {
-          this._updateFn(existing.entryId, entry.content);
-          deduped++;
-          dominated = true;
-          break;
-        }
-        if (sim >= CONTRADICTION_LOW && sim <= DEDUP_THRESHOLD) {
-          contradictions.push({
-            existingId: existing.entryId,
-            existingContent: existing.content,
-            newContent: entry.content,
-            similarity: sim,
-          });
-          dominated = true;
-          break;
-        }
-      }
-      if (!dominated) {
-        this._commitFn(entry);
-        committed++;
-      }
-    }
-
-    this._pending = [];
-    return { committed, deduped, contradictions };
-  }
-
-  get pending() { return this._pending; }
-}
+/**
+ * Active Recall — turn-aware memory scoring and tiered injection.
+ *
+ * Spec: docs/superpowers/specs/2026-03-16-interaction-layer-design.md § Pillar 1
+ */
+
+// ── Scoring ─────────────────────────────────────────────────────
+
+export function computeRecency(lastAccessedOrCreated, now = new Date()) {
+  const ts = new Date(lastAccessedOrCreated);
+  const daysSince = (now.getTime() - ts.getTime()) / (24 * 60 * 60 * 1000);
+  return 1 / (1 + daysSince * 0.1);
+}
+
+export function scoreCandidate({ similarity, topicRelevance, recency, confidence }) {
+  const hasTopicRelevance = topicRelevance > 0;
+  if (hasTopicRelevance) {
+    return (similarity * 0.5) + (topicRelevance * 0.3) + (recency * confidence * 0.2);
+  }
+  return (similarity * 0.7) + (recency * confidence * 0.3);
+}
+
+// ── Tier classification ─────────────────────────────────────────
+
+const FACT_THRESHOLD = 0.85;
+export const ASIDE_THRESHOLD = 0.70;
+
+export function classifyTier(score) {
+  if (score > FACT_THRESHOLD) return "fact";
+  if (score >= ASIDE_THRESHOLD) return "aside";
+  return "silent";
+}
+
+// ── Injection builder ───────────────────────────────────────────
+
+const CHARS_PER_TOKEN = 4;
+
+export function buildInjection(candidates, { tokenBudget = 2000 } = {}) {
+  let remainingChars = tokenBudget * CHARS_PER_TOKEN;
+  const facts = [];
+  const asides = [];
+  const silent = [];
+
+  const sorted = [...candidates].sort((a, b) => b.score - a.score);
+
+  for (const c of sorted) {
+    if (c.tier === "silent") { silent.push(c); continue; }
+    if (c.tier === "fact") {
+      const len = c.content.length;
+      if (len <= remainingChars) {
+        facts.push(c);
+        remainingChars -= len;
+      }
+    }
+  }
+
+  for (const c of sorted) {
+    if (c.tier === "aside") {
+      const len = c.content.length;
+      if (len <= remainingChars) {
+        asides.push(c);
+        remainingChars -= len;
+      }
+    }
+  }
+
+  return { facts, asides, silent };
+}
+
+// ── Orchestrator ────────────────────────────────────────────────
+
+export async function activeRecall({ inboundMessage, memoryStore, tokenBudget = 2000, topicRelevanceFn = null, contextWindow = 0 }) {
+  const budget = contextWindow > 0 ? Math.min(tokenBudget, Math.floor(contextWindow * 0.08)) : tokenBudget;
+
+  // Stage 1: Candidate retrieval (top 20)
+  // queryRetrievalCandidates(query, options) — positional args
+  const raw = memoryStore.queryRetrievalCandidates
+    ? memoryStore.queryRetrievalCandidates(inboundMessage, { limit: 20 })
+    : [];
+
+  // Unwrap nested shape: real store returns { item: { entry_id, content, ... }, embeddingSimilarity }
+  const candidates = raw.map((r) => ({
+    entryId: r.item?.entry_id || r.entryId,
+    content: r.item?.content || r.content,
+    summary: r.item?.summary || r.summary,
+    salience: r.item?.salience ?? r.salience ?? 0.5,
+    embeddingSimilarity: r.embeddingSimilarity ?? 0,
+    last_accessed: r.item?.last_accessed || r.last_accessed || null,
+    created_at: r.item?.timestamp || r.created_at,
+  }));
+
+  // Stage 2: Turn-aware scoring
+  const now = new Date();
+  const scored = candidates.map((c) => {
+    const similarity = c.embeddingSimilarity || c.salience || 0.5;
+    const topicRelevance = topicRelevanceFn ? topicRelevanceFn(inboundMessage, c) : 0;
+    const recency = computeRecency(c.last_accessed || c.created_at || now.toISOString(), now);
+    const confidence = 0.75; // Default — declared memory (MEMORY.md) injected separately at 1.0
+    const score = scoreCandidate({ similarity, topicRelevance, recency, confidence });
+    const tier = classifyTier(score);
+    return { ...c, score, tier };
+  });
+
+  // Stage 3: Tiered injection
+  const injection = buildInjection(scored, { tokenBudget: budget });
+
+  // Stage 4: Access tracking (score >= 0.70)
+  const accessedIds = scored.filter((c) => c.score >= ASIDE_THRESHOLD).map((c) => c.entryId);
+  if (accessedIds.length && memoryStore.updateAccessTime) {
+    memoryStore.updateAccessTime(accessedIds);
+  }
+
+  return injection;
+}
+
+// ── Write discipline ────────────────────────────────────────────
+
+const DEDUP_THRESHOLD = 0.95;
+const CONTRADICTION_LOW = 0.85;
+
+export class WriteBuffer {
+  constructor({ commitFn, similarityFn, updateFn, existingEntries = [] }) {
+    this._pending = [];
+    this._commitFn = commitFn;
+    this._similarityFn = similarityFn;
+    this._updateFn = updateFn || (() => {});
+    this._existingEntries = existingEntries;
+  }
+
+  add(entry) {
+    this._pending.push(entry);
+  }
+
+  flush() {
+    let committed = 0;
+    let deduped = 0;
+    const contradictions = [];
+
+    for (const entry of this._pending) {
+      let dominated = false;
+      for (const existing of this._existingEntries) {
+        const sim = this._similarityFn(entry.content, existing.content);
+        if (sim > DEDUP_THRESHOLD) {
+          this._updateFn(existing.entryId, entry.content);
+          deduped++;
+          dominated = true;
+          break;
+        }
+        if (sim >= CONTRADICTION_LOW && sim <= DEDUP_THRESHOLD) {
+          contradictions.push({
+            existingId: existing.entryId,
+            existingContent: existing.content,
+            newContent: entry.content,
+            similarity: sim,
+          });
+          dominated = true;
+          break;
+        }
+      }
+      if (!dominated) {
+        this._commitFn(entry);
+        committed++;
+      }
+    }
+
+    this._pending = [];
+    return { committed, deduped, contradictions };
+  }
+
+  get pending() { return this._pending; }
+}

package/src/memory/backend-manager.js

@@ -1,97 +1,97 @@
-import { FileMemoryBackend } from "./backends/file-backend.js";
-import { QmdMemoryBackend } from "./backends/qmd-backend.js";
-
-export class MemoryBackendManager {
-  constructor({ memoryStore, embeddingIndex, liveRoot }) {
-    this.fileBackend = new FileMemoryBackend({ memoryStore, embeddingIndex });
-    this.qmdBackend = new QmdMemoryBackend({ liveRoot });
-  }
-
-  defaultBackend() {
-    return this.fileBackend;
-  }
-
-  async queryCombined(agentId, query, options = {}) {
-    const limit = options.limit ?? 8;
-    const workspaceRoot = options.workspaceRoot || null;
-    const backendOrder = options.backendOrder || ["file"];
-    const qmdSupplementLimit = options.qmdSupplementLimit ?? 2;
-    const fileQuery = options.fileQuery || query;
-    const qmdQuery = options.qmdQuery || query;
-
-    const fileResult = await this.fileBackend.query(agentId, fileQuery, {
-      limit,
-      now: options.now,
-      retrievalBlend: options.retrievalBlend
-    });
-
-    let merged = [...fileResult.items];
-    let qmdResult = {
-      backend: "qmd",
-      available: false,
-      items: []
-    };
-
-    if (backendOrder.includes("qmd")) {
-      qmdResult = await this.qmdBackend.query(agentId, qmdQuery, {
-        workspaceRoot,
-        limit: qmdSupplementLimit
-      });
-
-      const qmdItems = qmdResult.items.map((item, index) => ({
-        type: "external",
-        category: "qmd_match",
-        title: item.title,
-        content: item.snippet,
-        summary: item.filepath,
-        reason: "Matched through local QMD FTS retrieval.",
-        score: Number((0.35 - index * 0.03).toFixed(4)),
-        sourceBackend: "qmd",
-        candidateSource: "qmd",
-        lexicalScore: 0,
-        embeddingSimilarity: 0,
-        embeddingFreshness: "not_applicable",
-        retrievalSources: ["qmd"]
-      }));
-
-      merged = [...merged, ...qmdItems];
-    }
-
-    return {
-      items: merged.slice(0, limit),
-      backends: {
-        file: {
-          available: fileResult.available,
-          totalCandidates: fileResult.totalCandidates ?? fileResult.items.length,
-          query: fileQuery
-        },
-        qmd: {
-          available: qmdResult.available,
-          totalCandidates: qmdResult.items.length,
-          stats: qmdResult.stats || null,
-          query: qmdQuery
-        }
-      },
-      retrieval: fileResult.retrieval || null
-    };
-  }
-
-  async inspect(agentId, workspaceRoot = null) {
-    const [file, qmd] = await Promise.all([
-      this.fileBackend.inspect(agentId),
-      this.qmdBackend.inspect(agentId, workspaceRoot)
-    ]);
-
-    return {
-      defaultBackend: file.kind,
-      backends: [file, qmd]
-    };
-  }
-
-  async queryQmd(agentId, query, workspaceRoot = null, limit = 5) {
-    return this.qmdBackend.query(agentId, query, {
-      workspaceRoot,
-      limit
-    });
-  }
-}
+import { FileMemoryBackend } from "./backends/file-backend.js";
+import { QmdMemoryBackend } from "./backends/qmd-backend.js";
+
+export class MemoryBackendManager {
+  constructor({ memoryStore, embeddingIndex, liveRoot }) {
+    this.fileBackend = new FileMemoryBackend({ memoryStore, embeddingIndex });
+    this.qmdBackend = new QmdMemoryBackend({ liveRoot });
+  }
+
+  defaultBackend() {
+    return this.fileBackend;
+  }
+
+  async queryCombined(agentId, query, options = {}) {
+    const limit = options.limit ?? 8;
+    const workspaceRoot = options.workspaceRoot || null;
+    const backendOrder = options.backendOrder || ["file"];
+    const qmdSupplementLimit = options.qmdSupplementLimit ?? 2;
+    const fileQuery = options.fileQuery || query;
+    const qmdQuery = options.qmdQuery || query;
+
+    const fileResult = await this.fileBackend.query(agentId, fileQuery, {
+      limit,
+      now: options.now,
+      retrievalBlend: options.retrievalBlend
+    });
+
+    let merged = [...fileResult.items];
+    let qmdResult = {
+      backend: "qmd",
+      available: false,
+      items: []
+    };
+
+    if (backendOrder.includes("qmd")) {
+      qmdResult = await this.qmdBackend.query(agentId, qmdQuery, {
+        workspaceRoot,
+        limit: qmdSupplementLimit
+      });
+
+      const qmdItems = qmdResult.items.map((item, index) => ({
+        type: "external",
+        category: "qmd_match",
+        title: item.title,
+        content: item.snippet,
+        summary: item.filepath,
+        reason: "Matched through local QMD FTS retrieval.",
+        score: Number((0.35 - index * 0.03).toFixed(4)),
+        sourceBackend: "qmd",
+        candidateSource: "qmd",
+        lexicalScore: 0,
+        embeddingSimilarity: 0,
+        embeddingFreshness: "not_applicable",
+        retrievalSources: ["qmd"]
+      }));
+
+      merged = [...merged, ...qmdItems];
+    }
+
+    return {
+      items: merged.slice(0, limit),
+      backends: {
+        file: {
+          available: fileResult.available,
+          totalCandidates: fileResult.totalCandidates ?? fileResult.items.length,
+          query: fileQuery
+        },
+        qmd: {
+          available: qmdResult.available,
+          totalCandidates: qmdResult.items.length,
+          stats: qmdResult.stats || null,
+          query: qmdQuery
+        }
+      },
+      retrieval: fileResult.retrieval || null
+    };
+  }
+
+  async inspect(agentId, workspaceRoot = null) {
+    const [file, qmd] = await Promise.all([
+      this.fileBackend.inspect(agentId),
+      this.qmdBackend.inspect(agentId, workspaceRoot)
+    ]);
+
+    return {
+      defaultBackend: file.kind,
+      backends: [file, qmd]
+    };
+  }
+
+  async queryQmd(agentId, query, workspaceRoot = null, limit = 5) {
+    return this.qmdBackend.query(agentId, query, {
+      workspaceRoot,
+      limit
+    });
+  }
+}

package/src/memory/backends/file-backend.js

@@ -1,38 +1,38 @@
-export class FileMemoryBackend {
-  constructor({ memoryStore, embeddingIndex = null } = {}) {
-    this.kind = "file";
-    this.memoryStore = memoryStore;
-    this.embeddingIndex = embeddingIndex;
-  }
-
-  async query(agentId, query, options = {}) {
-    const result = await this.memoryStore.query(agentId, query, {
-      ...options,
-      embeddingIndex: this.embeddingIndex
-    });
-    return {
-      backend: this.kind,
-      available: true,
-      items: result.items.map((item) => ({
-        ...item,
-        sourceBackend: this.kind
-      })),
-      totalCandidates: result.totalCandidates,
-      retrieval: result.retrieval || null
-    };
-  }
-
-  async listAll(agentId) {
-    return this.memoryStore.listAll(agentId);
-  }
-
-  async inspect(agentId) {
-    const items = await this.memoryStore.listAll(agentId);
-    return {
-      kind: this.kind,
-      available: true,
-      itemCount: items.length,
-      embeddingIndexConfigured: Boolean(this.embeddingIndex)
-    };
-  }
-}
+export class FileMemoryBackend {
+  constructor({ memoryStore, embeddingIndex = null } = {}) {
+    this.kind = "file";
+    this.memoryStore = memoryStore;
+    this.embeddingIndex = embeddingIndex;
+  }
+
+  async query(agentId, query, options = {}) {
+    const result = await this.memoryStore.query(agentId, query, {
+      ...options,
+      embeddingIndex: this.embeddingIndex
+    });
+    return {
+      backend: this.kind,
+      available: true,
+      items: result.items.map((item) => ({
+        ...item,
+        sourceBackend: this.kind
+      })),
+      totalCandidates: result.totalCandidates,
+      retrieval: result.retrieval || null
+    };
+  }
+
+  async listAll(agentId) {
+    return this.memoryStore.listAll(agentId);
+  }
+
+  async inspect(agentId) {
+    const items = await this.memoryStore.listAll(agentId);
+    return {
+      kind: this.kind,
+      available: true,
+      itemCount: items.length,
+      embeddingIndexConfigured: Boolean(this.embeddingIndex)
+    };
+  }
+}