@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.2

package/dist/cli/commands/generate/docs.generate.cli-command.descriptor.js

@@ -0,0 +1,58 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'docs.generate',
+    name: 'generate',
+    description: 'Scaffold a new documentation descriptor for a package',
+    group: 'docs',
+    arguments: [
+        {
+            name: 'package',
+            description: 'Package name (e.g. @vibesdotdev/tools or tools)',
+            required: true
+        },
+        {
+            name: 'topic',
+            description: 'Topic slug (e.g. providers.anthropic)',
+            required: true
+        }
+    ],
+    options: [
+        {
+            flags: '--pattern <pattern>',
+            description: 'Descriptor pattern: inline | package | hybrid (default: inline)',
+            default: 'inline'
+        },
+        {
+            flags: '--parent <parent>',
+            description: 'Parent topic id for nav tree'
+        },
+        {
+            flags: '--title <title>',
+            description: 'Human-readable title (default: generated from topic slug)'
+        },
+        {
+            flags: '--dry-run',
+            description: 'Show what would be created without writing files',
+            default: false
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true,
+    examples: [
+        {
+            command: 'vibes docs generate tools list',
+            description: 'Generate inline descriptor for tools.list'
+        },
+        {
+            command: 'vibes docs generate ai providers.anthropic --pattern package',
+            description: 'Generate package-sourced descriptor for ai.providers.anthropic'
+        },
+        {
+            command: 'vibes docs generate storage adapters.drizzle --parent storage.adapters --title "Drizzle ORM Adapter"',
+            description: 'Generate with custom parent and title'
+        }
+    ]
+};
+export default descriptor;
+//# sourceMappingURL=docs.generate.cli-command.descriptor.js.map

package/dist/cli/commands/generate/docs.generate.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.generate.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/generate/docs.generate.cli-command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,uDAAuD;IACpE,KAAK,EAAE,MAAM;IACb,SAAS,EAAE;QACV;YACC,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,iDAAiD;YAC9D,QAAQ,EAAE,IAAI;SACd;QACD;YACC,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,uCAAuC;YACpD,QAAQ,EAAE,IAAI;SACd;KACD;IACA,OAAO,EAAE;QACP;YACE,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EAAE,iEAAiE;YAC9E,OAAO,EAAE,QAAQ;SAClB;QACD;YACE,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,8BAA8B;SAC5C;QACD;YACE,KAAK,EAAE,iBAAiB;YACxB,WAAW,EAAE,2DAA2D;SACzE;QACD;YACE,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,kDAAkD;YAC/D,OAAO,EAAE,KAAK;SACf;KACF;IACF,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,gCAAgC;YACzC,WAAW,EAAE,2CAA2C;SACxD;QACD;YACC,OAAO,EAAE,8DAA8D;YACvE,WAAW,EAAE,gEAAgE;SAC7E;QACD;YACC,OAAO,EAAE,sGAAsG;YAC/G,WAAW,EAAE,uCAAuC;SACpD;KACD;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/generate/docs.generate.cli-command.impl.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Docs Generate Command
+ *
+ * Scaffolds new documentation descriptors for packages.
+ * Supports three patterns: inline, package-sourced, and hybrid.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+interface DocsGenerateArgs {
+    package?: string;
+    topic?: string;
+}
+interface DocsGenerateOpts {
+    pattern?: string;
+    dryRun?: boolean;
+    parent?: string;
+    title?: string;
+}
+declare const _default: {
+    execute(args: DocsGenerateArgs, opts: DocsGenerateOpts, context: {
+        runtime: VibesRuntime;
+    }): Promise<number>;
+};
+export default _default;
+//# sourceMappingURL=docs.generate.cli-command.impl.d.ts.map

package/dist/cli/commands/generate/docs.generate.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.generate.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/docs.generate.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAexD,UAAU,gBAAgB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;;kBAIO,gBAAgB,QAChB,gBAAgB,WACb;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAChC,OAAO,CAAC,MAAM,CAAC;;AALnB,wBAgEE"}

package/dist/cli/commands/generate/docs.generate.cli-command.impl.js

@@ -0,0 +1,283 @@
+/**
+ * Docs Generate Command
+ *
+ * Scaffolds new documentation descriptors for packages.
+ * Supports three patterns: inline, package-sourced, and hybrid.
+ */
+import { requestCLIExit } from '@vibesdotdev/cli/providers';
+import { resolveFileSystemAdapter, statChecked } from '@vibesdotdev/filesystem';
+import { getRuntimePath } from '@vibesdotdev/paths';
+export default {
+    async execute(args, opts, context) {
+        const ui = await context.runtime.context('cli/ui');
+        const packageName = String(args.package ?? '').trim();
+        const topicSlug = String(args.topic ?? '').trim();
+        if (!packageName || !topicSlug) {
+            ui.error('Usage: vibes docs generate <package> <topic>');
+            ui.error('Example: vibes docs generate tools list');
+            requestCLIExit(1);
+            return 1;
+        }
+        const patternOpt = opts.pattern ?? 'inline';
+        const pattern = patternOpt === 'package' || patternOpt === 'hybrid' ? patternOpt : 'inline';
+        const dryRun = Boolean(opts.dryRun);
+        const parent = opts.parent ? opts.parent : inferParent(topicSlug);
+        const title = opts.title ? opts.title : slugToTitle(topicSlug);
+        // Parse package name (handle @scope/name format)
+        const cleanPackageName = packageName.startsWith('@')
+            ? packageName
+            : `@vibesdotdev/${packageName}`;
+        // Generate topic ID from slug
+        const topicId = topicSlug.replace(/\//g, '.');
+        // Generate summary placeholder
+        const summary = `Documentation for ${title.toLowerCase()}`;
+        // Generate tags from package name
+        const packageShortName = cleanPackageName.replace('@vibesdotdev/', '');
+        const tags = [packageShortName, ...topicSlug.split('.').map((s) => s.toLowerCase())];
+        // Build context
+        const ctx = {
+            packageName: cleanPackageName,
+            topicSlug,
+            topicId,
+            title,
+            summary,
+            tags,
+            parent,
+            pattern,
+            descriptorPath: getDescriptorPath(packageShortName, topicId),
+            markdownPath: pattern === 'package' || pattern === 'hybrid'
+                ? getMarkdownPath(packageShortName, topicId)
+                : undefined
+        };
+        if (dryRun) {
+            printDryRun(ctx, ui);
+            return 0;
+        }
+        return generateFiles(ctx, ui, context.runtime);
+    }
+};
+function slugToTitle(slug) {
+    return slug
+        .split('.')
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1).replace(/-/g, ' '))
+        .join(' ');
+}
+function inferParent(slug) {
+    const parts = slug.split('.');
+    if (parts.length > 1) {
+        return parts.slice(0, -1).join('.');
+    }
+    return undefined;
+}
+function getDescriptorPath(packageName, topicId) {
+    const packageDir = packageName.replace('@vibesdotdev/', '');
+    return `${packageDir}/src/docs/${topicId}.docs.descriptor.ts`;
+}
+function getMarkdownPath(packageName, topicId) {
+    const packageDir = packageName.replace('@vibesdotdev/', '');
+    return `${packageDir}/src/docs/${topicId}.md`;
+}
+function printDryRun(ctx, ui) {
+    ui.info('📄 Would create the following files:\n');
+    ui.info(`   ${ctx.descriptorPath}`);
+    if (ctx.markdownPath) {
+        ui.info(`   ${ctx.markdownPath}`);
+    }
+    ui.info('\n📝 Descriptor metadata:\n');
+    ui.info(`   ID: ${ctx.topicId}`);
+    ui.info(`   Title: ${ctx.title}`);
+    ui.info(`   Summary: ${ctx.summary}`);
+    ui.info(`   Parent: ${ctx.parent || '(none)'}`);
+    ui.info(`   Tags: ${ctx.tags.join(', ')}`);
+    ui.info(`   Pattern: ${ctx.pattern}`);
+    ui.info('\n💡 Run without --dry-run to create files.');
+}
+async function generateFiles(ctx, ui, runtime) {
+    try {
+        const fs = await resolveFileSystemAdapter(runtime);
+        const runtimePath = await getRuntimePath(runtime);
+        const descriptorStat = await statChecked(fs, ctx.descriptorPath);
+        if (descriptorStat.found) {
+            ui.error(`File already exists: ${ctx.descriptorPath}`);
+            requestCLIExit(1);
+            return 1;
+        }
+        if (ctx.markdownPath) {
+            const markdownStat = await statChecked(fs, ctx.markdownPath);
+            if (markdownStat.found) {
+                ui.error(`File already exists: ${ctx.markdownPath}`);
+                requestCLIExit(1);
+                return 1;
+            }
+        }
+        // Create descriptor content
+        const descriptorContent = generateDescriptorContent(ctx);
+        // Create markdown content if package-sourced
+        const markdownContent = ctx.markdownPath
+            ? generateMarkdownContent(ctx)
+            : null;
+        // Ensure directory exists
+        const descriptorDir = runtimePath.dirname(ctx.descriptorPath);
+        await fs.mkdir(descriptorDir, { recursive: true });
+        // Write descriptor file
+        await fs.writeFile(ctx.descriptorPath, descriptorContent, 'utf-8');
+        ui.success(`✓ Created ${ctx.descriptorPath}`);
+        // Write markdown file if applicable
+        if (markdownContent && ctx.markdownPath) {
+            const markdownDir = runtimePath.dirname(ctx.markdownPath);
+            await fs.mkdir(markdownDir, { recursive: true });
+            await fs.writeFile(ctx.markdownPath, markdownContent, 'utf-8');
+            ui.success(`✓ Created ${ctx.markdownPath}`);
+        }
+        // Print next steps
+        ui.info('\n📝 Next steps:');
+        ui.info(`   1. Edit ${ctx.descriptorPath} to customize metadata`);
+        if (ctx.markdownPath) {
+            ui.info(`   2. Edit ${ctx.markdownPath} to add content`);
+        }
+        ui.info(`   3. Import and register the descriptor in ${ctx.packageName.replace('@vibesdotdev/', '')}/src/${ctx.packageName.replace('@vibesdotdev/', '')}.plugin.ts`);
+        ui.info('   4. Verify with: vibes man ' + ctx.topicId);
+        return 0;
+    }
+    catch (error) {
+        ui.error(`Failed to generate files: ${error instanceof Error ? error.message : String(error)}`);
+        requestCLIExit(1);
+        throw error;
+    }
+}
+function generateDescriptorContent(ctx) {
+    const { topicId, title, summary, parent, tags, pattern } = ctx;
+    const orderComment = parent
+        ? `  order: 1,  // adjust sibling ordering`
+        : '';
+    const parentLine = parent
+        ? `  parent: '${parent}',`
+        : '';
+    if (pattern === 'inline' || pattern === 'hybrid') {
+        return generateInlineDescriptor(ctx);
+    }
+    // Package-sourced pattern
+    return `import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+
+/**
+ * Descriptor for ${topicId}
+ * Auto-generated by \`vibes docs generate\`
+ */
+const descriptor: DocsTopicDescriptor = {
+  kind: 'docs/topic',
+  id: '${topicId}',
+  title: '${title}',
+  summary: '${summary}',
+  body: {
+    type: 'markdown',
+    sourceType: 'package',
+    source: 'package:@vibesdotdev/${ctx.packageName.replace('@vibesdotdev/', '')}:docs/${topicId}.md'
+  },
+${parentLine}${orderComment ? '\n' : ''}${orderComment}
+  tags: [${tags.map(t => `'${t}'`).join(', ')}],
+  surfaces: ['cli', 'web', 'in-app'],
+  hardware: ['consumer'],
+  enabled: true
+};
+
+export default descriptor;
+`;
+}
+function generateInlineDescriptor(ctx) {
+    const { topicId, title, summary, parent, tags, topicSlug } = ctx;
+    const packageShortName = ctx.packageName.replace('@vibesdotdev/', '');
+    return `import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+
+/**
+ * Descriptor for ${topicId}
+ * Auto-generated by \`vibes docs generate\`
+ */
+const ${topicSlug.replace(/\./g, '_')}Markdown = \`---
+title: ${title}
+summary: ${summary}
+tags: [${tags.map(t => t).join(', ')}]
+${parent ? `parent: ${parent}` : ''}
+---
+
+# ${title}
+
+${summary}
+
+## Overview
+
+<!-- TODO: Add overview content -->
+
+## Usage
+
+\`\`\`ts
+// TODO: Add usage example
+\`\`\`
+
+## Related
+
+:::card{title="See also"}
+- [\`${packageShortName}\`](../README.md) — Main package documentation
+:::
+\`;
+
+const descriptor: DocsTopicDescriptor = {
+  kind: 'docs/topic',
+  id: '${topicId}',
+  title: '${title}',
+  summary: '${summary}',
+  body: {
+    type: 'markdown',
+    sourceType: 'raw',
+    source: ${topicSlug.replace(/\./g, '_')}Markdown
+  },
+${parent ? `  parent: '${parent}',` : ''}
+  tags: [${tags.map(t => `'${t}'`).join(', ')}],
+  surfaces: ['cli', 'web', 'in-app'],
+  hardware: ['consumer'],
+  enabled: true
+};
+
+export default descriptor;
+`;
+}
+function generateMarkdownContent(ctx) {
+    const { title, summary, parent, tags } = ctx;
+    return `---
+title: ${title}
+summary: ${summary}
+tags: [${tags.join(', ')}]
+${parent ? `parent: ${parent}` : ''}
+---
+
+# ${title}
+
+${summary}
+
+## Overview
+
+<!-- TODO: Add overview content -->
+
+## Usage
+
+\`\`\`ts
+// TODO: Add usage example
+\`\`\`
+
+## Examples
+
+### Basic example
+
+<!-- TODO: Add basic example -->
+
+### Advanced example
+
+<!-- TODO: Add advanced example -->
+
+## Related
+
+:::card{title="See also"}
+- [Main documentation](../README.md)
+:::
+`;
+}
+//# sourceMappingURL=docs.generate.cli-command.impl.js.map

package/dist/cli/commands/generate/docs.generate.cli-command.impl.js.map

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

package/dist/cli/commands/man/man.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/cli/schemas/descriptors';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=man.cli-command.descriptor.d.ts.map

package/dist/cli/commands/man/man.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"man.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/man/man.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEtF,QAAA,MAAM,UAAU,EAAE,yBA6BjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/man/man.cli-command.descriptor.js

@@ -0,0 +1,32 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'man',
+    name: 'man',
+    description: 'Show a documentation topic in man-page format (alias of `vibes docs show`)',
+    group: 'man',
+    arguments: [
+        {
+            name: 'topic',
+            description: 'Topic id (e.g. tools.list) or subject kind (with id). Omit to browse all topics.',
+            required: false
+        },
+        {
+            name: 'id',
+            description: 'When supplied, the previous argument is treated as the subject kind',
+            required: false
+        }
+    ],
+    options: [
+        { flags: '--bare', description: 'Skip the man-page envelope; emit body only' },
+        { flags: '--no-color', description: 'Disable ANSI color' }
+    ],
+    // `noArgsAndTty`: a bare `vibes man` on a TTY opens the docs explorer
+    // TUI, but `vibes man <topic>` (or any piped/CI invocation) falls
+    // through to the man-page renderer in this command's CLI impl.
+    interactive: { appId: 'docs.explorer', launchWhen: 'noArgsAndTty' },
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=man.cli-command.descriptor.js.map

package/dist/cli/commands/man/man.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"man.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/man/man.cli-command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,4EAA4E;IACzF,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE;QACV;YACC,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kFAAkF;YAC/F,QAAQ,EAAE,KAAK;SACf;QACD;YACC,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,KAAK;SACf;KACD;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;QAC9E,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE;KAC1D;IACD,sEAAsE;IACtE,kEAAkE;IAClE,+DAA+D;IAC/D,WAAW,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE;IACnE,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/man/man.cli-command.impl.d.ts

@@ -0,0 +1,23 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+interface ManArgs {
+    readonly topic?: string;
+    readonly id?: string;
+}
+type ManOpts = Record<string, JsonValue | undefined>;
+/**
+ * `vibes man <topic>` — single-word top-level alias.
+ *
+ * Delegates to the `docs.show` command, which migrated to
+ * the docs/cli surface. Resolve-don't-import: man lives in
+ * `@vibesdotdev/docs` and resolves the show impl through the runtime
+ * `cli/command` kind rather than importing the sibling surface package
+ * (mirrors `bridge.install` → `os.install` resolution).
+ */
+declare const _default: {
+    execute(args: ManArgs, opts: ManOpts, context: {
+        runtime: VibesRuntime;
+    }): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=man.cli-command.impl.d.ts.map

package/dist/cli/commands/man/man.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"man.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/man/man.cli-command.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,UAAU,OAAO;IAChB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAUrD;;;;;;;;GAQG;;kBAGK,OAAO,QACP,OAAO,WACJ;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAChC,OAAO,CAAC,IAAI,CAAC;;AALjB,wBAgBE"}

package/dist/cli/commands/man/man.cli-command.impl.js

@@ -0,0 +1,22 @@
+/**
+ * `vibes man <topic>` — single-word top-level alias.
+ *
+ * Delegates to the `docs.show` command, which migrated to
+ * the docs/cli surface. Resolve-don't-import: man lives in
+ * `@vibesdotdev/docs` and resolves the show impl through the runtime
+ * `cli/command` kind rather than importing the sibling surface package
+ * (mirrors `bridge.install` → `os.install` resolution).
+ */
+export default {
+    async execute(args, opts, context) {
+        const topic = args.topic ? args.topic.trim() : '';
+        const id = args.id ? args.id.trim() : '';
+        if (!topic && !id) {
+            const listCommand = await context.runtime.resolve('cli/command', 'docs.list');
+            return listCommand.execute({}, opts, context);
+        }
+        const showCommand = await context.runtime.resolve('cli/command', 'docs.show');
+        return showCommand.execute(args, opts, context);
+    }
+};
+//# sourceMappingURL=man.cli-command.impl.js.map

package/dist/cli/commands/man/man.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"man.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/commands/man/man.cli-command.impl.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,eAAe;IACd,KAAK,CAAC,OAAO,CACZ,IAAa,EACb,IAAa,EACb,OAAkC;QAElC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAoB,aAAa,EAAE,WAAW,CAAC,CAAC;YACjG,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAoB,aAAa,EAAE,WAAW,CAAC,CAAC;QACjG,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACD,CAAC"}

package/dist/cli/commands/open/docs.open.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/cli/schemas/descriptors';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=docs.open.cli-command.descriptor.d.ts.map

package/dist/cli/commands/open/docs.open.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.open.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/docs.open.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEtF,QAAA,MAAM,UAAU,EAAE,yBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/open/docs.open.cli-command.descriptor.js

@@ -0,0 +1,18 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'docs.open',
+    name: 'open',
+    description: 'Open a documentation topic in the docs.vibes.dev web browser',
+    group: 'docs',
+    arguments: [
+        { name: 'topic', description: 'Topic id to open', required: false }
+    ],
+    options: [
+        { flags: '--print', description: 'Print the URL instead of opening a browser' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=docs.open.cli-command.descriptor.js.map

package/dist/cli/commands/open/docs.open.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.open.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/open/docs.open.cli-command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,8DAA8D;IAC3E,KAAK,EAAE,MAAM;IACb,SAAS,EAAE;QACV,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;KACnE;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,4CAA4C,EAAE;KAC/E;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/open/docs.open.cli-command.impl.d.ts

@@ -0,0 +1,14 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export interface DocsOpenArgs {
+    readonly topic?: string;
+}
+export interface DocsOpenOpts {
+    readonly print?: boolean;
+}
+declare const _default: {
+    execute(args: DocsOpenArgs, opts: DocsOpenOpts, context: {
+        runtime: VibesRuntime;
+    }): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=docs.open.cli-command.impl.d.ts.map

package/dist/cli/commands/open/docs.open.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.open.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/docs.open.cli-command.impl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA+BxD,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACzB;;kBAIO,YAAY,QACZ,YAAY,WACT;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAChC,OAAO,CAAC,IAAI,CAAC;;AALjB,wBAiCE"}

package/dist/cli/commands/open/docs.open.cli-command.impl.js

@@ -0,0 +1,52 @@
+import { requestCLIExit } from '@vibesdotdev/cli/providers';
+import { writeStdoutLine } from '@vibesdotdev/cli/output';
+import { getRuntimeExecution } from '@vibesdotdev/kernel/execution';
+import { serviceOrigin } from '@vibesdotdev/infra-core/service';
+import { getVibesDocsClient } from "../../../client/index.js";
+async function openInBrowser(runtime, url) {
+    const platform = runtime.localEnvironment.getPlatform?.();
+    const cmd = platform === 'darwin'
+        ? 'open'
+        : platform === 'win32'
+            ? 'start'
+            : 'xdg-open';
+    const execution = await getRuntimeExecution(runtime);
+    await execution.spawn({
+        command: cmd,
+        args: [url],
+        detached: true,
+        envMode: 'inherit',
+        inheritReason: 'open browser URL',
+        stdin: 'ignore',
+        stdout: 'ignore',
+        stderr: 'ignore'
+    });
+}
+export default {
+    async execute(args, opts, context) {
+        const { runtime } = context;
+        const ui = await runtime.context('cli/ui');
+        const docs = await getVibesDocsClient(runtime);
+        const topicArg = String(args.topic ?? '').trim();
+        if (!topicArg) {
+            ui.error('Missing required argument: <topic>');
+            requestCLIExit(1);
+        }
+        const descriptor = docs.findById(topicArg);
+        if (!descriptor) {
+            ui.error(`No topic registered with id "${topicArg}"`);
+            requestCLIExit(1);
+        }
+        // The declared `docs` service in the configured service environment;
+        // an undeclared service fails `service-undeclared` rather than guessing an origin.
+        const docsOrigin = (await serviceOrigin(runtime, 'docs')).replace(/\/$/, '');
+        const url = `${docsOrigin}/${descriptor.id}`;
+        if (opts.print) {
+            await writeStdoutLine(runtime, url);
+            return;
+        }
+        ui.info(`Opening ${url}`);
+        await openInBrowser(runtime, url);
+    }
+};
+//# sourceMappingURL=docs.open.cli-command.impl.js.map

package/dist/cli/commands/open/docs.open.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.open.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/commands/open/docs.open.cli-command.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAO9D,KAAK,UAAU,aAAa,CAAC,OAAqB,EAAE,GAAW;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;IAC1D,MAAM,GAAG,GACR,QAAQ,KAAK,QAAQ;QACpB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,QAAQ,KAAK,OAAO;YACrB,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,UAAU,CAAC;IAChB,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,KAAK,CAAC;QACrB,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,CAAC,GAAG,CAAC;QACX,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,SAAS;QAClB,aAAa,EAAE,kBAAkB;QACjC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KAChB,CAAC,CAAC;AACJ,CAAC;AAUD,eAAe;IACd,KAAK,CAAC,OAAO,CACZ,IAAkB,EAClB,IAAkB,EAClB,OAAkC;QAElC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAY,QAAQ,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC/C,cAAc,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,EAAE,CAAC,KAAK,CAAC,gCAAgC,QAAQ,GAAG,CAAC,CAAC;YACtD,cAAc,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QAED,qEAAqE;QACrE,mFAAmF;QACnF,MAAM,UAAU,GAAG,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACpC,OAAO;QACR,CAAC;QACD,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;QAC1B,MAAM,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;CACD,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * `vibes docs search <query>` — fuzzy-match topics by id / title / summary / tags.
+ */
+export declare const searchCommandDescriptor: {
+    readonly kind: "cli/command";
+    readonly id: "docs.search";
+    readonly name: "search";
+    readonly description: "Search documentation topics by id, title, summary, or tags";
+    readonly group: "docs";
+    readonly arguments: [{
+        readonly name: "query";
+        readonly description: "Search query";
+        readonly required: true;
+    }];
+    readonly options: [{
+        readonly flags: "--topic <id>";
+        readonly description: "Restrict matches to a single topic id (still must match query)";
+    }, {
+        readonly flags: "--limit <n>";
+        readonly description: "Maximum number of matches to return";
+    }];
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer", "cloud"];
+    readonly enabled: true;
+    readonly examples: [{
+        readonly command: "vibes docs search \"runtime\"";
+        readonly description: "Match topics containing \"runtime\"";
+        readonly expectExit: 0;
+    }, {
+        readonly command: "vibes docs search \"providers\" --json";
+        readonly description: "JSON output for an editor / pipeline";
+        readonly expectExit: 0;
+    }];
+};
+export default searchCommandDescriptor;
+//# sourceMappingURL=search.command.descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.command.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BlC,CAAC;AAEH,eAAe,uBAAuB,CAAC"}