contextvault-mcp 1.0.0

package/dist/tools/bootstrap.js

@@ -0,0 +1,108 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function handleBootstrap(vault, _params) {
+    if (!vault.projectIndex.exists())
+        vault.initProject();
+    const projectRoot = path.resolve(vault.projectPath, '..');
+    const scan = scanProject(projectRoot);
+    let text = `# Bootstrap Scan Results\n\n`;
+    text += `**Project root:** ${projectRoot}\n\n`;
+    text += `## Detected\n\n`;
+    text += `- **Languages:** ${scan.languages.join(', ') || 'None detected'}\n`;
+    text += `- **Frameworks:** ${scan.frameworks.join(', ') || 'None detected'}\n`;
+    text += `- **Package managers:** ${scan.packageManagers.join(', ') || 'None detected'}\n`;
+    text += `- **Config files:** ${scan.configFiles.length} found\n`;
+    text += `- **Source directories:** ${scan.srcDirs.join(', ') || 'None detected'}\n\n`;
+    text += `## Recommendation\n\n`;
+    text += `Use **ctx_doc** to create documentation for each major component found.\n`;
+    text += `Use **ctx_intel** to document the architecture and patterns discovered.\n\n`;
+    text += `### Suggested Documents\n\n`;
+    if (scan.languages.length > 0) {
+        text += `1. Architecture doc: tech stack (${scan.languages.join(', ')}), structure, patterns\n`;
+    }
+    if (scan.frameworks.length > 0) {
+        text += `2. Framework doc: ${scan.frameworks.join(', ')} setup and conventions\n`;
+    }
+    text += `3. Build/deploy doc: how to build, test, and deploy this project\n`;
+    return { content: [{ type: 'text', text }] };
+}
+function scanProject(root) {
+    const result = {
+        languages: [],
+        frameworks: [],
+        packageManagers: [],
+        configFiles: [],
+        srcDirs: [],
+    };
+    const ignoreDirs = new Set(['.git', 'node_modules', '.contextvault', '.claude', 'dist', 'build', '__pycache__', '.venv', 'venv']);
+    try {
+        const entries = fs.readdirSync(root);
+        // Check for package managers and languages
+        for (const entry of entries) {
+            const fullPath = path.join(root, entry);
+            const stat = fs.statSync(fullPath);
+            if (stat.isDirectory() && !ignoreDirs.has(entry)) {
+                if (['src', 'lib', 'app', 'pkg', 'cmd'].includes(entry)) {
+                    result.srcDirs.push(entry);
+                }
+            }
+            if (stat.isFile()) {
+                // Package managers
+                if (entry === 'package.json') {
+                    result.packageManagers.push('npm');
+                    try {
+                        const pkg = JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
+                        if (pkg.dependencies) {
+                            if (pkg.dependencies.react)
+                                result.frameworks.push('React');
+                            if (pkg.dependencies.vue)
+                                result.frameworks.push('Vue');
+                            if (pkg.dependencies.next)
+                                result.frameworks.push('Next.js');
+                            if (pkg.dependencies.express)
+                                result.frameworks.push('Express');
+                            if (pkg.dependencies.fastify)
+                                result.frameworks.push('Fastify');
+                        }
+                    }
+                    catch { /* ignore parse errors */ }
+                }
+                if (entry === 'Cargo.toml') {
+                    result.packageManagers.push('cargo');
+                    result.languages.push('Rust');
+                }
+                if (entry === 'go.mod') {
+                    result.packageManagers.push('go modules');
+                    result.languages.push('Go');
+                }
+                if (entry === 'requirements.txt' || entry === 'pyproject.toml') {
+                    result.packageManagers.push('pip');
+                    result.languages.push('Python');
+                }
+                if (entry === 'Gemfile') {
+                    result.packageManagers.push('bundler');
+                    result.languages.push('Ruby');
+                }
+                // Languages
+                if (entry === 'tsconfig.json')
+                    result.languages.push('TypeScript');
+                if (entry.endsWith('.js') || entry.endsWith('.mjs'))
+                    result.languages.push('JavaScript');
+                // Config files
+                if (entry.startsWith('.') && stat.isFile() && entry !== '.git' && entry !== '.DS_Store') {
+                    result.configFiles.push(entry);
+                }
+                if (entry.endsWith('.json') || entry.endsWith('.yaml') || entry.endsWith('.yml') || entry.endsWith('.toml')) {
+                    result.configFiles.push(entry);
+                }
+            }
+        }
+    }
+    catch { /* ignore read errors */ }
+    // Deduplicate
+    result.languages = [...new Set(result.languages)];
+    result.frameworks = [...new Set(result.frameworks)];
+    result.packageManagers = [...new Set(result.packageManagers)];
+    return result;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/tools/bootstrap.js.map

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

package/dist/tools/changelog.d.ts

@@ -0,0 +1,3 @@
+import { ToolResponse } from '../vault/types.js';
+export declare function handleChangelog(): ToolResponse;
+//# sourceMappingURL=changelog.d.ts.map

package/dist/tools/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/tools/changelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,eAAe,IAAI,YAAY,CA8B9C"}

package/dist/tools/changelog.js

@@ -0,0 +1,31 @@
+export function handleChangelog() {
+    const text = `# ContextVault Changelog
+
+## v1.0.0 (MCP Server)
+- Initial MCP server release
+- 25 tools mirroring all /ctx-* commands
+- 4 MCP resources (global index, project index, settings, instructions)
+- Resource templates for individual documents
+- Server-side enforcement engine (no hooks needed)
+- CLI-agnostic vault paths (~/.contextvault/, ./.contextvault/)
+- Backward compatible with legacy .claude/vault/ locations
+- Works with: Claude Code, Cursor, Windsurf, OpenCode, Cline, Continue, Copilot CLI
+
+## Based on ContextVault v1.8.4 (Bash Installer)
+- v1.8.4: CLAUDE.md optimization (775 → 221 lines)
+- v1.8.3: Configurable enforcement levels (light/balanced/strict)
+- v1.8.2: Smart blocking at session end
+- v1.8.1: Completion-triggered reminders
+- v1.8.0: "Remind, Don't Block" enforcement
+- v1.7.6: Hook deduplication + smarter bootstrap
+- v1.7.5: /ctx-bootstrap auto-scan
+- v1.7.0: Smart detection, context-aware suggestions
+- v1.6.9: Blocking PreToolUse enforcement
+- v1.6.0: 6 new commands (health, note, changelog, link, quiz, explain)
+- v1.5.3: /ctx-upgrade command
+- v1.5.0: Share/import with ZIP support
+- v1.4.0: Enhanced instructions with checklists
+`;
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=changelog.js.map

package/dist/tools/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/tools/changelog.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bd,CAAC;IAEA,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/tools/decision.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleDecision(vault: VaultManager, params: Record<string, unknown>): ToolResponse;
+//# sourceMappingURL=decision.d.ts.map

package/dist/tools/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/tools/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAuCjG"}

package/dist/tools/decision.js

@@ -0,0 +1,34 @@
+export function handleDecision(vault, params) {
+    const decision = params.decision;
+    const options = params.options ?? '';
+    const reasoning = params.reasoning;
+    const tradeoffs = params.tradeoffs ?? '';
+    if (!decision || !reasoning) {
+        return { content: [{ type: 'text', text: 'Error: decision and reasoning are required.' }], isError: true };
+    }
+    const indexMgr = vault.projectIndex;
+    if (!indexMgr.exists()) {
+        vault.initProject();
+    }
+    const id = indexMgr.getNextId();
+    const slug = decision.slice(0, 40).toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '');
+    const filename = `${id}_decision_${slug}.md`;
+    const topic = `Decision: ${decision.slice(0, 60)}`;
+    const docContent = vault.generateDocContent({
+        id,
+        title: topic,
+        type: 'decision',
+        sections: { decision, options, reasoning, tradeoffs },
+    });
+    vault.writeDocument(id, filename, docContent, 'project');
+    const summary = `Chose: ${decision.slice(0, 50)}`;
+    indexMgr.addEntry({ id, topic, status: 'Active', summary });
+    indexMgr.addRelatedTerms(`decision, ${slug.replace(/_/g, ', ')}`, id);
+    return {
+        content: [{
+                type: 'text',
+                text: `Documented decision to **${filename}**\n\nID: ${id} | Decision: ${decision.slice(0, 80)}`,
+            }],
+    };
+}
+//# sourceMappingURL=decision.js.map

package/dist/tools/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/tools/decision.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,cAAc,CAAC,KAAmB,EAAE,MAA+B;IACjF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAkB,CAAC;IAC3C,MAAM,OAAO,GAAI,MAAM,CAAC,OAAkB,IAAI,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAmB,CAAC;IAC7C,MAAM,SAAS,GAAI,MAAM,CAAC,SAAoB,IAAI,EAAE,CAAC;IAErD,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6CAA6C,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7G,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnG,MAAM,QAAQ,GAAG,GAAG,EAAE,aAAa,IAAI,KAAK,CAAC;IAC7C,MAAM,KAAK,GAAG,aAAa,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEnD,MAAM,UAAU,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC1C,EAAE;QACF,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE;KACtD,CAAC,CAAC;IAEH,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,UAAU,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAEtE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,4BAA4B,QAAQ,aAAa,EAAE,gBAAgB,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;aACjG,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/doc.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleDoc(vault: VaultManager, params: Record<string, unknown>): ToolResponse;
+//# sourceMappingURL=doc.d.ts.map

package/dist/tools/doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../src/tools/doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAa,MAAM,mBAAmB,CAAC;AAE5D,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CA6D5F"}

package/dist/tools/doc.js

@@ -0,0 +1,53 @@
+export function handleDoc(vault, params) {
+    const topic = params.topic;
+    const content = params.content;
+    const tier = params.vault ?? 'project';
+    if (!topic || !content) {
+        return { content: [{ type: 'text', text: 'Error: topic and content are required.' }], isError: true };
+    }
+    const indexMgr = tier === 'global' ? vault.globalIndex : vault.projectIndex;
+    if (!indexMgr.exists()) {
+        if (tier === 'project') {
+            vault.initProject();
+        }
+        else {
+            vault.initGlobal();
+        }
+    }
+    // Check for existing doc on same topic
+    const existing = indexMgr.search(topic);
+    if (existing.length > 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Found existing document **${existing[0].id}** on "${existing[0].topic}". Use **ctx_update** to update it instead of creating a duplicate.\n\nExisting summary: ${existing[0].summary}`,
+                }],
+        };
+    }
+    const settings = vault.settings.load();
+    const maxDocs = tier === 'global' ? settings.limits.max_global_docs : settings.limits.max_project_docs;
+    const currentCount = indexMgr.getEntryCount();
+    if (currentCount >= maxDocs) {
+        return { content: [{ type: 'text', text: `Error: ${tier} vault is full (${currentCount}/${maxDocs} docs). Archive old docs first.` }], isError: true };
+    }
+    const id = indexMgr.getNextId();
+    const slug = topic.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '');
+    const filename = `${id}_${slug}.md`;
+    const docContent = vault.generateDocContent({
+        id,
+        title: topic,
+        type: 'doc',
+        sections: { content, key_points: `- ${content.split('.')[0]}` },
+    });
+    vault.writeDocument(id, filename, docContent, tier);
+    const summary = content.split('.')[0].trim().slice(0, 80);
+    indexMgr.addEntry({ id, topic, status: 'Active', summary });
+    indexMgr.addRelatedTerms(topic.toLowerCase().replace(/[^a-z0-9]+/g, ', '), id);
+    return {
+        content: [{
+                type: 'text',
+                text: `Documented to **${filename}** (${tier} vault)\n\nID: ${id} | Topic: ${topic}`,
+            }],
+    };
+}
+//# sourceMappingURL=doc.js.map

package/dist/tools/doc.js.map

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

package/dist/tools/error.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleError(vault: VaultManager, params: Record<string, unknown>): ToolResponse;
+//# sourceMappingURL=error.d.ts.map

package/dist/tools/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/tools/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAuC9F"}

package/dist/tools/error.js

@@ -0,0 +1,34 @@
+export function handleError(vault, params) {
+    const errorMessage = params.error_message;
+    const rootCause = params.root_cause;
+    const solution = params.solution;
+    const prevention = params.prevention ?? '';
+    if (!errorMessage || !rootCause || !solution) {
+        return { content: [{ type: 'text', text: 'Error: error_message, root_cause, and solution are required.' }], isError: true };
+    }
+    const indexMgr = vault.projectIndex;
+    if (!indexMgr.exists()) {
+        vault.initProject();
+    }
+    const id = indexMgr.getNextId();
+    const slug = errorMessage.slice(0, 40).toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '');
+    const filename = `${id}_error_${slug}.md`;
+    const topic = `Error: ${errorMessage.slice(0, 60)}`;
+    const docContent = vault.generateDocContent({
+        id,
+        title: topic,
+        type: 'error',
+        sections: { error_message: errorMessage, root_cause: rootCause, solution, prevention },
+    });
+    vault.writeDocument(id, filename, docContent, 'project');
+    const summary = `${rootCause.slice(0, 40)} → ${solution.slice(0, 30)}`;
+    indexMgr.addEntry({ id, topic, status: 'Active', summary });
+    indexMgr.addRelatedTerms(`error, bug, ${slug.replace(/_/g, ', ')}`, id);
+    return {
+        content: [{
+                type: 'text',
+                text: `Documented error to **${filename}**\n\nID: ${id} | Root cause: ${rootCause.slice(0, 60)}`,
+            }],
+    };
+}
+//# sourceMappingURL=error.js.map

package/dist/tools/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/tools/error.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CAAC,KAAmB,EAAE,MAA+B;IAC9E,MAAM,YAAY,GAAG,MAAM,CAAC,aAAuB,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAoB,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAkB,CAAC;IAC3C,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,EAAE,CAAC;IAEvD,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8DAA8D,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9H,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvG,MAAM,QAAQ,GAAG,GAAG,EAAE,UAAU,IAAI,KAAK,CAAC;IAC1C,MAAM,KAAK,GAAG,UAAU,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEpD,MAAM,UAAU,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC1C,EAAE;QACF,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE;KACvF,CAAC,CAAC;IAEH,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAExE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,yBAAyB,QAAQ,aAAa,EAAE,kBAAkB,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;aACjG,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/explain.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleExplain(vault: VaultManager, params: Record<string, unknown>): ToolResponse;
+//# sourceMappingURL=explain.d.ts.map

package/dist/tools/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAkDhG"}

package/dist/tools/explain.js

@@ -0,0 +1,43 @@
+export function handleExplain(vault, params) {
+    const concept = params.concept;
+    const save = params.save === true;
+    if (!concept) {
+        return { content: [{ type: 'text', text: 'Error: concept is required.' }], isError: true };
+    }
+    // Check if we have existing documentation about this concept
+    const results = vault.search(concept);
+    let existingKnowledge = '';
+    if (results.length > 0) {
+        existingKnowledge = `\n\n## Existing Vault Knowledge\n\nFound ${results.length} related doc(s):\n`;
+        for (const r of results) {
+            existingKnowledge += `- **${r.id}** (${r.vault}): ${r.topic} — ${r.summary}\n`;
+        }
+        existingKnowledge += `\nUse **ctx_read** to see full details.`;
+    }
+    let text = `# Explain: ${concept}\n\n`;
+    text += `This tool helps you document your understanding of "${concept}".\n\n`;
+    text += `To save an explanation, provide your explanation content and set save=true. `;
+    text += `The explanation will be saved as a new vault document.`;
+    text += existingKnowledge;
+    if (save) {
+        // Save as a document
+        const indexMgr = vault.globalIndex.exists() ? vault.globalIndex : vault.projectIndex;
+        if (!indexMgr.exists())
+            vault.initGlobal();
+        const id = indexMgr.getNextId();
+        const slug = concept.slice(0, 40).toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '');
+        const filename = `${id}_explain_${slug}.md`;
+        const docContent = vault.generateDocContent({
+            id,
+            title: `Explain: ${concept}`,
+            type: 'explain',
+            sections: { concept, explanation: `Explanation of ${concept} — to be filled in by the AI assistant.` },
+        });
+        const tier = id.startsWith('G') ? 'global' : 'project';
+        vault.writeDocument(id, filename, docContent, tier);
+        indexMgr.addEntry({ id, topic: `Explain: ${concept}`, status: 'Active', summary: `Explanation of ${concept}` });
+        text = `Saved explanation template to **${filename}**\n\nID: ${id} | Use **ctx_update** to fill in the explanation.${existingKnowledge}`;
+    }
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=explain.js.map

package/dist/tools/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,MAA+B;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;IAElC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IAED,6DAA6D;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,iBAAiB,GAAG,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,iBAAiB,GAAG,4CAA4C,OAAO,CAAC,MAAM,oBAAoB,CAAC;QACnG,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,iBAAiB,IAAI,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;QACjF,CAAC;QACD,iBAAiB,IAAI,yCAAyC,CAAC;IACjE,CAAC;IAED,IAAI,IAAI,GAAG,cAAc,OAAO,MAAM,CAAC;IACvC,IAAI,IAAI,uDAAuD,OAAO,QAAQ,CAAC;IAC/E,IAAI,IAAI,8EAA8E,CAAC;IACvF,IAAI,IAAI,wDAAwD,CAAC;IACjE,IAAI,IAAI,iBAAiB,CAAC;IAE1B,IAAI,IAAI,EAAE,CAAC;QACT,qBAAqB;QACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACrF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QAE3C,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClG,MAAM,QAAQ,GAAG,GAAG,EAAE,YAAY,IAAI,KAAK,CAAC;QAE5C,MAAM,UAAU,GAAG,KAAK,CAAC,kBAAkB,CAAC;YAC1C,EAAE;YACF,KAAK,EAAE,YAAY,OAAO,EAAE;YAC5B,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,OAAO,yCAAyC,EAAE;SACvG,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAiB,CAAC,CAAC,CAAC,SAAkB,CAAC;QACzE,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,OAAO,EAAE,EAAE,CAAC,CAAC;QAEhH,IAAI,GAAG,mCAAmC,QAAQ,aAAa,EAAE,oDAAoD,iBAAiB,EAAE,CAAC;IAC3I,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/tools/handoff.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleHandoff(vault: VaultManager, params: Record<string, unknown>): ToolResponse;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/tools/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/tools/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAqChG"}

package/dist/tools/handoff.js

@@ -0,0 +1,32 @@
+export function handleHandoff(vault, params) {
+    const completed = params.completed;
+    const inProgress = params.in_progress ?? 'None';
+    const nextSteps = params.next_steps;
+    if (!completed || !nextSteps) {
+        return { content: [{ type: 'text', text: 'Error: completed and next_steps are required.' }], isError: true };
+    }
+    const indexMgr = vault.projectIndex;
+    if (!indexMgr.exists()) {
+        vault.initProject();
+    }
+    const today = new Date().toISOString().split('T')[0];
+    const id = indexMgr.getNextId();
+    const filename = `${id}_handoff_${today}.md`;
+    const topic = `Handoff ${today}`;
+    const docContent = vault.generateDocContent({
+        id,
+        title: topic,
+        type: 'handoff',
+        sections: { completed, in_progress: inProgress, next_steps: nextSteps },
+    });
+    vault.writeDocument(id, filename, docContent, 'project');
+    const summary = `Session handoff: ${nextSteps.slice(0, 40)}`;
+    indexMgr.addEntry({ id, topic, status: 'Active', summary });
+    return {
+        content: [{
+                type: 'text',
+                text: `Session handoff saved to **${filename}**\n\nID: ${id}\n\n**Next session should:**\n${nextSteps}`,
+            }],
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/tools/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/tools/handoff.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,MAA+B;IAChF,MAAM,SAAS,GAAG,MAAM,CAAC,SAAmB,CAAC;IAC7C,MAAM,UAAU,GAAI,MAAM,CAAC,WAAsB,IAAI,MAAM,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,UAAoB,CAAC;IAE9C,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+CAA+C,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/G,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,EAAE,YAAY,KAAK,KAAK,CAAC;IAC7C,MAAM,KAAK,GAAG,WAAW,KAAK,EAAE,CAAC;IAEjC,MAAM,UAAU,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC1C,EAAE;QACF,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE;KACxE,CAAC,CAAC;IAEH,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,oBAAoB,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAE5D,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,8BAA8B,QAAQ,aAAa,EAAE,iCAAiC,SAAS,EAAE;aACxG,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/health.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleHealth(vault: VaultManager): ToolResponse;
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAwG9D"}

package/dist/tools/health.js

@@ -0,0 +1,98 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function handleHealth(vault) {
+    const issues = [];
+    const fixes = [];
+    let score = 100;
+    // Check global vault
+    if (vault.globalExists()) {
+        const globalEntries = vault.globalIndex.parseEntries();
+        const globalFiles = vault.listDocFiles('global');
+        // Check for orphaned files (file exists but not in index)
+        for (const file of globalFiles) {
+            const id = file.split('_')[0];
+            if (!globalEntries.find(e => e.id === id)) {
+                issues.push(`Orphaned file: ${file} (not in global index)`);
+                score -= 5;
+            }
+        }
+        // Check for missing files (in index but file missing)
+        for (const entry of globalEntries) {
+            if (!globalFiles.find(f => f.startsWith(entry.id + '_'))) {
+                issues.push(`Missing file for global index entry: ${entry.id} - ${entry.topic}`);
+                score -= 10;
+            }
+        }
+        // Check doc sizes
+        for (const file of globalFiles) {
+            const content = fs.readFileSync(path.join(vault.globalPath, file), 'utf-8');
+            const lines = content.split('\n').length;
+            if (lines > 100) {
+                issues.push(`${file}: ${lines} lines (exceeds 100-line limit)`);
+                score -= 3;
+            }
+        }
+    }
+    else {
+        issues.push('Global vault not initialized');
+        score -= 10;
+    }
+    // Check project vault
+    if (vault.projectExists()) {
+        const projectEntries = vault.projectIndex.parseEntries();
+        const projectFiles = vault.listDocFiles('project');
+        for (const file of projectFiles) {
+            const id = file.split('_')[0];
+            if (!projectEntries.find(e => e.id === id)) {
+                issues.push(`Orphaned file: ${file} (not in project index)`);
+                score -= 5;
+            }
+        }
+        for (const entry of projectEntries) {
+            if (!projectFiles.find(f => f.startsWith(entry.id + '_'))) {
+                issues.push(`Missing file for project index entry: ${entry.id} - ${entry.topic}`);
+                score -= 10;
+            }
+        }
+        for (const file of projectFiles) {
+            const content = fs.readFileSync(path.join(vault.projectPath, file), 'utf-8');
+            const lines = content.split('\n').length;
+            if (lines > 100) {
+                issues.push(`${file}: ${lines} lines (exceeds 100-line limit)`);
+                score -= 3;
+            }
+        }
+    }
+    else {
+        issues.push('Project vault not initialized');
+        score -= 5;
+    }
+    // Check settings
+    try {
+        vault.settings.load();
+    }
+    catch {
+        issues.push('Settings file corrupted or missing');
+        score -= 5;
+    }
+    score = Math.max(0, score);
+    let text = `# Vault Health Check\n\n`;
+    text += `**Score:** ${score}/100 ${score >= 90 ? 'Healthy' : score >= 70 ? 'Fair' : 'Needs Attention'}\n\n`;
+    if (issues.length === 0) {
+        text += `No issues found. Vault is in great shape.\n`;
+    }
+    else {
+        text += `## Issues Found (${issues.length})\n\n`;
+        for (const issue of issues) {
+            text += `- ${issue}\n`;
+        }
+    }
+    if (fixes.length > 0) {
+        text += `\n## Auto-Fixed\n\n`;
+        for (const fix of fixes) {
+            text += `- ${fix}\n`;
+        }
+    }
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/health.js.map

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

package/dist/tools/help.d.ts

@@ -0,0 +1,4 @@
+import { VaultManager } from '../vault/manager.js';
+import { ToolResponse } from '../vault/types.js';
+export declare function handleHelp(_vault: VaultManager): ToolResponse;
+//# sourceMappingURL=help.d.ts.map

package/dist/tools/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAoD7D"}

package/dist/tools/help.js

@@ -0,0 +1,53 @@
+export function handleHelp(_vault) {
+    const text = `# ContextVault MCP Commands
+
+## Document Your Work
+| Command | Description |
+|---------|-------------|
+| **ctx_doc** | Quick document a learning, feature, or finding |
+| **ctx_error** | Document a bug fix (error, cause, solution) |
+| **ctx_decision** | Document a decision with reasoning |
+| **ctx_plan** | Document an implementation plan |
+| **ctx_snippet** | Save a reusable code snippet |
+| **ctx_intel** | Document codebase exploration findings |
+| **ctx_handoff** | Create session handoff summary |
+| **ctx_explain** | Explain a concept and save to vault |
+
+## Manage Documents
+| Command | Description |
+|---------|-------------|
+| **ctx_search** | Search vault documents by keyword |
+| **ctx_read** | Read a document by ID (P001, G003) |
+| **ctx_update** | Update an existing document |
+| **ctx_new** | Create a new document with custom content |
+| **ctx_note** | Add a quick note to existing doc |
+| **ctx_link** | Link two related documents |
+
+## Vault Management
+| Command | Description |
+|---------|-------------|
+| **ctx_init** | Initialize vault in current project |
+| **ctx_status** | Show vault status and stats |
+| **ctx_mode** | Switch mode (local/global/full) or enforcement |
+| **ctx_health** | Check vault health and fix issues |
+| **ctx_bootstrap** | Auto-scan codebase for documentation |
+| **ctx_upgrade** | Upgrade vault format |
+| **ctx_changelog** | Show version history |
+
+## Share & Import
+| Command | Description |
+|---------|-------------|
+| **ctx_share** | Export documents for sharing |
+| **ctx_import** | Import from external source or legacy vault |
+| **ctx_quiz** | Test knowledge retention |
+
+## Resources (Auto-loaded)
+- \`contextvault://global/index\` — Global vault index
+- \`contextvault://project/index\` — Project vault index
+- \`contextvault://settings\` — Current settings
+- \`contextvault://instructions\` — Documentation rules
+- \`contextvault://doc/{id}\` — Individual document
+`;
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=help.js.map

package/dist/tools/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDd,CAAC;IAEA,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}