contentbit 0.1.1 → 0.2.0

package/dist/commands/agents.d.ts

@@ -0,0 +1,11 @@
+import type { Io } from '../run.js';
+export interface AgentOptions {
+    /** Install Claude Code skills; defaults to detecting a .claude/ directory. */
+    claude?: boolean;
+    /** Manage the AGENTS.md block; defaults to true. */
+    agentsMd?: boolean;
+}
+/** Install or refresh the agent integration. Shared by `agents` and `init`. */
+export declare function installAgentIntegration(cwd: string, options: AgentOptions, io: Io): Promise<void>;
+export declare function agentsCommand(args: string[], io: Io): Promise<number>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/commands/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AA2JnC,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,+EAA+E;AAC/E,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB3E"}

package/dist/commands/agents.js

@@ -0,0 +1,197 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parseArgs } from 'node:util';
+// Everything here is static and project-independent by design: skills fetch
+// live data (authoring guide, stats, diagnostics) by running the CLI, so the
+// registry stays the single source of truth and nothing can drift. Bump the
+// frontmatter version when a template changes; `contentbit agents` re-runs
+// overwrite in place.
+const TEMPLATE_VERSION = 1;
+const AUTHOR_SKILL = `---
+name: contentbit-author
+description: |
+  Write or edit contentbit Markdown content (directive blocks like :::callout).
+  Use when asked to create or modify content documents in a project that uses
+  contentbit — blog posts, docs pages, changelogs, any Markdown covered by
+  \`contentbit validate\`.
+version: ${TEMPLATE_VERSION}
+---
+
+# Writing contentbit content
+
+contentbit documents are plain Markdown plus directive blocks
+(\`:::name{props} ... :::\`). Every block has a schema. Never guess block names,
+props, or body shapes — fetch the live guide from the project's registry first.
+
+## Find the project conventions
+
+Check \`package.json\` for a \`content:check\` script. It holds the canonical
+validate invocation for this project: the content glob and, if present, the
+\`--registry <path>\` flag pointing at custom block definitions. Reuse both
+below. No script? Default to \`content/**/*.md\` with no \`--registry\` flag.
+
+## The loop
+
+1. **Fetch the authoring guide** (always — it covers this project's custom blocks):
+
+   \`\`\`sh
+   contentbit instructions --audience llm [--registry <path from content:check>]
+   \`\`\`
+
+   Read it before writing. It documents every available block: props, body
+   shape, and when to use or avoid it.
+
+2. **Write the document.** Plain Markdown everywhere; blocks only where the
+   guide's use-when guidance fits. Keep frontmatter consistent with sibling
+   documents in the same folder.
+
+3. **Validate and fix until clean:**
+
+   \`\`\`sh
+   contentbit validate <file> [--registry <path>]
+   \`\`\`
+
+   Diagnostics print to stderr as \`file:line:col severity CODE message\`, often
+   with a \`hint:\` line suggesting the fix. Exit 0 means clean; exit 1 means
+   errors remain. Fix every diagnostic and re-run. Never finish with a failing
+   validate.
+
+## Failure modes
+
+- \`contentbit\` not found or no registry resolvable: the project is not set up.
+  Say so and suggest \`npx contentbit@latest init\` — do not invent block syntax.
+- A block you want does not exist: use plain Markdown, or ask whether to define
+  a custom block in the registry. Never emit an unregistered block name.
+`;
+const AUDIT_SKILL = `---
+name: contentbit-audit
+description: |
+  Audit contentbit Markdown content health using document stats. Use when asked
+  to audit, review, or find improvements across content — thin pages, missing
+  structure, validation issues — in a project that uses contentbit.
+version: ${TEMPLATE_VERSION}
+---
+
+# Auditing contentbit content
+
+\`contentbit stats\` analyzes documents and prints JSON to stdout. It is a read
+tool: it always exits 0, even when documents have validation errors.
+
+## Gather
+
+Check \`package.json\` for the \`content:check\` script to find this project's
+content glob and \`--registry\` flag, then:
+
+\`\`\`sh
+contentbit stats "content/**/*.md" [--registry <path>]
+\`\`\`
+
+One matched file prints a single stats object; multiple files print an array.
+Each entry includes the file path, frontmatter data, a heading \`outline\` with
+per-section word counts, \`blocks.byName\` usage counts, \`links.domains\`, and
+a \`validation\` summary (\`errors\`/\`warnings\`).
+
+## Interpret
+
+Prioritize findings in this order:
+
+1. **Validation errors and warnings** — broken content ships broken pages.
+2. **Thin documents** — outline sections with very low word counts.
+3. **Block-less documents** — \`blocks.byName\` empty where sibling documents
+   use blocks; structure (steps, callouts, comparisons, faq) may be missing.
+4. **Missing or inconsistent frontmatter** compared to sibling documents.
+5. **Structural imbalance** — skipped heading levels, single-section walls of text.
+
+## Report
+
+Report findings per file with concrete suggestions, ordered by priority. Do not
+edit files during the audit. To fix a finding, follow the contentbit-author
+skill (fetch the guide, edit, validate until clean) — offer that as a follow-up.
+`;
+const AGENTS_MD_BLOCK = `<!-- contentbit:start -->
+
+## contentbit content (generated — edits inside this block are overwritten)
+
+This project validates Markdown content with contentbit. Documents are plain
+Markdown plus directive blocks (\`:::name{props} ... :::\`), each with a schema.
+The \`content:check\` script in package.json holds the canonical validate
+command — the content glob and the \`--registry\` flag — reuse its arguments.
+
+When writing or editing content:
+
+1. Fetch the live authoring guide first — never guess block syntax:
+   \`contentbit instructions --audience llm [--registry <path>]\`
+2. Write plain Markdown; use blocks where the guide's use-when guidance fits.
+3. Validate until clean (exit 0): \`contentbit validate <file> [--registry <path>]\`.
+   Diagnostics print as \`file:line:col severity CODE message\` with fix hints.
+
+When auditing content health:
+
+- \`contentbit stats "content/**/*.md" [--registry <path>]\` prints JSON stats
+  and always exits 0: outline word counts, block usage, link domains, and
+  validation error/warning counts. Flag validation issues, thin documents, and
+  block-less pages first.
+
+If \`contentbit\` is unavailable, suggest \`npx contentbit@latest init\` instead
+of inventing block syntax.
+
+<!-- contentbit:end -->`;
+const START = '<!-- contentbit:start -->';
+const END = '<!-- contentbit:end -->';
+/** Insert or replace the fenced contentbit block, leaving the rest untouched. */
+function upsertBlock(existing) {
+    const start = existing.indexOf(START);
+    const end = existing.indexOf(END);
+    if (start !== -1 && end !== -1) {
+        return existing.slice(0, start) + AGENTS_MD_BLOCK + existing.slice(end + END.length);
+    }
+    if (existing.trim() === '')
+        return `${AGENTS_MD_BLOCK}\n`;
+    return `${existing.replace(/\n*$/, '\n\n')}${AGENTS_MD_BLOCK}\n`;
+}
+/** Install or refresh the agent integration. Shared by `agents` and `init`. */
+export async function installAgentIntegration(cwd, options, io) {
+    const claude = options.claude ?? existsSync(join(cwd, '.claude'));
+    const agentsMd = options.agentsMd ?? true;
+    if (agentsMd) {
+        const path = join(cwd, 'AGENTS.md');
+        let existing = '';
+        try {
+            existing = await readFile(path, 'utf8');
+        }
+        catch {
+            /* not there yet */
+        }
+        const created = existing === '';
+        await writeFile(path, upsertBlock(existing), 'utf8');
+        io.stdout(`${created ? 'created' : 'updated'}: AGENTS.md (contentbit block)`);
+    }
+    if (claude) {
+        const skills = [
+            ['contentbit-author', AUTHOR_SKILL],
+            ['contentbit-audit', AUDIT_SKILL],
+        ];
+        for (const [name, content] of skills) {
+            const dir = join(cwd, '.claude/skills', name);
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'SKILL.md'), content, 'utf8');
+            io.stdout(`installed: .claude/skills/${name}/SKILL.md`);
+        }
+    }
+}
+export async function agentsCommand(args, io) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            claude: { type: 'boolean', default: false },
+            'no-agents-md': { type: 'boolean', default: false },
+            cwd: { type: 'string', default: process.cwd() },
+        },
+    });
+    await installAgentIntegration(values.cwd, {
+        claude: values.claude || undefined, // false means "detect", not "skip"
+        agentsMd: !values['no-agents-md'],
+    }, io);
+    return 0;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAiSnC,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyMzE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAgYnC,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyNzE"}

package/dist/commands/init.js

@@ -4,12 +4,15 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { parseArgs } from 'node:util';
 import { loadRegistry } from '../load-registry.js';
-const TARGETS = ['react', 'html', 'markdown'];
+import { installAgentIntegration } from './agents.js';
+const TARGETS = ['react', 'html', 'markdown', 'astro'];
 /** Markdown library choices per target; the first entry is the default. */
 const MD_CHOICES = {
     react: ['react-markdown', 'none'],
     html: ['marked', 'markdown-it', 'none'],
     markdown: ['none'],
+    // @contentbit/astro ships its own marked-based default; nothing to install.
+    astro: ['none'],
 };
 const REGISTRY_TEMPLATE = `// Custom block definitions for this project. The CLI and your app share
 // this module — Node 22.18+ imports TypeScript directly:
@@ -213,6 +216,67 @@ export default async function ExamplePage() {
   )
 }
 `;
+const ASTRO_CONTENT_CONFIG = `import { defineCollection } from 'astro:content'
+import { glob } from 'astro/loaders'
+
+export const collections = {
+  articles: defineCollection({
+    // Astro's builtin Markdown loader. Entry bodies are parsed and validated
+    // where they render (see src/pages/example.astro); \`contentbit validate\`
+    // covers the same files in CI.
+    loader: glob({ pattern: '**/*.md', base: './content' }),
+  }),
+}
+`;
+const ASTRO_QUOTE_BLOCK = `---
+// The Astro component for the custom \`quote\` block defined in blocks/registry.ts.
+// Block props arrive as component props; nested content arrives via <slot />.
+interface Props {
+  author: string
+  role?: string
+}
+
+const { author, role } = Astro.props
+---
+
+<figure style="margin: 1.5rem 0; border-left: 2px solid #d4d4d4; padding-left: 1rem;">
+  <blockquote style="font-style: italic;"><slot /></blockquote>
+  <figcaption style="margin-top: 0.5rem; font-size: 0.875rem; opacity: 0.7;">
+    — {author}{role ? \`, \${role}\` : null}
+  </figcaption>
+</figure>
+`;
+/** The example page: styled pack renderer or the headless ContentBlocks. */
+function astroPage(styled) {
+    const importLine = styled
+        ? "import ContentRenderer from '../components/content-blocks/content-renderer.astro'"
+        : "import { ContentBlocks } from '@contentbit/astro/components'";
+    const renderer = styled ? 'ContentRenderer' : 'ContentBlocks';
+    return `---
+import { genericBlocks } from '@contentbit/blocks'
+import { createBlockRegistry, parseDocument, validateDocument } from '@contentbit/core'
+import { getEntry } from 'astro:content'
+
+${importLine}
+
+// Definitions in blocks/registry.ts are shared with the validate CLI.
+import customBlocks from '../../blocks/registry'
+import QuoteBlock from '../../blocks/QuoteBlock.astro'
+
+// Entry ids are the file path relative to the collection base, minus ".md".
+const entry = await getEntry('articles', 'example')
+if (!entry?.body) throw new Error('Entry "example" not found in the articles collection.')
+
+const registry = createBlockRegistry().use(genericBlocks()).use(customBlocks)
+// Static pages render at build time, so invalid blocks fail the build here.
+const result = validateDocument(parseDocument(entry.body), registry)
+---
+
+<main style="max-width: 42rem; margin: 0 auto; padding: 3rem 1.5rem;">
+  <${renderer} document={result.document} components={{ quote: QuoteBlock }} />
+</main>
+`;
+}
 function detectPackageManager(cwd) {
     // The project's lockfile outranks however the CLI itself was launched.
     const locks = [
@@ -253,6 +317,27 @@ function runInstall(pm, args, cwd) {
         child.on('error', () => resolve(1));
     });
 }
+/** Wire the @contentbit shadcn registry and install a styled pack. Returns true on success. */
+async function installStyledPack(cwd, pack, noInstall, io) {
+    const componentsJsonPath = join(cwd, 'components.json');
+    const componentsJson = JSON.parse(await readFile(componentsJsonPath, 'utf8'));
+    componentsJson.registries ??= {};
+    if (!componentsJson.registries['@contentbit']) {
+        componentsJson.registries['@contentbit'] = 'https://contentbit.dev/r/{name}.json';
+        await writeFile(componentsJsonPath, `${JSON.stringify(componentsJson, null, 2)}\n`, 'utf8');
+        io.stdout('added @contentbit registry to components.json');
+    }
+    if (noInstall) {
+        io.stdout(`skipped: shadcn add ${pack}`);
+        return true;
+    }
+    const [bin, prefix] = dlxCommand(detectPackageManager(cwd));
+    io.stdout(`installing the styled pack: shadcn add ${pack}`);
+    const code = await runInstall(bin, [...prefix, 'shadcn@latest', 'add', pack, '--yes'], cwd);
+    if (code !== 0)
+        io.stderr('styled pack install failed; falling back to headless defaults');
+    return code === 0;
+}
 /** Write a file unless it already exists; returns what happened for the summary. */
 async function scaffold(path, content) {
     try {
@@ -276,6 +361,7 @@ export async function initCommand(args, io) {
             'no-install': { type: 'boolean', default: false },
             'no-page': { type: 'boolean', default: false },
             'no-styled': { type: 'boolean', default: false },
+            'no-agents': { type: 'boolean', default: false },
         },
     });
     const cwd = values.cwd;
@@ -291,7 +377,8 @@ export async function initCommand(args, io) {
     }
     // Resolve the render target: flag > prompt (interactive) > detection.
     const hasReact = Boolean(pkg.dependencies?.react ?? pkg.devDependencies?.react);
-    const detected = hasReact ? 'react' : 'html';
+    const hasAstro = Boolean(pkg.dependencies?.astro ?? pkg.devDependencies?.astro);
+    const detected = hasAstro ? 'astro' : hasReact ? 'react' : 'html';
     let target;
     if (values.target) {
         if (!TARGETS.includes(values.target)) {
@@ -307,6 +394,7 @@ export async function initCommand(args, io) {
             initialValue: detected,
             options: [
                 { value: 'react', label: 'React', hint: 'ContentBlocks component' },
+                { value: 'astro', label: 'Astro', hint: 'content collections + .astro components' },
                 { value: 'html', label: 'Static HTML', hint: 'renderToHtml, no framework' },
                 { value: 'markdown', label: 'Plain Markdown', hint: 'fallback rendering only' },
             ],
@@ -353,6 +441,8 @@ export async function initCommand(args, io) {
         runtime.push('@contentbit/react');
     if (target === 'html')
         runtime.push('@contentbit/html');
+    if (target === 'astro')
+        runtime.push('@contentbit/astro');
     if (md !== 'none')
         runtime.push(md);
     if (values['no-install']) {
@@ -380,26 +470,7 @@ export async function initCommand(args, io) {
     let styled = false;
     const componentsJsonPath = join(cwd, 'components.json');
     if (target === 'react' && !values['no-styled'] && existsSync(componentsJsonPath)) {
-        const componentsJson = JSON.parse(await readFile(componentsJsonPath, 'utf8'));
-        componentsJson.registries ??= {};
-        if (!componentsJson.registries['@contentbit']) {
-            componentsJson.registries['@contentbit'] = 'https://contentbit.dev/r/{name}.json';
-            await writeFile(componentsJsonPath, `${JSON.stringify(componentsJson, null, 2)}\n`, 'utf8');
-            io.stdout('added @contentbit registry to components.json');
-        }
-        if (values['no-install']) {
-            io.stdout('skipped: shadcn add @contentbit/generic-pack');
-            styled = true;
-        }
-        else {
-            const [bin, prefix] = dlxCommand(detectPackageManager(cwd));
-            io.stdout('installing the styled pack: shadcn add @contentbit/generic-pack');
-            const code = await runInstall(bin, [...prefix, 'shadcn@latest', 'add', '@contentbit/generic-pack', '--yes'], cwd);
-            if (code === 0)
-                styled = true;
-            else
-                io.stderr('styled pack install failed; falling back to headless defaults');
-        }
+        styled = await installStyledPack(cwd, '@contentbit/generic-pack', values['no-install'], io);
     }
     if (target === 'react') {
         const depth = layout.componentPath.split('/').length - 1;
@@ -420,6 +491,31 @@ export async function initCommand(args, io) {
             htmlRenderScript(md),
         ]);
     }
+    if (target === 'astro') {
+        let astroStyled = false;
+        if (!values['no-styled'] && existsSync(componentsJsonPath)) {
+            astroStyled = await installStyledPack(cwd, '@contentbit/astro-pack', values['no-install'], io);
+        }
+        files.push(['blocks/QuoteBlock.astro', ASTRO_QUOTE_BLOCK]);
+        // Every config filename Astro resolves (src/content.config.* plus the
+        // legacy src/content/config.* location), so we never scaffold a second
+        // config that Astro would silently ignore.
+        const configCandidates = ['ts', 'mts', 'mjs', 'js'].flatMap((ext) => [
+            `src/content.config.${ext}`,
+            `src/content/config.${ext}`,
+        ]);
+        const existingConfig = configCandidates.find((p) => existsSync(join(cwd, p)));
+        if (existingConfig) {
+            io.stdout(`content config exists (${existingConfig}); add this collection manually:`);
+            io.stdout(ASTRO_CONTENT_CONFIG);
+            io.stdout('the example page expects the "articles" collection above');
+        }
+        else {
+            files.push(['src/content.config.ts', ASTRO_CONTENT_CONFIG]);
+        }
+        if (!values['no-page'])
+            files.push(['src/pages/example.astro', astroPage(astroStyled)]);
+    }
     for (const [rel, content] of files) {
         const result = await scaffold(join(cwd, rel), content);
         io.stdout(`${result}: ${rel}`);
@@ -445,6 +541,13 @@ export async function initCommand(args, io) {
     const guide = registry.toAuthoringGuide({ audience: 'llm', includeExamples: true });
     await writeFile(join(cwd, 'contentbit-guide.md'), guide, 'utf8');
     io.stdout('created: contentbit-guide.md (LLM authoring instructions)');
+    // Coding-agent integration: an AGENTS.md block for every agent, plus Claude
+    // Code skills when a .claude/ directory exists. `contentbit agents` refreshes.
+    if (!values['no-agents']) {
+        await installAgentIntegration(cwd, {}, io);
+        io.stdout('Agent integration installed — try asking your agent:');
+        io.stdout('  "write a blog post about X" or "audit my content"');
+    }
     io.stdout('');
     io.stdout('Done. Next steps:');
     io.stdout(`  1. Validate the starter content: ${detectPackageManager(cwd)} run content:check`);
@@ -458,6 +561,10 @@ export async function initCommand(args, io) {
         }
         io.stdout('  3. Styled components: pnpm dlx shadcn@latest add @contentbit/generic-pack');
     }
+    else if (target === 'astro') {
+        io.stdout('  2. Start the dev server and open /example to see the article rendered.');
+        io.stdout('  3. Styled components: pnpm dlx shadcn@latest add @contentbit/astro-pack');
+    }
     else if (target === 'html') {
         io.stdout('  2. Render it: node scripts/render-example.mjs && open example.html');
     }

package/dist/commands/stats.d.ts

@@ -0,0 +1,3 @@
+import type { Io } from '../run.js';
+export declare function statsCommand(args: string[], io: Io): Promise<number>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAuBnC,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B1E"}

package/dist/commands/stats.js

@@ -0,0 +1,49 @@
+import { analyzeDocument, parseDocument, stripFrontmatter, validateDocument, } from '@contentbit/core';
+import { readFile } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
+import { glob } from 'tinyglobby';
+import { loadRegistry } from '../load-registry.js';
+async function fileStats(file, registry) {
+    const source = await readFile(file, 'utf8');
+    const stats = analyzeDocument(source, { path: file });
+    if (registry) {
+        const result = validateDocument(parseDocument(stripFrontmatter(source)), registry);
+        let errors = 0;
+        let warnings = 0;
+        for (const d of result.diagnostics) {
+            if (d.severity === 'error')
+                errors++;
+            else if (d.severity === 'warning')
+                warnings++;
+        }
+        stats.validation = { errors, warnings };
+    }
+    return stats;
+}
+export async function statsCommand(args, io) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            registry: { type: 'string' },
+            'no-validate': { type: 'boolean', default: false },
+        },
+    });
+    if (positionals.length === 0) {
+        io.stderr('stats: provide at least one file or glob.');
+        return 2;
+    }
+    const files = await glob(positionals, { absolute: true });
+    if (files.length === 0) {
+        io.stderr(`stats: no files matched ${positionals.join(' ')}`);
+        return 2;
+    }
+    const registry = values['no-validate'] ? null : await loadRegistry(values.registry);
+    const all = [];
+    for (const file of files.sort()) {
+        all.push(await fileStats(file, registry));
+    }
+    // A single file keeps the flat object shape; multiple files emit an array.
+    io.stdout(JSON.stringify(all.length === 1 ? all[0] : all, null, 2));
+    return 0;
+}

package/dist/commands/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC7E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAInC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsC7E"}

package/dist/commands/validate.js

@@ -1,4 +1,4 @@
-import { formatDiagnostic, parseDocument, validateDocument } from '@contentbit/core';
+import { formatDiagnostic, parseDocument, stripFrontmatter, validateDocument, } from '@contentbit/core';
 import { readFile } from 'node:fs/promises';
 import { parseArgs } from 'node:util';
 import { glob } from 'tinyglobby';
@@ -26,7 +26,10 @@ export async function validateCommand(args, io) {
     let warnings = 0;
     for (const file of files.sort()) {
         const source = await readFile(file, 'utf8');
-        const result = validateDocument(parseDocument(source), registry);
+        // Frontmatter is metadata, not content: blanked (positions preserved) so
+        // block syntax inside YAML never produces diagnostics — matching what
+        // frontmatter-aware consumers like Astro validate from entry bodies.
+        const result = validateDocument(parseDocument(stripFrontmatter(source)), registry);
         for (const d of result.diagnostics) {
             io.stderr(formatDiagnostic(d, file));
             if (d.severity === 'error')

package/dist/run.d.ts

@@ -3,6 +3,6 @@ export interface Io {
     stderr(line: string): void;
     writeFile(path: string, content: string): Promise<void>;
 }
-export declare const USAGE = "Usage: contentbit <init|validate|render|instructions|docs> [options]\n\n  init [-t react|html|markdown] [--md ...] [-y] [--no-install] [--no-page]\n\n  validate <globs...> [--registry <module.mjs>] [--strict-warnings]\n  render <file> --target html|markdown [--registry <module.mjs>] [--out <file>]\n  instructions [--audience llm|human] [--no-examples] [--registry <module.mjs>] [--out <file>]\n  docs [--registry <module.mjs>] [--out <file>]";
+export declare const USAGE = "Usage: contentbit <init|validate|stats|render|instructions|docs|agents> [options]\n\n  init [-t react|html|markdown|astro] [--md ...] [-y] [--no-install] [--no-page] [--no-agents]\n  agents [--claude] [--no-agents-md]\n\n  validate <globs...> [--registry <module.mjs>] [--strict-warnings]\n  stats <globs...> [--registry <module.mjs>] [--no-validate]\n  render <file> --target html|markdown [--registry <module.mjs>] [--out <file>]\n  instructions [--audience llm|human] [--no-examples] [--registry <module.mjs>] [--out <file>]\n  docs [--registry <module.mjs>] [--out <file>]";
 export declare function run(argv: string[], io: Io): Promise<number>;
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,EAAE;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD;AAED,eAAO,MAAM,KAAK,gcAO8B,CAAA;AAYhD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjE"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,EAAE;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD;AAED,eAAO,MAAM,KAAK,qkBAS8B,CAAA;AAchD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjE"}