@kinqs/brainrouter-mcp-server 0.3.5 → 0.3.6

package/dist/memory/pipeline/l2-scene.d.ts

@@ -1,15 +0,0 @@
-import type { IMemoryStore } from "@brainrouter/types";
-import type { LLMRunner } from "@brainrouter/types";
-/**
- * L2 Scene Pipeline
- * Groups L1 memories by scene_name and asks the LLM to produce
- * a Markdown summary for each scene. Updates heat scores.
- */
-export declare function distillScenes(params: {
-    userId: string;
-    store: IMemoryStore;
-    llmRunner: LLMRunner;
-}): Promise<{
-    scenesDistilled: number;
-    sceneNames: string[];
-}>;

package/dist/memory/pipeline/l2-scene.js

@@ -1,140 +0,0 @@
-import { L2_SCENE_SYSTEM_PROMPT, formatL2ScenePrompt } from "../prompts/l2-scene.js";
-import { L2_SCENE_CLUSTER_SYSTEM_PROMPT, formatSceneClusterPrompt } from "../prompts/l2-scene-cluster.js";
-import { L2_MAX_SCENES } from "../scheduler.js";
-import crypto from "node:crypto";
-async function canonicalizeSceneNames(params) {
-    const { userId, store, llmRunner } = params;
-    const sceneNames = store.getDistinctSceneNames(userId);
-    if (sceneNames.length < 2)
-        return;
-    try {
-        const rawCluster = await llmRunner.run({
-            prompt: formatSceneClusterPrompt(sceneNames),
-            systemPrompt: L2_SCENE_CLUSTER_SYSTEM_PROMPT,
-            taskId: "l2-scene-clustering",
-            timeoutMs: 45_000,
-        });
-        const jsonMatch = rawCluster.match(/\[[\s\S]*\]/);
-        if (!jsonMatch)
-            return;
-        const clusters = JSON.parse(jsonMatch[0]);
-        if (!Array.isArray(clusters))
-            return;
-        for (const cluster of clusters) {
-            const canonical = String(cluster.canonical || "").trim();
-            const aliases = Array.isArray(cluster.aliases) ? cluster.aliases.map((a) => String(a).trim()) : [];
-            if (!canonical || aliases.length === 0)
-                continue;
-            for (const alias of aliases) {
-                if (alias === canonical)
-                    continue;
-                store.renameSceneInL1Records(userId, alias, canonical);
-            }
-        }
-    }
-    catch (err) {
-        console.error(`[BrainRouter] Scene canonicalization failed for "${userId}":`, err.message);
-    }
-}
-/**
- * L2 Scene Pipeline
- * Groups L1 memories by scene_name and asks the LLM to produce
- * a Markdown summary for each scene. Updates heat scores.
- */
-export async function distillScenes(params) {
-    const { userId, store, llmRunner } = params;
-    // Run scene canonicalization/clustering pass to prevent cold-start fragmentation
-    await canonicalizeSceneNames({ userId, store, llmRunner });
-    // Decay all existing heat scores (each distillation cycle = time passing)
-    store.decayL2HeatScores(userId);
-    const sceneNames = store.getDistinctSceneNames(userId);
-    if (sceneNames.length === 0) {
-        return { scenesDistilled: 0, sceneNames: [] };
-    }
-    const now = new Date().toISOString();
-    const distilled = [];
-    // Fetch existing L2 scene names up-front so the prompt can avoid near-duplicates
-    const existingL2SceneNames = store.getTopL2Scenes(userId, 50).map(s => s.sceneName);
-    for (const sceneName of sceneNames) {
-        const l1s = store.getL1sByScene(userId, sceneName, 30);
-        if (l1s.length === 0)
-            continue;
-        let summaryMd;
-        try {
-            summaryMd = await llmRunner.run({
-                prompt: formatL2ScenePrompt(sceneName, l1s, existingL2SceneNames.filter(n => n !== sceneName)),
-                systemPrompt: L2_SCENE_SYSTEM_PROMPT,
-                taskId: "l2-scene-distillation",
-                timeoutMs: 60_000,
-            });
-        }
-        catch (err) {
-            console.error(`[BrainRouter] L2 scene distillation failed for "${sceneName}":`, err.message);
-            continue;
-        }
-        const existing = store.getL2SceneByName(userId, sceneName);
-        const record = {
-            id: existing?.id ?? `l2_${crypto.randomBytes(6).toString("hex")}`,
-            userId,
-            sceneName,
-            summaryMd: summaryMd.trim(),
-            heatScore: existing ? Math.min(100, existing.heatScore + 30) : 100,
-            lastActiveTime: now,
-            createdTime: existing?.createdTime ?? now,
-            updatedTime: now,
-        };
-        store.upsertL2Scene(record);
-        distilled.push(sceneName);
-    }
-    // Auto-merge cold scenes if we exceed the max threshold
-    await mergeScenes({ userId, store, llmRunner });
-    console.error(`[BrainRouter] L2 distilled ${distilled.length} scene(s) for user "${userId}".`);
-    return { scenesDistilled: distilled.length, sceneNames: distilled };
-}
-async function mergeScenes(params) {
-    const { userId, store, llmRunner } = params;
-    const sceneCount = store.getL2SceneCount(userId);
-    if (sceneCount < L2_MAX_SCENES)
-        return;
-    const overflow = sceneCount - L2_MAX_SCENES + 1;
-    const coldScenes = store.getColdL2Scenes(userId, overflow + 3);
-    // Need at least 2 cold scenes to meaningfully merge
-    if (coldScenes.length < 2)
-        return;
-    // Skip any existing [Archived] scene from the merge input — we'll update it separately
-    const archiveSceneName = "[Archived]";
-    const scenesToMerge = coldScenes.filter(s => s.sceneName !== archiveSceneName);
-    if (scenesToMerge.length < 2)
-        return;
-    const sceneSummaries = scenesToMerge.map(s => `## ${s.sceneName}\n${s.summaryMd}`).join("\n\n");
-    let unifiedSummary;
-    try {
-        unifiedSummary = await llmRunner.run({
-            prompt: `Merge the following old scene summaries into a single concise "Archived Scenes" overview.\n\n${sceneSummaries}\n\nOutput only the Markdown summary. Be concise — no preamble.`,
-            systemPrompt: L2_SCENE_SYSTEM_PROMPT,
-            taskId: "l2-scene-merge",
-            timeoutMs: 60_000,
-        });
-    }
-    catch (err) {
-        console.error(`[BrainRouter] L2 scene merge failed for "${userId}":`, err.message);
-        return;
-    }
-    const now = new Date().toISOString();
-    // Look up any pre-existing [Archived] scene
-    const existingArchive = store.getL2SceneByName(userId, archiveSceneName);
-    const record = {
-        id: existingArchive?.id ?? `l2_${crypto.randomBytes(6).toString("hex")}`,
-        userId,
-        sceneName: archiveSceneName,
-        summaryMd: unifiedSummary.trim(),
-        heatScore: 10,
-        lastActiveTime: now,
-        createdTime: existingArchive?.createdTime ?? now,
-        updatedTime: now,
-    };
-    store.upsertL2Scene(record);
-    const idsToDelete = scenesToMerge.map(s => s.id);
-    store.deleteL2Scenes(userId, idsToDelete);
-    console.error(`[BrainRouter] L2 auto-merge: merged ${idsToDelete.length} cold scenes into "${archiveSceneName}".`);
-}

package/dist/memory/pipeline/l3-distiller.d.ts

@@ -1,15 +0,0 @@
-import type { IMemoryStore } from "@brainrouter/types";
-import type { LLMRunner } from "@brainrouter/types";
-/**
- * L3 Persona Distillation Pipeline
- * Scans ALL persona + instruction L1 memories across all sessions
- * for a user and synthesizes a durable Narrative Profile.
- */
-export declare function distillPersona(params: {
-    userId: string;
-    store: IMemoryStore;
-    llmRunner: LLMRunner;
-}): Promise<{
-    success: boolean;
-    personaMd?: string;
-}>;

package/dist/memory/pipeline/l3-distiller.js

@@ -1,40 +0,0 @@
-import { L3_PERSONA_SYSTEM_PROMPT, formatL3PersonaPrompt } from "../prompts/l3-persona.js";
-/**
- * L3 Persona Distillation Pipeline
- * Scans ALL persona + instruction L1 memories across all sessions
- * for a user and synthesizes a durable Narrative Profile.
- */
-export async function distillPersona(params) {
-    const { userId, store, llmRunner } = params;
-    // Cross-session: fetch all persona + instruction L1s for this user
-    const memories = store.getPersonaAndInstructionL1s(userId, 100);
-    if (memories.length === 0) {
-        console.error(`[BrainRouter] L3 skipped for "${userId}" — no persona/instruction memories yet.`);
-        return { success: false };
-    }
-    let personaMd;
-    try {
-        personaMd = await llmRunner.run({
-            prompt: formatL3PersonaPrompt(memories),
-            systemPrompt: L3_PERSONA_SYSTEM_PROMPT,
-            taskId: "l3-persona-distillation",
-            timeoutMs: 90_000,
-        });
-    }
-    catch (err) {
-        console.error(`[BrainRouter] L3 persona distillation failed for "${userId}":`, err.message);
-        return { success: false };
-    }
-    const now = new Date().toISOString();
-    const existing = store.getL3Persona(userId);
-    const record = {
-        userId,
-        personaMd: personaMd.trim(),
-        l1CountAtGeneration: memories.length,
-        createdTime: existing?.createdTime ?? now,
-        updatedTime: now,
-    };
-    store.upsertL3Persona(record);
-    console.error(`[BrainRouter] L3 persona updated for "${userId}" (${memories.length} L1s).`);
-    return { success: true, personaMd: personaMd.trim() };
-}

package/dist/memory/pipeline/task-queue.d.ts

@@ -1,54 +0,0 @@
-/**
- * BrainRouter — Background Task Queue (Optimization C)
- *
- * Decouples L2 scene distillation and L3 persona distillation from the hot
- * path of capture(). These are the most expensive, non-latency-critical steps.
- *
- * Graph extraction (Opt B) fires immediately as fire-and-forget — it is NOT queued.
- * Contradiction detection (Opt A) also fires immediately as fire-and-forget.
- *
- * Flush triggers:
- *   1. Lazy — called by recall() when the user is idle (lastCapture > idleThresholdMs)
- *   2. Explicit — engine.flush(userId) called directly
- *   3. Disabled — BRAINROUTER_ASYNC_PIPELINE=false keeps old fire-and-forget behaviour
- */
-import type { SqliteMemoryStore } from "../store/sqlite.js";
-import type { LLMRunner } from "../types.js";
-export type TaskType = "l2_scene" | "l3_persona";
-export interface PendingTask {
-    id: string;
-    userId: string;
-    taskType: TaskType;
-    /** JSON-encoded payload specific to the task type */
-    payload: string;
-    createdAt: string;
-}
-/** Is the async pipeline enabled? Default: true. Set to "false" to use old fire-and-forget. */
-export declare function isAsyncPipelineEnabled(): boolean;
-/**
- * Enqueue a task in the persistent SQLite queue instead of firing it immediately.
- * Safe to call from the capture hot path — synchronous SQLite insert, no I/O wait.
- */
-export declare function enqueueTask(store: SqliteMemoryStore, task: {
-    userId: string;
-    taskType: TaskType;
-    payload: Record<string, unknown>;
-}): void;
-export interface FlushResult {
-    userId: string;
-    tasksProcessed: number;
-    tasksFailed: number;
-    durationMs: number;
-}
-/**
- * Process all pending L2/L3 tasks for a user in FIFO order.
- *
- * Re-entrant safe: if a flush is already in progress for this userId, the existing
- * promise is returned instead of starting a second flush.
- */
-export declare function flushPendingTasks(userId: string, store: SqliteMemoryStore, synthesisRunner: LLMRunner): Promise<FlushResult>;
-/**
- * Returns true if the user has been idle long enough that pre-recall flushing
- * won't noticeably delay the response.
- */
-export declare function isUserIdle(store: SqliteMemoryStore, userId: string): boolean;

package/dist/memory/pipeline/task-queue.js

@@ -1,117 +0,0 @@
-/**
- * BrainRouter — Background Task Queue (Optimization C)
- *
- * Decouples L2 scene distillation and L3 persona distillation from the hot
- * path of capture(). These are the most expensive, non-latency-critical steps.
- *
- * Graph extraction (Opt B) fires immediately as fire-and-forget — it is NOT queued.
- * Contradiction detection (Opt A) also fires immediately as fire-and-forget.
- *
- * Flush triggers:
- *   1. Lazy — called by recall() when the user is idle (lastCapture > idleThresholdMs)
- *   2. Explicit — engine.flush(userId) called directly
- *   3. Disabled — BRAINROUTER_ASYNC_PIPELINE=false keeps old fire-and-forget behaviour
- */
-import { distillScenes } from "./l2-scene.js";
-import { distillPersona } from "./l3-distiller.js";
-// ─── Config ───────────────────────────────────────────────────────────────────
-/** Flush pending tasks before recall if last capture was more than this many ms ago. */
-const IDLE_THRESHOLD_MS = parseInt(process.env.BRAINROUTER_FLUSH_IDLE_MS ?? String(30_000), // default: 30s idle
-10);
-/** Is the async pipeline enabled? Default: true. Set to "false" to use old fire-and-forget. */
-export function isAsyncPipelineEnabled() {
-    return process.env.BRAINROUTER_ASYNC_PIPELINE !== "false";
-}
-// ─── Enqueue ──────────────────────────────────────────────────────────────────
-/**
- * Enqueue a task in the persistent SQLite queue instead of firing it immediately.
- * Safe to call from the capture hot path — synchronous SQLite insert, no I/O wait.
- */
-export function enqueueTask(store, task) {
-    const id = `task_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-    store.upsertPendingTask({
-        id,
-        userId: task.userId,
-        taskType: task.taskType,
-        payload: JSON.stringify(task.payload),
-        createdAt: new Date().toISOString(),
-    });
-}
-// ─── Flush ────────────────────────────────────────────────────────────────────
-/** Active flush promises per userId to prevent concurrent flushes */
-const flushInProgress = new Map();
-/**
- * Process all pending L2/L3 tasks for a user in FIFO order.
- *
- * Re-entrant safe: if a flush is already in progress for this userId, the existing
- * promise is returned instead of starting a second flush.
- */
-export async function flushPendingTasks(userId, store, synthesisRunner) {
-    const existing = flushInProgress.get(userId);
-    if (existing)
-        return existing;
-    const flushPromise = _doFlush(userId, store, synthesisRunner);
-    flushInProgress.set(userId, flushPromise);
-    try {
-        return await flushPromise;
-    }
-    finally {
-        flushInProgress.delete(userId);
-    }
-}
-async function _doFlush(userId, store, synthesisRunner) {
-    const start = Date.now();
-    const tasks = store.getPendingTasks(userId);
-    if (tasks.length === 0) {
-        return { userId, tasksProcessed: 0, tasksFailed: 0, durationMs: 0 };
-    }
-    let processed = 0;
-    let failed = 0;
-    // Process l2_scene and l3_persona in FIFO order.
-    // Deduplicate consecutive same-type tasks (e.g., 10 queued l2_scene → run once).
-    let lastTaskType = null;
-    for (const task of tasks) {
-        try {
-            if (task.taskType === lastTaskType) {
-                // Skip duplicate consecutive task of same type — one distillation run is sufficient
-                store.deletePendingTask(task.id);
-                continue;
-            }
-            switch (task.taskType) {
-                case "l2_scene":
-                    await distillScenes({ userId, store, llmRunner: synthesisRunner });
-                    break;
-                case "l3_persona":
-                    await distillPersona({ userId, store, llmRunner: synthesisRunner });
-                    break;
-            }
-            lastTaskType = task.taskType;
-            processed++;
-        }
-        catch (err) {
-            console.error(`[BrainRouter] Flush: task ${task.taskType} failed:`, err.message);
-            failed++;
-        }
-        finally {
-            store.deletePendingTask(task.id);
-        }
-    }
-    return {
-        userId,
-        tasksProcessed: processed,
-        tasksFailed: failed,
-        durationMs: Date.now() - start,
-    };
-}
-// ─── Idle Check ───────────────────────────────────────────────────────────────
-/**
- * Returns true if the user has been idle long enough that pre-recall flushing
- * won't noticeably delay the response.
- */
-export function isUserIdle(store, userId) {
-    const state = store.getSchedulerState(userId);
-    if (!state.lastCaptureAt)
-        return true; // never captured = trivially idle
-    const idleMs = Date.now() - new Date(state.lastCaptureAt).getTime();
-    return idleMs >= IDLE_THRESHOLD_MS;
-}

package/dist/memory/prompts/graph-extraction-batch.d.ts

@@ -1,14 +0,0 @@
-/**
- * Batch Graph Extraction Prompt
- *
- * Replaces N individual per-memory graph extraction calls with a single call
- * covering all new L1 memories from a capture cycle simultaneously.
- *
- * Token reduction: N → 1 call per capture cycle.
- */
-export declare const BATCH_GRAPH_EXTRACTION_SYSTEM_PROMPT = "You are an expert knowledge graph extraction engine.\n\nYou will receive a numbered list of memory statements. Extract ALL key entities (nodes)\nand their relationships (edges) across the entire list.\n\nLIMITS:\n- Extract at most 15 key entities total across all memories.\n- Extract at most 20 key relations total.\n- Focus on the most important technical choices, mandates, roles, and decisions.\n\nEntity Types:\n- \"tool\" / \"technology\" (e.g. pnpm, React, Postgres, Zod)\n- \"project\" (e.g. BrainRouter, Kinqs Radio)\n- \"person\" (e.g. lead engineer, user, junior developers)\n- \"concept\" / \"decision\" (e.g. monorepo migration, dark mode, camelCase policy)\n\nRelation Types (use ONLY these):\n- \"uses\" / \"adopts\"\n- \"owns\" / \"manages\"\n- \"decided\" / \"revised\"\n- \"conflicts_with\" / \"replaces\"\n- \"applies_to\"\n- \"requires\"\n- \"is_a\" / \"is_role\"\n\nFor each entity, also include \"sourceIndex\" matching the memory's index number.\n\nOutput ONLY a valid JSON object (no markdown fences):\n{\n  \"entities\": [\n    { \"entity\": \"Canonical Name\", \"type\": \"tool|technology|project|person|concept|decision\", \"confidence\": 1.0, \"sourceIndex\": 0 }\n  ],\n  \"relations\": [\n    { \"from\": \"Entity A\", \"to\": \"Entity B\", \"relation\": \"uses\", \"confidence\": 1.0 }\n  ]\n}";
-export declare function formatBatchGraphExtractionPrompt(memories: Array<{
-    index: number;
-    content: string;
-    recordId: string;
-}>): string;

package/dist/memory/prompts/graph-extraction-batch.js

@@ -1,54 +0,0 @@
-/**
- * Batch Graph Extraction Prompt
- *
- * Replaces N individual per-memory graph extraction calls with a single call
- * covering all new L1 memories from a capture cycle simultaneously.
- *
- * Token reduction: N → 1 call per capture cycle.
- */
-export const BATCH_GRAPH_EXTRACTION_SYSTEM_PROMPT = `You are an expert knowledge graph extraction engine.
-
-You will receive a numbered list of memory statements. Extract ALL key entities (nodes)
-and their relationships (edges) across the entire list.
-
-LIMITS:
-- Extract at most 15 key entities total across all memories.
-- Extract at most 20 key relations total.
-- Focus on the most important technical choices, mandates, roles, and decisions.
-
-Entity Types:
-- "tool" / "technology" (e.g. pnpm, React, Postgres, Zod)
-- "project" (e.g. BrainRouter, Kinqs Radio)
-- "person" (e.g. lead engineer, user, junior developers)
-- "concept" / "decision" (e.g. monorepo migration, dark mode, camelCase policy)
-
-Relation Types (use ONLY these):
-- "uses" / "adopts"
-- "owns" / "manages"
-- "decided" / "revised"
-- "conflicts_with" / "replaces"
-- "applies_to"
-- "requires"
-- "is_a" / "is_role"
-
-For each entity, also include "sourceIndex" matching the memory's index number.
-
-Output ONLY a valid JSON object (no markdown fences):
-{
-  "entities": [
-    { "entity": "Canonical Name", "type": "tool|technology|project|person|concept|decision", "confidence": 1.0, "sourceIndex": 0 }
-  ],
-  "relations": [
-    { "from": "Entity A", "to": "Entity B", "relation": "uses", "confidence": 1.0 }
-  ]
-}`;
-export function formatBatchGraphExtractionPrompt(memories) {
-    const memoryList = memories
-        .map(m => `  [${m.index}] "${m.content}"`)
-        .join("\n");
-    return `Extract entities and relations from ALL of the following memories:
-
-${memoryList}
-
-JSON Output:`;
-}

package/dist/memory/prompts/l1-contradiction-batch.d.ts

@@ -1,16 +0,0 @@
-/**
- * Batch Contradiction Detection Prompt
- *
- * Replaces N×K individual pairwise LLM calls with a single call covering
- * all new memories and their top FTS candidates simultaneously.
- *
- * Token reduction: 25 → 1 call per capture cycle (for 5 new memories × 5 candidates).
- */
-export declare const BATCH_CONTRADICTION_SYSTEM_PROMPT = "You are the Contradiction & Temporal Update Detector for a hierarchical memory engine.\n\nYou will receive a list of NEWLY EXTRACTED memories and a list of EXISTING memories.\nYour task is to identify ALL pairs that contradict, supersede, or update each other.\n\nRULES:\n1. Only flag pairs with genuine overlap or conflict. Ignore unrelated pairs.\n2. Classify each contradiction into one of two kinds:\n   - \"temporal_update\": The new memory deliberately supersedes the old one (e.g. user changed their mind, moved cities, switched tools). The NEW memory wins.\n   - \"genuine_conflict\": Logically incompatible absolute claims where neither obviously supersedes the other (e.g. conflicting birth years).\n3. Provide a confidence score (0.0\u20131.0). Only include pairs with confidence > 0.7.\n4. If no contradictions exist, return an empty array.\n\nRespond ONLY with a JSON array (no markdown fences):\n[\n  {\n    \"newIndex\": number,\n    \"existingIndex\": number,\n    \"kind\": \"temporal_update\" | \"genuine_conflict\",\n    \"reason\": \"Brief explanation\",\n    \"confidence\": number\n  }\n]";
-export declare function formatBatchContradictionPrompt(newMemories: Array<{
-    index: number;
-    content: string;
-}>, existingMemories: Array<{
-    index: number;
-    content: string;
-}>): string;

package/dist/memory/prompts/l1-contradiction-batch.js

@@ -1,47 +0,0 @@
-/**
- * Batch Contradiction Detection Prompt
- *
- * Replaces N×K individual pairwise LLM calls with a single call covering
- * all new memories and their top FTS candidates simultaneously.
- *
- * Token reduction: 25 → 1 call per capture cycle (for 5 new memories × 5 candidates).
- */
-export const BATCH_CONTRADICTION_SYSTEM_PROMPT = `You are the Contradiction & Temporal Update Detector for a hierarchical memory engine.
-
-You will receive a list of NEWLY EXTRACTED memories and a list of EXISTING memories.
-Your task is to identify ALL pairs that contradict, supersede, or update each other.
-
-RULES:
-1. Only flag pairs with genuine overlap or conflict. Ignore unrelated pairs.
-2. Classify each contradiction into one of two kinds:
-   - "temporal_update": The new memory deliberately supersedes the old one (e.g. user changed their mind, moved cities, switched tools). The NEW memory wins.
-   - "genuine_conflict": Logically incompatible absolute claims where neither obviously supersedes the other (e.g. conflicting birth years).
-3. Provide a confidence score (0.0–1.0). Only include pairs with confidence > 0.7.
-4. If no contradictions exist, return an empty array.
-
-Respond ONLY with a JSON array (no markdown fences):
-[
-  {
-    "newIndex": number,
-    "existingIndex": number,
-    "kind": "temporal_update" | "genuine_conflict",
-    "reason": "Brief explanation",
-    "confidence": number
-  }
-]`;
-export function formatBatchContradictionPrompt(newMemories, existingMemories) {
-    const newList = newMemories
-        .map(m => `  [N${m.index}] "${m.content}"`)
-        .join("\n");
-    const existingList = existingMemories
-        .map(m => `  [E${m.index}] "${m.content}"`)
-        .join("\n");
-    return `NEWLY EXTRACTED MEMORIES:
-${newList}
-
-EXISTING MEMORIES (candidates for contradiction):
-${existingList}
-
-Identify all contradicting pairs between the N (new) and E (existing) sets.
-JSON Array Output:`;
-}

package/dist/memory/prompts/l1-contradiction.d.ts

@@ -1 +0,0 @@
-export declare const L1_CONTRADICTION_PROMPT = "\nYou are the Contradiction & Temporal Update Detector for a hierarchical memory engine.\nYour task is to compare a NEWLY EXTRACTED memory with an EXISTING RELEVANT memory and determine if they contradict, supersede, or update each other.\n\nNEW MEMORY:\n\"{{newContent}}\"\n\nEXISTING MEMORY:\n\"{{existingContent}}\"\n\nRULES:\n1. Determine if they overlap or conflict. If there is no overlap/conflict, set \"isContradiction\" to false.\n2. If they conflict or override, classify the relationship into one of two kinds:\n   - \"temporal_update\": The new memory is a deliberate update, change of mind, transition, or correction to the old memory (e.g. \"User lives in SF\" vs \"User moved to NYC\", or \"User wants pnpm\" vs \"User changed package manager to regular npm\"). This means the new memory actively supersedes the old one.\n   - \"genuine_conflict\": The statements are logically incompatible, absolute claims that cannot both be true, and it is NOT a simple update or transition (e.g. \"User was born in 1990\" vs \"User was born in 1995\", or conflicting rules without a clear indication that one was meant to update the other).\n3. Provide a clear reason and a confidence score.\n\nRespond ONLY with a JSON object:\n{\n  \"isContradiction\": boolean,\n  \"kind\": \"temporal_update\" | \"genuine_conflict\" | null,\n  \"reason\": \"Brief explanation if isContradiction is true, else null\",\n  \"confidence\": number (0.0 to 1.0)\n}\n";

package/dist/memory/prompts/l1-contradiction.js

@@ -1,25 +0,0 @@
-export const L1_CONTRADICTION_PROMPT = `
-You are the Contradiction & Temporal Update Detector for a hierarchical memory engine.
-Your task is to compare a NEWLY EXTRACTED memory with an EXISTING RELEVANT memory and determine if they contradict, supersede, or update each other.
-
-NEW MEMORY:
-"{{newContent}}"
-
-EXISTING MEMORY:
-"{{existingContent}}"
-
-RULES:
-1. Determine if they overlap or conflict. If there is no overlap/conflict, set "isContradiction" to false.
-2. If they conflict or override, classify the relationship into one of two kinds:
-   - "temporal_update": The new memory is a deliberate update, change of mind, transition, or correction to the old memory (e.g. "User lives in SF" vs "User moved to NYC", or "User wants pnpm" vs "User changed package manager to regular npm"). This means the new memory actively supersedes the old one.
-   - "genuine_conflict": The statements are logically incompatible, absolute claims that cannot both be true, and it is NOT a simple update or transition (e.g. "User was born in 1990" vs "User was born in 1995", or conflicting rules without a clear indication that one was meant to update the other).
-3. Provide a clear reason and a confidence score.
-
-Respond ONLY with a JSON object:
-{
-  "isContradiction": boolean,
-  "kind": "temporal_update" | "genuine_conflict" | null,
-  "reason": "Brief explanation if isContradiction is true, else null",
-  "confidence": number (0.0 to 1.0)
-}
-`;

package/dist/memory/prompts/l1-extraction.d.ts

@@ -1,10 +0,0 @@
-import type { L0Record } from "@brainrouter/types";
-export declare const EXTRACT_MEMORIES_SYSTEM_PROMPT = "You are a Skill-Aware Memory Extraction Expert for a software engineering AI assistant.\n\nYour task is to analyze a conversation and extract durable, self-contained memories.\n\n### Scene Segmentation\nDetermine if the topic has changed since the previous scene.\nIf there are existing scenes, PREFER to reuse the most relevant existing scene name \u2014 only create a new name if the topic is genuinely different from ALL existing scenes.\nIf reusing, use the EXACT existing name (no paraphrasing).\nIf creating new, format: \"AI helping [user role] with [goal activity]\" (unique, max 50 chars).\n\n### Memory Types\n\n1. **persona** \u2014 Stable user traits, preferences, identity\n   - Format: \"User [prefers/is/always/never] ...\"\n   - Priority: 80-100 (core identity) / 50-70 (preferences) / skip if <50\n\n2. **episodic** \u2014 Objective events, decisions, results with timestamps\n   - Format: \"User [did X] at [time] resulting in [Y]\"\n   - Priority: 80-100 (major decisions) / 60-79 (significant events) / skip if <60\n\n3. **instruction** \u2014 Long-term rules the user gave the AI\n   - Format: \"User requires AI to always/never ...\"\n   - Priority: 90-100 (hard rules) / 70-89 (preferences) / skip if <70\n   - Instructions NEVER decay.\n\n4. **skill_context** \u2014 Observations about how the user runs THIS SKILL specifically\n   - Format: \"When running [skill], user tends to ...\"\n   - Only extract if a genuine behavioral pattern is visible, not a one-off.\n\n5. **tool_preference** \u2014 Stable preferences about tools, workflows, or command usage.\n6. **codebase_fact / api_contract / data_model** \u2014 Verified facts about code, public APIs, schemas, or storage models.\n7. **dependency_constraint / environment_constraint** \u2014 Version, runtime, platform, sandbox, or deployment constraints.\n8. **architecture_decision / implementation_decision / design_constraint** \u2014 Durable decisions and constraints that future agents must preserve.\n9. **security_policy / performance_baseline** \u2014 Security rules or measured performance facts. Extract only with direct evidence.\n10. **bug_finding / debug_trace / fix_summary / verification_result / failed_attempt / regression_risk** \u2014 Debugging history, fixes, checks, and risk notes.\n11. **task_state / handover_note / blocked_reason / review_comment / release_note** \u2014 Planning, review, release, and continuation state.\n12. **source_evidence / artifact_reference / file_history / command_knowledge** \u2014 Evidence-backed references to files, artifacts, file evolution, or command behavior.\n\nAllowed type values:\npersona, episodic, instruction, skill_context, tool_preference, codebase_fact, api_contract,\ndata_model, dependency_constraint, environment_constraint, architecture_decision,\nimplementation_decision, design_constraint, security_policy, performance_baseline,\nbug_finding, debug_trace, fix_summary, verification_result, failed_attempt, regression_risk,\ntask_state, handover_note, blocked_reason, review_comment, release_note, source_evidence,\nartifact_reference, file_history, command_knowledge.\n\n### Quality Rules\n- Nothingness > Bad memory. Prefer empty over wrong.\n- Memory must stand alone without the conversation.\n- Merge causally-linked facts into one memory.\n- Do not extract AI outputs \u2014 only user behavior and statements.\n- Filter out: tool calls, one-time requests, casual greetings.\n- Evidence-gated types (api_contract, data_model, security_policy, performance_baseline) require a cited file path, command, test result, or explicit user statement.\n- Use confidence from 0.0 to 1.0. Use lower confidence for model inference, higher confidence for direct source or command output.\n- Classify sourceKind as user_instruction, source_file, command_output, test_result, model_inference, or prior_memory.\n- Extract filePaths, repoPaths, and commands when explicitly mentioned; otherwise use empty arrays.\n\n### Output\nReturn ONLY a valid JSON array matching this format exactly:\n[\n  {\n    \"scene_name\": \"current or inherited scene name\",\n    \"message_ids\": [\"id1\"],\n    \"memories\": [\n      {\n        \"type\": \"one allowed type value\",\n        \"content\": \"self-contained memory statement\",\n        \"priority\": 85,\n        \"skill_tag\": \"the active skill\",\n        \"source_message_ids\": [\"id1\"],\n        \"confidence\": 0.75,\n        \"sourceKind\": \"user_instruction|source_file|command_output|test_result|model_inference|prior_memory\",\n        \"verificationStatus\": \"verified|unverified|stale\",\n        \"repoPaths\": [],\n        \"filePaths\": [],\n        \"commands\": [],\n        \"metadata\": {}\n      }\n    ]\n  }\n]\n";
-export declare function formatExtractionPrompt(params: {
-    newMessages: L0Record[];
-    backgroundMessages?: L0Record[];
-    previousSceneName?: string;
-    existingSceneNames?: string[];
-    activeSkill?: string;
-    skillHints?: string;
-}): string;