contentbase 0.4.0 → 0.4.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,GAAG,MAAM,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,CAAA;IAChC,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAA;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;GA4B9E;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB;;;GAuD7E"}

package/dist/mcp/server.js

@@ -0,0 +1,83 @@
+import { loadCollection } from '../cli/load-collection.js';
+import { registerResources } from './resources.js';
+import { registerQueryTools } from './tools/query.js';
+import { registerSearchTools } from './tools/search.js';
+import { registerMutationTools } from './tools/mutation.js';
+import { registerPrompts } from './prompts.js';
+export async function createMcpServer(container, options) {
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+        modulePath: options.modulePath,
+    });
+    const modelDefs = collection.modelDefinitions;
+    console.error(`[cnotes mcp] Loaded collection: ${collection.rootPath}`);
+    console.error(`[cnotes mcp] Models: ${modelDefs.map((d) => d.name).join(', ') || '(none)'}`);
+    console.error(`[cnotes mcp] Documents: ${collection.available.length}`);
+    const mcpServer = container.server('mcp', {
+        transport: options.transport,
+        port: options.port,
+        serverName: 'contentbase',
+        serverVersion: '1.0.0',
+        mcpCompat: options.mcpCompat,
+        stdioCompat: options.stdioCompat,
+    });
+    // Register all capabilities
+    registerResources(mcpServer, collection);
+    registerQueryTools(mcpServer, collection);
+    registerSearchTools(mcpServer, collection, container);
+    registerMutationTools(mcpServer, collection);
+    registerPrompts(mcpServer, collection);
+    return { mcpServer, collection };
+}
+export async function startMcpServer(container, options) {
+    const envCompat = process.env.MCP_HTTP_COMPAT?.toLowerCase();
+    const resolvedCompat = options.mcpCompat || (envCompat === 'codex' ? 'codex' : 'standard');
+    const envStdioCompat = process.env.MCP_STDIO_COMPAT?.toLowerCase();
+    const resolvedStdioCompat = options.stdioCompat
+        || (envStdioCompat === 'codex' || envStdioCompat === 'auto' ? envStdioCompat : 'standard');
+    const { mcpServer, collection } = await createMcpServer(container, options);
+    await mcpServer.start({
+        transport: options.transport,
+        port: options.port,
+        mcpCompat: options.mcpCompat,
+        stdioCompat: options.stdioCompat,
+    });
+    if (options.transport === 'http') {
+        console.log(`\nContentbase MCP listening on http://localhost:${options.port}/mcp`);
+        console.log(`Transport: HTTP (Streamable)`);
+        console.log(`Compatibility: ${resolvedCompat}`);
+    }
+    else {
+        console.error(`[cnotes mcp] Server started (stdio transport)`);
+        console.error(`[cnotes mcp] Stdio compatibility: ${resolvedStdioCompat}`);
+        console.error(`[cnotes mcp] Tools: ${mcpServer._tools.size} | Resources: ${mcpServer._resources.size} | Prompts: ${mcpServer._prompts.size}`);
+    }
+    // File watching
+    if (options.watch !== false) {
+        const fileManager = container.feature('fileManager');
+        await fileManager.start({ rootPath: collection.rootPath });
+        await fileManager.watch();
+        const { debounce } = container.utils.lodash;
+        const refreshCollection = debounce(async () => {
+            try {
+                const before = collection.available.length;
+                await collection.load({ refresh: true });
+                const after = collection.available.length;
+                if (after !== before) {
+                    console.error(`[watch] Collection refreshed: ${before} → ${after} documents`);
+                }
+            }
+            catch (err) {
+                console.error(`[watch] Refresh failed: ${err.message}`);
+            }
+        }, 500);
+        fileManager.on('file:change', (event) => {
+            if (/\.(md|mdx)$/i.test(event.path)) {
+                refreshCollection();
+            }
+        });
+        console.error(`[cnotes mcp] Watching for file changes in ${collection.rootPath}`);
+    }
+    return { mcpServer, collection };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAY9C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAc,EAAE,OAAyB;IAC7E,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,UAAU,CAAC,gBAAyB,CAAA;IAEtD,OAAO,CAAC,KAAK,CAAC,mCAAmC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvE,OAAO,CAAC,KAAK,CAAC,wBAAwB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAA;IACjG,OAAO,CAAC,KAAK,CAAC,2BAA2B,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAEvE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,aAAa;QACzB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAQ,CAAA;IAET,4BAA4B;IAC5B,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACxC,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACzC,mBAAmB,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;IACrD,qBAAqB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IAC5C,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IAEtC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAc,EAAE,OAAyB;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,EAAE,CAAA;IAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAC1F,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,WAAW,EAAE,CAAA;IAClE,MAAM,mBAAmB,GAAG,OAAO,CAAC,WAAW;WAC1C,CAAC,cAAc,KAAK,OAAO,IAAI,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAE5F,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAE3E,MAAM,SAAS,CAAC,KAAK,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAA;IAEF,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,mDAAmD,OAAO,CAAC,IAAI,MAAM,CAAC,CAAA;QAClF,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;QAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,cAAc,EAAE,CAAC,CAAA;IACjD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAC9D,OAAO,CAAC,KAAK,CAAC,qCAAqC,mBAAmB,EAAE,CAAC,CAAA;QACzE,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,CAAC,MAAM,CAAC,IAAI,iBAAiB,SAAS,CAAC,UAAU,CAAC,IAAI,eAAe,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAC/I,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACpD,MAAM,WAAW,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC1D,MAAM,WAAW,CAAC,KAAK,EAAE,CAAA;QAEzB,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAA;QAC3C,MAAM,iBAAiB,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC5C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAA;gBAC1C,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;gBACxC,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAA;gBACzC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;oBACrB,OAAO,CAAC,KAAK,CAAC,iCAAiC,MAAM,MAAM,KAAK,YAAY,CAAC,CAAA;gBAC/E,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,2BAA4B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;YACpE,CAAC;QACH,CAAC,EAAE,GAAG,CAAC,CAAA;QAEP,WAAW,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAqC,EAAE,EAAE;YACtE,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,iBAAiB,EAAE,CAAA;YACrB,CAAC;QACH,CAAC,CAAC,CAAA;QACF,OAAO,CAAC,KAAK,CAAC,6CAA6C,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;IACnF,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;AAClC,CAAC"}

package/dist/mcp/tools/mutation.d.ts

@@ -0,0 +1,2 @@
+export declare function registerMutationTools(mcpServer: any, collection: any): void;
+//# sourceMappingURL=mutation.d.ts.map

package/dist/mcp/tools/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/mutation.ts"],"names":[],"mappings":"AAMA,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,QAyKpE"}

package/dist/mcp/tools/mutation.js

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import matter from 'gray-matter';
+import { errorResult, textResult } from '../helpers.js';
+import { resolveModelDef } from '../../cli/commands/api/helpers.js';
+import { validateDocument } from '../../index.js';
+export function registerMutationTools(mcpServer, collection) {
+    const modelDefs = collection.modelDefinitions;
+    mcpServer.tool('validate', {
+        description: 'Validate a document against its model schema. Returns validation result with any errors. **ALWAYS call after create/update operations** to confirm the document conforms to its model.',
+        schema: z.object({
+            pathId: z.string().describe('Document path ID'),
+            model: z.string().optional().describe('Model name (auto-detected if omitted)'),
+        }),
+        handler: (args) => {
+            const doc = collection.document(args.pathId);
+            if (!doc)
+                return errorResult(`Document not found: ${args.pathId}`);
+            const def = args.model
+                ? resolveModelDef(collection, args.model)
+                : collection.findModelDefinition(args.pathId);
+            if (!def) {
+                return errorResult(`No model definition found for ${args.pathId}. Specify one with the model parameter.`);
+            }
+            const result = validateDocument(doc, def);
+            return textResult(JSON.stringify(result, null, 2));
+        },
+    });
+    mcpServer.tool('create_document', {
+        description: '**ALWAYS use this instead of writing markdown files directly.** Creates a new document with proper scaffolding from a model definition — generates correct frontmatter defaults and section headings. Call `validate` after creation.',
+        schema: z.object({
+            pathId: z.string().describe('Path ID for the new document (e.g. "epics/my-new-epic")'),
+            title: z.string().describe('Document title (used as the H1 heading)'),
+            meta: z.record(z.string(), z.any()).optional().describe('Frontmatter fields to set'),
+            model: z.string().optional().describe('Model name (auto-detected from pathId prefix if omitted)'),
+        }),
+        handler: async (args) => {
+            if (collection.available.includes(args.pathId)) {
+                return errorResult(`Document already exists: ${args.pathId}`);
+            }
+            const def = args.model
+                ? resolveModelDef(collection, args.model)
+                : collection.findModelDefinition(args.pathId);
+            const metaData = { ...(def?.defaults || {}), ...(args.meta || {}) };
+            const sectionHeadings = def
+                ? Object.values(def.sections || {}).map((s) => `## ${s.heading}\n\n`)
+                : [];
+            const body = [
+                `# ${args.title}`,
+                '',
+                ...sectionHeadings,
+            ].join('\n');
+            const content = matter.stringify(body, metaData);
+            await collection.saveItem(args.pathId, { content });
+            await collection.load({ refresh: true });
+            return textResult(JSON.stringify({
+                created: args.pathId,
+                model: def ? def.name : null,
+                meta: metaData,
+            }, null, 2));
+        },
+    });
+    mcpServer.tool('update_document', {
+        description: 'Update a document\'s frontmatter and/or replace its entire content body. Use for frontmatter changes. For section-level edits, prefer `update_section` instead. Call `validate` after.',
+        schema: z.object({
+            pathId: z.string().describe('Document path ID'),
+            meta: z.record(z.string(), z.any()).optional().describe('Frontmatter fields to merge (existing fields are preserved unless overridden)'),
+            content: z.string().optional().describe('New markdown content body (replaces everything after frontmatter)'),
+        }),
+        handler: async (args) => {
+            const doc = collection.document(args.pathId);
+            if (!doc)
+                return errorResult(`Document not found: ${args.pathId}`);
+            const currentMeta = { ...doc.meta };
+            const newMeta = args.meta ? { ...currentMeta, ...args.meta } : currentMeta;
+            const newContent = args.content ?? doc.content;
+            const fullContent = matter.stringify(newContent, newMeta);
+            await collection.saveItem(args.pathId, { content: fullContent });
+            await collection.load({ refresh: true });
+            return textResult(JSON.stringify({
+                updated: args.pathId,
+                meta: newMeta,
+            }, null, 2));
+        },
+    });
+    mcpServer.tool('update_section', {
+        description: 'Preferred way to edit document content. Surgically edit a specific section — replace, append, or remove. Target a section by its heading name. Call `validate` after.',
+        schema: z.object({
+            pathId: z.string().describe('Document path ID'),
+            heading: z.string().describe('Section heading text to target (e.g. "Overview", "Requirements")'),
+            action: z.enum(['replace', 'append', 'remove']).describe('What to do with the section'),
+            content: z.string().optional().describe('New content (required for replace/append, ignored for remove)'),
+        }),
+        handler: async (args) => {
+            let doc = collection.document(args.pathId);
+            if (!doc)
+                return errorResult(`Document not found: ${args.pathId}`);
+            switch (args.action) {
+                case 'replace': {
+                    if (!args.content)
+                        return errorResult('Content is required for replace action');
+                    doc = doc.replaceSectionContent(args.heading, args.content);
+                    break;
+                }
+                case 'append': {
+                    if (!args.content)
+                        return errorResult('Content is required for append action');
+                    doc = doc.appendToSection(args.heading, args.content);
+                    break;
+                }
+                case 'remove': {
+                    doc = doc.removeSection(args.heading);
+                    break;
+                }
+            }
+            const fullContent = matter.stringify(doc.content, doc.meta);
+            await collection.saveItem(args.pathId, { content: fullContent });
+            await collection.load({ refresh: true });
+            return textResult(JSON.stringify({
+                updated: args.pathId,
+                action: args.action,
+                heading: args.heading,
+            }, null, 2));
+        },
+    });
+    mcpServer.tool('delete_document', {
+        description: 'Delete a document from the collection permanently. Cannot be undone except through version control.',
+        schema: z.object({
+            pathId: z.string().describe('Document path ID to delete'),
+        }),
+        handler: async (args) => {
+            if (!collection.available.includes(args.pathId)) {
+                return errorResult(`Document not found: ${args.pathId}`);
+            }
+            await collection.deleteItem(args.pathId);
+            await collection.load({ refresh: true });
+            return textResult(JSON.stringify({ deleted: args.pathId }, null, 2));
+        },
+    });
+    mcpServer.tool('run_action', {
+        description: 'Execute a registered collection action by name.',
+        schema: z.object({
+            name: z.string().describe('Action name'),
+            args: z.array(z.any()).optional().describe('Arguments to pass to the action'),
+        }),
+        handler: async (toolArgs) => {
+            if (!collection.availableActions.includes(toolArgs.name)) {
+                return errorResult(`Unknown action: ${toolArgs.name}. Available: ${collection.availableActions.join(', ') || '(none)'}`);
+            }
+            const result = await collection.runAction(toolArgs.name, ...(toolArgs.args || []));
+            const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+            return textResult(text);
+        },
+    });
+}
+//# sourceMappingURL=mutation.js.map

package/dist/mcp/tools/mutation.js.map

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

package/dist/mcp/tools/query.d.ts

@@ -0,0 +1,2 @@
+export declare function registerQueryTools(mcpServer: any, collection: any): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/mcp/tools/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/query.ts"],"names":[],"mappings":"AAOA,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,QAqIjE"}

package/dist/mcp/tools/query.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { errorResult, textResult } from '../helpers.js';
+import { generateReadMe } from '../readme.js';
+import { generateModelInfo } from '../model-info.js';
+import { resolveModelDef, buildSchemaJSON } from '../../cli/commands/api/helpers.js';
+import { queryDSLSchema, executeQueryDSL } from '../../query/query-dsl.js';
+export function registerQueryTools(mcpServer, collection) {
+    const modelDefs = collection.modelDefinitions;
+    // -- read_me: entry-point guidance for AI agents --
+    const readMeContent = generateReadMe(collection, modelDefs);
+    mcpServer.tool('read_me', {
+        description: [
+            'Returns the content collection guide. Call this BEFORE working with any documents.',
+            'Contains model definitions, available tools, query syntax, and recommended workflow.',
+            'Call this at the start of every session to understand the collection structure.',
+        ].join('\n'),
+        schema: z.object({}),
+        handler: () => textResult(readMeContent),
+    });
+    mcpServer.tool('inspect', {
+        description: 'Overview of the collection — registered models, document count, available actions. Call `read_me` first if this is your first interaction.',
+        schema: z.object({}),
+        handler: () => {
+            const schema = buildSchemaJSON(collection);
+            const overview = {
+                rootPath: collection.rootPath,
+                documentCount: collection.available.length,
+                models: Object.values(schema),
+                actions: collection.availableActions,
+            };
+            return textResult(JSON.stringify(overview, null, 2));
+        },
+    });
+    mcpServer.tool('get_model_info', {
+        description: 'Get detailed information about a single model — fields, sections, relationships, example document. Use when you need to understand a model before creating or editing its documents.',
+        schema: z.object({
+            model: z.string().describe('Model name or prefix'),
+        }),
+        handler: (args) => {
+            const def = resolveModelDef(collection, args.model);
+            if (!def) {
+                return errorResult(`Unknown model: ${args.model}. Available: ${modelDefs.map((d) => d.name).join(', ')}`);
+            }
+            return textResult(generateModelInfo(collection, def));
+        },
+    });
+    mcpServer.tool('list_documents', {
+        description: 'List all document path IDs in the collection, optionally filtered by model name or prefix. The prefix before the slash indicates the model.',
+        schema: z.object({
+            model: z.string().optional().describe('Filter by model name or prefix'),
+        }),
+        handler: (args) => {
+            let ids = collection.available;
+            if (args.model) {
+                const def = resolveModelDef(collection, args.model);
+                if (def) {
+                    const prefix = def.prefix + '/';
+                    ids = ids.filter((id) => id.startsWith(prefix));
+                }
+                else {
+                    return errorResult(`Unknown model: ${args.model}. Available: ${modelDefs.map((d) => d.name).join(', ')}`);
+                }
+            }
+            return textResult(JSON.stringify(ids, null, 2));
+        },
+    });
+    mcpServer.tool('query', {
+        description: [
+            'Query typed model instances with MongoDB-style filtering. See `read_me` output for full syntax reference.',
+            'Where clause: keys are dot-notation paths, values are literals (implies $eq),',
+            'arrays (implies $in), or operator objects like { "$gt": 5 }.',
+            'Operators: $eq, $neq, $in, $notIn, $gt, $lt, $gte, $lte,',
+            '$contains, $startsWith, $endsWith, $regex, $exists.',
+            'Supports sort, limit, offset, select, and method (fetchAll/first/last/count).',
+        ].join(' '),
+        schema: z.object({
+            model: z.string().describe('Model name to query'),
+            where: z.any().optional().describe('MongoDB-style where clause. Keys are field paths, values are literals (implicit $eq), arrays (implicit $in), or operator objects like { "$gt": 5 }. Also accepts legacy array format for backward compat.'),
+            sort: z.record(z.string(), z.enum(['asc', 'desc'])).optional().describe('Sort specification, e.g. { "meta.priority": "desc" }'),
+            select: z.array(z.string()).optional().describe('Fields to include in output (default: all)'),
+            related: z.array(z.string()).optional().describe('Relationship names to include in results (e.g. ["plans", "goal"])'),
+            scopes: z.array(z.string()).optional().describe('Named scopes to apply before filtering'),
+            limit: z.number().optional().describe('Maximum results to return'),
+            offset: z.number().optional().describe('Number of results to skip'),
+            method: z.enum(['fetchAll', 'first', 'last', 'count']).optional().describe('Terminal operation (default: fetchAll)'),
+        }),
+        handler: async (args) => {
+            try {
+                // Backward compat: convert legacy array-style where to MongoDB-style
+                let whereClause = args.where;
+                if (Array.isArray(whereClause)) {
+                    const converted = {};
+                    for (const cond of whereClause) {
+                        const op = cond.operator || 'eq';
+                        if (op === 'eq') {
+                            converted[cond.path] = cond.value;
+                        }
+                        else if (op === 'notExists') {
+                            converted[cond.path] = { $exists: false };
+                        }
+                        else if (op === 'exists') {
+                            converted[cond.path] = { $exists: true };
+                        }
+                        else {
+                            converted[cond.path] = { [`$${op}`]: cond.value };
+                        }
+                    }
+                    whereClause = converted;
+                }
+                const dsl = queryDSLSchema.parse({
+                    model: args.model,
+                    where: whereClause,
+                    sort: args.sort,
+                    select: args.select,
+                    related: args.related,
+                    scopes: args.scopes,
+                    limit: args.limit,
+                    offset: args.offset,
+                    method: args.method,
+                });
+                const result = await executeQueryDSL(collection, dsl);
+                return textResult(JSON.stringify(result, null, 2));
+            }
+            catch (error) {
+                return errorResult(error.message);
+            }
+        },
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/mcp/tools/query.js.map

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

package/dist/mcp/tools/search.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSearchTools(mcpServer: any, collection: any, container: any): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,QA8KlF"}

package/dist/mcp/tools/search.js

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+import { errorResult, textResult } from '../helpers.js';
+import { resolveModelDef } from '../../cli/commands/api/helpers.js';
+import { getInitializedSemanticSearch, hasSearchIndex as searchIndexExists } from '../../search/luca-semantic-search.js';
+export function registerSearchTools(mcpServer, collection, container) {
+    let _semanticSearch = null;
+    function hasSearchIndex() {
+        return searchIndexExists(collection.rootPath);
+    }
+    async function getSemanticSearch() {
+        if (_semanticSearch?.state?.get('dbReady'))
+            return _semanticSearch;
+        _semanticSearch = await getInitializedSemanticSearch(container, collection.rootPath);
+        return _semanticSearch;
+    }
+    mcpServer.tool('search_content', {
+        description: 'Full-text regex search across all document content. Returns matching document IDs with context. Searches document body text, not metadata — for metadata filtering, use `query` instead.',
+        schema: z.object({
+            pattern: z.string().describe('Regex pattern to search for'),
+            model: z.string().optional().describe('Limit search to a specific model'),
+            caseSensitive: z.boolean().default(false).describe('Case-sensitive matching'),
+        }),
+        handler: (args) => {
+            const flags = args.caseSensitive ? 'g' : 'gi';
+            let regex;
+            try {
+                regex = new RegExp(args.pattern, flags);
+            }
+            catch (e) {
+                return errorResult(`Invalid regex: ${e.message}`);
+            }
+            let ids = collection.available;
+            if (args.model) {
+                const def = resolveModelDef(collection, args.model);
+                if (def) {
+                    const prefix = def.prefix + '/';
+                    ids = ids.filter((id) => id.startsWith(prefix));
+                }
+            }
+            const results = [];
+            for (const pathId of ids) {
+                const doc = collection.document(pathId);
+                const content = doc.content;
+                const matches = [];
+                for (const line of content.split('\n')) {
+                    if (regex.test(line)) {
+                        matches.push(line.trim());
+                    }
+                    regex.lastIndex = 0;
+                }
+                if (matches.length > 0) {
+                    results.push({ pathId, matches: matches.slice(0, 10) });
+                }
+            }
+            return textResult(JSON.stringify(results, null, 2));
+        },
+    });
+    mcpServer.tool('text_search', {
+        description: 'Search file contents with pattern matching using ripgrep. Returns distinct file matches by default, or line-level detail with expanded=true.',
+        schema: z.object({
+            pattern: z.string().describe('Text or regex pattern to search for'),
+            expanded: z.boolean().default(false).describe('Return line-level matches instead of just file paths'),
+            include: z.string().optional().describe('Glob filter (e.g. "*.md")'),
+            exclude: z.string().optional().describe('Glob filter (e.g. "node_modules")'),
+            ignoreCase: z.boolean().default(false).describe('Case insensitive search'),
+            maxResults: z.number().optional().describe('Limit number of results'),
+        }),
+        handler: async (args) => {
+            const grep = container.feature('grep');
+            const searchPath = collection.rootPath;
+            const grepOpts = {
+                path: searchPath,
+                ignoreCase: args.ignoreCase,
+                maxResults: args.maxResults,
+                include: args.include,
+                exclude: args.exclude,
+            };
+            if (!args.expanded) {
+                const files = await grep.filesContaining(args.pattern, grepOpts);
+                return textResult(JSON.stringify({ files, count: files.length }, null, 2));
+            }
+            const results = await grep.search({ ...grepOpts, pattern: args.pattern });
+            const grouped = new Map();
+            for (const match of results) {
+                if (!grouped.has(match.file))
+                    grouped.set(match.file, []);
+                grouped.get(match.file).push({ line: match.line, column: match.column, content: match.content });
+            }
+            const files = Array.from(grouped.entries()).map(([file, matches]) => ({ file, matches }));
+            return textResult(JSON.stringify({ files, count: files.length }, null, 2));
+        },
+    });
+    mcpServer.tool('keyword_search', {
+        description: 'Fast keyword search using BM25 ranking. Best for exact terms, identifiers, and known phrases. Requires a search index — run `cnotes embed` first if not indexed.',
+        schema: z.object({
+            query: z.string().describe('Search query text'),
+            limit: z.number().optional().default(10).describe('Maximum results to return'),
+            model: z.string().optional().describe('Filter results to a specific model name'),
+        }),
+        handler: async (args) => {
+            if (!hasSearchIndex()) {
+                return errorResult('No search index found. Run: cnotes embed');
+            }
+            try {
+                const ss = await getSemanticSearch();
+                const results = await ss.search(args.query, {
+                    limit: args.limit,
+                    model: args.model,
+                });
+                return textResult(JSON.stringify(results, null, 2));
+            }
+            catch (error) {
+                return errorResult(`Search failed: ${error.message}`);
+            }
+        },
+    });
+    mcpServer.tool('semantic_search', {
+        description: 'Search by meaning using vector embeddings. Finds conceptually related documents even without keyword matches. Requires a search index — run `cnotes embed` first if not indexed.',
+        schema: z.object({
+            query: z.string().describe('Search query text'),
+            limit: z.number().optional().default(10).describe('Maximum results to return'),
+            model: z.string().optional().describe('Filter results to a specific model name'),
+        }),
+        handler: async (args) => {
+            if (!hasSearchIndex()) {
+                return errorResult('No search index found. Run: cnotes embed');
+            }
+            try {
+                const ss = await getSemanticSearch();
+                const results = await ss.vectorSearch(args.query, {
+                    limit: args.limit,
+                    model: args.model,
+                });
+                return textResult(JSON.stringify(results, null, 2));
+            }
+            catch (error) {
+                return errorResult(`Search failed: ${error.message}`);
+            }
+        },
+    });
+    mcpServer.tool('hybrid_search', {
+        description: 'Combined keyword + semantic search with score fusion. Best for general questions about the collection. Requires a search index — run `cnotes embed` first if not indexed.',
+        schema: z.object({
+            query: z.string().describe('Search query text'),
+            limit: z.number().optional().default(10).describe('Maximum results to return'),
+            model: z.string().optional().describe('Filter results to a specific model name'),
+            where: z.record(z.string(), z.any()).optional().describe('Metadata filters, e.g. {"status": "approved"}'),
+        }),
+        handler: async (args) => {
+            if (!hasSearchIndex()) {
+                return errorResult('No search index found. Run: cnotes embed');
+            }
+            try {
+                const ss = await getSemanticSearch();
+                const results = await ss.hybridSearch(args.query, {
+                    limit: args.limit,
+                    model: args.model,
+                    where: args.where,
+                });
+                return textResult(JSON.stringify(results, null, 2));
+            }
+            catch (error) {
+                return errorResult(`Search failed: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

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

package/dist/model-instance.d.ts

@@ -0,0 +1,11 @@
+import type { ModelDefinition, InferModelInstance } from "./types";
+import type { Document } from "./document";
+import type { Collection } from "./collection";
+/**
+ * Creates a model instance from a document and its model definition.
+ *
+ * This is the central factory function. Every typed model instance
+ * in contentbase is created here.
+ */
+export declare function createModelInstance<TDef extends ModelDefinition<any, any, any, any, any>>(document: Document, definition: TDef, collection: Collection): InferModelInstance<TDef>;
+//# sourceMappingURL=model-instance.d.ts.map

package/dist/model-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-instance.d.ts","sourceRoot":"","sources":["../src/model-instance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAMnB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAErD,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,IAAI,EAChB,UAAU,EAAE,UAAU,GACrB,kBAAkB,CAAC,IAAI,CAAC,CAqO1B"}