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

package/dist/cli/commands/search.command.descriptor.js

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

package/dist/cli/commands/search.command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.command.descriptor.js","sourceRoot":"","sources":["../../../src/cli/commands/search.command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;IACzD,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,4DAA4D;IACzE,KAAK,EAAE,MAAM;IACb,SAAS,EAAE;QACV,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC9D;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gEAAgE,EAAE;QACxG,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,qCAAqC,EAAE;KAC5E;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,6BAA6B;YACtC,WAAW,EAAE,mCAAmC;YAChD,UAAU,EAAE,CAAC;SACb;QACD;YACC,OAAO,EAAE,sCAAsC;YAC/C,WAAW,EAAE,sCAAsC;YACnD,UAAU,EAAE,CAAC;SACb;KACD;CACD,CAAC,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * `vibes docs search` implementation.
+ *
+ * Queries the `docs/topic` kind directly (matches list.command.impl.ts).
+ * Filters by query (case-insensitive substring across id/title/summary/tags),
+ * `--topic`, and `--limit`. Emits JSON or a hand-formatted table.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+export interface DocsSearchArgs {
+    query?: string;
+}
+export interface DocsSearchOpts {
+    topic?: string;
+    limit?: string;
+    format?: string;
+    json?: boolean;
+}
+export declare function execute(args: DocsSearchArgs, opts: DocsSearchOpts, context: {
+    runtime: VibesRuntime;
+}): Promise<void>;
+declare const _default: {
+    execute: typeof execute;
+};
+export default _default;
+//# sourceMappingURL=search.command.impl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.command.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG3G,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAwFD,wBAAsB,OAAO,CAC5B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GAChC,OAAO,CAAC,IAAI,CAAC,CA2Cf;;;;AAED,wBAA2B"}

package/dist/cli/commands/search.command.impl.js

@@ -0,0 +1,113 @@
+/**
+ * `vibes docs search` implementation.
+ *
+ * Queries the `docs/topic` kind directly (matches list.command.impl.ts).
+ * Filters by query (case-insensitive substring across id/title/summary/tags),
+ * `--topic`, and `--limit`. Emits JSON or a hand-formatted table.
+ */
+import { commandWriters, writeJson } from '@vibesdotdev/cli/output';
+import { requestCLIExit } from '@vibesdotdev/cli/providers';
+import { getLogger } from '@vibesdotdev/logging';
+import { settleNow, valueFreeFailure, settle } from '@vibesdotdev/kernel';
+function descriptorMatches(d, q) {
+    const id = d.id.toLowerCase();
+    const title = (d.title ?? '').toLowerCase();
+    const summary = (d.summary ?? '').toLowerCase();
+    if (id.includes(q) || title.includes(q) || summary.includes(q))
+        return true;
+    const tags = d.tags ?? [];
+    return tags.some((t) => t.toLowerCase().includes(q));
+}
+function descriptorToRow(d) {
+    return {
+        id: d.id,
+        title: d.title ?? d.id,
+        summary: d.summary,
+        tags: d.tags ? [...d.tags] : []
+    };
+}
+function searchTopics(runtime, query, opts) {
+    if (!runtime.hasKind('docs/topic'))
+        return [];
+    const q = query.toLowerCase().trim();
+    if (!q)
+        return [];
+    const descriptors = runtime
+        .query('docs/topic')
+        .enabled()
+        .descriptors();
+    let matches = descriptors.filter((d) => descriptorMatches(d, q));
+    if (opts.topic) {
+        const topic = opts.topic;
+        matches = matches.filter((d) => d.id === topic);
+    }
+    matches.sort((a, b) => a.id.localeCompare(b.id));
+    if (opts.limit) {
+        const n = Number.parseInt(opts.limit, 10);
+        if (Number.isFinite(n) && n > 0) {
+            matches = matches.slice(0, n);
+        }
+    }
+    return matches.map(descriptorToRow);
+}
+async function printTable(runtime, rows, query) {
+    const writers = await commandWriters(runtime);
+    if (rows.length === 0) {
+        writers.log(`No topics matched "${query}".`);
+        return;
+    }
+    writers.log(`\nMatches for "${query}" (${rows.length}):\n`);
+    writers.log(`${'ID'.padEnd(32)} ${'Title'.padEnd(36)} Summary`);
+    writers.log('-'.repeat(100));
+    for (const r of rows) {
+        writers.log(`${r.id.slice(0, 32).padEnd(32)} ${r.title.slice(0, 36).padEnd(36)} ${(r.summary ?? '').slice(0, 80)}`);
+    }
+    writers.log('');
+}
+async function resolveUIContext(runtime) {
+    return settle(() => runtime.context('cli/ui'));
+}
+export async function execute(args, opts, context) {
+    const writers = await commandWriters(context.runtime);
+    const query = args.query ?? '';
+    if (query.trim().length === 0) {
+        const message = 'query is required (usage: vibes docs search <query>)';
+        const wantsJson = opts.json === true || opts.format === 'json';
+        if (wantsJson) {
+            await writeJson(context.runtime, { error: message });
+        }
+        else {
+            writers.err(message);
+        }
+        requestCLIExit(1);
+        return;
+    }
+    const options = {
+        topic: opts.topic,
+        limit: opts.limit,
+        format: opts.format,
+        json: opts.json === true
+    };
+    const rows = searchTopics(context.runtime, query, options);
+    const format = options.json ? 'json' : options.format;
+    const wantsStructured = format === 'json' || format === 'yaml' || format === 'markdown';
+    if (wantsStructured) {
+        const uiResult = await resolveUIContext(context.runtime);
+        if (uiResult.ok && uiResult.value?.render) {
+            uiResult.value.render(rows, { format: format ?? 'json' });
+            return;
+        }
+        if (!uiResult.ok) {
+            const diagnostic = settleNow(() => getLogger('docs.search', context.runtime).debug('cli/ui context unavailable; writing structured JSON', {
+                error: valueFreeFailure(uiResult.cause)
+            }));
+            if (!diagnostic.ok)
+                settleNow(() => context.runtime.diagnostics.error('Docs structured fallback diagnostic failed', { scope: 'docs', plugin: 'docs', error: new AggregateError([uiResult.cause, diagnostic.cause], 'Primary failure and diagnostic failed.', { cause: uiResult.cause }) }));
+        }
+        await writeJson(context.runtime, rows);
+        return;
+    }
+    await printTable(context.runtime, rows, query);
+}
+export default { execute };
+//# sourceMappingURL=search.command.impl.js.map

package/dist/cli/commands/search.command.impl.js.map

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

package/dist/cli/directives/card.d.ts

@@ -0,0 +1,11 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * `:::card{title="See also"}` ... `:::` — generic bordered card.
+ *
+ *   ─── See also ───
+ *     <body>
+ *   ────────────────
+ */
+export declare function renderCardDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=card.d.ts.map

package/dist/cli/directives/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CASnF"}

package/dist/cli/directives/card.js

@@ -0,0 +1,18 @@
+/**
+ * `:::card{title="See also"}` ... `:::` — generic bordered card.
+ *
+ *   ─── See also ───
+ *     <body>
+ *   ────────────────
+ */
+export function renderCardDirectiveCli(node, ansi) {
+    const title = node.attrs.title;
+    const header = title
+        ? `${ansi.gray('───')} ${ansi.bold(title)} ${ansi.gray('─'.repeat(16))}`
+        : `${ansi.gray('─'.repeat(40))}`;
+    const footer = ansi.gray('─'.repeat(40));
+    const lines = node.body.trim().split('\n');
+    const body = lines.map((line) => `  ${line}`).join('\n');
+    return `${header}\n${body}\n${footer}`;
+}
+//# sourceMappingURL=card.js.map

package/dist/cli/directives/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../../src/cli/directives/card.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAmB,EAAE,IAAe;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK;QACnB,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE;QACxE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,GAAG,MAAM,KAAK,IAAI,KAAK,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/dist/cli/directives/descriptor.d.ts

@@ -0,0 +1,11 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * `:::descriptor{kind="tools/tool" id="tools.list"}` →
+ *   ┌─ descriptor ───────────────────────────────
+ *   │  kind: tools/tool
+ *   │  id:   tools.list
+ *   └──────────────────────────────────────────────
+ */
+export declare function renderDescriptorDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/cli/directives/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAWzF"}

package/dist/cli/directives/descriptor.js

@@ -0,0 +1,20 @@
+/**
+ * `:::descriptor{kind="tools/tool" id="tools.list"}` →
+ *   ┌─ descriptor ───────────────────────────────
+ *   │  kind: tools/tool
+ *   │  id:   tools.list
+ *   └──────────────────────────────────────────────
+ */
+export function renderDescriptorDirectiveCli(node, ansi) {
+    const kind = node.attrs.kind ?? '?';
+    const id = node.attrs.id ?? '?';
+    const title = ansi.bold(ansi.cyan('descriptor'));
+    const lines = [
+        `${ansi.gray('┌─')} ${title} ${ansi.gray('─'.repeat(40))}`,
+        `${ansi.gray('│')}  ${ansi.bold('kind:')} ${ansi.yellow(kind)}`,
+        `${ansi.gray('│')}  ${ansi.bold('id:  ')} ${ansi.yellow(id)}`,
+        `${ansi.gray('└' + '─'.repeat(52))}`
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/cli/directives/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../../src/cli/directives/descriptor.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAmB,EAAE,IAAe;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC;IACpC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG;QACb,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE;QAC1D,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QAC/D,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QAC7D,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE;KACpC,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/cli/directives/endpoint.d.ts

@@ -0,0 +1,8 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * `:::endpoint{method="GET" path="/api/tools" appId="ai-web"}` →
+ *   GET    /api/tools                                 (ai-web)
+ */
+export declare function renderEndpointDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/cli/directives/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAqB/D;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CASvF"}

package/dist/cli/directives/endpoint.js

@@ -0,0 +1,31 @@
+function getMethodColor(method) {
+    switch (method) {
+        case 'GET':
+            return 'green';
+        case 'POST':
+            return 'yellow';
+        case 'PUT':
+            return 'blue';
+        case 'PATCH':
+            return 'magenta';
+        case 'DELETE':
+            return 'red';
+        default:
+            return 'gray';
+    }
+}
+/**
+ * `:::endpoint{method="GET" path="/api/tools" appId="ai-web"}` →
+ *   GET    /api/tools                                 (ai-web)
+ */
+export function renderEndpointDirectiveCli(node, ansi) {
+    const method = (node.attrs.method ?? 'GET').toUpperCase();
+    const path = node.attrs.path ?? '/';
+    const appId = node.attrs.appId;
+    const color = ansi[getMethodColor(method)];
+    const methodCol = ansi.bold(color(method.padEnd(6)));
+    const pathCol = ansi.cyan(path);
+    const appCol = appId ? ` ${ansi.gray(`(${appId})`)}` : '';
+    return `  ${methodCol} ${pathCol}${appCol}`;
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/cli/directives/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../../src/cli/directives/endpoint.ts"],"names":[],"mappings":"AAKA,SAAS,cAAc,CAAC,MAAc;IACrC,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,KAAK;YACT,OAAO,OAAO,CAAC;QAChB,KAAK,MAAM;YACV,OAAO,QAAQ,CAAC;QACjB,KAAK,KAAK;YACT,OAAO,MAAM,CAAC;QACf,KAAK,OAAO;YACX,OAAO,SAAS,CAAC;QAClB,KAAK,QAAQ;YACZ,OAAO,KAAK,CAAC;QACd;YACC,OAAO,MAAM,CAAC;IAChB,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAmB,EAAE,IAAe;IAC9E,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * Render any directive AST node to ANSI text for the CLI surface.
+ * Unknown directives fall back to a labelled passthrough so authors
+ * see what's missing.
+ */
+export declare function renderDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA6B/D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAK/E"}

package/dist/cli/directives/index.js

@@ -0,0 +1,37 @@
+import { renderDescriptorDirectiveCli } from "./descriptor.js";
+import { renderEndpointDirectiveCli } from "./endpoint.js";
+import { renderInstallDirectiveCli } from "./install.js";
+import { renderShellDirectiveCli } from "./shell.js";
+import { renderUsageDirectiveCli } from "./usage.js";
+import { renderCardDirectiveCli } from "./card.js";
+function getDirectiveRenderer(name) {
+    switch (name) {
+        case 'descriptor':
+            return renderDescriptorDirectiveCli;
+        case 'endpoint':
+            return renderEndpointDirectiveCli;
+        case 'install':
+            return renderInstallDirectiveCli;
+        case 'shell':
+            return renderShellDirectiveCli;
+        case 'usage':
+            return renderUsageDirectiveCli;
+        case 'card':
+            return renderCardDirectiveCli;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Render any directive AST node to ANSI text for the CLI surface.
+ * Unknown directives fall back to a labelled passthrough so authors
+ * see what's missing.
+ */
+export function renderDirectiveCli(node, ansi) {
+    const renderer = getDirectiveRenderer(node.name);
+    if (renderer)
+        return renderer(node, ansi);
+    const label = ansi.gray(`[unknown directive: ${node.name}]`);
+    return node.body.trim() ? `${label}\n${node.body.trim()}` : label;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/directives/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAInD,SAAS,oBAAoB,CAAC,IAAY;IACzC,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,YAAY;YAChB,OAAO,4BAA4B,CAAC;QACrC,KAAK,UAAU;YACd,OAAO,0BAA0B,CAAC;QACnC,KAAK,SAAS;YACb,OAAO,yBAAyB,CAAC;QAClC,KAAK,OAAO;YACX,OAAO,uBAAuB,CAAC;QAChC,KAAK,OAAO;YACX,OAAO,uBAAuB,CAAC;QAChC,KAAK,MAAM;YACV,OAAO,sBAAsB,CAAC;QAC/B;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB,EAAE,IAAe;IACtE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACnE,CAAC"}

package/dist/cli/directives/install.d.ts

@@ -0,0 +1,12 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * `:::install{package="@vibesdotdev/tools"}` ... `:::` →
+ *   ╭─ install: @vibesdotdev/tools ─────────────╮
+ *   │ $ bun add @vibesdotdev/tools              │
+ *   │                                            │
+ *   │ <body content rendered as plain text>     │
+ *   ╰────────────────────────────────────────────╯
+ */
+export declare function renderInstallDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/directives/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAiBtF"}

package/dist/cli/directives/install.js

@@ -0,0 +1,27 @@
+/**
+ * `:::install{package="@vibesdotdev/tools"}` ... `:::` →
+ *   ╭─ install: @vibesdotdev/tools ─────────────╮
+ *   │ $ bun add @vibesdotdev/tools              │
+ *   │                                            │
+ *   │ <body content rendered as plain text>     │
+ *   ╰────────────────────────────────────────────╯
+ */
+export function renderInstallDirectiveCli(node, ansi) {
+    const pkg = node.attrs.package ?? '<package>';
+    const title = `install: ${ansi.bold(ansi.cyan(pkg))}`;
+    const command = `${ansi.green('$')} ${ansi.bold('bun add')} ${pkg}`;
+    const bodyLines = node.body.trim().split('\n');
+    const lines = [
+        `${ansi.gray('╭─')} ${title} ${ansi.gray('─'.repeat(20))}`,
+        `${ansi.gray('│')}  ${command}`
+    ];
+    if (node.body.trim()) {
+        lines.push(`${ansi.gray('│')}`);
+        for (const line of bodyLines) {
+            lines.push(`${ansi.gray('│')}  ${ansi.dim(line)}`);
+        }
+    }
+    lines.push(`${ansi.gray('╰' + '─'.repeat(52))}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/directives/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/directives/install.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAmB,EAAE,IAAe;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,EAAE,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG;QACb,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE;QAC1D,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE;KAC/B,CAAC;IACF,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/cli/directives/shell.d.ts

@@ -0,0 +1,10 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * `:::shell` ... `:::` — copy-able shell command block.
+ *
+ *     $ vibes tools list --json | jq '.[] | .id'
+ *     $ vibes docs search "tools"
+ */
+export declare function renderShellDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=shell.d.ts.map

package/dist/cli/directives/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAQpF"}

package/dist/cli/directives/shell.js

@@ -0,0 +1,16 @@
+/**
+ * `:::shell` ... `:::` — copy-able shell command block.
+ *
+ *     $ vibes tools list --json | jq '.[] | .id'
+ *     $ vibes docs search "tools"
+ */
+export function renderShellDirectiveCli(node, ansi) {
+    const lines = node.body.trim().split('\n');
+    return lines
+        .map((line) => {
+        const trimmed = line.replace(/^\$\s*/, '');
+        return `    ${ansi.green('$')} ${ansi.bold(trimmed)}`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=shell.js.map

package/dist/cli/directives/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/cli/directives/shell.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAmB,EAAE,IAAe;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,KAAK;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3C,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/cli/directives/usage.d.ts

@@ -0,0 +1,9 @@
+import type { BoundAnsi } from '../../render/ansi.ts';
+import type { DirectiveNode } from '../../directives/types.ts';
+/**
+ * `:::usage{language="ts"}` ... `:::` — code usage example.
+ * CLI surface renders without syntax highlighting (web surface uses
+ * kit's <CodeViewer /> with shiki).
+ */
+export declare function renderUsageDirectiveCli(node: DirectiveNode, ansi: BoundAnsi): string;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/directives/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/cli/directives/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAMpF"}

package/dist/cli/directives/usage.js

@@ -0,0 +1,13 @@
+/**
+ * `:::usage{language="ts"}` ... `:::` — code usage example.
+ * CLI surface renders without syntax highlighting (web surface uses
+ * kit's <CodeViewer /> with shiki).
+ */
+export function renderUsageDirectiveCli(node, ansi) {
+    const lang = node.attrs.language ?? 'ts';
+    const header = ansi.gray(`── ${lang} ──`);
+    const lines = node.body.trim().split('\n');
+    const body = lines.map((line) => `    ${line}`).join('\n');
+    return `${header}\n${body}`;
+}
+//# sourceMappingURL=usage.js.map

package/dist/cli/directives/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/cli/directives/usage.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAmB,EAAE,IAAe;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,GAAG,MAAM,KAAK,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/dist/cli/docs/docs.cli.docs.descriptor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Descriptor for docs.cli
+ */
+declare const descriptor: {
+    kind: "docs/topic";
+    id: string;
+    title: string;
+    summary: string;
+    body: {
+        type: "markdown";
+        sourceType: "raw";
+        source: string;
+    };
+    parent: string;
+    order: number;
+    tags: string[];
+    surfaces: readonly ["cli", "web", "in-app"];
+    hardware: readonly ["consumer"];
+    enabled: boolean;
+};
+export default descriptor;
+//# sourceMappingURL=docs.cli.docs.descriptor.d.ts.map

package/dist/cli/docs/docs.cli.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cli.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/docs/docs.cli.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyEH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;CAgBf,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/docs/docs.cli.docs.descriptor.js

@@ -0,0 +1,92 @@
+/**
+ * Descriptor for docs.cli
+ */
+const docsCliMarkdown = `---
+title: Docs CLI
+summary: The vibes docs / vibes man commands for browsing, searching, and generating documentation
+tags: [docs, cli, man, vibes-docs]
+parent: docs
+order: 3
+---
+
+# Docs CLI
+
+The docs/cli surface provides the \`vibes docs\` command group and the \`vibes man\` alias for browsing and searching the documentation registry from the terminal.
+
+## What this provides
+
+- **\`vibes docs\` group** — list, search, show, open, and generate topics.
+- **\`vibes man\` alias** — short alias for \`vibes docs show\`; supports subject refs (\`vibes man tools/tool tools.list\`).
+- **Output modes** — plain text, JSON (\`--json\`), bare (\`--bare\`), no-color (\`--no-color\`).
+
+## Types and clients
+
+\`\`\`ts
+import { getVibesDocsClient } from '@vibesdotdev/docs';
+
+const docs = await getVibesDocsClient(runtime);
+const topics = docs.list();
+\`\`\`
+
+The CLI commands resolve the runtime/client id \`docs\` and call \`list()\`, \`search()\`, and \`findById()\` on it.
+
+## Commands available
+
+\`\`\`bash
+# Discovery
+vibes docs list                          # list every topic
+vibes docs list --tag <tag>              # filter by tag
+vibes docs list --parent <id>            # filter by parent topic
+vibes docs list --json                   # machine-readable output
+
+# Search
+vibes docs search "<query>"              # full-text search
+
+# Render
+vibes docs show <topic-id>               # render a topic body to stdout
+vibes man <topic-id>                     # alias for docs show
+vibes man <kind> <id>                    # render the docs topic for a subject ref
+
+# Open in browser
+vibes docs open <topic-id>               # opens the web docs surface
+
+# Scaffold new descriptor
+vibes docs generate <package> <topic>           # inline pattern (default)
+vibes docs generate <package> <topic> --pattern package
+vibes docs generate <package> <topic> --dry-run
+\`\`\`
+
+## Common options
+
+| Option | Purpose |
+|---|---|
+| \`--json\` | Machine-readable output (parseable by tooling) |
+| \`--bare\` | Skip envelope/formatting (raw body only) |
+| \`--no-color\` | Disable ANSI colors for piping |
+| \`--help\` | Show inline help for any subcommand |
+
+## Related topics
+
+- [\`docs.topics\`](docs.topics) — what each entry in \`vibes docs list\` represents
+- [\`docs.directives\`](docs.directives) — directive blocks rendered in topic bodies
+- [\`cli.commands\`](cli.commands) — global CLI command catalog
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'docs.cli',
+    title: 'Docs CLI',
+    summary: 'The vibes docs / vibes man commands for browsing, searching, and generating documentation',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: docsCliMarkdown
+    },
+    parent: 'docs',
+    order: 3,
+    tags: ['docs', 'cli', 'man', 'vibes-docs'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=docs.cli.docs.descriptor.js.map

package/dist/cli/docs/docs.cli.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cli.docs.descriptor.js","sourceRoot":"","sources":["../../../src/cli/docs/docs.cli.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEvB,CAAC;AAEF,MAAM,UAAU,GAAG;IACjB,IAAI,EAAE,YAAqB;IAC3B,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,2FAA2F;IACpG,IAAI,EAAE;QACJ,IAAI,EAAE,UAAmB;QACzB,UAAU,EAAE,KAAc;QAC1B,MAAM,EAAE,eAAe;KACxB;IACD,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAU;IAC3C,QAAQ,EAAE,CAAC,UAAU,CAAU;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}