nodebench-mcp 2.11.0 → 2.13.0

package/dist/tools/reconTools.js

@@ -443,21 +443,21 @@ export const reconTools = [
             let learnings = [];
             try {
                 learnings = db
-                    .prepare(`SELECT l.key, l.content, l.category, l.tags, l.source_cycle, l.created_at
-             FROM learnings_fts
-             JOIN learnings l ON l.id = learnings_fts.rowid
-             WHERE learnings_fts MATCH ?
-             ORDER BY rank
+                    .prepare(`SELECT l.key, l.content, l.category, l.tags, l.source_cycle, l.created_at
+             FROM learnings_fts
+             JOIN learnings l ON l.id = learnings_fts.rowid
+             WHERE learnings_fts MATCH ?
+             ORDER BY rank
              LIMIT ?`)
                     .all(query, limit);
             }
             catch {
                 // FTS5 syntax error (e.g., special chars in query) — fall back to LIKE
                 learnings = db
-                    .prepare(`SELECT key, content, category, tags, source_cycle, created_at
-             FROM learnings
-             WHERE content LIKE ? OR key LIKE ?
-             ORDER BY created_at DESC
+                    .prepare(`SELECT key, content, category, tags, source_cycle, created_at
+             FROM learnings
+             WHERE content LIKE ? OR key LIKE ?
+             ORDER BY created_at DESC
              LIMIT ?`)
                     .all(`%${query}%`, `%${query}%`, limit);
             }
@@ -470,38 +470,38 @@ export const reconTools = [
             if (categories && categories.length > 0) {
                 const placeholders = categories.map(() => "?").join(", ");
                 reconFindings = db
-                    .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
-                    f.relevance, f.action_items, f.created_at,
-                    s.target as session_target
-             FROM recon_findings f
-             JOIN recon_sessions s ON s.id = f.session_id
-             WHERE (f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?)
-               AND f.category IN (${placeholders})
-             ORDER BY f.created_at DESC
+                    .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
+                    f.relevance, f.action_items, f.created_at,
+                    s.target as session_target
+             FROM recon_findings f
+             JOIN recon_sessions s ON s.id = f.session_id
+             WHERE (f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?)
+               AND f.category IN (${placeholders})
+             ORDER BY f.created_at DESC
              LIMIT ?`)
                     .all(`%${query}%`, `%${query}%`, `%${query}%`, ...categories, limit);
             }
             else {
                 reconFindings = db
-                    .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
-                    f.relevance, f.action_items, f.created_at,
-                    s.target as session_target
-             FROM recon_findings f
-             JOIN recon_sessions s ON s.id = f.session_id
-             WHERE f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?
-             ORDER BY f.created_at DESC
+                    .prepare(`SELECT f.id, f.session_id, f.source_url, f.category, f.summary,
+                    f.relevance, f.action_items, f.created_at,
+                    s.target as session_target
+             FROM recon_findings f
+             JOIN recon_sessions s ON s.id = f.session_id
+             WHERE f.summary LIKE ? OR f.relevance LIKE ? OR f.action_items LIKE ?
+             ORDER BY f.created_at DESC
              LIMIT ?`)
                     .all(`%${query}%`, `%${query}%`, `%${query}%`, limit);
             }
             // 3. Search ALL gaps from past verification cycles (resolved + open)
             const matchedGaps = db
-                .prepare(`SELECT g.id, g.cycle_id, g.title, g.description, g.severity,
-                  g.status, g.fix_strategy as resolution, g.resolved_at,
-                  c.title as cycle_target
-           FROM gaps g
-           JOIN verification_cycles c ON c.id = g.cycle_id
-           WHERE (g.description LIKE ? OR g.fix_strategy LIKE ? OR g.title LIKE ?)
-           ORDER BY g.created_at DESC
+                .prepare(`SELECT g.id, g.cycle_id, g.title, g.description, g.severity,
+                  g.status, g.fix_strategy as resolution, g.resolved_at,
+                  c.title as cycle_target
+           FROM gaps g
+           JOIN verification_cycles c ON c.id = g.cycle_id
+           WHERE (g.description LIKE ? OR g.fix_strategy LIKE ? OR g.title LIKE ?)
+           ORDER BY g.created_at DESC
            LIMIT ?`)
                 .all(`%${query}%`, `%${query}%`, `%${query}%`, limit);
             const totalResults = learnings.length + reconFindings.length + matchedGaps.length;

package/dist/tools/selfEvalTools.js

@@ -1160,28 +1160,28 @@ export const selfEvalTools = [
         handler: async (args) => {
             const db = getDb();
             // Ensure table exists
-            db.exec(`CREATE TABLE IF NOT EXISTS eval_task_bank (
-        id TEXT PRIMARY KEY,
-        task_id TEXT UNIQUE NOT NULL,
-        title TEXT NOT NULL,
-        category TEXT NOT NULL,
-        difficulty TEXT NOT NULL,
-        prompt TEXT NOT NULL,
-        initial_state TEXT,
-        success_criteria TEXT NOT NULL,
-        forbidden_behaviors TEXT,
-        expected_tools TEXT,
-        time_budget_minutes INTEGER DEFAULT 30,
-        token_budget INTEGER,
-        created_at TEXT DEFAULT (datetime('now')),
-        run_count INTEGER DEFAULT 0,
-        pass_count INTEGER DEFAULT 0
+            db.exec(`CREATE TABLE IF NOT EXISTS eval_task_bank (
+        id TEXT PRIMARY KEY,
+        task_id TEXT UNIQUE NOT NULL,
+        title TEXT NOT NULL,
+        category TEXT NOT NULL,
+        difficulty TEXT NOT NULL,
+        prompt TEXT NOT NULL,
+        initial_state TEXT,
+        success_criteria TEXT NOT NULL,
+        forbidden_behaviors TEXT,
+        expected_tools TEXT,
+        time_budget_minutes INTEGER DEFAULT 30,
+        token_budget INTEGER,
+        created_at TEXT DEFAULT (datetime('now')),
+        run_count INTEGER DEFAULT 0,
+        pass_count INTEGER DEFAULT 0
       )`);
             const existing = db.prepare("SELECT * FROM eval_task_bank WHERE task_id = ?").get(args.taskId);
             if (existing) {
                 // Update existing task
-                db.prepare(`UPDATE eval_task_bank SET title = ?, category = ?, difficulty = ?, prompt = ?,
-          initial_state = ?, success_criteria = ?, forbidden_behaviors = ?, expected_tools = ?,
+                db.prepare(`UPDATE eval_task_bank SET title = ?, category = ?, difficulty = ?, prompt = ?,
+          initial_state = ?, success_criteria = ?, forbidden_behaviors = ?, expected_tools = ?,
           time_budget_minutes = ?, token_budget = ? WHERE task_id = ?`).run(args.title, args.category, args.difficulty, args.prompt, args.initialState ?? null, JSON.stringify(args.successCriteria), args.forbiddenBehaviors ? JSON.stringify(args.forbiddenBehaviors) : null, args.expectedTools ? JSON.stringify(args.expectedTools) : null, args.timeBudgetMinutes ?? 30, args.tokenBudget ?? null, args.taskId);
                 return {
                     action: "updated",
@@ -1190,8 +1190,8 @@ export const selfEvalTools = [
                 };
             }
             // Insert new task
-            db.prepare(`INSERT INTO eval_task_bank (id, task_id, title, category, difficulty, prompt,
-        initial_state, success_criteria, forbidden_behaviors, expected_tools, time_budget_minutes, token_budget)
+            db.prepare(`INSERT INTO eval_task_bank (id, task_id, title, category, difficulty, prompt,
+        initial_state, success_criteria, forbidden_behaviors, expected_tools, time_budget_minutes, token_budget)
         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(genId("etb"), args.taskId, args.title, args.category, args.difficulty, args.prompt, args.initialState ?? null, JSON.stringify(args.successCriteria), args.forbiddenBehaviors ? JSON.stringify(args.forbiddenBehaviors) : null, args.expectedTools ? JSON.stringify(args.expectedTools) : null, args.timeBudgetMinutes ?? 30, args.tokenBudget ?? null);
             const total = db.prepare("SELECT COUNT(*) as cnt FROM eval_task_bank").get().cnt;
             return {
@@ -1275,30 +1275,30 @@ export const selfEvalTools = [
         handler: async (args) => {
             const db = getDb();
             // Ensure results table exists
-            db.exec(`CREATE TABLE IF NOT EXISTS eval_run_results (
-        id TEXT PRIMARY KEY,
-        task_id TEXT NOT NULL,
-        session_id TEXT,
-        condition TEXT NOT NULL,
-        trial_number INTEGER DEFAULT 1,
-        outcome_score REAL,
-        process_score REAL,
-        combined_score REAL,
-        outcome_results TEXT,
-        forbidden_violations TEXT,
-        duration_minutes REAL,
-        total_tool_calls INTEGER,
-        total_tokens INTEGER,
-        notes TEXT,
-        created_at TEXT DEFAULT (datetime('now'))
+            db.exec(`CREATE TABLE IF NOT EXISTS eval_run_results (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL,
+        session_id TEXT,
+        condition TEXT NOT NULL,
+        trial_number INTEGER DEFAULT 1,
+        outcome_score REAL,
+        process_score REAL,
+        combined_score REAL,
+        outcome_results TEXT,
+        forbidden_violations TEXT,
+        duration_minutes REAL,
+        total_tool_calls INTEGER,
+        total_tokens INTEGER,
+        notes TEXT,
+        created_at TEXT DEFAULT (datetime('now'))
       )`);
             // Load task from bank (optional — if it exists, validate)
-            db.exec(`CREATE TABLE IF NOT EXISTS eval_task_bank (
-        id TEXT PRIMARY KEY, task_id TEXT UNIQUE NOT NULL, title TEXT NOT NULL,
-        category TEXT NOT NULL, difficulty TEXT NOT NULL, prompt TEXT NOT NULL,
-        initial_state TEXT, success_criteria TEXT NOT NULL, forbidden_behaviors TEXT,
-        expected_tools TEXT, time_budget_minutes INTEGER DEFAULT 30, token_budget INTEGER,
-        created_at TEXT DEFAULT (datetime('now')), run_count INTEGER DEFAULT 0, pass_count INTEGER DEFAULT 0
+            db.exec(`CREATE TABLE IF NOT EXISTS eval_task_bank (
+        id TEXT PRIMARY KEY, task_id TEXT UNIQUE NOT NULL, title TEXT NOT NULL,
+        category TEXT NOT NULL, difficulty TEXT NOT NULL, prompt TEXT NOT NULL,
+        initial_state TEXT, success_criteria TEXT NOT NULL, forbidden_behaviors TEXT,
+        expected_tools TEXT, time_budget_minutes INTEGER DEFAULT 30, token_budget INTEGER,
+        created_at TEXT DEFAULT (datetime('now')), run_count INTEGER DEFAULT 0, pass_count INTEGER DEFAULT 0
       )`);
             const task = db.prepare("SELECT * FROM eval_task_bank WHERE task_id = ?").get(args.taskId);
             // ── Outcome scoring (50pts) ──
@@ -1383,8 +1383,8 @@ export const selfEvalTools = [
                 grade = "F (Non-Compliant)";
             // Persist result
             const resultId = genId("err");
-            db.prepare(`INSERT INTO eval_run_results (id, task_id, session_id, condition, trial_number,
-        outcome_score, process_score, combined_score, outcome_results, forbidden_violations,
+            db.prepare(`INSERT INTO eval_run_results (id, task_id, session_id, condition, trial_number,
+        outcome_score, process_score, combined_score, outcome_results, forbidden_violations,
         duration_minutes, total_tool_calls, total_tokens, notes) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(resultId, args.taskId, args.sessionId ?? null, args.condition, args.trialNumber ?? 1, totalOutcomeScore, totalProcessScore, combinedScore, JSON.stringify(outcomes), violations.length > 0 ? JSON.stringify(violations) : null, args.durationMinutes ?? null, args.totalToolCalls ?? null, args.totalTokens ?? null, args.notes ?? null);
             // Update task bank stats
             if (task) {

package/dist/tools/sessionMemoryTools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Session Memory Tools — Compaction-resilient notes, attention refresh, and session recovery.
+ *
+ * Inspired by:
+ * - claude-mem (thedotmack): 3-layer progressive disclosure, compaction-resilient notepad
+ * - planning-with-files (OthmanAdi): Manus-style filesystem-as-memory, attention refresh
+ * - oh-my-claudecode (Yeachan-Heo): .omc/notepad.md compaction-resilient state
+ *
+ * 3 tools:
+ * - save_session_note: Persist findings to filesystem (survives context compaction)
+ * - load_session_notes: Retrieve notes from filesystem
+ * - refresh_task_context: Re-inject current goals mid-session (attention management)
+ */
+import type { McpTool } from "../types.js";
+export declare const sessionMemoryTools: McpTool[];

package/dist/tools/sessionMemoryTools.js

@@ -0,0 +1,348 @@
+/**
+ * Session Memory Tools — Compaction-resilient notes, attention refresh, and session recovery.
+ *
+ * Inspired by:
+ * - claude-mem (thedotmack): 3-layer progressive disclosure, compaction-resilient notepad
+ * - planning-with-files (OthmanAdi): Manus-style filesystem-as-memory, attention refresh
+ * - oh-my-claudecode (Yeachan-Heo): .omc/notepad.md compaction-resilient state
+ *
+ * 3 tools:
+ * - save_session_note: Persist findings to filesystem (survives context compaction)
+ * - load_session_notes: Retrieve notes from filesystem
+ * - refresh_task_context: Re-inject current goals mid-session (attention management)
+ */
+import { getDb, genId } from "../db.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const NOTES_DIR = path.join(os.homedir(), ".nodebench", "notes");
+function ensureNotesDir() {
+    if (!fs.existsSync(NOTES_DIR)) {
+        fs.mkdirSync(NOTES_DIR, { recursive: true });
+    }
+}
+export const sessionMemoryTools = [
+    // ─── Tool 1: save_session_note ───────────────────────────────────────────
+    {
+        name: "save_session_note",
+        description: "Persist a critical finding, decision, or progress note to the filesystem. Notes survive context compaction — call this after every major finding or decision so state is never lost. Writes to ~/.nodebench/notes/ as dated markdown files.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Short headline for the note (e.g. 'Auth bug root cause', 'Migration decision: JWT over sessions')",
+                },
+                content: {
+                    type: "string",
+                    description: "Full note content. Include facts, decisions, file paths, error messages — anything needed to reconstruct context after compaction.",
+                },
+                category: {
+                    type: "string",
+                    enum: [
+                        "finding",
+                        "decision",
+                        "progress",
+                        "blocker",
+                        "learning",
+                        "architecture",
+                        "debugging",
+                    ],
+                    description: "Type of note (default: finding)",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags for searchability (e.g. ['auth', 'jwt', 'security'])",
+                },
+            },
+            required: ["title", "content"],
+        },
+        handler: async (args) => {
+            ensureNotesDir();
+            const { title, content, category = "finding", tags = [], } = args;
+            const now = new Date();
+            const dateStr = now.toISOString().slice(0, 10);
+            const timeStr = now.toISOString().slice(11, 19).replace(/:/g, "");
+            const safeTitle = title
+                .toLowerCase()
+                .replace(/[^a-z0-9]+/g, "-")
+                .slice(0, 50);
+            const filename = `${dateStr}-${timeStr}-${safeTitle}.md`;
+            const filePath = path.join(NOTES_DIR, filename);
+            const markdown = [
+                `# ${title}`,
+                "",
+                `**Category:** ${category}`,
+                `**Date:** ${now.toISOString()}`,
+                tags.length > 0 ? `**Tags:** ${tags.join(", ")}` : "",
+                "",
+                "---",
+                "",
+                content,
+                "",
+            ]
+                .filter(Boolean)
+                .join("\n");
+            fs.writeFileSync(filePath, markdown, "utf-8");
+            // Also persist to SQLite for cross-session search
+            try {
+                const db = getDb();
+                db.prepare(`INSERT INTO learnings (id, key, content, category, tags, source_cycle_id, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, datetime('now'))`).run(genId("note"), `session_note:${safeTitle}`, `[Session Note] ${title}\n\n${content}`, category === "finding" ? "pattern" : category === "debugging" ? "gotcha" : "convention", JSON.stringify(tags), null);
+            }
+            catch {
+                /* SQLite backup is best-effort */
+            }
+            return {
+                saved: true,
+                filePath,
+                filename,
+                title,
+                category,
+                tip: "Notes persist to filesystem and survive context compaction. Call load_session_notes to retrieve after /clear or /compact.",
+            };
+        },
+    },
+    // ─── Tool 2: load_session_notes ──────────────────────────────────────────
+    {
+        name: "load_session_notes",
+        description: "Load session notes from the filesystem. Use after context compaction, /clear, or session resume to recover state. Returns notes sorted by recency. Supports filtering by date, category, or keyword.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                date: {
+                    type: "string",
+                    description: "Filter by date (YYYY-MM-DD). Default: today. Use 'all' for all notes.",
+                },
+                category: {
+                    type: "string",
+                    enum: [
+                        "finding",
+                        "decision",
+                        "progress",
+                        "blocker",
+                        "learning",
+                        "architecture",
+                        "debugging",
+                    ],
+                    description: "Filter by note category (optional)",
+                },
+                keyword: {
+                    type: "string",
+                    description: "Search notes containing this keyword (case-insensitive)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max notes to return (default: 10)",
+                },
+            },
+            required: [],
+        },
+        handler: async (args) => {
+            ensureNotesDir();
+            const { date, category, keyword, limit = 10 } = args;
+            const files = fs.readdirSync(NOTES_DIR).filter((f) => f.endsWith(".md"));
+            // Sort by filename (date-time prefix) descending (most recent first)
+            files.sort((a, b) => b.localeCompare(a));
+            // Filter by date
+            let filtered = files;
+            if (date && date !== "all") {
+                filtered = filtered.filter((f) => f.startsWith(date));
+            }
+            else if (!date) {
+                // Default: today
+                const today = new Date().toISOString().slice(0, 10);
+                filtered = filtered.filter((f) => f.startsWith(today));
+            }
+            // Read file contents and apply filters
+            const notes = [];
+            for (const file of filtered) {
+                if (notes.length >= limit)
+                    break;
+                const content = fs.readFileSync(path.join(NOTES_DIR, file), "utf-8");
+                // Extract metadata from markdown
+                const titleMatch = content.match(/^# (.+)$/m);
+                const categoryMatch = content.match(/\*\*Category:\*\* (.+)$/m);
+                const dateMatch = content.match(/\*\*Date:\*\* (.+)$/m);
+                const noteCategory = categoryMatch?.[1] || "unknown";
+                const noteTitle = titleMatch?.[1] || file;
+                const noteDate = dateMatch?.[1] || "";
+                // Category filter
+                if (category && noteCategory !== category)
+                    continue;
+                // Keyword filter
+                if (keyword && !content.toLowerCase().includes(keyword.toLowerCase()))
+                    continue;
+                notes.push({
+                    filename: file,
+                    title: noteTitle,
+                    category: noteCategory,
+                    content,
+                    date: noteDate,
+                });
+            }
+            return {
+                noteCount: notes.length,
+                totalFiles: files.length,
+                notes: notes.map((n) => ({
+                    filename: n.filename,
+                    title: n.title,
+                    category: n.category,
+                    preview: n.content.slice(0, 300),
+                    fullContent: n.content,
+                })),
+                tip: notes.length === 0
+                    ? "No notes found. Use save_session_note to persist findings during your session."
+                    : "Notes loaded. Review findings and continue where you left off.",
+            };
+        },
+    },
+    // ─── Tool 3: refresh_task_context ────────────────────────────────────────
+    {
+        name: "refresh_task_context",
+        description: "Re-inject the current task context to combat attention drift. After 30+ tool calls, models lose sight of original goals ('lost in the middle' problem). This tool gathers your active verification cycle, open gaps, recent learnings, and session notes into a compact refresher. Based on Manus's 'Manipulate Attention Through Recitation' principle.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskDescription: {
+                    type: "string",
+                    description: "What you're currently working on (re-state the original goal to anchor attention)",
+                },
+                includeNotes: {
+                    type: "boolean",
+                    description: "Include today's session notes in the refresher (default: true)",
+                },
+                includeGaps: {
+                    type: "boolean",
+                    description: "Include open verification gaps (default: true)",
+                },
+                includeLearnings: {
+                    type: "boolean",
+                    description: "Include recent relevant learnings (default: true)",
+                },
+            },
+            required: [],
+        },
+        handler: async (args) => {
+            const { taskDescription = "", includeNotes = true, includeGaps = true, includeLearnings = true, } = args;
+            const db = getDb();
+            const context = {};
+            // 1. Active verification cycle
+            try {
+                const activeCycle = db
+                    .prepare("SELECT * FROM verification_cycles WHERE status = 'active' ORDER BY created_at DESC LIMIT 1")
+                    .get();
+                if (activeCycle) {
+                    const phases = db
+                        .prepare("SELECT phase, status, summary FROM phase_findings WHERE cycle_id = ? ORDER BY phase ASC")
+                        .all(activeCycle.id);
+                    context.activeCycle = {
+                        id: activeCycle.id,
+                        title: activeCycle.title,
+                        currentPhase: activeCycle.current_phase,
+                        status: activeCycle.status,
+                        phases: phases.map((p) => ({
+                            phase: p.phase,
+                            status: p.status,
+                            summary: p.summary?.slice(0, 100),
+                        })),
+                    };
+                }
+            }
+            catch {
+                /* table may not exist yet */
+            }
+            // 2. Open gaps
+            if (includeGaps) {
+                try {
+                    const gaps = db
+                        .prepare("SELECT id, description, severity, status FROM gaps WHERE status = 'open' ORDER BY CASE severity WHEN 'critical' THEN 1 WHEN 'high' THEN 2 WHEN 'medium' THEN 3 ELSE 4 END LIMIT 10")
+                        .all();
+                    if (gaps.length > 0) {
+                        context.openGaps = gaps.map((g) => ({
+                            id: g.id,
+                            description: g.description?.slice(0, 100),
+                            severity: g.severity,
+                        }));
+                    }
+                }
+                catch {
+                    /* table may not exist yet */
+                }
+            }
+            // 3. Recent learnings
+            if (includeLearnings) {
+                try {
+                    const learnings = db
+                        .prepare("SELECT key, content, category FROM learnings ORDER BY created_at DESC LIMIT 5")
+                        .all();
+                    if (learnings.length > 0) {
+                        context.recentLearnings = learnings.map((l) => ({
+                            key: l.key,
+                            category: l.category,
+                            preview: l.content?.slice(0, 100),
+                        }));
+                    }
+                }
+                catch {
+                    /* table may not exist yet */
+                }
+            }
+            // 4. Today's session notes
+            if (includeNotes) {
+                ensureNotesDir();
+                const today = new Date().toISOString().slice(0, 10);
+                const files = fs
+                    .readdirSync(NOTES_DIR)
+                    .filter((f) => f.endsWith(".md") && f.startsWith(today))
+                    .sort((a, b) => b.localeCompare(a))
+                    .slice(0, 5);
+                if (files.length > 0) {
+                    context.todayNotes = files.map((f) => {
+                        const content = fs.readFileSync(path.join(NOTES_DIR, f), "utf-8");
+                        const titleMatch = content.match(/^# (.+)$/m);
+                        return {
+                            title: titleMatch?.[1] || f,
+                            preview: content.slice(0, 200),
+                        };
+                    });
+                }
+            }
+            // 5. Tool call stats for this session
+            try {
+                const stats = db
+                    .prepare("SELECT COUNT(*) as total, SUM(CASE WHEN result_status = 'error' THEN 1 ELSE 0 END) as errors FROM tool_call_log WHERE session_id = (SELECT session_id FROM tool_call_log ORDER BY created_at DESC LIMIT 1)")
+                    .get();
+                if (stats) {
+                    context.sessionStats = {
+                        totalToolCalls: stats.total,
+                        errors: stats.errors,
+                        attentionWarning: stats.total > 30
+                            ? "HIGH DRIFT RISK: 30+ tool calls. Recite your original goal before proceeding."
+                            : stats.total > 15
+                                ? "MODERATE: 15+ tool calls. Consider re-reading your task plan."
+                                : "LOW: Fresh context, proceed normally.",
+                    };
+                }
+            }
+            catch {
+                /* table may not exist yet */
+            }
+            return {
+                taskDescription: taskDescription ||
+                    "(Not specified — re-state your original goal to anchor attention)",
+                context,
+                refreshedAt: new Date().toISOString(),
+                guideline: "Re-read the taskDescription and activeCycle goal. Focus on open gaps by severity. Check todayNotes for decisions made earlier. Avoid repeating solved problems.",
+                antiDrift: [
+                    "Does my current action serve the original goal?",
+                    "Am I repeating something I already tried?",
+                    "Have I checked learnings before implementing?",
+                    "Am I within scope or drifting to tangents?",
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=sessionMemoryTools.js.map

package/dist/tools/sessionMemoryTools.js.map

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

package/dist/tools/toolRegistry.d.ts

@@ -26,6 +26,8 @@ export interface ToolRegistryEntry {
     quickRef: ToolQuickRef;
     /** Where this tool sits in a typical workflow: research, implement, test, verify, ship */
     phase: "research" | "implement" | "test" | "verify" | "ship" | "meta" | "utility";
+    /** Recommended model tier: low=Haiku, medium=Sonnet, high=Opus. Used for cost-aware routing. */
+    complexity?: "low" | "medium" | "high";
 }
 /** Map of tool name → registry entry for O(1) lookup */
 export declare const TOOL_REGISTRY: Map<string, ToolRegistryEntry>;
@@ -37,6 +39,8 @@ export declare function getQuickRef(toolName: string): ToolQuickRef | null;
 export declare function getToolsByCategory(category: string): ToolRegistryEntry[];
 /** Get all tools in a workflow phase */
 export declare function getToolsByPhase(phase: ToolRegistryEntry["phase"]): ToolRegistryEntry[];
+/** Get the recommended model complexity tier for a tool */
+export declare function getToolComplexity(toolName: string): "low" | "medium" | "high";
 export interface SearchResult {
     name: string;
     description: string;