nodebench-mcp 2.31.2 → 2.32.0

package/dist/tools/memoryDecay.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Memory Decay — L2 archival policy for session notes
+ *
+ * Notes older than MEMORY_DECAY_DAYS are moved to an archive directory.
+ * Archived notes can still be loaded on demand but are deprioritized
+ * in refresh_task_context (weight 0.3 vs 1.0 for recent).
+ *
+ * Policy: archive, never delete. Configurable via NODEBENCH_MEMORY_DECAY_DAYS env var.
+ */
+export declare const DEFAULT_DECAY_DAYS = 30;
+export declare const DECAY_WEIGHT_RECENT = 1;
+export declare const DECAY_WEIGHT_ARCHIVED = 0.3;
+export declare const MAX_ARCHIVE_SCAN = 1000;
+export declare const MAX_ARCHIVED_RESULTS = 50;
+export declare const NOTES_DIR: string;
+export declare const ARCHIVE_DIR: string;
+/**
+ * Returns the configured decay threshold in days.
+ * Reads NODEBENCH_MEMORY_DECAY_DAYS env var, falls back to DEFAULT_DECAY_DAYS.
+ */
+export declare function getDecayDays(): number;
+/**
+ * Creates the archive directory if it doesn't exist.
+ */
+export declare function ensureArchiveDir(): void;
+/**
+ * Extracts a Date from a note filename.
+ * Accepts patterns like `2026-03-18.md` or `2026-03-18-143012-some-title.md`.
+ * Returns null if the filename doesn't start with a valid YYYY-MM-DD prefix.
+ */
+export declare function getNoteDateFromFilename(filename: string): Date | null;
+/**
+ * Archives notes older than the decay threshold.
+ * Moves files from NOTES_DIR to ARCHIVE_DIR — never deletes.
+ *
+ * @returns count of archived files and errors encountered
+ */
+export declare function archiveOldNotes(): {
+    archived: number;
+    errors: number;
+};
+/**
+ * Loads archived notes with optional keyword filtering.
+ * All archived notes carry DECAY_WEIGHT_ARCHIVED (0.3).
+ *
+ * @returns array of archived notes sorted by date descending, capped at MAX_ARCHIVED_RESULTS
+ */
+export declare function loadArchivedNotes(options?: {
+    keyword?: string;
+}): Array<{
+    date: string;
+    content: string;
+    weight: number;
+}>;
+/**
+ * Returns the decay weight for a given date string.
+ * Recent notes (within decay window) get 1.0, archived get 0.3.
+ * On parse error, returns DECAY_WEIGHT_RECENT as a fail-safe.
+ */
+export declare function getDecayWeight(dateStr: string): number;
+/**
+ * Returns summary statistics about notes and archive state.
+ */
+export declare function getDecayStats(): {
+    totalNotes: number;
+    archivedNotes: number;
+    recentNotes: number;
+    oldestNote: string | null;
+    newestNote: string | null;
+};

package/dist/tools/memoryDecay.js

@@ -0,0 +1,247 @@
+/**
+ * Memory Decay — L2 archival policy for session notes
+ *
+ * Notes older than MEMORY_DECAY_DAYS are moved to an archive directory.
+ * Archived notes can still be loaded on demand but are deprioritized
+ * in refresh_task_context (weight 0.3 vs 1.0 for recent).
+ *
+ * Policy: archive, never delete. Configurable via NODEBENCH_MEMORY_DECAY_DAYS env var.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+// ─── Constants ───────────────────────────────────────────────────────────────
+export const DEFAULT_DECAY_DAYS = 30;
+export const DECAY_WEIGHT_RECENT = 1.0;
+export const DECAY_WEIGHT_ARCHIVED = 0.3;
+export const MAX_ARCHIVE_SCAN = 1000; // BOUND: max files to scan per directory
+export const MAX_ARCHIVED_RESULTS = 50; // BOUND: max archived notes returned
+export const NOTES_DIR = path.join(os.homedir(), ".nodebench", "notes");
+export const ARCHIVE_DIR = path.join(NOTES_DIR, "archive");
+const DATE_FILENAME_RE = /^(\d{4}-\d{2}-\d{2})(?:[-T].*)?\.md$/;
+// ─── Configuration ───────────────────────────────────────────────────────────
+/**
+ * Returns the configured decay threshold in days.
+ * Reads NODEBENCH_MEMORY_DECAY_DAYS env var, falls back to DEFAULT_DECAY_DAYS.
+ */
+export function getDecayDays() {
+    const env = process.env.NODEBENCH_MEMORY_DECAY_DAYS;
+    if (env) {
+        const parsed = parseInt(env, 10);
+        if (!isNaN(parsed) && parsed > 0)
+            return parsed;
+    }
+    return DEFAULT_DECAY_DAYS;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Creates the archive directory if it doesn't exist.
+ */
+export function ensureArchiveDir() {
+    try {
+        if (!fs.existsSync(ARCHIVE_DIR)) {
+            fs.mkdirSync(ARCHIVE_DIR, { recursive: true });
+        }
+    }
+    catch {
+        // Best-effort — caller handles missing dir gracefully
+    }
+}
+/**
+ * Extracts a Date from a note filename.
+ * Accepts patterns like `2026-03-18.md` or `2026-03-18-143012-some-title.md`.
+ * Returns null if the filename doesn't start with a valid YYYY-MM-DD prefix.
+ */
+export function getNoteDateFromFilename(filename) {
+    const match = filename.match(DATE_FILENAME_RE);
+    if (!match)
+        return null;
+    const date = new Date(match[1] + "T00:00:00");
+    // Guard against invalid dates (e.g., 2026-02-30)
+    if (isNaN(date.getTime()))
+        return null;
+    return date;
+}
+/**
+ * Returns the age in days between a given date and now.
+ */
+function ageDays(date) {
+    const now = Date.now();
+    return (now - date.getTime()) / (1000 * 60 * 60 * 24);
+}
+// ─── Core Functions ──────────────────────────────────────────────────────────
+/**
+ * Archives notes older than the decay threshold.
+ * Moves files from NOTES_DIR to ARCHIVE_DIR — never deletes.
+ *
+ * @returns count of archived files and errors encountered
+ */
+export function archiveOldNotes() {
+    // If notes dir doesn't exist, nothing to archive
+    if (!fs.existsSync(NOTES_DIR)) {
+        return { archived: 0, errors: 0 };
+    }
+    ensureArchiveDir();
+    const decayDays = getDecayDays();
+    let archived = 0;
+    let errors = 0;
+    try {
+        const entries = fs.readdirSync(NOTES_DIR);
+        // BOUND: limit scan size
+        const mdFiles = entries.filter((f) => f.endsWith(".md")).slice(0, MAX_ARCHIVE_SCAN);
+        for (const file of mdFiles) {
+            try {
+                const noteDate = getNoteDateFromFilename(file);
+                if (!noteDate)
+                    continue; // Non-standard filename, skip
+                if (ageDays(noteDate) > decayDays) {
+                    const src = path.join(NOTES_DIR, file);
+                    const dest = path.join(ARCHIVE_DIR, file);
+                    fs.renameSync(src, dest);
+                    archived++;
+                }
+            }
+            catch {
+                // ERROR_BOUNDARY: individual file failure doesn't stop the sweep
+                errors++;
+            }
+        }
+    }
+    catch {
+        // ERROR_BOUNDARY: directory read failure
+        errors++;
+    }
+    return { archived, errors };
+}
+/**
+ * Loads archived notes with optional keyword filtering.
+ * All archived notes carry DECAY_WEIGHT_ARCHIVED (0.3).
+ *
+ * @returns array of archived notes sorted by date descending, capped at MAX_ARCHIVED_RESULTS
+ */
+export function loadArchivedNotes(options) {
+    if (!fs.existsSync(ARCHIVE_DIR))
+        return [];
+    const keyword = options?.keyword?.toLowerCase();
+    const results = [];
+    try {
+        const entries = fs.readdirSync(ARCHIVE_DIR);
+        const mdFiles = entries
+            .filter((f) => f.endsWith(".md"))
+            .sort((a, b) => b.localeCompare(a)); // newest first
+        for (const file of mdFiles) {
+            if (results.length >= MAX_ARCHIVED_RESULTS)
+                break; // BOUND
+            try {
+                const noteDate = getNoteDateFromFilename(file);
+                const dateStr = noteDate
+                    ? noteDate.toISOString().slice(0, 10)
+                    : file.slice(0, 10); // best-effort fallback
+                const content = fs.readFileSync(path.join(ARCHIVE_DIR, file), "utf-8");
+                // Keyword filter
+                if (keyword && !content.toLowerCase().includes(keyword))
+                    continue;
+                results.push({
+                    date: dateStr,
+                    content,
+                    weight: DECAY_WEIGHT_ARCHIVED,
+                });
+            }
+            catch {
+                // ERROR_BOUNDARY: skip unreadable files
+                continue;
+            }
+        }
+    }
+    catch {
+        // ERROR_BOUNDARY: archive dir read failure
+        return [];
+    }
+    return results;
+}
+/**
+ * Returns the decay weight for a given date string.
+ * Recent notes (within decay window) get 1.0, archived get 0.3.
+ * On parse error, returns DECAY_WEIGHT_RECENT as a fail-safe.
+ */
+export function getDecayWeight(dateStr) {
+    try {
+        const date = new Date(dateStr);
+        if (isNaN(date.getTime()))
+            return DECAY_WEIGHT_RECENT;
+        return ageDays(date) > getDecayDays()
+            ? DECAY_WEIGHT_ARCHIVED
+            : DECAY_WEIGHT_RECENT;
+    }
+    catch {
+        return DECAY_WEIGHT_RECENT; // fail-safe: treat as recent
+    }
+}
+/**
+ * Returns summary statistics about notes and archive state.
+ */
+export function getDecayStats() {
+    let recentNotes = 0;
+    let archivedNotes = 0;
+    let oldestNote = null;
+    let newestNote = null;
+    // Count recent notes
+    try {
+        if (fs.existsSync(NOTES_DIR)) {
+            const files = fs
+                .readdirSync(NOTES_DIR)
+                .filter((f) => f.endsWith(".md"))
+                .sort();
+            recentNotes = files.length;
+            if (files.length > 0) {
+                const oldestDate = getNoteDateFromFilename(files[0]);
+                const newestDate = getNoteDateFromFilename(files[files.length - 1]);
+                if (oldestDate)
+                    oldestNote = oldestDate.toISOString().slice(0, 10);
+                if (newestDate)
+                    newestNote = newestDate.toISOString().slice(0, 10);
+            }
+        }
+    }
+    catch {
+        // ERROR_BOUNDARY
+    }
+    // Count archived notes
+    try {
+        if (fs.existsSync(ARCHIVE_DIR)) {
+            const archiveFiles = fs
+                .readdirSync(ARCHIVE_DIR)
+                .filter((f) => f.endsWith(".md"))
+                .sort();
+            archivedNotes = archiveFiles.length;
+            // Extend oldest/newest to include archive
+            if (archiveFiles.length > 0) {
+                const archiveOldest = getNoteDateFromFilename(archiveFiles[0]);
+                const archiveNewest = getNoteDateFromFilename(archiveFiles[archiveFiles.length - 1]);
+                if (archiveOldest) {
+                    const archiveOldestStr = archiveOldest.toISOString().slice(0, 10);
+                    if (!oldestNote || archiveOldestStr < oldestNote) {
+                        oldestNote = archiveOldestStr;
+                    }
+                }
+                if (archiveNewest) {
+                    const archiveNewestStr = archiveNewest.toISOString().slice(0, 10);
+                    if (!newestNote || archiveNewestStr > newestNote) {
+                        newestNote = archiveNewestStr;
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // ERROR_BOUNDARY
+    }
+    return {
+        totalNotes: recentNotes + archivedNotes,
+        archivedNotes,
+        recentNotes,
+        oldestNote,
+        newestNote,
+    };
+}
+//# sourceMappingURL=memoryDecay.js.map

package/dist/tools/memoryDecay.js.map

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

package/dist/tools/missionHarnessTools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Mission Harness Tools — Hierarchical mission execution for verifiable work
+ *
+ * NodeBench is not a single-agent assistant. It is a hierarchical mission
+ * execution harness for verifiable work.
+ *
+ * Architecture: Planner → Worker → Judge → Human Sniff-Check → Merge
+ *
+ * 5 first-class tools:
+ *   plan.decompose_mission   — Break mission into subtasks with verifiability routing
+ *   judge.verify_subtask     — Machine/expert verification with retry budget
+ *   judge.request_retry      — Retry, re-plan, escalate, or stop
+ *   merge.compose_output     — Judge-gated merge of subtask artifacts
+ *   sniff.record_human_review — Human pass/concern/block with issue tags
+ *
+ * Persistence: SQLite-backed runs, taskPlans, subtaskAssignments, runSteps,
+ * artifacts, evidence, judgeReviews, retryAttempts, mergeBoundaries,
+ * sniffChecks, approvals.
+ *
+ * Verifiability tiers:
+ *   Tier 1 — Machine-checkable (deterministic, automated judge)
+ *   Tier 2 — Expert-checkable (requires human sniff-check)
+ *
+ * Anti-flat-coordination rules enforced:
+ *   - One owner per subtask
+ *   - Bounded input package
+ *   - Explicit output contract
+ *   - Judge-gated merge only
+ *   - No shared free-for-all editing
+ */
+import type { McpTool } from "../types.js";
+export declare const missionHarnessTools: McpTool[];