contentbase 0.2.0 → 0.4.1

package/dist/cli/commands/create.js

@@ -0,0 +1,185 @@
+import { z } from 'zod';
+import fs from 'fs/promises';
+import path from 'path';
+import matter from 'gray-matter';
+import { execSync } from 'child_process';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+import { kebabCase } from '../../utils/inflect.js';
+import { introspectMetaSchema } from '../../collection.js';
+const argsSchema = z.object({
+    title: z.string().optional(),
+    contentFolder: z.string().optional(),
+    openEditor: z.boolean().optional(),
+});
+async function handler(options, context) {
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+    });
+    const modelName = context.container.argv._[1];
+    if (!modelName) {
+        console.error('Usage: cnotes create <model> --title "Document Title"');
+        process.exit(1);
+    }
+    const title = options.title;
+    if (!title) {
+        console.error('--title is required');
+        process.exit(1);
+    }
+    const def = collection.getModelDefinition(modelName) ??
+        collection.modelDefinitions.find((d) => d.name.toLowerCase() === modelName.toLowerCase());
+    if (!def) {
+        console.error(`Model "${modelName}" not found. Available: ${collection.modelDefinitions.map((d) => d.name).join(', ')}`);
+        process.exit(1);
+    }
+    // Parse --meta.* flags from raw argv
+    // minimist nests dotted keys: --meta.status active → { meta: { status: 'active' } }
+    const metaOverrides = {};
+    const rawMeta = context.container.argv.meta;
+    if (rawMeta && typeof rawMeta === 'object') {
+        Object.assign(metaOverrides, rawMeta);
+    }
+    // Build meta from priority layers: zod defaults < definition.defaults < template frontmatter < CLI overrides
+    const zodDefaults = {};
+    for (const field of introspectMetaSchema(def.meta)) {
+        if (field.defaultValue !== undefined) {
+            zodDefaults[field.name] = field.defaultValue;
+        }
+    }
+    const definitionDefaults = def.defaults ?? {};
+    // Template lookup
+    const templateExtensions = ['md', 'mdx'];
+    let templateContent = null;
+    for (const ext of templateExtensions) {
+        const templatePath = path.resolve(collection.rootPath, 'templates', `${modelName.toLowerCase()}.${ext}`);
+        try {
+            templateContent = await fs.readFile(templatePath, 'utf8');
+            break;
+        }
+        catch {
+            // template not found, try next extension
+        }
+    }
+    let content;
+    if (templateContent) {
+        const parsed = matter(templateContent);
+        const mergedMeta = {
+            ...zodDefaults,
+            ...definitionDefaults,
+            ...parsed.data,
+            ...metaOverrides,
+        };
+        const body = parsed.content.replace(/^# .+$/m, `# ${title}`);
+        content = matter.stringify(body, mergedMeta);
+    }
+    else {
+        const mergedMeta = {
+            ...zodDefaults,
+            ...definitionDefaults,
+            ...metaOverrides,
+        };
+        const lines = [];
+        lines.push(`# ${title}`);
+        lines.push('');
+        const sections = def.sections ?? {};
+        for (const [, sec] of Object.entries(sections)) {
+            const s = sec;
+            lines.push(`## ${s.heading}`);
+            lines.push('');
+            if (s.schema?.description) {
+                lines.push(s.schema.description);
+                lines.push('');
+            }
+        }
+        content = matter.stringify(lines.join('\n'), mergedMeta);
+    }
+    const slug = kebabCase(title.toLowerCase());
+    const pathId = `${def.prefix}/${slug}`;
+    const filePath = path.resolve(collection.rootPath, `${pathId}.md`);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, 'utf8');
+    console.log(`Created ${filePath}`);
+    if (options.openEditor) {
+        const editor = process.env.EDITOR;
+        if (editor) {
+            execSync(`${editor} ${filePath}`, { stdio: 'inherit' });
+        }
+        else {
+            const candidates = ['cursor', 'code', 'vim'];
+            let found = false;
+            for (const cmd of candidates) {
+                try {
+                    execSync(`which ${cmd}`, { stdio: 'ignore' });
+                    execSync(`${cmd} ${filePath}`, { stdio: 'inherit' });
+                    found = true;
+                    break;
+                }
+                catch {
+                    // not available, try next
+                }
+            }
+            if (!found) {
+                console.error('No editor found. Tried: cursor, code, vim. Set $EDITOR to your preferred editor.');
+                process.exit(1);
+            }
+        }
+    }
+}
+commands.register('create', {
+    description: 'Create a new document for a model type',
+    usage: '<model>',
+    help: `# cnotes create
+
+Create a new document for a registered model, with proper frontmatter defaults and section scaffolding.
+
+## Usage
+
+\`\`\`
+cnotes create <model> --title "Document Title" [options]
+\`\`\`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| \`model\` | Model name (e.g. \`Post\`, \`Epic\`, \`Task\`) |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| \`--title\` | **Required.** Title for the new document (used as H1 and slug) |
+| \`--meta.*\` | Set frontmatter fields (e.g. \`--meta.status active\`) |
+| \`--open-editor\` | Open the new file in your editor ($EDITOR, or tries cursor/code/vim) |
+| \`--contentFolder\` | Path to content folder |
+
+## Template Lookup
+
+If \`templates/<model>.md\` (or \`.mdx\`) exists in the content root, it will be used as the document scaffold. Template frontmatter is merged with schema defaults and CLI overrides.
+
+## Meta Priority
+
+Frontmatter values are merged in this order (last wins):
+
+1. Zod schema defaults
+2. Model definition defaults
+3. Template frontmatter
+4. CLI \`--meta.*\` overrides
+
+## Examples
+
+\`\`\`bash
+# Create a new post
+cnotes create Post --title "My First Post"
+
+# Create with meta overrides
+cnotes create Task --title "Fix login bug" --meta.status active --meta.priority high
+
+# Create from a different content folder
+cnotes create Epic --title "Auth System" --contentFolder ./docs
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=create.js.map

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

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

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

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

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

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

package/dist/cli/commands/embed.js

@@ -0,0 +1,231 @@
+import { z } from 'zod';
+import { existsSync, accessSync, constants as fsConstants } from 'node:fs';
+import path from 'node:path';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+import { collectDocumentInputs } from '../../search/document-inputs.js';
+import { createSemanticSearch, ensureSemanticSearchAttached, getInitializedSemanticSearch, hasSearchIndex, loadSemanticSearchClass } from '../../search/luca-semantic-search.js';
+const argsSchema = z.object({
+    force: z.boolean().default(false),
+    provider: z.enum(['local', 'openai']).default('openai'),
+    status: z.boolean().default(false),
+    local: z.boolean().default(false),
+    installLocal: z.boolean().default(false),
+    contentFolder: z.string().optional(),
+});
+function isLocalInstalled() {
+    const modulePath = path.join(process.cwd(), 'node_modules', 'node-llama-cpp');
+    try {
+        return existsSync(modulePath);
+    }
+    catch {
+        return false;
+    }
+}
+async function installLocal(SemanticSearch, container) {
+    const cwd = process.cwd();
+    const nodeModules = path.join(cwd, 'node_modules');
+    // Check permissions
+    try {
+        if (existsSync(nodeModules)) {
+            accessSync(nodeModules, fsConstants.W_OK);
+        }
+    }
+    catch {
+        const version = SemanticSearch.PINNED_LLAMA_VERSION;
+        const cmd = detectInstallCommand(cwd, version);
+        console.error(`Cannot write to ${nodeModules}.`);
+        console.error(`Run manually with elevated permissions:\n  ${cmd}`);
+        process.exit(1);
+    }
+    console.error(`Installing node-llama-cpp@${SemanticSearch.PINNED_LLAMA_VERSION}...`);
+    // Create a temporary instance to use the install method
+    await ensureSemanticSearchAttached(container, SemanticSearch);
+    const ss = await createSemanticSearch(container, cwd, {
+        dbPath: path.join(cwd, '.contentbase/search.sqlite'),
+        embeddingProvider: 'local',
+    });
+    try {
+        await ss.installLocalEmbeddings(cwd);
+        console.log(`node-llama-cpp@${SemanticSearch.PINNED_LLAMA_VERSION} installed successfully.`);
+    }
+    catch (err) {
+        const msg = err?.message ?? String(err);
+        if (msg.includes('network') || msg.includes('ETIMEDOUT') || msg.includes('ENOTFOUND')) {
+            console.error(`Install failed (network unreachable). To use local embeddings offline, manually install node-llama-cpp@${SemanticSearch.PINNED_LLAMA_VERSION} into this project.`);
+        }
+        else {
+            console.error(msg);
+        }
+        process.exit(1);
+    }
+}
+function detectInstallCommand(cwd, version) {
+    const pkg = `node-llama-cpp@${version}`;
+    if (existsSync(path.join(cwd, 'bun.lockb')) || existsSync(path.join(cwd, 'bun.lock'))) {
+        return `bun add --optional ${pkg}`;
+    }
+    else if (existsSync(path.join(cwd, 'pnpm-lock.yaml'))) {
+        return `pnpm add --save-optional ${pkg}`;
+    }
+    else if (existsSync(path.join(cwd, 'yarn.lock'))) {
+        return `yarn add --optional ${pkg}`;
+    }
+    return `npm install --save-optional ${pkg}`;
+}
+async function handler(options, { container }) {
+    const SemanticSearch = await loadSemanticSearchClass();
+    // --install-local: install node-llama-cpp only, then exit
+    if (options.installLocal) {
+        if (isLocalInstalled()) {
+            console.log('node-llama-cpp is already installed. Skipping.');
+            return;
+        }
+        await installLocal(SemanticSearch, container);
+        return;
+    }
+    // Resolve effective provider: --local flag overrides --provider
+    const provider = options.local ? 'local' : options.provider;
+    // --local: auto-install if needed
+    if (options.local && !isLocalInstalled()) {
+        await installLocal(SemanticSearch, container);
+    }
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+    });
+    // --status: show index health without modifying anything
+    if (options.status) {
+        if (!hasSearchIndex(collection.rootPath)) {
+            console.log('No search index found.');
+            console.log(`Documents in collection: ${collection.available.length}`);
+            console.log(`\nRun: cnotes embed`);
+            return;
+        }
+        const ss = await getInitializedSemanticSearch(container, collection.rootPath, {
+            embeddingProvider: provider,
+        });
+        const stats = ss.getStats();
+        console.log('Search Index Status');
+        console.log('-------------------');
+        console.log(`Documents indexed:  ${stats.documentCount}`);
+        console.log(`Chunks created:     ${stats.chunkCount}`);
+        console.log(`Embeddings stored:  ${stats.embeddingCount}`);
+        console.log(`Last indexed:       ${stats.lastIndexedAt ?? 'never'}`);
+        console.log(`Provider:           ${stats.provider}`);
+        console.log(`Model:              ${stats.model}`);
+        console.log(`Dimensions:         ${stats.dimensions}`);
+        console.log(`Database size:      ${formatBytes(stats.dbSizeBytes)}`);
+        console.log(`Collection docs:    ${collection.available.length}`);
+        // Check for staleness
+        const docs = collectDocumentInputs(collection);
+        const stale = docs.filter((d) => ss.needsReindex(d)).length;
+        if (stale > 0) {
+            console.log(`Stale documents:    ${stale}`);
+        }
+        else {
+            console.log(`Status:             up to date`);
+        }
+        return;
+    }
+    // Embed / re-embed
+    const ss = await getInitializedSemanticSearch(container, collection.rootPath, {
+        embeddingProvider: provider,
+    });
+    const docs = collectDocumentInputs(collection);
+    const startTime = Date.now();
+    if (options.force) {
+        console.error('Clearing existing index...');
+        await ss.reindex();
+    }
+    const toIndex = options.force ? docs : docs.filter((d) => ss.needsReindex(d));
+    // Remove stale
+    ss.removeStale(docs.map((d) => d.pathId));
+    if (toIndex.length === 0) {
+        console.log('All documents are up to date. Nothing to embed.');
+        const stats = ss.getStats();
+        printStats(stats, 0, Date.now() - startTime);
+        return;
+    }
+    console.error(`Embedding ${toIndex.length} of ${docs.length} document(s)...`);
+    console.error(`Provider: ${provider}`);
+    const batchSize = 5;
+    for (let i = 0; i < toIndex.length; i += batchSize) {
+        const batch = toIndex.slice(i, i + batchSize);
+        await ss.indexDocuments(batch);
+        const done = Math.min(i + batchSize, toIndex.length);
+        const pct = Math.round((done / toIndex.length) * 100);
+        const elapsed = Date.now() - startTime;
+        const eta = toIndex.length > done
+            ? Math.round((elapsed / done) * (toIndex.length - done) / 1000)
+            : 0;
+        const etaStr = eta > 0 ? ` ETA: ${eta}s` : '';
+        console.error(`  [${pct}%] ${done}/${toIndex.length} documents${etaStr}`);
+    }
+    const elapsed = Date.now() - startTime;
+    const stats = ss.getStats();
+    printStats(stats, toIndex.length, elapsed);
+}
+function printStats(stats, indexed, elapsedMs) {
+    console.log();
+    console.log('Embedding complete.');
+    if (indexed > 0)
+        console.log(`  Documents indexed: ${indexed}`);
+    console.log(`  Total documents:   ${stats.documentCount}`);
+    console.log(`  Total chunks:      ${stats.chunkCount}`);
+    console.log(`  Embeddings:        ${stats.embeddingCount}`);
+    console.log(`  Time elapsed:      ${(elapsedMs / 1000).toFixed(1)}s`);
+    console.log(`  Database size:     ${formatBytes(stats.dbSizeBytes)}`);
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+commands.register('embed', {
+    description: 'Generate embeddings for collection documents',
+    help: `# cnotes embed
+
+Generate or update vector embeddings for all documents in the collection. Required before using \`cnotes search\`.
+
+## Usage
+
+\`\`\`
+cnotes embed [options]
+\`\`\`
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| \`--force\` | \`false\` | Re-embed everything (ignore content hashes) |
+| \`--provider\` | \`openai\` | Embedding provider: \`openai\` or \`local\` |
+| \`--status\` | \`false\` | Show index health without embedding |
+| \`--local\` | \`false\` | Use local embeddings; auto-installs node-llama-cpp if not found |
+| \`--install-local\` | \`false\` | Only install node-llama-cpp (no embedding), then exit |
+| \`--contentFolder\` | | Path to content folder |
+
+## Examples
+
+\`\`\`bash
+# Generate/update embeddings (uses OpenAI by default)
+cnotes embed
+
+# Re-embed everything from scratch
+cnotes embed --force
+
+# Use local embeddings (auto-installs node-llama-cpp if needed)
+cnotes embed --local
+
+# Only install node-llama-cpp without embedding
+cnotes embed --install-local
+
+# Show index health
+cnotes embed --status
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=embed.js.map

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

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

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

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

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

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

package/dist/cli/commands/export.js

@@ -0,0 +1,55 @@
+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,
+    });
+    const data = await collection.export();
+    console.log(JSON.stringify(data, null, 2));
+}
+commands.register('export', {
+    description: 'Export collection as JSON',
+    help: `# cnotes export
+
+Export the entire collection as a JSON object. Each document includes its path ID, title, frontmatter, content, and model info.
+
+## Usage
+
+\`\`\`
+cnotes export [options]
+\`\`\`
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| \`--contentFolder\` | Path to content folder |
+
+## Output
+
+Writes JSON to stdout. Pipe to a file or another tool.
+
+## Examples
+
+\`\`\`bash
+# Export to stdout
+cnotes export
+
+# Save to a file
+cnotes export > backup.json
+
+# Export a specific content folder
+cnotes export --contentFolder ./docs > docs.json
+
+# Pipe to jq for filtering
+cnotes export | jq '.[] | select(.meta.status == "published")'
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=export.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/cli/commands/export.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,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAA;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;IAC1B,WAAW,EAAE,2BAA2B;IACxC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCP;IACC,UAAU;IACV,OAAO;CACR,CAAC,CAAA"}

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

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

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

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

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