contentbase 0.4.0 → 0.4.1

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+export { Collection, introspectMetaSchema } from "./collection";
+export type { FieldInfo } from "./collection";
+export { Document } from "./document";
+export { AstQuery } from "./ast-query";
+export { NodeShortcuts } from "./node-shortcuts";
+export { parse } from "./parse";
+export type { ParsedDocument } from "./parse";
+export { extractSections } from "./extract-sections";
+export type { ExtractionEntry, ExtractSectionsOptions, SectionSource, } from "./extract-sections";
+export { defineModel, generateDescription } from "./define-model";
+export { Base } from "./base-model";
+export { section } from "./section";
+export { hasMany, belongsTo } from "./relationships/index";
+export { CollectionQuery } from "./query/collection-query";
+export { QueryBuilder } from "./query/query-builder";
+export { queryDSLSchema, parseWhereClause, parseSortClause, executeQueryDSL, } from "./query/query-dsl";
+export type { QueryDSL } from "./query/query-dsl";
+export { createModelInstance } from "./model-instance";
+export { validateDocument } from "./validator";
+export { matchPattern, matchPatterns } from "./utils/match-pattern";
+export { stripMarkdown } from "./utils/strip-markdown";
+export type { StripMarkdownOptions } from "./utils/strip-markdown";
+import { toString } from "mdast-util-to-string";
+export { NodeStorageAdapter } from "./adapters/node-fs";
+export type { ModelDefinition, InferModelInstance, SectionDefinition, HasManyDefinition, BelongsToDefinition, RelationshipDefinition, CollectionItem, CollectionOptions, HasManyAccessor, BelongsToAccessor, ValidationResult, SerializeOptions, SaveOptions, DocumentRef, StorageAdapter, FileStat, FileEntry, } from "./types";
+export { z } from "zod";
+export { toString };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+// Core classes
+export { Collection, introspectMetaSchema } from "./collection";
+export { Document } from "./document";
+export { AstQuery } from "./ast-query";
+export { NodeShortcuts } from "./node-shortcuts";
+export { parse } from "./parse";
+export { extractSections } from "./extract-sections";
+// defineModel and helpers
+export { defineModel, generateDescription } from "./define-model";
+export { Base } from "./base-model";
+export { section } from "./section";
+export { hasMany, belongsTo } from "./relationships/index";
+// Query
+export { CollectionQuery } from "./query/collection-query";
+export { QueryBuilder } from "./query/query-builder";
+export { queryDSLSchema, parseWhereClause, parseSortClause, executeQueryDSL, } from "./query/query-dsl";
+// Model instance factory (advanced use)
+export { createModelInstance } from "./model-instance";
+// Validation
+export { validateDocument } from "./validator";
+// Pattern matching
+export { matchPattern, matchPatterns } from "./utils/match-pattern";
+// Markdown utilities
+export { stripMarkdown } from "./utils/strip-markdown";
+import { toString } from "mdast-util-to-string";
+// Storage adapters
+export { NodeStorageAdapter } from "./adapters/node-fs";
+// Re-export zod for convenience
+export { z } from "zod";
+export { toString };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOrD,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE3D,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,wCAAwC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpE,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAuBxD,gCAAgC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/mcp/helpers.d.ts

@@ -0,0 +1,14 @@
+export declare function errorResult(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function textResult(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM;;;;;;EAE1C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM;;;;;EAEtC"}

package/dist/mcp/helpers.js

@@ -0,0 +1,7 @@
+export function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/mcp/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAC/E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AACvD,CAAC"}

package/dist/mcp/model-info.d.ts

@@ -0,0 +1,2 @@
+export declare function generateModelInfo(collection: any, def: any): string;
+//# sourceMappingURL=model-info.d.ts.map

package/dist/mcp/model-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-info.d.ts","sourceRoot":"","sources":["../../src/mcp/model-info.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,UAmG1D"}

package/dist/mcp/model-info.js

@@ -0,0 +1,94 @@
+import { introspectMetaSchema } from '../index.js';
+export function generateModelInfo(collection, def) {
+    const lines = [];
+    const name = def.name;
+    const prefix = def.prefix;
+    const description = def.description || '';
+    const prefixDocs = collection.available.filter((id) => id.startsWith(prefix + '/'));
+    lines.push(`# Model: ${name}`, '');
+    lines.push(`- **Prefix:** \`${prefix}/\``);
+    lines.push(`- **Documents:** ${prefixDocs.length}`);
+    if (description)
+        lines.push(`- **Description:** ${description}`);
+    lines.push('');
+    // Fields
+    const fields = introspectMetaSchema(def.meta);
+    if (fields.length > 0) {
+        lines.push('## Frontmatter Fields', '');
+        lines.push('| Field | Type | Required | Default | Description |');
+        lines.push('|-------|------|----------|---------|-------------|');
+        for (const f of fields) {
+            const req = f.required ? 'yes' : 'no';
+            const def_val = f.defaultValue !== undefined ? `\`${JSON.stringify(f.defaultValue)}\`` : '';
+            const desc = f.description || '';
+            lines.push(`| ${f.name} | ${f.type} | ${req} | ${def_val} | ${desc} |`);
+        }
+        lines.push('');
+    }
+    // Sections
+    const sections = Object.entries(def.sections || {});
+    if (sections.length > 0) {
+        lines.push('## Sections', '');
+        for (const [key, sec] of sections) {
+            lines.push(`- **${sec.heading}** (key: \`${key}\`)${sec.schema ? ' — has schema validation' : ''}`);
+            if (sec.alternatives?.length) {
+                lines.push(`  Alternatives: ${sec.alternatives.join(', ')}`);
+            }
+        }
+        lines.push('');
+    }
+    // Relationships
+    const relationships = Object.entries(def.relationships || {});
+    if (relationships.length > 0) {
+        lines.push('## Relationships', '');
+        for (const [key, rel] of relationships) {
+            lines.push(`- \`${key}\` → ${rel.type} **${rel.model}**`);
+        }
+        lines.push('');
+    }
+    // Computed & Scopes
+    const computedKeys = Object.keys(def.computed || {});
+    if (computedKeys.length > 0) {
+        lines.push('## Computed Properties', '');
+        lines.push(computedKeys.map(k => `- \`${k}\``).join('\n'));
+        lines.push('');
+    }
+    const scopeKeys = Object.keys(def.scopes || {});
+    if (scopeKeys.length > 0) {
+        lines.push('## Named Scopes', '');
+        lines.push(scopeKeys.map(k => `- \`${k}\``).join('\n'));
+        lines.push('');
+    }
+    // Existing documents
+    if (prefixDocs.length > 0) {
+        lines.push('## Existing Documents', '');
+        for (const id of prefixDocs) {
+            lines.push(`- \`${id}\``);
+        }
+        lines.push('');
+    }
+    // Example scaffold
+    const defaultMeta = {};
+    for (const f of fields) {
+        if (f.defaultValue !== undefined) {
+            defaultMeta[f.name] = f.defaultValue;
+        }
+        else if (f.required) {
+            defaultMeta[f.name] = `<${f.type}>`;
+        }
+    }
+    const sectionHeadings = sections.map(([, sec]) => `## ${sec.heading}\n\n`);
+    lines.push('## Example Document', '');
+    lines.push('```markdown');
+    lines.push('---');
+    for (const [k, v] of Object.entries(defaultMeta)) {
+        lines.push(`${k}: ${typeof v === 'string' ? v : JSON.stringify(v)}`);
+    }
+    lines.push('---');
+    lines.push(`# Your Title Here`);
+    lines.push('');
+    lines.push(sectionHeadings.join(''));
+    lines.push('```');
+    return lines.join('\n');
+}
+//# sourceMappingURL=model-info.js.map

package/dist/mcp/model-info.js.map

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

package/dist/mcp/prompts.d.ts

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

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

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

package/dist/mcp/prompts.js

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { introspectMetaSchema, validateDocument } from '../index.js';
+export function registerPrompts(mcpServer, collection) {
+    const modelDefs = collection.modelDefinitions;
+    // Per-model creation prompts
+    for (const def of modelDefs) {
+        const modelName = def.name;
+        const promptName = `create-${modelName.toLowerCase()}`;
+        mcpServer.prompt(promptName, {
+            description: `Guide creation of a new ${modelName} document with proper schema and sections`,
+            args: {
+                title: z.string().describe('Title for the new document'),
+            },
+            handler: (args) => {
+                const fields = introspectMetaSchema(def.meta);
+                const sections = Object.entries(def.sections || {}).map(([key, sec]) => ({
+                    key,
+                    heading: sec.heading,
+                    hasSchema: !!sec.schema,
+                }));
+                const fieldDocs = fields.map((f) => `- **${f.name}** (${f.type}${f.required ? ', required' : ''})${f.description ? `: ${f.description}` : ''}${f.defaultValue !== undefined ? ` [default: ${JSON.stringify(f.defaultValue)}]` : ''}`).join('\n');
+                const sectionDocs = sections.map((s) => `- **${s.heading}** (key: \`${s.key}\`)${s.hasSchema ? ' — has schema validation' : ''}`).join('\n');
+                const content = [
+                    `# Create a new ${modelName}`,
+                    '',
+                    `Title: ${args.title || '(not specified)'}`,
+                    '',
+                    '## Frontmatter Fields',
+                    '',
+                    fieldDocs || '(no schema fields defined)',
+                    '',
+                    '## Sections',
+                    '',
+                    sectionDocs || '(no sections defined)',
+                    '',
+                    '## Instructions',
+                    '',
+                    `Use the \`create_document\` tool with model="${modelName}" and fill in the meta fields.`,
+                    'Then use `update_section` to populate each section with content.',
+                ].join('\n');
+                return [{ role: 'user', content }];
+            },
+        });
+    }
+    mcpServer.prompt('review-document', {
+        description: 'Fetch a document, run validation, and present it for review',
+        args: {
+            pathId: z.string().describe('Document path ID to review'),
+        },
+        handler: (args) => {
+            const pathId = args.pathId;
+            if (!pathId) {
+                return [{ role: 'user', content: 'Error: pathId argument is required.' }];
+            }
+            const doc = collection.document(pathId);
+            if (!doc) {
+                return [{ role: 'user', content: `Document not found: ${pathId}` }];
+            }
+            const def = collection.findModelDefinition(pathId);
+            let validationText = '';
+            if (def) {
+                const result = validateDocument(doc, def);
+                validationText = result.valid
+                    ? '\n**Validation: PASSED**\n'
+                    : `\n**Validation: FAILED**\n\nErrors:\n${result.errors.map((e) => `- ${e.path.join('.')}: ${e.message}`).join('\n')}\n`;
+            }
+            else {
+                validationText = '\n*No model definition found — validation skipped.*\n';
+            }
+            const content = [
+                `# Review: ${doc.title}`,
+                '',
+                `**Path:** ${pathId}`,
+                `**Model:** ${def ? def.name : 'untyped'}`,
+                validationText,
+                '## Outline',
+                '',
+                doc.toOutline(),
+                '',
+                '## Frontmatter',
+                '',
+                '```json',
+                JSON.stringify(doc.meta, null, 2),
+                '```',
+                '',
+                '## Content',
+                '',
+                doc.content,
+            ].join('\n');
+            return [{ role: 'user', content }];
+        },
+    });
+    mcpServer.prompt('teach', {
+        description: 'Full contentbase documentation — models, table of contents, CLI reference, and API primer. For a quick-start behavioral guide, use the `read_me` tool instead.',
+        handler: async () => {
+            const modelsSummary = collection.generateModelSummary();
+            const toc = collection.tableOfContents({ title: 'Table of Contents' });
+            const packageRoot = path.resolve(import.meta.dir, '../..');
+            let primer = '';
+            let cli = '';
+            try {
+                primer = await fs.readFile(path.join(packageRoot, 'PRIMER.md'), 'utf8');
+            }
+            catch { }
+            try {
+                cli = await fs.readFile(path.join(packageRoot, 'CLI.md'), 'utf8');
+            }
+            catch { }
+            const content = [
+                '> **Quick start:** Call the `read_me` tool for a concise behavioral guide. This prompt provides the full reference.',
+                '',
+                modelsSummary.trimEnd(),
+                '', '---', '',
+                toc.trimEnd(),
+                '', '---', '',
+                cli.trimEnd(),
+                '', '---', '',
+                primer.trimEnd(),
+            ].join('\n');
+            return [{ role: 'user', content }];
+        },
+    });
+    mcpServer.prompt('query-guide', {
+        description: 'Show available models, fields, and query operators to help build queries',
+        args: {
+            intent: z.string().optional().describe('What you want to find (helps tailor the guide)'),
+        },
+        handler: () => {
+            const modelsInfo = modelDefs.map((def) => {
+                const fields = introspectMetaSchema(def.meta);
+                const fieldList = fields.map((f) => `  - ${f.name} (${f.type})`).join('\n');
+                return `### ${def.name} (prefix: ${def.prefix})\n${fieldList || '  (no schema fields)'}`;
+            }).join('\n\n');
+            const content = [
+                '# Query Guide',
+                '',
+                '## Available Models',
+                '',
+                modelsInfo || '(no models registered)',
+                '',
+                '## Query Operators',
+                '',
+                '| Operator | Description | Example value |',
+                '|----------|-------------|---------------|',
+                '| eq | Exact equality (default) | `"published"` |',
+                '| in | Value is in array | `["draft", "published"]` |',
+                '| notIn | Value is not in array | `["archived"]` |',
+                '| gt / lt / gte / lte | Numeric/date comparison | `5` |',
+                '| contains | String contains substring | `"auth"` |',
+                '| startsWith / endsWith | String prefix/suffix | `"user-"` |',
+                '| regex | Regex pattern match | `"^v\\\\d+"` |',
+                '| exists / notExists | Field presence check | (no value needed) |',
+                '',
+                '## Example (MongoDB-style DSL)',
+                '',
+                '```json',
+                '{',
+                '  "model": "Epic",',
+                '  "where": {',
+                '    "meta.status": "active",',
+                '    "meta.priority": { "$in": ["high", "critical"] }',
+                '  },',
+                '  "sort": { "meta.priority": "desc" },',
+                '  "limit": 10',
+                '}',
+                '```',
+                '',
+                'Where value shortcuts:',
+                '- Literal value → implicit $eq: `"meta.status": "active"`',
+                '- Array → implicit $in: `"meta.tags": ["a", "b"]`',
+                '- Operator object: `"meta.priority": { "$gt": 5 }`',
+                '- Multiple operators: `"meta.priority": { "$gte": 3, "$lte": 8 }`',
+            ].join('\n');
+            return [{ role: 'user', content }];
+        },
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/mcp/prompts.js.map

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

package/dist/mcp/readme.d.ts

@@ -0,0 +1,2 @@
+export declare function generateReadMe(collection: any, modelDefs: any[]): string;
+//# sourceMappingURL=readme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../src/mcp/readme.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAsJ/D"}

package/dist/mcp/readme.js

@@ -0,0 +1,71 @@
+import { introspectMetaSchema } from '../index.js';
+export function generateReadMe(collection, modelDefs) {
+    const lines = [];
+    // Section 1: The Rules
+    const rootPath = collection.rootPath;
+    lines.push('# Contentbase Collection Guide', '', `> **This collection is located at \`${rootPath}\`.**`, '', '## Rules — READ CAREFULLY', '', `**Every markdown file under \`${rootPath}\` is a structured document governed by a model schema.** These are NOT freeform files. They have required frontmatter fields, expected section headings, and validation rules. Treat them accordingly.`, '', '1. **DO NOT write or edit markdown files directly** — not with Write, Edit, cat, echo, sed, or any other means. Use `create_document` to scaffold new documents. Use `update_section` to edit section content. Use `update_document` to change frontmatter. These tools ensure the document structure stays valid.', '2. **ALWAYS call `validate` after ANY mutation** — after creating, updating frontmatter, or editing sections. No exceptions. If validation fails, fix the document before moving on.', '3. **Use MCP tools to read content** — not cat, Read, or raw file access. Use `query` to fetch documents by criteria, `search_content` for full-text search, and `list_documents` for discovery.', '4. **A document\'s folder prefix = its model = its contract.** The prefix determines which schema governs the file — what frontmatter fields are required, what sections are expected, and what values are valid. Do not guess. Call `get_model_info` if you are unsure.', '5. **Every document MUST have a title** — either an H1 heading (`# Title`) or a `title` field in frontmatter. Validation will fail without one, unless the model sets `titleOptional: true`.', '');
+    // Section 2: Models in This Collection
+    lines.push('## Models in This Collection', '');
+    for (const def of modelDefs) {
+        const name = def.name;
+        const prefix = def.prefix;
+        const description = def.description || '';
+        const prefixDocs = collection.available.filter((id) => id.startsWith(prefix + '/'));
+        const docCount = prefixDocs.length;
+        lines.push(`### ${name}`, '');
+        lines.push(`- **Prefix:** \`${prefix}/\``);
+        lines.push(`- **Documents:** ${docCount}`);
+        if (description)
+            lines.push(`- **Description:** ${description}`);
+        lines.push('');
+        // Fields
+        const fields = introspectMetaSchema(def.meta);
+        if (fields.length > 0) {
+            lines.push('**Frontmatter Fields:**', '');
+            lines.push('| Field | Type | Required | Default | Description |');
+            lines.push('|-------|------|----------|---------|-------------|');
+            for (const f of fields) {
+                const req = f.required ? 'yes' : 'no';
+                const def_val = f.defaultValue !== undefined ? `\`${JSON.stringify(f.defaultValue)}\`` : '';
+                const desc = f.description || '';
+                lines.push(`| ${f.name} | ${f.type} | ${req} | ${def_val} | ${desc} |`);
+            }
+            lines.push('');
+        }
+        // Sections
+        const sections = Object.entries(def.sections || {});
+        if (sections.length > 0) {
+            lines.push('**Sections:**', '');
+            for (const [key, sec] of sections) {
+                lines.push(`- **${sec.heading}** (key: \`${key}\`)${sec.schema ? ' — validated' : ''}`);
+            }
+            lines.push('');
+        }
+        // Relationships
+        const relationships = Object.entries(def.relationships || {});
+        if (relationships.length > 0) {
+            lines.push('**Relationships:**', '');
+            for (const [key, rel] of relationships) {
+                lines.push(`- \`${key}\` → ${rel.type} **${rel.model}**`);
+            }
+            lines.push('');
+        }
+        // Computed & Scopes
+        const computedKeys = Object.keys(def.computed || {});
+        const scopeKeys = Object.keys(def.scopes || {});
+        if (computedKeys.length > 0)
+            lines.push(`**Computed:** ${computedKeys.join(', ')}`, '');
+        if (scopeKeys.length > 0)
+            lines.push(`**Scopes:** ${scopeKeys.join(', ')}`, '');
+    }
+    // Section 3: Capability Map
+    lines.push('## Capability Map', '', '| Intent | Tool |', '|--------|------|', '| Orientation & guidance | `read_me` |', '| See what models exist | `inspect` |', '| Deep-dive one model | `get_model_info` |', '| List documents | `list_documents` |', '| Find by criteria | `query` |', '| Full-text search | `search_content` |', '| File-level grep | `text_search` |', '| Keyword search (BM25) | `keyword_search` |', '| Semantic search (embeddings) | `semantic_search` |', '| Hybrid search (keyword + semantic) | `hybrid_search` |', '| Create new document | `create_document` |', '| Edit a section | `update_section` |', '| Update frontmatter | `update_document` |', '| Validate a document | `validate` |', '| Delete a document | `delete_document` |', '| Run a collection action | `run_action` |', '');
+    // Section 4: Workflow
+    lines.push('## Recommended Workflow', '', '1. **Orientation** — Call `read_me` (this tool) at the start of every session.', '2. **Discovery** — Use `list_documents` or `query` to find what exists.', '3. **Reading** — Use `query` with `select` to fetch specific fields, or read a document resource.', '4. **Creating** — Use `create_document` with the correct prefix. It scaffolds frontmatter and sections.', '5. **Editing** — Use `update_section` for targeted section edits, `update_document` for frontmatter.', '6. **Validation** — Always call `validate` after creating or editing.', '');
+    // Section 5: Query Quick Reference
+    lines.push('## Query Quick Reference', '', 'The `query` tool uses MongoDB-style DSL:', '', '- Literal value → `$eq`: `"meta.status": "active"`', '- Array → `$in`: `"meta.tags": ["a", "b"]`', '- Operator object: `"meta.priority": { "$gt": 5 }`', '- Operators: `$eq`, `$neq`, `$in`, `$notIn`, `$gt`, `$lt`, `$gte`, `$lte`, `$contains`, `$startsWith`, `$endsWith`, `$regex`, `$exists`', '- Supports `sort`, `limit`, `offset`, `select`, `scopes`, `method` (fetchAll/first/last/count)', '');
+    // Section 6: Document Anatomy
+    lines.push('## Document Anatomy', '', '```markdown', '---', 'field: value      # YAML frontmatter (model schema)', '---', '# Document Title  # H1 = title', '', '## Section Name   # H2 = sections (defined by model)', '', 'Content here...', '```');
+    return lines.join('\n');
+}
+//# sourceMappingURL=readme.js.map

package/dist/mcp/readme.js.map

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

package/dist/mcp/resources.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,QAoFhE"}

package/dist/mcp/resources.js

@@ -0,0 +1,85 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { buildSchemaJSON } from '../cli/commands/api/helpers.js';
+export function registerResources(mcpServer, collection) {
+    mcpServer.resource('contentbase://schema', {
+        name: 'Collection Schema',
+        description: 'JSON schema of all registered models — fields, sections, relationships, computed properties',
+        mimeType: 'application/json',
+        handler: () => JSON.stringify(buildSchemaJSON(collection), null, 2),
+    });
+    mcpServer.resource('contentbase://toc', {
+        name: 'Table of Contents',
+        description: 'Markdown table of contents for all documents in the collection',
+        mimeType: 'text/markdown',
+        handler: () => collection.tableOfContents({ title: 'Table of Contents' }),
+    });
+    mcpServer.resource('contentbase://models-summary', {
+        name: 'Models Summary',
+        description: 'Generated README.md describing all model definitions with attributes, sections, and relationships',
+        mimeType: 'text/markdown',
+        handler: () => collection.generateModelSummary(),
+    });
+    mcpServer.resource('contentbase://primer', {
+        name: 'Contentbase Primer',
+        description: 'Combined teach output — models summary, table of contents, CLI reference, and API primer',
+        mimeType: 'text/markdown',
+        handler: async () => {
+            const modelsSummary = collection.generateModelSummary();
+            const toc = collection.tableOfContents({ title: 'Table of Contents' });
+            const packageRoot = path.resolve(import.meta.dir, '../..');
+            let primer = '';
+            let cli = '';
+            try {
+                primer = await fs.readFile(path.join(packageRoot, 'PRIMER.md'), 'utf8');
+            }
+            catch { }
+            try {
+                cli = await fs.readFile(path.join(packageRoot, 'CLI.md'), 'utf8');
+            }
+            catch { }
+            return [
+                modelsSummary.trimEnd(),
+                '',
+                '---',
+                '',
+                toc.trimEnd(),
+                '',
+                '---',
+                '',
+                cli.trimEnd(),
+                '',
+                '---',
+                '',
+                primer.trimEnd(),
+                '',
+            ].join('\n');
+        },
+    });
+    // Per-document resources
+    for (const pathId of collection.available) {
+        const uri = `contentbase://documents/${pathId}`;
+        const doc = collection.document(pathId);
+        mcpServer.resource(uri, {
+            name: doc.title || pathId,
+            description: `Document: ${pathId}`,
+            mimeType: 'application/json',
+            handler: () => {
+                const d = collection.document(pathId);
+                const modelDef = collection.findModelDefinition(pathId);
+                return JSON.stringify({
+                    id: d.id,
+                    title: d.title,
+                    meta: d.meta,
+                    content: d.content,
+                    outline: d.toOutline(),
+                    model: modelDef?.name || null,
+                    createdAt: d.createdAt,
+                    updatedAt: d.updatedAt,
+                    size: d.size,
+                }, null, 2);
+            },
+        });
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,18 @@
+export interface McpServerOptions {
+    transport: 'stdio' | 'http';
+    port: number;
+    contentFolder?: string;
+    modulePath?: string;
+    mcpCompat?: 'standard' | 'codex';
+    stdioCompat?: 'standard' | 'codex' | 'auto';
+    watch?: boolean;
+}
+export declare function createMcpServer(container: any, options: McpServerOptions): Promise<{
+    mcpServer: any;
+    collection: import("../collection.js").Collection;
+}>;
+export declare function startMcpServer(container: any, options: McpServerOptions): Promise<{
+    mcpServer: any;
+    collection: import("../collection.js").Collection;
+}>;
+//# sourceMappingURL=server.d.ts.map