@coreyuan/vector-mind 1.0.49 → 1.0.52

package/dist/token-savings.d.ts

@@ -0,0 +1,40 @@
+import Database from "better-sqlite3";
+import type { OutputFormat } from "./tool-schemas.js";
+type TokenSavingsContext = {
+    getDb: () => Database.Database | undefined;
+    getInsertTokenSavingsStatement: () => Database.Statement | undefined;
+    getSummarizeTokenSavingsStatement: () => Database.Statement;
+    getSummarizeTokenSavingsByToolStatement: () => Database.Statement;
+    getListRecentTokenSavingsStatement: () => Database.Statement;
+};
+export declare function configureTokenSavings(context: TokenSavingsContext): void;
+export declare function toolText(tool: string, rawValue: unknown, compactText: string, format?: "compact" | "json"): string;
+export declare function toolCompactOrJson(tool: string, rawValue: unknown, compactText: string, format: OutputFormat): string;
+export declare function tokenSavingsSummary(limit: number): {
+    ok: boolean;
+    summary: {
+        calls: number;
+        raw_tokens: number;
+        output_tokens: number;
+        saved_tokens: number;
+        avg_savings_pct: number;
+    };
+    by_tool: {
+        tool: string;
+        calls: number;
+        raw_tokens: number;
+        output_tokens: number;
+        saved_tokens: number;
+        avg_savings_pct: number;
+    }[];
+    recent: {
+        id: number;
+        tool: string;
+        raw_tokens: number;
+        output_tokens: number;
+        saved_tokens: number;
+        savings_pct: number;
+        created_at: string;
+    }[];
+};
+export {};

package/dist/token-savings.js

@@ -0,0 +1,50 @@
+import { estimateTokens, toolJson } from "./tool-output.js";
+let tokenSavingsContext = null;
+export function configureTokenSavings(context) {
+    tokenSavingsContext = context;
+}
+function requireTokenSavingsContext() {
+    if (!tokenSavingsContext)
+        throw new Error("[VectorMind] token savings context is not configured");
+    return tokenSavingsContext;
+}
+function recordTokenSavings(tool, rawText, outputText) {
+    const context = requireTokenSavingsContext();
+    const db = context.getDb();
+    const insertTokenSavingsStmt = context.getInsertTokenSavingsStatement();
+    if (!db || !insertTokenSavingsStmt)
+        return;
+    const rawTokens = estimateTokens(rawText);
+    const outputTokens = estimateTokens(outputText);
+    const savedTokens = Math.max(0, rawTokens - outputTokens);
+    const savingsPct = rawTokens > 0 ? (savedTokens / rawTokens) * 100 : 0;
+    try {
+        insertTokenSavingsStmt.run(tool, rawTokens, outputTokens, savedTokens, savingsPct);
+    }
+    catch (err) {
+        console.error("[vectormind] token savings record failed:", err);
+    }
+}
+export function toolText(tool, rawValue, compactText, format = "compact") {
+    const rawText = toolJson(rawValue);
+    if (format === "json")
+        return rawText;
+    recordTokenSavings(tool, rawText, compactText);
+    return compactText;
+}
+export function toolCompactOrJson(tool, rawValue, compactText, format) {
+    return toolText(tool, rawValue, compactText, format);
+}
+export function tokenSavingsSummary(limit) {
+    const context = requireTokenSavingsContext();
+    const summary = context.getSummarizeTokenSavingsStatement().get();
+    const by_tool = context.getSummarizeTokenSavingsByToolStatement().all(limit);
+    const recent = context.getListRecentTokenSavingsStatement().all(limit);
+    return {
+        ok: true,
+        summary: summary ?? { calls: 0, raw_tokens: 0, output_tokens: 0, saved_tokens: 0, avg_savings_pct: 0 },
+        by_tool,
+        recent,
+    };
+}
+//# sourceMappingURL=token-savings.js.map

package/dist/token-savings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-savings.js","sourceRoot":"","sources":["../src/token-savings.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAU5D,IAAI,mBAAmB,GAA+B,IAAI,CAAC;AAE3D,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,mBAAmB,GAAG,OAAO,CAAC;AAChC,CAAC;AAED,SAAS,0BAA0B;IACjC,IAAI,CAAC,mBAAmB;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAClG,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,OAAe,EAAE,UAAkB;IAC3E,MAAM,OAAO,GAAG,0BAA0B,EAAE,CAAC;IAC7C,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,MAAM,sBAAsB,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC;IACxE,IAAI,CAAC,EAAE,IAAI,CAAC,sBAAsB;QAAE,OAAO;IAE3C,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,sBAAsB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,QAAiB,EACjB,WAAmB,EACnB,SAA6B,SAAS;IAEtC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC;IACtC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,QAAiB,EACjB,WAAmB,EACnB,MAAoB;IAEpB,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,OAAO,GAAG,0BAA0B,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,iCAAiC,EAAE,CAAC,GAAG,EAQlD,CAAC;IACd,MAAM,OAAO,GAAG,OAAO,CAAC,uCAAuC,EAAE,CAAC,GAAG,CAAC,KAAK,CAOzE,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,kCAAkC,EAAE,CAAC,GAAG,CAAC,KAAK,CAQnE,CAAC;IACH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,OAAO,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE;QACtG,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/tool-catalog.d.ts

@@ -0,0 +1,18 @@
+import { toJsonSchemaCompat } from "@modelcontextprotocol/sdk/server/zod-json-schema-compat.js";
+type ToolDefinition = {
+    name: string;
+    description: string;
+    inputSchema: ReturnType<typeof toJsonSchemaCompat>;
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+    _meta?: Record<string, unknown>;
+};
+export declare function listToolDefinitions(): Promise<{
+    tools: ToolDefinition[];
+}>;
+export {};

package/dist/tool-catalog.js

@@ -0,0 +1,243 @@
+import { toJsonSchemaCompat } from "@modelcontextprotocol/sdk/server/zod-json-schema-compat.js";
+import { AddNoteArgsSchema, AnalyzeMemoryConflictsArgsSchema, BootstrapContextArgsSchema, ClearActivityLogArgsSchema, CompareCheckpointContextArgsSchema, CompleteRequirementArgsSchema, CreateCheckpointArgsSchema, DetectRtkArgsSchema, GetActivityLogArgsSchema, GetActivitySummaryArgsSchema, GetBrainDumpArgsSchema, GetPendingChangesArgsSchema, GetTokenSavingsArgsSchema, GrepArgsSchema, InstallRtkArgsSchema, ListCheckpointsArgsSchema, ListProjectFilesArgsSchema, MaintainMemoryArgsSchema, MemoryTimelineArgsSchema, MemoryQualityReportArgsSchema, PlanLargeFileSplitArgsSchema, PreflightChangeScopeArgsSchema, PruneIndexArgsSchema, QueryCodebaseArgsSchema, ReadCodexTextFileArgsSchema, ReadFileLinesArgsSchema, ReadFileTextArgsSchema, ReadMemoryItemArgsSchema, RecordLargeFileSplitArgsSchema, RestoreCheckpointContextArgsSchema, SemanticSearchArgsSchema, StartRequirementArgsSchema, SupersedeMemoryArgsSchema, SyncChangeIntentArgsSchema, UpsertConventionArgsSchema, UpsertDecisionArgsSchema, UpsertProjectSummaryArgsSchema, } from "./tool-schemas.js";
+const DEFAULT_READ_ONLY_BEHAVIOR = {
+    tags: ["read_only", "advisory_only", "bounded_output"],
+    readOnlyHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const TOOL_BEHAVIOR = {
+    start_requirement: { tags: ["write_memory", "requirement_boundary", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    sync_change_intent: { tags: ["write_memory", "change_intent", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    record_large_file_split: { tags: ["write_memory", "large_file_tracking", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    complete_requirement: { tags: ["write_memory", "requirement_lifecycle", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    clear_activity_log: { tags: ["diagnostic_state", "non_project_memory"], readOnlyHint: false, idempotentHint: true },
+    install_rtk: { tags: ["optional_setup", "dry_run_by_default"], readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+    upsert_project_summary: { tags: ["write_memory", "project_summary", "advisory_only"], readOnlyHint: false, idempotentHint: true },
+    add_note: { tags: ["write_memory", "project_note", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    upsert_decision: { tags: ["write_memory", "current_decision", "advisory_only"], readOnlyHint: false, idempotentHint: true },
+    supersede_memory: { tags: ["write_memory", "stale_memory_control", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    upsert_convention: { tags: ["write_memory", "project_convention", "advisory_only"], readOnlyHint: false, idempotentHint: true },
+    maintain_memory: { tags: ["memory_maintenance", "dry_run_by_default", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    prune_index: { tags: ["index_maintenance", "dry_run_by_default", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    create_checkpoint: { tags: ["write_memory", "checkpoint", "advisory_only"], readOnlyHint: false, idempotentHint: false },
+    restore_checkpoint_context: { tags: ["read_only", "checkpoint_context", "advisory_only"], readOnlyHint: true, idempotentHint: true },
+    analyze_memory_conflicts: { tags: ["read_only", "memory_diagnostics", "advisory_only"], readOnlyHint: true, idempotentHint: true },
+    memory_quality_report: { tags: ["read_only", "memory_quality", "advisory_only"], readOnlyHint: true, idempotentHint: true },
+    compare_checkpoint_context: { tags: ["read_only", "checkpoint_diff", "advisory_only"], readOnlyHint: true, idempotentHint: true },
+};
+function withToolBehavior(tool) {
+    const behavior = TOOL_BEHAVIOR[tool.name] ?? DEFAULT_READ_ONLY_BEHAVIOR;
+    return {
+        ...tool,
+        annotations: {
+            title: tool.name,
+            readOnlyHint: behavior.readOnlyHint,
+            destructiveHint: false,
+            idempotentHint: behavior.idempotentHint,
+            openWorldHint: behavior.openWorldHint ?? false,
+        },
+        _meta: {
+            ...tool._meta,
+            "vectormind/behavior": {
+                tags: behavior.tags,
+                advisory_only: true,
+                does_not_control_model_reasoning: true,
+                does_not_control_host_runtime: true,
+            },
+        },
+    };
+}
+export async function listToolDefinitions() {
+    const tools = [
+        {
+            name: "start_requirement",
+            description: "MUST call BEFORE editing code. Starts/activates the concrete user requirement so subsequent changes stay inside that requirement boundary and do not accumulate unrelated work. Supports scope_allow/scope_deny, allowed_paths/denied_paths, and optional requirement_items for explicit user-request mapping.",
+            inputSchema: toJsonSchemaCompat(StartRequirementArgsSchema),
+        },
+        {
+            name: "sync_change_intent",
+            description: "MUST call AFTER you edit code and save files. Archives the intent summary, links affected files to the current active requirement, and returns development_warnings for oversized files, broad change scope, or missing file targets.",
+            inputSchema: toJsonSchemaCompat(SyncChangeIntentArgsSchema),
+        },
+        {
+            name: "preflight_change_scope",
+            description: "MUST call BEFORE editing once you know the intended files/modules. Checks planned files against the active requirement, optional generic scope_allow/scope_deny/allowed_paths/denied_paths, and optional requirement_items/planned_changes mapping. If ok=false/safe_to_edit=false, stop before editing and narrow the plan or scope contract. For huge files, use change_mode='mechanical_modularization' only when the task is to split the file.",
+            inputSchema: toJsonSchemaCompat(PreflightChangeScopeArgsSchema),
+        },
+        {
+            name: "plan_large_file_split",
+            description: "Plan a mechanical modularization split for a huge implementation file. Produces real module names/directories and explicitly forbids generated/parts/partN files. Use this before normal feature work when preflight_change_scope returns huge_file_modularization_required.",
+            inputSchema: toJsonSchemaCompat(PlanLargeFileSplitArgsSchema),
+        },
+        {
+            name: "record_large_file_split",
+            description: "Record the planned/in-progress/partial/resolved status of a huge-file mechanical modularization split so future sessions know the file is being decomposed and where modules moved.",
+            inputSchema: toJsonSchemaCompat(RecordLargeFileSplitArgsSchema),
+        },
+        {
+            name: "get_brain_dump",
+            description: "Restore recent requirements/changes/notes/summary/pending changes. Prefer bootstrap_context() at session start when you also want recall from the local memory store.",
+            inputSchema: toJsonSchemaCompat(GetBrainDumpArgsSchema),
+        },
+        {
+            name: "bootstrap_context",
+            description: "MUST call at the start of every new chat/session. Returns brain dump + pending changes + development_warnings, and (if you pass query) matches from the local memory store to avoid guessing.",
+            inputSchema: toJsonSchemaCompat(BootstrapContextArgsSchema),
+        },
+        {
+            name: "get_pending_changes",
+            description: "List files that changed locally but have not been acknowledged by sync_change_intent yet. Also returns development_warnings to catch god-file growth, broad change scope, and requirement-boundary drift.",
+            inputSchema: toJsonSchemaCompat(GetPendingChangesArgsSchema),
+        },
+        {
+            name: "complete_requirement",
+            description: "Mark a requirement as completed (by id or the current active one). Use this when work for a requirement is done so it no longer shows as active.",
+            inputSchema: toJsonSchemaCompat(CompleteRequirementArgsSchema),
+        },
+        {
+            name: "read_memory_item",
+            description: "Read a memory item by id. Use this to fetch full text only when needed (bootstrap_context/get_brain_dump/semantic_search return previews by default). Supports offset/limit chunking to avoid huge tool outputs.",
+            inputSchema: toJsonSchemaCompat(ReadMemoryItemArgsSchema),
+        },
+        {
+            name: "get_activity_log",
+            description: "Get recent debug activity (indexing/search/pending) for troubleshooting. Enable logging with VECTORMIND_DEBUG_LOG=1. Use since_id/limit to page.",
+            inputSchema: toJsonSchemaCompat(GetActivityLogArgsSchema),
+        },
+        {
+            name: "get_activity_summary",
+            description: "Get a compact summary of recent debug activity (counts + small samples). Enable logging with VECTORMIND_DEBUG_LOG=1. Use since_id to get incremental summaries.",
+            inputSchema: toJsonSchemaCompat(GetActivitySummaryArgsSchema),
+        },
+        {
+            name: "clear_activity_log",
+            description: "Clear the in-memory debug activity log. Enable logging with VECTORMIND_DEBUG_LOG=1.",
+            inputSchema: toJsonSchemaCompat(ClearActivityLogArgsSchema),
+        },
+        {
+            name: "detect_rtk",
+            description: "Detect whether rtk is available on PATH or via VectorMind's bundled RTK shim. When available, prefer the returned command as a shell prefix to reduce command-output tokens.",
+            inputSchema: toJsonSchemaCompat(DetectRtkArgsSchema),
+        },
+        {
+            name: "install_rtk",
+            description: "Install the rtk-ai/rtk Rust Token Killer binary when it is missing. Defaults to dry_run=true and never patches hooks unless init is explicitly requested.",
+            inputSchema: toJsonSchemaCompat(InstallRtkArgsSchema),
+        },
+        {
+            name: "get_token_savings",
+            description: "Show VectorMind compact-output token savings recorded by MCP tools. Use this to verify raw-vs-compact output reduction.",
+            inputSchema: toJsonSchemaCompat(GetTokenSavingsArgsSchema),
+        },
+        {
+            name: "grep",
+            description: "Repo text search with precise file/line/col matches, powered by ripgrep against real project files plus built-in noise filters. Falls back to indexed search only when ripgrep is unavailable. Returns development_warnings for cross-project paths or huge implementation-file matches.",
+            inputSchema: toJsonSchemaCompat(GrepArgsSchema),
+        },
+        {
+            name: "list_project_files",
+            description: "AI-friendly, ignore-aware file/directory listing under project_root with bounded output. Prefer this over Get-ChildItem/ls for local repository browsing.",
+            inputSchema: toJsonSchemaCompat(ListProjectFilesArgsSchema),
+        },
+        {
+            name: "read_codex_text_file",
+            description: "Read bounded text from local Codex/agents files such as SKILL.md, prompt files, and rules under CODEX_HOME/AGENTS_HOME. Prefer this over assuming another local-file MCP resource server exists.",
+            inputSchema: toJsonSchemaCompat(ReadCodexTextFileArgsSchema),
+        },
+        {
+            name: "read_file_lines",
+            description: "Read a specific line range from a file under project_root (with strict size limits). Prefer this over Get-Content for deterministic reads. Returns development_warnings when the target is a huge implementation file.",
+            inputSchema: toJsonSchemaCompat(ReadFileLinesArgsSchema),
+        },
+        {
+            name: "read_file_text",
+            description: "Read bounded raw UTF-8 text from a file under project_root. Prefer this over Get-Content -Raw for small/medium text files; use read_file_lines for large files or line-specific reads.",
+            inputSchema: toJsonSchemaCompat(ReadFileTextArgsSchema),
+        },
+        {
+            name: "query_codebase",
+            description: "Search the symbol index for class/function/type names (or substrings) to locate definitions by file path and signature. Use this when you need to find code; do not guess locations. Returns development_warnings when matches point at huge implementation files.",
+            inputSchema: toJsonSchemaCompat(QueryCodebaseArgsSchema),
+        },
+        {
+            name: "upsert_project_summary",
+            description: "Save/update the project-level context summary (written by the AI in the conversation). Call this after major milestones/decisions so future sessions can recover context quickly.",
+            inputSchema: toJsonSchemaCompat(UpsertProjectSummaryArgsSchema),
+        },
+        {
+            name: "add_note",
+            description: "Save a durable project note (decision, constraint, TODO, architecture detail). Use this to persist important context locally instead of relying on chat memory.",
+            inputSchema: toJsonSchemaCompat(AddNoteArgsSchema),
+        },
+        {
+            name: "upsert_decision",
+            description: "Save/update the current authoritative project decision for a key. Use it when requirements change, reverse, or supersede older behavior so future sessions prefer the latest decision over old history.",
+            inputSchema: toJsonSchemaCompat(UpsertDecisionArgsSchema),
+        },
+        {
+            name: "supersede_memory",
+            description: "Mark old requirements or memory items as superseded by a newer requirement/decision. Superseded items are hidden from default semantic recall to avoid reverting to stale behavior.",
+            inputSchema: toJsonSchemaCompat(SupersedeMemoryArgsSchema),
+        },
+        {
+            name: "upsert_convention",
+            description: "Save/update a project convention (framework choice, build command, naming rules, etc). Conventions are durable and should be applied automatically in future sessions.",
+            inputSchema: toJsonSchemaCompat(UpsertConventionArgsSchema),
+        },
+        {
+            name: "semantic_search",
+            description: "Semantic search across the local memory store (requirements, change intents, notes, project summary, and indexed code/doc chunks). Use this to retrieve relevant context instead of guessing.",
+            inputSchema: toJsonSchemaCompat(SemanticSearchArgsSchema),
+        },
+        {
+            name: "memory_timeline",
+            description: "Read-only timeline around a memory item, requirement, file, timestamp, or query. Use this to understand what happened before/after a decision without letting old context override newer observed facts.",
+            inputSchema: toJsonSchemaCompat(MemoryTimelineArgsSchema),
+        },
+        {
+            name: "create_checkpoint",
+            description: "Create a local context checkpoint/waypoint for long sessions. Stores a compact snapshot of active requirement, current decisions, recent memory, and pending changes. It is context evidence only and does not affect model reasoning or active client state.",
+            inputSchema: toJsonSchemaCompat(CreateCheckpointArgsSchema),
+        },
+        {
+            name: "list_checkpoints",
+            description: "List local context checkpoints with bounded output. Use before restoring a long-session waypoint.",
+            inputSchema: toJsonSchemaCompat(ListCheckpointsArgsSchema),
+        },
+        {
+            name: "restore_checkpoint_context",
+            description: "Read-only restore of checkpoint context. Returns the saved snapshot but does not mutate requirements, files, runtime state, or model decisions.",
+            inputSchema: toJsonSchemaCompat(RestoreCheckpointContextArgsSchema),
+        },
+        {
+            name: "analyze_memory_conflicts",
+            description: "Read-only diagnostic for likely memory conflicts such as duplicate visible titles, multiple active requirements, or superseded targets that remain visible. It reports evidence only and never changes memory, source files, active requirements, or model decisions.",
+            inputSchema: toJsonSchemaCompat(AnalyzeMemoryConflictsArgsSchema),
+        },
+        {
+            name: "memory_quality_report",
+            description: "Read-only quality report for the local memory store: counts, hidden memory, duplicates, oversized checkpoints, stale indexed files, and orphaned memory records. Use maintain_memory/prune_index separately if cleanup is desired.",
+            inputSchema: toJsonSchemaCompat(MemoryQualityReportArgsSchema),
+        },
+        {
+            name: "compare_checkpoint_context",
+            description: "Read-only diff between a saved checkpoint snapshot and current context. Shows active requirement, project summary, decisions, recent memory, and pending-change differences without restoring or mutating anything.",
+            inputSchema: toJsonSchemaCompat(CompareCheckpointContextArgsSchema),
+        },
+        {
+            name: "maintain_memory",
+            description: "Compact old completed memory and prune stale/noisy indexes to keep long-lived large projects fast. Defaults to dry_run=true; automatic safe maintenance also runs periodically.",
+            inputSchema: toJsonSchemaCompat(MaintainMemoryArgsSchema),
+        },
+        {
+            name: "prune_index",
+            description: "Prune noisy auto-indexed items (code_chunk/doc_chunk + symbols). Useful after tightening ignore rules to shrink the index and improve search relevance.",
+            inputSchema: toJsonSchemaCompat(PruneIndexArgsSchema),
+        },
+    ];
+    return {
+        tools: tools.map(withToolBehavior),
+    };
+}
+//# sourceMappingURL=tool-catalog.js.map

package/dist/tool-catalog.js.map

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

package/dist/tool-handlers/context-recovery.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ToolHandlerContext } from "./context.js";
+export declare function handleMemoryTimeline(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleCreateCheckpoint(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleListCheckpoints(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;
+export declare function handleRestoreCheckpointContext(rawArgs: Record<string, unknown>, context: ToolHandlerContext): Promise<CallToolResult>;