contentbase 0.4.0 → 0.4.2

package/dist/cli/commands/extract.js

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+import picomatch from 'picomatch';
+import yaml from 'js-yaml';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+import { stringifyAst } from '../../utils/stringify-ast.js';
+const argsSchema = z.object({
+    sections: z.string().optional(),
+    s: z.string().optional(),
+    title: z.string().optional(),
+    t: z.string().optional(),
+    frontmatter: z.boolean().default(false),
+    noNormalizeHeadings: z.boolean().default(false),
+    contentFolder: z.string().optional(),
+});
+async function handler(options, context) {
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+    });
+    const target = context.container.argv._[1];
+    if (!target) {
+        console.error('Usage: cnotes extract <target> --sections "Section1,Section2"');
+        process.exit(1);
+    }
+    const sectionsArg = options.sections || options.s;
+    if (!sectionsArg) {
+        console.error('--sections is required');
+        process.exit(1);
+    }
+    const sectionNames = sectionsArg
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const includeFrontmatter = options.frontmatter;
+    const noNormalize = options.noNormalizeHeadings;
+    const title = options.title || options.t;
+    const isMatch = picomatch(target);
+    const matchingIds = collection.available.filter((id) => isMatch(id));
+    if (matchingIds.length === 0) {
+        console.error(`No documents matched: ${target}`);
+        process.exit(1);
+    }
+    const allNodes = [];
+    if (title) {
+        allNodes.push({
+            type: 'heading',
+            depth: 1,
+            children: [{ type: 'text', value: title }],
+        });
+    }
+    for (const id of matchingIds) {
+        const doc = collection.document(id);
+        if (includeFrontmatter && Object.keys(doc.meta).length > 0) {
+            allNodes.push({
+                type: 'yaml',
+                value: yaml.dump(doc.meta).trim(),
+            });
+        }
+        const docNodes = [];
+        const titleNode = doc.nodes.firstHeading;
+        if (titleNode) {
+            docNodes.push(titleNode);
+        }
+        const leading = doc.nodes.leadingElementsAfterTitle;
+        if (leading.length > 0) {
+            docNodes.push(...leading);
+        }
+        for (const name of sectionNames) {
+            try {
+                const sectionNodes = doc.extractSection(name);
+                if (sectionNodes.length > 0) {
+                    docNodes.push(...sectionNodes);
+                }
+            }
+            catch {
+                // Section not found — skip
+            }
+        }
+        if (!noNormalize && docNodes.length > 0) {
+            const headings = docNodes.filter((n) => n.type === 'heading');
+            if (headings.length > 0) {
+                const minDepth = Math.min(...headings.map((h) => h.depth));
+                const targetDepth = title ? 2 : 1;
+                const shift = targetDepth - minDepth;
+                if (shift !== 0) {
+                    for (const h of headings) {
+                        h.depth = Math.max(1, Math.min(6, h.depth + shift));
+                    }
+                }
+            }
+        }
+        allNodes.push(...docNodes);
+    }
+    const combinedAst = { type: 'root', children: allNodes };
+    console.log(stringifyAst(combinedAst).trim());
+}
+commands.register('extract', {
+    description: 'Extract specific sections from documents',
+    usage: '<glob>',
+    help: `# cnotes extract
+
+Extract specific sections from one or more documents. Supports glob patterns for matching multiple documents and outputs clean markdown with normalized headings.
+
+## Usage
+
+\`\`\`
+cnotes extract <target> --sections "Section1,Section2" [options]
+\`\`\`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| \`target\` | Path ID or glob pattern (e.g. \`epics/*\`, \`tasks/auth-*\`) |
+
+## Options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| \`--sections\` | \`-s\` | **Required.** Comma-separated section headings to extract |
+| \`--title\` | \`-t\` | Add a top-level H1 title to the output |
+| \`--frontmatter\` | | Include YAML frontmatter in the output |
+| \`--noNormalizeHeadings\` | | Skip heading depth normalization |
+| \`--contentFolder\` | | Path to content folder |
+
+## Heading Normalization
+
+By default, extracted headings are re-leveled so the output starts at H1 (or H2 when \`--title\` is used). Use \`--noNormalizeHeadings\` to preserve original depths.
+
+## Examples
+
+\`\`\`bash
+# Extract Overview from a single document
+cnotes extract epics/auth-system --sections "Overview"
+
+# Extract multiple sections
+cnotes extract tasks/login-bug -s "Overview,Requirements,Acceptance Criteria"
+
+# Extract from all epics with a title wrapper
+cnotes extract "epics/*" -s "Overview" -t "Epic Summaries"
+
+# Include frontmatter in output
+cnotes extract epics/auth-system -s "Overview" --frontmatter
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=extract.js.map

package/dist/cli/commands/extract.js.map

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

package/dist/cli/commands/help.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/help.ts"],"names":[],"mappings":""}

package/dist/cli/commands/help.js

@@ -0,0 +1,58 @@
+import { commands } from '../registry.js';
+async function handler(_options, context) {
+    const ui = context.container.feature('ui');
+    const lines = [
+        '# cnotes',
+        '',
+        'An ORM for structured Markdown/MDX files.',
+        '',
+        '## Usage',
+        '',
+        '```',
+        'cnotes <command> [options]',
+        '```',
+        '',
+        '## Commands',
+        '',
+        '| Command | Description |',
+        '|---------|-------------|',
+    ];
+    for (const name of commands.available) {
+        const def = commands.get(name);
+        const label = def.usage ? `${name} ${def.usage}` : name;
+        lines.push(`| \`${label}\` | ${def.description} |`);
+    }
+    lines.push('', '## Global Options', '', '| Option | Description |', '|--------|-------------|', '| `--help`, `-h` | Show help for a command |', '| `--contentFolder` | Path to content folder (most commands) |', '', '## Getting Help', '', '```bash', '# Show this overview', 'cnotes help', '', '# Show detailed help for a command', 'cnotes help serve', 'cnotes serve --help', '```');
+    console.log(ui.markdown(lines.join('\n')));
+}
+commands.register('help', {
+    description: 'Show available commands',
+    help: `# cnotes help
+
+Show available commands and usage information.
+
+## Usage
+
+\`\`\`
+cnotes help [command]
+\`\`\`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| \`command\` | Show detailed help for a specific command |
+
+## Examples
+
+\`\`\`bash
+# Show all commands
+cnotes help
+
+# Show help for the serve command
+cnotes help serve
+\`\`\`
+`,
+    handler,
+});
+//# sourceMappingURL=help.js.map

package/dist/cli/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/cli/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,KAAK,UAAU,OAAO,CAAC,QAAa,EAAE,OAA2B;IAC/D,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1C,MAAM,KAAK,GAAa;QACtB,UAAU;QACV,EAAE;QACF,2CAA2C;QAC3C,EAAE;QACF,UAAU;QACV,EAAE;QACF,KAAK;QACL,4BAA4B;QAC5B,KAAK;QACL,EAAE;QACF,aAAa;QACb,EAAE;QACF,2BAA2B;QAC3B,2BAA2B;KAC5B,CAAA;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAA;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QACvD,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,GAAG,CAAC,WAAW,IAAI,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mBAAmB,EACnB,EAAE,EACF,0BAA0B,EAC1B,0BAA0B,EAC1B,8CAA8C,EAC9C,gEAAgE,EAChE,EAAE,EACF,iBAAiB,EACjB,EAAE,EACF,SAAS,EACT,sBAAsB,EACtB,aAAa,EACb,EAAE,EACF,oCAAoC,EACpC,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,CACN,CAAA;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE;IACxB,WAAW,EAAE,yBAAyB;IACtC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBP;IACC,OAAO;CACR,CAAC,CAAA"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,18 @@
+import './init.js';
+import './create.js';
+import './inspect.js';
+import './validate.js';
+import './export.js';
+import './action.js';
+import './summary.js';
+import './teach.js';
+import './extract.js';
+import './mcp.js';
+import './serve.js';
+import './console.js';
+import './help.js';
+import './text-search.js';
+import './search.js';
+import './embed.js';
+import './update.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,CAAA;AAClB,OAAO,aAAa,CAAA;AACpB,OAAO,cAAc,CAAA;AACrB,OAAO,eAAe,CAAA;AACtB,OAAO,aAAa,CAAA;AACpB,OAAO,aAAa,CAAA;AACpB,OAAO,cAAc,CAAA;AACrB,OAAO,YAAY,CAAA;AACnB,OAAO,cAAc,CAAA;AACrB,OAAO,UAAU,CAAA;AACjB,OAAO,YAAY,CAAA;AACnB,OAAO,cAAc,CAAA;AACrB,OAAO,WAAW,CAAA;AAClB,OAAO,kBAAkB,CAAA;AACzB,OAAO,aAAa,CAAA;AACpB,OAAO,YAAY,CAAA;AACnB,OAAO,aAAa,CAAA"}

package/dist/cli/commands/index.js

@@ -0,0 +1,19 @@
+// Side-effect imports register each command
+import './init.js';
+import './create.js';
+import './inspect.js';
+import './validate.js';
+import './export.js';
+import './action.js';
+import './summary.js';
+import './teach.js';
+import './extract.js';
+import './mcp.js';
+import './serve.js';
+import './console.js';
+import './help.js';
+import './text-search.js';
+import './search.js';
+import './embed.js';
+import './update.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,WAAW,CAAA;AAClB,OAAO,aAAa,CAAA;AACpB,OAAO,cAAc,CAAA;AACrB,OAAO,eAAe,CAAA;AACtB,OAAO,aAAa,CAAA;AACpB,OAAO,aAAa,CAAA;AACpB,OAAO,cAAc,CAAA;AACrB,OAAO,YAAY,CAAA;AACnB,OAAO,cAAc,CAAA;AACrB,OAAO,UAAU,CAAA;AACjB,OAAO,YAAY,CAAA;AACnB,OAAO,cAAc,CAAA;AACrB,OAAO,WAAW,CAAA;AAClB,OAAO,kBAAkB,CAAA;AACzB,OAAO,aAAa,CAAA;AACpB,OAAO,YAAY,CAAA;AACnB,OAAO,aAAa,CAAA"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":""}

package/dist/cli/commands/init.js

@@ -0,0 +1,82 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { commands } from '../registry.js';
+async function handler(_options, context) {
+    const name = context.container.argv._[1] || 'my-content';
+    const dir = path.resolve(process.cwd(), name);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.mkdir(path.join(dir, 'posts'), { recursive: true });
+    await fs.writeFile(path.join(dir, 'models.ts'), `import { defineModel, z } from "contentbase";
+
+export const Post = defineModel("Post", {
+  prefix: "posts",
+  meta: z.object({
+    status: z.enum(["draft", "published"]).default("draft"),
+    author: z.string().optional(),
+  }),
+});
+`, 'utf8');
+    await fs.writeFile(path.join(dir, 'posts', 'hello-world.md'), `---
+status: draft
+author: me
+---
+
+# Hello World
+
+Welcome to your contentbase project!
+`, 'utf8');
+    await fs.writeFile(path.join(dir, 'index.ts'), `import { Collection } from "contentbase";
+import { Post } from "./models";
+
+export const collection = new Collection({
+  rootPath: import.meta.dir,
+});
+
+collection.register(Post);
+`, 'utf8');
+    console.log(`Created contentbase project at ${dir}`);
+    console.log(`  ${name}/models.ts`);
+    console.log(`  ${name}/index.ts`);
+    console.log(`  ${name}/posts/hello-world.md`);
+}
+commands.register('init', {
+    description: 'Initialize a new contentbase project',
+    usage: '[name]',
+    help: `# cnotes init
+
+Scaffold a new contentbase project with a sample model and document.
+
+## Usage
+
+\`\`\`
+cnotes init [name]
+\`\`\`
+
+## Arguments
+
+| Argument | Description | Default |
+|----------|-------------|---------|
+| \`name\` | Directory name for the project | \`my-content\` |
+
+## What It Creates
+
+- \`<name>/models.ts\` — Model definitions with a sample Post model
+- \`<name>/index.ts\` — Collection entry point
+- \`<name>/posts/hello-world.md\` — Sample document
+
+## Examples
+
+\`\`\`bash
+# Create with default name
+cnotes init
+
+# Create with custom name
+cnotes init docs
+
+# Create in a subdirectory
+cnotes init content/blog
+\`\`\`
+`,
+    handler,
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,KAAK,UAAU,OAAO,CAAC,QAAa,EAAE,OAA2B;IAC/D,MAAM,IAAI,GAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAY,IAAI,YAAY,CAAA;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAA;IAE7C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE5D,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAC3B;;;;;;;;;CASH,EACG,MAAM,CACP,CAAA;IAED,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,gBAAgB,CAAC,EACzC;;;;;;;;CAQH,EACG,MAAM,CACP,CAAA;IAED,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAC1B;;;;;;;;CAQH,EACG,MAAM,CACP,CAAA;IAED,OAAO,CAAC,GAAG,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAA;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,YAAY,CAAC,CAAA;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC,CAAA;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAA;AAC/C,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE;IACxB,WAAW,EAAE,sCAAsC;IACnD,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCP;IACC,OAAO;CACR,CAAC,CAAA"}

package/dist/cli/commands/inspect.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":""}

package/dist/cli/commands/inspect.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+const argsSchema = z.object({
+    contentFolder: z.string().optional(),
+});
+async function handler(options) {
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+    });
+    console.log(collection.generateModelSummary());
+}
+commands.register('inspect', {
+    description: 'Display collection info and registered models',
+    help: `# cnotes inspect
+
+Display a summary of the collection: registered models, their fields, sections, relationships, and document counts.
+
+## Usage
+
+\`\`\`
+cnotes inspect [options]
+\`\`\`
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| \`--contentFolder\` | Path to content folder |
+
+## Output
+
+Shows for each model:
+- Prefix and document count
+- Meta field definitions (name, type, required, default)
+- Section headings
+- Relationships (belongsTo, hasMany)
+- Computed properties and named scopes
+
+## Examples
+
+\`\`\`bash
+# Inspect current directory's collection
+cnotes inspect
+
+# Inspect a specific content folder
+cnotes inspect --contentFolder test/fixtures/sdlc
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=inspect.js.map

package/dist/cli/commands/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAA;AAEF,KAAK,UAAU,OAAO,CAAC,OAAmC;IACxD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE;IAC3B,WAAW,EAAE,+CAA+C;IAC5D,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCP;IACC,UAAU;IACV,OAAO;CACR,CAAC,CAAA"}

package/dist/cli/commands/mcp.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/cli/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":""}

package/dist/cli/commands/mcp.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { commands } from '../registry.js';
+import { startMcpServer } from '../../mcp/server.js';
+const argsSchema = z.object({
+    transport: z.enum(['stdio', 'http']).default('stdio'),
+    port: z.number().default(3003),
+    contentFolder: z.string().optional(),
+    modulePath: z.string().optional(),
+    mcpCompat: z.enum(['standard', 'codex']).optional(),
+    stdioCompat: z.enum(['standard', 'codex', 'auto']).optional(),
+    watch: z.boolean().default(true),
+});
+async function handler(options, context) {
+    const container = context.container;
+    // Resolve content folder: positional arg > --contentFolder > ./docs
+    const positionalFolder = container.argv._[1];
+    const contentFolder = positionalFolder || options.contentFolder || undefined;
+    const modulePath = options.modulePath || undefined;
+    await startMcpServer(container, {
+        transport: options.transport,
+        port: options.port,
+        contentFolder,
+        modulePath,
+        mcpCompat: options.mcpCompat,
+        stdioCompat: options.stdioCompat,
+        watch: options.watch,
+    });
+}
+commands.register('mcp', {
+    description: 'Start an MCP server for AI agents to query and manage structured markdown content',
+    help: `# cnotes mcp
+
+Start an MCP (Model Context Protocol) server that exposes collection tools, resources, and prompts for AI agents. Supports both stdio and HTTP transports.
+
+## Usage
+
+\`\`\`
+cnotes mcp [contentFolder] [options]
+\`\`\`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| \`contentFolder\` | Path to content folder (positional or via \`--contentFolder\`) |
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| \`--transport\` | \`stdio\` | Transport mode: \`stdio\` or \`http\` |
+| \`--port\` | \`3003\` | Port for HTTP transport |
+| \`--mcpCompat\` | \`standard\` | HTTP compatibility profile: \`standard\` or \`codex\` (or set \`MCP_HTTP_COMPAT\`) |
+| \`--stdioCompat\` | \`standard\` | Stdio framing profile: \`standard\`, \`codex\`, or \`auto\` (or set \`MCP_STDIO_COMPAT\`) |
+| \`--modulePath\` | | Path to collection entry module |
+| \`--contentFolder\` | | Path to content folder |
+| \`--disable-watch\` | \`false\` | Disable file watching for automatic collection refresh |
+
+## Exposed Capabilities
+
+**Tools:** read_me, inspect, get_model_info, list_documents, query, search_content, text_search, keyword_search, semantic_search, hybrid_search, validate, create_document, update_document, update_section, delete_document, run_action
+
+**Resources:** schema, table of contents, models summary, primer, per-document resources
+
+**Prompts:** create-<model>, review-document, teach, query-guide
+
+## Examples
+
+\`\`\`bash
+# Start with stdio (for Claude Desktop, Cursor, etc.)
+cnotes mcp
+
+# Start with HTTP transport
+cnotes mcp --transport http --port 3003
+
+# Start with Codex HTTP compatibility mode
+cnotes mcp --transport http --port 3003 --mcpCompat codex
+
+# Start with Codex stdio framing mode
+cnotes mcp --stdioCompat codex
+
+# Serve a specific content folder
+cnotes mcp ./docs
+
+# Use in claude_desktop_config.json
+# { "command": "cnotes", "args": ["mcp", "./docs"] }
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=mcp.js.map

package/dist/cli/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnD,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACjC,CAAC,CAAA;AAEF,KAAK,UAAU,OAAO,CAAC,OAAmC,EAAE,OAA2B;IACrF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IAEnC,oEAAoE;IACpE,MAAM,gBAAgB,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAuB,CAAA;IAClE,MAAM,aAAa,GAAG,gBAAgB,IAAI,OAAO,CAAC,aAAa,IAAI,SAAS,CAAA;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAA;IAElD,MAAM,cAAc,CAAC,SAAS,EAAE;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,aAAa;QACb,UAAU;QACV,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAA;AACJ,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB,WAAW,EAAE,mFAAmF;IAChG,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDP;IACC,UAAU;IACV,OAAO;CACR,CAAC,CAAA"}

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":""}