prelude-context 1.4.3 → 1.5.0

package/README.md

@@ -171,6 +171,80 @@ prelude watch
 # Press Ctrl+C when done to save the session
 ```
 
+### `prelude serve`
+Starts Prelude as an MCP server over stdio transport:
+```bash
+prelude serve                    # Serve context for current directory
+prelude serve --root ~/my-project  # Serve context for a specific project
+```
+
+AI tools connect to this server to query your project context programmatically — no clipboard needed.
+
+### `prelude mcp-config`
+Prints the configuration snippet to connect Prelude to your AI tool:
+```bash
+prelude mcp-config --client claude-code      # Default
+prelude mcp-config --client claude-desktop
+prelude mcp-config --client cursor
+```
+
+---
+
+## MCP Server Integration
+
+Prelude can run as an [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server, making your project context directly available to AI tools like Claude Code, Claude Desktop, and Cursor — no copy-paste required.
+
+### Quick Setup (Claude Code)
+
+```bash
+# From your project directory (must have .context/ — run prelude init first)
+prelude mcp-config --client claude-code
+```
+
+This prints the command to register Prelude as an MCP server. Once connected, your AI tools have access to three tools:
+
+| Tool | Description |
+|------|-------------|
+| `prelude_query` | Full-power context queries with topic, scope, and type filtering |
+| `prelude_compact` | Token-efficient context for prompt injection (~800 tokens) |
+| `prelude_status` | Check which context files are available |
+
+And three resources for passive context discovery:
+
+| Resource URI | Description |
+|-------------|-------------|
+| `prelude://context/full` | Complete project context as markdown |
+| `prelude://context/compact` | Token-efficient summary |
+| `prelude://context/{type}` | Individual context files (project, stack, architecture, constraints, decisions) |
+
+### Other Clients
+
+```bash
+prelude mcp-config --client claude-desktop
+prelude mcp-config --client cursor
+```
+
+### Manual Setup
+
+Start the server directly:
+
+```bash
+prelude serve --root /path/to/your/project
+```
+
+The server uses stdio transport. Configure your MCP client to run this command.
+
+### `prelude mcp-config [options]`
+
+Prints the configuration snippet for connecting Prelude to your AI tool:
+
+```bash
+prelude mcp-config                          # Claude Code (default)
+prelude mcp-config --client claude-desktop   # Claude Desktop
+prelude mcp-config --client cursor           # Cursor
+prelude mcp-config --root /path/to/project   # Specify project root
+```
+
 ---
 
 ## Use Cases
@@ -363,12 +437,14 @@ Yes! While the CLI is built with Node.js, the Prelude format works with any lang
 
 - [x] Smart context updates with manual edit preservation
 - [x] Scoped context query engine (`prelude query`)
+- [x] MCP server for AI tool integration (`prelude serve`)
 - [ ] Improved inference for Python, Rust, Go
 - [ ] VS Code extension for inline context
 - [ ] GitHub Action for automated updates
 - [ ] Plugin system for custom inference
 - [ ] CLI validation command
 - [ ] Context diff tool
+- [ ] Temporal brain layer (learned heuristics from AI tool usage)
 
 ---
 

package/dist/bin/prelude.js

@@ -26,6 +26,8 @@ import { registerDecisionCommand } from '../src/commands/decision.js';
 import { registerWatchCommand } from '../src/commands/watch.js';
 import { registerQueryCommand } from '../src/commands/query.js';
 import { registerCompactCommand } from '../src/commands/compact.js';
+import { registerServeCommand } from '../src/commands/serve.js';
+import { registerMcpConfigCommand } from '../src/commands/mcp-config.js';
 import { update } from '../src/commands/update.js';
 // Register all commands
 registerInitCommand(cli);
@@ -35,6 +37,8 @@ registerDecisionCommand(cli);
 registerWatchCommand(cli);
 registerQueryCommand(cli);
 registerCompactCommand(cli);
+registerServeCommand(cli);
+registerMcpConfigCommand(cli);
 // Register update command
 cli
     .command('update', 'Update context by re-analyzing the codebase')

package/dist/bin/prelude.js.map

@@ -1 +1 @@
-{"version":3,"file":"prelude.js","sourceRoot":"","sources":["../../bin/prelude.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,0DAA0D;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+DAA+D;AAC/D,IAAI,WAAgB,CAAC;AACrB,IAAI,CAAC;IACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC;AAAC,MAAM,CAAC;IACP,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;AAE3B,GAAG;KACA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,IAAI,EAAE,CAAC;AAEV,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,wBAAwB;AACxB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AACzB,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC3B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,uBAAuB,CAAC,GAAG,CAAC,CAAC;AAC7B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,sBAAsB,CAAC,GAAG,CAAC,CAAC;AAE5B,0BAA0B;AAC1B,GAAG;KACA,OAAO,CAAC,QAAQ,EAAE,6CAA6C,CAAC;KAChE,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,yCAAyC,CAAC;KAC9D,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC;KACpC,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,gBAAgB;AAChB,GAAG,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"prelude.js","sourceRoot":"","sources":["../../bin/prelude.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,0DAA0D;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+DAA+D;AAC/D,IAAI,WAAgB,CAAC;AACrB,IAAI,CAAC;IACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC;AAAC,MAAM,CAAC;IACP,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;AAE3B,GAAG;KACA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,IAAI,EAAE,CAAC;AAEV,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,wBAAwB;AACxB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AACzB,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC3B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,uBAAuB,CAAC,GAAG,CAAC,CAAC;AAC7B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,sBAAsB,CAAC,GAAG,CAAC,CAAC;AAC5B,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAC1B,wBAAwB,CAAC,GAAG,CAAC,CAAC;AAE9B,0BAA0B;AAC1B,GAAG;KACA,OAAO,CAAC,QAAQ,EAAE,6CAA6C,CAAC;KAChE,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,yCAAyC,CAAC;KAC9D,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC;KACpC,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,gBAAgB;AAChB,GAAG,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/commands/mcp-config.d.ts

@@ -0,0 +1,3 @@
+import type { CAC } from 'cac';
+export declare function registerMcpConfigCommand(cli: CAC): void;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/src/commands/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAI/B,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,QAsEhD"}

package/dist/src/commands/mcp-config.js

@@ -0,0 +1,72 @@
+import { resolve } from 'path';
+import { execSync } from 'child_process';
+export function registerMcpConfigCommand(cli) {
+    cli
+        .command('mcp-config', 'Print MCP server configuration for AI tool integration')
+        .option('--root <path>', 'Project root directory (default: cwd)')
+        .option('--client <name>', 'Target client: claude-desktop, claude-code, cursor', { default: 'claude-code' })
+        .action(async (options) => {
+        const rootDir = resolve(options.root || process.cwd());
+        // Find the prelude binary path
+        let preludePath;
+        try {
+            preludePath = execSync('which prelude', { encoding: 'utf-8' }).trim();
+        }
+        catch {
+            // Fallback: assume npx
+            preludePath = 'npx';
+        }
+        const isNpx = preludePath === 'npx';
+        const command = isNpx ? 'npx' : preludePath;
+        const args = isNpx
+            ? ['prelude-context', 'serve', '--root', rootDir]
+            : ['serve', '--root', rootDir];
+        const serverConfig = {
+            command,
+            args,
+        };
+        const client = options.client || 'claude-code';
+        if (client === 'claude-code') {
+            // Claude Code uses: claude mcp add <name> -- <command> <args...>
+            const addCommand = isNpx
+                ? `claude mcp add prelude-context -- npx prelude-context serve --root ${rootDir}`
+                : `claude mcp add prelude-context -- ${preludePath} serve --root ${rootDir}`;
+            console.log('# Claude Code\n');
+            console.log('Run this command:\n');
+            console.log(`  ${addCommand}\n`);
+            console.log('Or add to .mcp.json in your project root:\n');
+            console.log(JSON.stringify({
+                mcpServers: {
+                    'prelude-context': serverConfig
+                }
+            }, null, 2));
+        }
+        else if (client === 'claude-desktop') {
+            // Claude Desktop uses claude_desktop_config.json
+            console.log('# Claude Desktop\n');
+            console.log('Add to ~/Library/Application Support/Claude/claude_desktop_config.json:\n');
+            console.log(JSON.stringify({
+                mcpServers: {
+                    'prelude-context': serverConfig
+                }
+            }, null, 2));
+        }
+        else if (client === 'cursor') {
+            console.log('# Cursor\n');
+            console.log('Add to .cursor/mcp.json in your project root:\n');
+            console.log(JSON.stringify({
+                mcpServers: {
+                    'prelude-context': serverConfig
+                }
+            }, null, 2));
+        }
+        else {
+            // Generic MCP config
+            console.log('# MCP Server Configuration\n');
+            console.log(JSON.stringify({
+                'prelude-context': serverConfig
+            }, null, 2));
+        }
+    });
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/src/commands/mcp-config.js.map

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

package/dist/src/commands/serve.d.ts

@@ -0,0 +1,3 @@
+import type { CAC } from 'cac';
+export declare function registerServeCommand(cli: CAC): void;
+//# sourceMappingURL=serve.d.ts.map

package/dist/src/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAO/B,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,QA4B5C"}

package/dist/src/commands/serve.js

@@ -0,0 +1,29 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createPreludeServer } from '../mcp/server.js';
+import { CONTEXT_DIR } from '../constants.js';
+import { fileExists } from '../utils/fs.js';
+import { join } from 'path';
+export function registerServeCommand(cli) {
+    cli
+        .command('serve', 'Start Prelude as an MCP server (stdio transport)')
+        .option('--root <path>', 'Root directory of the project (default: cwd)')
+        .action(async (options) => {
+        const rootDir = options.root || process.cwd();
+        // Validate .context/ exists
+        const externalRoot = process.env.PRELUDE_ROOT;
+        const contextDir = externalRoot
+            ? join(externalRoot, rootDir.split('/').pop())
+            : join(rootDir, CONTEXT_DIR);
+        if (!(await fileExists(contextDir))) {
+            // Write to stderr since stdout is the MCP transport
+            process.stderr.write('Error: .context/ directory not found. Run `prelude init` first.\n');
+            process.exit(1);
+        }
+        const server = createPreludeServer(rootDir);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        // Log to stderr (stdout is MCP transport)
+        process.stderr.write(`Prelude MCP server started for: ${rootDir}\n`);
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/src/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,oBAAoB,CAAC,GAAQ;IAC3C,GAAG;SACA,OAAO,CAAC,OAAO,EAAE,kDAAkD,CAAC;SACpE,MAAM,CAAC,eAAe,EAAE,8CAA8C,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAE9C,4BAA4B;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAC9C,MAAM,UAAU,GAAG,YAAY;YAC7B,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAY,CAAC;YACxD,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE/B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACpC,oDAAoD;YACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mEAAmE,CACpE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,0CAA0C;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createPreludeServer(rootDir: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAStF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAqM9D"}

package/dist/src/mcp/server.js

@@ -0,0 +1,162 @@
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { join } from 'path';
+import { executeQuery, VALID_TYPES } from '../core/query-engine.js';
+import { exportCompact } from '../core/compact.js';
+import { fileExists, readJSON } from '../utils/fs.js';
+import { CONTEXT_DIR, CONTEXT_FILES } from '../constants.js';
+export function createPreludeServer(rootDir) {
+    const server = new McpServer({
+        name: 'prelude-context',
+        version: '1.5.0',
+    });
+    server.tool('prelude_query', 'Query project context by topic, scope, or type. Returns structured context about the codebase.', {
+        topic: z.string().optional().describe('Filter context by topic keyword (e.g. "database", "auth", "testing")'),
+        scope: z.string().optional().describe('Filter to a specific directory path (e.g. "src/api", "packages/db")'),
+        type: z.enum(VALID_TYPES).optional().describe('Return only a specific context type'),
+        format: z.enum(['md', 'json']).default('md').describe('Output format — md for reading, json for parsing'),
+        max_tokens: z.number().positive().optional().describe('Approximate token budget for the response'),
+    }, async ({ topic, scope, type, format, max_tokens }) => {
+        if (!topic && !scope && !type) {
+            return {
+                content: [{ type: 'text', text: 'Error: Provide at least one filter — topic, scope, or type.' }],
+                isError: true,
+            };
+        }
+        try {
+            const { output, tokenEstimate } = await executeQuery(rootDir, {
+                topic,
+                scope,
+                type,
+                format,
+                maxTokens: max_tokens,
+            });
+            return {
+                content: [{ type: 'text', text: output }],
+                _meta: { tokenEstimate },
+            };
+        }
+        catch (e) {
+            return {
+                content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('prelude_compact', 'Get compact, token-efficient context for LLM prompt injection. Returns flat prefixed lines.', {
+        topic: z.string().optional().describe('Filter context by topic keyword'),
+        scope: z.string().optional().describe('Filter to a specific directory path'),
+        max_tokens: z.number().positive().default(800).describe('Token budget (default 800)'),
+    }, async ({ topic, scope, max_tokens }) => {
+        try {
+            const output = await exportCompact(rootDir, {
+                topic,
+                scope,
+                maxTokens: max_tokens,
+            });
+            return { content: [{ type: 'text', text: output }] };
+        }
+        catch (e) {
+            return {
+                content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('prelude_status', 'Check Prelude status — which context files exist and basic project info.', {}, async () => {
+        try {
+            const externalRoot = process.env.PRELUDE_ROOT;
+            const contextDir = externalRoot
+                ? join(externalRoot, rootDir.split('/').pop())
+                : join(rootDir, CONTEXT_DIR);
+            const fileNames = [
+                CONTEXT_FILES.PROJECT,
+                CONTEXT_FILES.STACK,
+                CONTEXT_FILES.ARCHITECTURE,
+                CONTEXT_FILES.CONSTRAINTS,
+                CONTEXT_FILES.DECISIONS,
+            ];
+            const existResults = await Promise.all(fileNames.map(f => fileExists(join(contextDir, f))));
+            const files = fileNames.filter((_, i) => existResults[i]);
+            let project = null;
+            if (existResults[0]) {
+                const data = await readJSON(join(contextDir, CONTEXT_FILES.PROJECT));
+                project = { name: data.name, description: data.description };
+            }
+            const status = { contextDir, files, project };
+            return { content: [{ type: 'text', text: JSON.stringify(status, null, 2) }] };
+        }
+        catch (e) {
+            return {
+                content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- Resources (passive context) ---
+    server.resource('full-context', 'prelude://context/full', async (uri) => {
+        const { exportToMarkdown } = await import('../core/exporter.js');
+        const markdown = await exportToMarkdown(rootDir);
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'text/markdown',
+                    text: markdown,
+                }],
+        };
+    });
+    server.resource('compact-context', 'prelude://context/compact', async (uri) => {
+        const output = await exportCompact(rootDir, { maxTokens: 800 });
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'text/plain',
+                    text: output,
+                }],
+        };
+    });
+    server.resource('context-by-type', new ResourceTemplate('prelude://context/{type}', { list: undefined }), async (uri, variables) => {
+        const typeStr = variables.type;
+        const fileMap = {
+            project: CONTEXT_FILES.PROJECT,
+            stack: CONTEXT_FILES.STACK,
+            architecture: CONTEXT_FILES.ARCHITECTURE,
+            constraints: CONTEXT_FILES.CONSTRAINTS,
+            decisions: CONTEXT_FILES.DECISIONS,
+        };
+        const filename = fileMap[typeStr];
+        if (!filename) {
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: 'text/plain',
+                        text: `Unknown context type: ${typeStr}. Valid types: ${Object.keys(fileMap).join(', ')}`,
+                    }],
+            };
+        }
+        const externalRoot = process.env.PRELUDE_ROOT;
+        const contextDir = externalRoot
+            ? join(externalRoot, rootDir.split('/').pop())
+            : join(rootDir, CONTEXT_DIR);
+        const filePath = join(contextDir, filename);
+        if (!(await fileExists(filePath))) {
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: 'text/plain',
+                        text: `Context file not found: ${filename}. Run \`prelude init\` to generate it.`,
+                    }],
+            };
+        }
+        const data = await readJSON(filePath);
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG7D,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CACT,eAAe,EACf,gGAAgG,EAChG;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;QAC7G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;QAC5G,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAA8C,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACvH,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACzG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KACnG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE;QACnD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,6DAA6D,EAAE,CAAC;gBACzG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE;gBAC5D,KAAK;gBACL,KAAK;gBACL,IAAI;gBACJ,MAAM;gBACN,SAAS,EAAE,UAAU;aACtB,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,KAAK,EAAE,EAAE,aAAa,EAAE;aACzB,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,6FAA6F,EAC7F;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAC5E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KACtF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE;gBAC1C,KAAK;gBACL,KAAK;gBACL,SAAS,EAAE,UAAU;aACtB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,0EAA0E,EAC1E,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YAC9C,MAAM,UAAU,GAAG,YAAY;gBAC7B,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAY,CAAC;gBACxD,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAE/B,MAAM,SAAS,GAAG;gBAChB,aAAa,CAAC,OAAO;gBACrB,aAAa,CAAC,KAAK;gBACnB,aAAa,CAAC,YAAY;gBAC1B,aAAa,CAAC,WAAW;gBACzB,aAAa,CAAC,SAAS;aACxB,CAAC;YAEF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CACpD,CAAC;YACF,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1D,IAAI,OAAO,GAAmD,IAAI,CAAC;YACnE,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CACxC,CAAC;gBACF,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/D,CAAC;YAED,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACzF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,sCAAsC;IAEtC,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,wBAAwB,EACxB,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,QAAQ;iBACf,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,MAAM;iBACb,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,iBAAiB,EACjB,IAAI,gBAAgB,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACrE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAc,CAAC;QACzC,MAAM,OAAO,GAA2B;YACtC,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,KAAK,EAAE,aAAa,CAAC,KAAK;YAC1B,YAAY,EAAE,aAAa,CAAC,YAAY;YACxC,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,SAAS,EAAE,aAAa,CAAC,SAAS;SACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE,yBAAyB,OAAO,kBAAkB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC1F,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAC9C,MAAM,UAAU,GAAG,YAAY;YAC7B,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAY,CAAC;YACxD,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE,2BAA2B,QAAQ,wCAAwC;qBAClF,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/schema/state.d.ts

@@ -12,14 +12,14 @@ export declare const FieldStateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     source: "inferred" | "manual" | "merged";
     value?: any;
-    lastInferred?: string | undefined;
     lastModified?: string | undefined;
+    lastInferred?: string | undefined;
     inferredHash?: string | undefined;
 }, {
     source: "inferred" | "manual" | "merged";
     value?: any;
-    lastInferred?: string | undefined;
     lastModified?: string | undefined;
+    lastInferred?: string | undefined;
     inferredHash?: string | undefined;
 }>;
 export declare const FileStateSchema: z.ZodObject<{
@@ -34,14 +34,14 @@ export declare const FileStateSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         source: "inferred" | "manual" | "merged";
         value?: any;
-        lastInferred?: string | undefined;
         lastModified?: string | undefined;
+        lastInferred?: string | undefined;
         inferredHash?: string | undefined;
     }, {
         source: "inferred" | "manual" | "merged";
         value?: any;
-        lastInferred?: string | undefined;
         lastModified?: string | undefined;
+        lastInferred?: string | undefined;
         inferredHash?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -50,8 +50,8 @@ export declare const FileStateSchema: z.ZodObject<{
     fields: Record<string, {
         source: "inferred" | "manual" | "merged";
         value?: any;
-        lastInferred?: string | undefined;
         lastModified?: string | undefined;
+        lastInferred?: string | undefined;
         inferredHash?: string | undefined;
     }>;
 }, {
@@ -60,8 +60,8 @@ export declare const FileStateSchema: z.ZodObject<{
     fields: Record<string, {
         source: "inferred" | "manual" | "merged";
         value?: any;
-        lastInferred?: string | undefined;
         lastModified?: string | undefined;
+        lastInferred?: string | undefined;
         inferredHash?: string | undefined;
     }>;
 }>;
@@ -81,14 +81,14 @@ export declare const PreludeStateSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             source: "inferred" | "manual" | "merged";
             value?: any;
-            lastInferred?: string | undefined;
             lastModified?: string | undefined;
+            lastInferred?: string | undefined;
             inferredHash?: string | undefined;
         }, {
             source: "inferred" | "manual" | "merged";
             value?: any;
-            lastInferred?: string | undefined;
             lastModified?: string | undefined;
+            lastInferred?: string | undefined;
             inferredHash?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -97,8 +97,8 @@ export declare const PreludeStateSchema: z.ZodObject<{
         fields: Record<string, {
             source: "inferred" | "manual" | "merged";
             value?: any;
-            lastInferred?: string | undefined;
             lastModified?: string | undefined;
+            lastInferred?: string | undefined;
             inferredHash?: string | undefined;
         }>;
     }, {
@@ -107,8 +107,8 @@ export declare const PreludeStateSchema: z.ZodObject<{
         fields: Record<string, {
             source: "inferred" | "manual" | "merged";
             value?: any;
-            lastInferred?: string | undefined;
             lastModified?: string | undefined;
+            lastInferred?: string | undefined;
             inferredHash?: string | undefined;
         }>;
     }>, "many">;
@@ -120,8 +120,8 @@ export declare const PreludeStateSchema: z.ZodObject<{
         fields: Record<string, {
             source: "inferred" | "manual" | "merged";
             value?: any;
-            lastInferred?: string | undefined;
             lastModified?: string | undefined;
+            lastInferred?: string | undefined;
             inferredHash?: string | undefined;
         }>;
     }[];
@@ -134,8 +134,8 @@ export declare const PreludeStateSchema: z.ZodObject<{
         fields: Record<string, {
             source: "inferred" | "manual" | "merged";
             value?: any;
-            lastInferred?: string | undefined;
             lastModified?: string | undefined;
+            lastInferred?: string | undefined;
             inferredHash?: string | undefined;
         }>;
     }[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prelude-context",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "The open standard for expressing and maintaining machine-readable context about a codebase",
   "type": "module",
   "bin": {
@@ -35,6 +35,7 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "cac": "^6.7.14",
     "chokidar": "^3.6.0",
     "colorette": "^2.0.20",