@vibesdotdev/cli 0.0.2 → 1.0.0-rc.2

package/dist/commands/completion/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAC/B,WAAW,CA+Db"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAEN,KAAK,qBAAqB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,YAAY,EACX,sBAAsB,IAAI,YAAY,EACtC,qBAAqB,IAAI,WAAW,EACpC,oBAAoB,IAAI,UAAU,EAClC,MAAM,6BAA6B,CAAC;AAgBrC,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAC/B,qBAAqB,CA+DvB"}

package/dist/commands/completion/tree.js

@@ -4,7 +4,8 @@
  * Extracts the full CLI command tree from runtime descriptors.
  * Used by shell completion generators to produce shell-specific output.
  */
-import { getCLIDiscovery } from '../../surface/discovery-cache.js';
+import { CompletionCommandNodeSchema } from "../../schemas/completion.js";
+import { getCLIDiscovery } from "../../surface/discovery-cache.js";
 function parseFlags(flags) {
     const takesValue = flags.includes('<') || flags.includes('[');
     const parts = flags.split(',').map((s) => s.trim().split(/\s/)[0]);
@@ -17,11 +18,11 @@ export function buildCommandTree(runtime, options = {}) {
     const groups = discovery.sortedGroups;
     const commands = discovery.sortedCommands.filter((command) => command.id !== 'completion');
     const groupNodes = new Map();
-    for (const g of groups) {
-        groupNodes.set(g.id, {
-            name: g.name,
-            description: g.description ?? '',
-            aliases: g.aliases ?? [],
+    for (const group of groups) {
+        groupNodes.set(group.id, {
+            name: group.name,
+            description: group.description ?? '',
+            aliases: group.aliases ?? [],
             arguments: [],
             options: [],
             children: []
@@ -38,38 +39,38 @@ export function buildCommandTree(runtime, options = {}) {
         ],
         children: []
     };
-    for (const g of groups) {
-        const node = groupNodes.get(g.id);
+    for (const group of groups) {
+        const node = groupNodes.get(group.id);
         if (!node)
             continue;
-        const parentNode = g.parent ? groupNodes.get(g.parent) : null;
+        const parentNode = group.parent ? groupNodes.get(group.parent) : null;
         (parentNode ?? root).children.push(node);
     }
-    for (const cmd of commands) {
+    for (const command of commands) {
         const node = {
-            name: cmd.name,
-            description: cmd.description ?? '',
-            aliases: cmd.aliases ?? [],
-            arguments: (cmd.arguments ?? []).map((a) => ({
-                name: a.name,
-                description: a.description ?? '',
-                required: a.required ?? false,
-                variadic: a.variadic ?? false
+            name: command.name,
+            description: command.description ?? '',
+            aliases: command.aliases ?? [],
+            arguments: (command.arguments ?? []).map((argument) => ({
+                name: argument.name,
+                description: argument.description ?? '',
+                required: argument.required ?? false,
+                variadic: argument.variadic ?? false
             })),
-            options: (cmd.options ?? []).map((o) => {
-                const parsed = parseFlags(o.flags);
+            options: (command.options ?? []).map((option) => {
+                const parsed = parseFlags(option.flags);
                 return {
                     ...parsed,
-                    description: o.description ?? '',
-                    choices: o.choices,
-                    default: o.default
+                    description: option.description ?? '',
+                    choices: option.choices,
+                    default: option.default
                 };
             }),
             children: []
         };
-        const parent = groupNodes.get(cmd.group);
+        const parent = groupNodes.get(command.group);
         (parent ?? root).children.push(node);
     }
-    return root;
+    return CompletionCommandNodeSchema.parse(root);
 }
 //# sourceMappingURL=tree.js.map

package/dist/commands/completion/tree.js.map

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

package/dist/commands/completion/zsh-widget.js

@@ -17,13 +17,13 @@ export function getWidgetCode() {
 
 _zsh_autosuggest_strategy_vibes() {
     # Only handle vibes-prefixed input
-    [[ "\$1" != vibes* ]] && return
+    [[ "$1" != vibes* ]] && return
 
     # Match against known command paths (no subprocess)
     local _vp
     for _vp in "\${_VIBES_SUGGEST_PATHS[@]}"; do
-        if [[ "vibes \$_vp" == "\$1"* && "vibes \$_vp" != "\$1" ]]; then
-            typeset -g suggestion="vibes \$_vp"
+        if [[ "vibes $_vp" == "$1"* && "vibes $_vp" != "$1" ]]; then
+            typeset -g suggestion="vibes $_vp"
             return
         fi
     done
@@ -31,7 +31,7 @@ _zsh_autosuggest_strategy_vibes() {
 
 # Prepend vibes strategy so it runs first for vibes commands,
 # then falls through to the default history strategy for everything else.
-if (( \$+functions[_zsh_autosuggest_strategy_history] )); then
+if (( $+functions[_zsh_autosuggest_strategy_history] )); then
     ZSH_AUTOSUGGEST_STRATEGY=(vibes \${ZSH_AUTOSUGGEST_STRATEGY[@]})
 fi
 `.trim();

package/dist/commands/completion/zsh.d.ts

@@ -4,6 +4,6 @@
  * Generates zsh tab completion with full flag/argument support
  * and integrates with zsh-autosuggestions for inline ghost-text.
  */
-import type { CommandNode } from './tree';
+import type { CommandNode } from './tree.ts';
 export declare function generateZshCompletion(tree: CommandNode): string;
 //# sourceMappingURL=zsh.d.ts.map

package/dist/commands/completion/zsh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zsh.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/zsh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA4B,MAAM,QAAQ,CAAC;AAmIpE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA0B/D"}
+{"version":3,"file":"zsh.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/zsh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,WAAW,CAAC;AAmIzD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA0B/D"}

package/dist/commands/completion/zsh.impl.consumer.d.ts

@@ -0,0 +1,6 @@
+import { generateZshCompletion } from './zsh.ts';
+declare const implementation: {
+    generate: typeof generateZshCompletion;
+};
+export default implementation;
+//# sourceMappingURL=zsh.impl.consumer.d.ts.map

package/dist/commands/completion/zsh.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/zsh.impl.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD,QAAA,MAAM,cAAc;;CAEqB,CAAC;AAE1C,eAAe,cAAc,CAAC"}

package/dist/commands/completion/zsh.impl.consumer.js

@@ -0,0 +1,6 @@
+import { generateZshCompletion } from "./zsh.js";
+const implementation = {
+    generate: generateZshCompletion
+};
+export default implementation;
+//# sourceMappingURL=zsh.impl.consumer.js.map

package/dist/commands/completion/zsh.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.impl.consumer.js","sourceRoot":"","sources":["../../../src/commands/completion/zsh.impl.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,cAAc,GAAG;IACtB,QAAQ,EAAE,qBAAqB;CACS,CAAC;AAE1C,eAAe,cAAc,CAAC"}

package/dist/commands/completion/zsh.js

@@ -4,7 +4,7 @@
  * Generates zsh tab completion with full flag/argument support
  * and integrates with zsh-autosuggestions for inline ghost-text.
  */
-import { getWidgetCode } from './zsh-widget.js';
+import { getWidgetCode } from "./zsh-widget.js";
 function esc(s) {
     return s.replace(/'/g, "'\\''").replace(/\[/g, '\\[').replace(/\]/g, '\\]');
 }

package/dist/commands/completion/zsh.js.map

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

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

@@ -0,0 +1,8 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+/**
+ * Descriptor for cli.commands
+ * Auto-generated by `vibes docs generate`
+ */
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=cli.commands.docs.descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.commands.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/cli.commands.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE;;;GAGG;AAEH,QAAA,MAAM,UAAU,EAAE,mBA+CjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,55 @@
+import markdown from './content/cli-commands.json' with { type: 'json' };
+/**
+ * Descriptor for cli.commands
+ * Auto-generated by `vibes docs generate`
+ */
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'cli.commands',
+    title: 'CLI Commands',
+    summary: 'Complete reference for vibes CLI commands and groups',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'cli',
+    order: 1,
+    tags: ['cli', 'commands', 'reference', 'man-pages'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer'],
+    enabled: true,
+    man: {
+        name: 'vibes — CLI command reference',
+        section: 1,
+        synopsis: 'vibes <group> <command> [options]',
+        options: [
+            { flag: '--help', description: 'Show help for command' },
+            { flag: '--json', description: 'Output as JSON' },
+            { flag: '--verbose', description: 'Enable verbose logging' },
+            { flag: '--no-color', description: 'Disable ANSI colors' },
+            { flag: '--bare', description: 'Skip envelope/formatting' }
+        ],
+        examples: [
+            {
+                description: 'List all tools',
+                command: 'vibes tools list'
+            },
+            {
+                description: 'View man-page for a topic',
+                command: 'vibes man tools.list'
+            },
+            {
+                description: 'Search documentation',
+                command: 'vibes docs search "runtime query"'
+            },
+            {
+                description: 'Generate new descriptor',
+                command: 'vibes docs generate ai providers.anthropic'
+            }
+        ],
+        seeAlso: ['cli.groups', 'runtime.query', 'docs.topic']
+    }
+};
+export default descriptor;
+//# sourceMappingURL=cli.commands.docs.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.commands.docs.descriptor.js","sourceRoot":"","sources":["../../../src/commands/docs/cli.commands.docs.descriptor.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,6BAA6B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEzE;;;GAGG;AAEH,MAAM,UAAU,GAAwB;IACtC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,sDAAsD;IAC/D,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KACjB;IACD,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC;IACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,GAAG,EAAE;QACH,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,mCAAmC;QAC7C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;YACxD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACjD,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC5D,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE;YAC1D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;SAC5D;QACD,QAAQ,EAAE;YACR;gBACE,WAAW,EAAE,gBAAgB;gBAC7B,OAAO,EAAE,kBAAkB;aAC5B;YACD;gBACE,WAAW,EAAE,2BAA2B;gBACxC,OAAO,EAAE,sBAAsB;aAChC;YACD;gBACE,WAAW,EAAE,sBAAsB;gBACnC,OAAO,EAAE,mCAAmC;aAC7C;YACD;gBACE,WAAW,EAAE,yBAAyB;gBACtC,OAAO,EAAE,4CAA4C;aACtD;SACF;QACD,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,YAAY,CAAC;KACvD;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/cli.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA6BvE,QAAA,MAAM,UAAU,EAAE,mBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,44 @@
+const cliMarkdown = `---
+title: CLI
+summary: Commands, groups, and output.
+parent: 
+order: 10
+---
+
+# CLI
+
+Commands, groups, and output. The \`vibes\` CLI is itself runtime-driven — commands are descriptors of kind \`cli/command\`.
+
+## When to use
+
+Reach for this area when you are scripting against the platform from a terminal or CI, or when you are adding your own \`vibes <group> <command>\` so a capability is reachable from the command line rather than only the web surfaces.
+
+## How it works
+
+The CLI is a command surface, not a capability you resolve in app code. Each command is a descriptor of kind \`cli/command\` (grouped under a \`cli/group\`); the runtime enumerates these descriptors (\`runtime.assets('cli/command')\`) to build the command tree and dispatch the matching implementation when you invoke it — there is no \`runtime.query(...).first()\` call to wire up.
+
+:::card{title="In this section"}
+- [\`branch.commands\`](branch.commands) — Branch hygiene CLI
+- [\`cli.commands\`](cli.commands) — CLI Commands
+- [\`cli.groups\`](cli.groups) — CLI Groups
+- [\`cli.output\`](cli.output) — CLI Output
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'cli',
+    title: 'CLI',
+    summary: "Commands, groups, and output.",
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: cliMarkdown
+    },
+    order: 10,
+    tags: ['cli', 'overview'],
+    surfaces: ['web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=cli.docs.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.docs.descriptor.js","sourceRoot":"","sources":["../../../src/commands/docs/cli.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBnB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,+BAA+B;IACxC,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,WAAW;KACnB;IACD,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=cli.groups.docs.descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.groups.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/cli.groups.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAIvE,QAAA,MAAM,UAAU,EAAE,mBAoCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,40 @@
+import markdown from './content/cli-groups.json' with { type: 'json' };
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'cli.groups',
+    title: 'CLI Groups',
+    summary: 'Command group structure, nesting, and help display',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'cli',
+    order: 2,
+    tags: ['cli', 'groups', 'commands', 'organization', 'help'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer'],
+    enabled: true,
+    man: {
+        name: 'cli.groups — CLI command group structure',
+        section: 1,
+        synopsis: 'vibes man cli.groups',
+        examples: [
+            {
+                description: 'View group structure documentation',
+                command: 'vibes man cli.groups'
+            },
+            {
+                description: 'List all registered groups',
+                command: 'vibes runtime assets cli/group'
+            },
+            {
+                description: 'Show help for a group',
+                command: 'vibes profile --help'
+            }
+        ],
+        seeAlso: ['cli.commands', 'cli.output', 'runtime.assets']
+    }
+};
+export default descriptor;
+//# sourceMappingURL=cli.groups.docs.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.groups.docs.descriptor.js","sourceRoot":"","sources":["../../../src/commands/docs/cli.groups.docs.descriptor.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,2BAA2B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAGvE,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,oDAAoD;IAC7D,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC;IAC3D,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,GAAG,EAAE;QACJ,IAAI,EAAE,0CAA0C;QAChD,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,sBAAsB;QAChC,QAAQ,EAAE;YACT;gBACC,WAAW,EAAE,oCAAoC;gBACjD,OAAO,EAAE,sBAAsB;aAC/B;YACD;gBACC,WAAW,EAAE,4BAA4B;gBACzC,OAAO,EAAE,gCAAgC;aACzC;YACD;gBACC,WAAW,EAAE,uBAAuB;gBACpC,OAAO,EAAE,sBAAsB;aAC/B;SACD;QACD,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,gBAAgB,CAAC;KACzD;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=cli.output.docs.descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.output.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/cli.output.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAIvE,QAAA,MAAM,UAAU,EAAE,mBAyCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,45 @@
+import markdown from './content/cli-output.json' with { type: 'json' };
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'cli.output',
+    title: 'CLI Output',
+    summary: 'Output formatting, UI toolkit integration, tables, and colors',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'cli',
+    order: 3,
+    tags: ['cli', 'output', 'formatting', 'ui', 'tables', 'colors'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer'],
+    enabled: true,
+    man: {
+        name: 'cli.output — CLI output formatting and UI toolkit',
+        section: 1,
+        synopsis: 'vibes man cli.output',
+        options: [
+            { flag: '--json', description: 'Output as JSON' },
+            { flag: '--yaml', description: 'Output as YAML' },
+            { flag: '--no-color', description: 'Disable ANSI colors' }
+        ],
+        examples: [
+            {
+                description: 'View output formatting documentation',
+                command: 'vibes man cli.output'
+            },
+            {
+                description: 'List commands with JSON output',
+                command: 'vibes tools list --json'
+            },
+            {
+                description: 'Profile list with JSON output',
+                command: 'vibes profile list --json'
+            }
+        ],
+        seeAlso: ['cli.commands', 'cli.groups', 'tools.list']
+    }
+};
+export default descriptor;
+//# sourceMappingURL=cli.output.docs.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.output.docs.descriptor.js","sourceRoot":"","sources":["../../../src/commands/docs/cli.output.docs.descriptor.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,2BAA2B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAGvE,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,+DAA+D;IACxE,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC/D,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,GAAG,EAAE;QACJ,IAAI,EAAE,mDAAmD;QACzD,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE;YACR,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACjD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACjD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE;SAC1D;QACD,QAAQ,EAAE;YACT;gBACC,WAAW,EAAE,sCAAsC;gBACnD,OAAO,EAAE,sBAAsB;aAC/B;YACD;gBACC,WAAW,EAAE,gCAAgC;gBAC7C,OAAO,EAAE,yBAAyB;aAClC;YACD;gBACC,WAAW,EAAE,+BAA+B;gBAC5C,OAAO,EAAE,2BAA2B;aACpC;SACD;QACD,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,YAAY,CAAC;KACrD;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/docs/content/cli-commands.json

@@ -0,0 +1 @@
+"---\ntitle: CLI Commands\nsummary: Complete reference for vibes CLI commands and groups\ntags: [cli, commands, reference, man-pages]\nparent: cli\norder: 1\n---\n\n# CLI Commands\n\nThe vibes CLI provides command-line access to runtime features, documentation, and development tools.\n\n## Overview\n\nThe CLI is organized into **groups** and **commands**:\n\n\\`\\`\\`\nvibes <group> <command> [options]\n\\`\\`\\`\n\n## Available groups\n\n### \\`vibes tools\\`\n\nTool management and invocation:\n\n- \\`vibes tools list\\` — List all registered tools\n- \\`vibes tools run <id>\\` — Invoke a tool by id\n- \\`vibes tools inspect <id>\\` — Show tool metadata\n\n### \\`vibes docs\\`\n\nDocumentation browsing:\n\n- \\`vibes docs show <topic>\\` — Render a topic to stdout\n- \\`vibes docs list\\` — List all topics\n- \\`vibes docs search <query>\\` — Search topics\n- \\`vibes docs open <topic>\\` — Open topic in browser\n- \\`vibes docs generate <package> <topic>\\` — Scaffold new descriptor\n\n### \\`vibes man\\`\n\nManual pages (alias for \\`vibes docs show\\`):\n\n- \\`vibes man <topic>\\` — Show man-page for topic\n- \\`vibes man <kind> <id>\\` — Show by subject reference\n\n### \\`vibes dev\\`\n\nDevelopment commands:\n\n- \\`vibes dev start\\` — Start development server\n- \\`vibes dev build\\` — Build for production\n- \\`vibes dev test\\` — Run tests\n- \\`vibes dev lint\\` — Run linter\n\n### \\`vibes workspace\\`\n\nWorkspace management:\n\n- \\`vibes workspace info\\` — Show workspace metadata\n- \\`vibes workspace list\\` — List workspace slices\n- \\`vibes workspace switch <slice>\\` — Switch active slice\n\n## Common options\n\nThese options are available across most commands:\n\n| Option | Description | Example |\n|--------|-------------|---------|\n| \\`--help\\` | Show help for command | \\`vibes tools list --help\\` |\n| \\`--json\\` | Output as JSON | \\`vibes tools list --json\\` |\n| \\`--verbose\\` | Enable verbose logging | \\`vibes dev start --verbose\\` |\n| \\`--no-color\\` | Disable ANSI colors | \\`vibes man tools.list --no-color\\` |\n| \\`--bare\\` | Skip envelope/formatting | \\`vibes man tools.list --bare\\` |\n\n## Examples\n\n### List all tools as JSON\n\n\\`\\`\\`bash\nvibes tools list --json | jq '.[] | { id: .id, description: .description }'\n\\`\\`\\`\n\n### View documentation\n\n\\`\\`\\`bash\n# By topic id\nvibes man tools.list\n\n# By subject reference\nvibes man tools/tool tools.list\n\n# Open in browser\nvibes docs open tools.list\n\\`\\`\\`\n\n### Search documentation\n\n\\`\\`\\`bash\n# Search by keyword\nvibes docs search \"runtime query\"\n\n# Filter by tag\nvibes docs list --tag=tools\n\n# Filter by parent\nvibes docs list --parent=runtime\n\\`\\`\\`\n\n### Generate new descriptor\n\n\\`\\`\\`bash\n# Inline pattern (default)\nvibes docs generate ai providers.anthropic\n\n# Package-sourced pattern\nvibes docs generate storage adapters.drizzle --pattern package\n\n# With custom metadata\nvibes docs generate tools my-tool \\\\\n  --parent tools \\\\\n  --title \"My Custom Tool\" \\\\\n  --dry-run\n\\`\\`\\`\n\n## Exit codes\n\n| Code | Meaning |\n|------|---------|\n| 0 | Success |\n| 1 | General error |\n| 2 | Invalid arguments |\n| 3 | Topic not found |\n| 4 | Permission denied |\n\n## Environment variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| \\`VIBES_HOME\\` | Vibes configuration directory | \\`~/.vibes\\` |\n| \\`VIBES_LOG_LEVEL\\` | Logging level | \\`info\\` |\n| \\`VIBES_NO_COLOR\\` | Disable colors | \\`false\\` |\n| \\`VIBES_HARDWARE\\` | Hardware surface | \\`consumer\\` |\n\n## Related\n\n:::card{title=\"See also\"}\n- [\\`cli.groups\\`](cli.groups) — Command group structure\n- [\\`runtime.query\\`](runtime.query) — Runtime discovery API\n- [\\`docs.topic\\`](docs.topics) — Descriptor schema\n:::\n\n## Pattern implementations\n\nThe CLI plugin composes CRUD, config-namespace, tool-wrapper, log-viewer and process-manager through the kernel's cli/pattern kind. PatternResolver resolves and enumerates the handed runtime's live graph. registerPattern supports custom implementations and replacement before or after activation; registrations stay local to that runtime. Kinds-only composition imports metadata without builtin loaders. Missing patterns refuse NOT_FOUND / not-registered; malformed implementations refuse INVALID_INPUT / implementation-invalid with value-free kind and id facts.\n"

package/dist/commands/docs/content/cli-groups.json

@@ -0,0 +1 @@
+"---\ntitle: CLI Groups\nsummary: Command group structure, nesting, and help display\ntags: [cli, groups, commands, organization, help]\nparent: cli\norder: 2\n---\n\n# CLI Groups\n\nCommand groups organize CLI commands into logical subcommand trees. Groups provide structure, discoverability, and consistent help display across the vibes CLI.\n\n## Overview\n\nGroups are registered as \\`cli/group\\` runtime assets. Each group can contain commands or nested subgroups, forming a hierarchical command tree.\n\n\\`\\`\\`\nvibes <group> <subgroup> <command> [options]\n\\`\\`\\`\n\n## Group descriptor structure\n\nGroups are defined with a descriptor that specifies metadata:\n\n\\`\\`\\`ts\nimport type { CLIGroupAssetDescriptor } from '@vibesdotdev/cli/schemas/descriptors';\n\nconst profileGroup: CLIGroupAssetDescriptor = {\n  kind: 'cli/group',\n  id: 'profile',\n  name: 'profile',\n  description: 'Manage configuration profiles',\n  parent: 'config',  // optional — creates 'vibes config profile'\n  aliases: ['prof'], // optional aliases\n  surfaces: ['cli'],\n  order: 2,          // sort order within parent\n  internal: false    // if true, hidden unless --internal flag\n};\n\\`\\`\\`\n\n### Fields\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| \\`id\\` | string | ✅ | Unique identifier (dot-separated for nesting) |\n| \\`name\\` | string | ✅ | Command name as typed |\n| \\`description\\` | string | ✅ | Help text shown in parent's help |\n| \\`parent\\` | string | ❌ | Parent group id for nesting |\n| \\`aliases\\` | string[] | ❌ | Alternative names |\n| \\`surfaces\\` | \\`'cli' | 'web' | 'worker' | 'bridge'\\`[] | ❌ | Where group appears |\n| \\`order\\` | number | ❌ | Sibling sort order (lower = earlier) |\n| \\`internal\\` | boolean | ❌ | If true, hidden by default |\n\n## Group registration\n\nGroups are registered via the runtime plugin:\n\n\\`\\`\\`ts\n// cli/src/cli.plugin.ts\nimport profileGroup from './commands/profile/profile-group.descriptor';\n\nexport default createRuntimePlugin({\n  id: 'cli',\n  kinds: [cliGroupKind, cliCommandKind],\n  descriptors: [\n    profileGroup,\n    // ... other groups and commands\n  ]\n});\n\\`\\`\\`\n\n## Nested groups\n\nGroups can nest by referencing a parent:\n\n\\`\\`\\`ts\n// Parent group\nconst configGroup: CLIGroupAssetDescriptor = {\n  kind: 'cli/group',\n  id: 'config',\n  name: 'config',\n  description: 'Configuration management'\n};\n\n// Child group\nconst profileGroup: CLIGroupAssetDescriptor = {\n  kind: 'cli/group',\n  id: 'config.profile',\n  name: 'profile',\n  description: 'Manage configuration profiles',\n  parent: 'config'  // → 'vibes config profile'\n};\n\\`\\`\\`\n\n**Result:**\n\n\\`\\`\\`bash\nvibes config           # parent group\nvibes config profile   # nested group\nvibes config profile list\nvibes config profile create\n\\`\\`\\`\n\n## Help display\n\nGroups automatically generate help text:\n\n\\`\\`\\`bash\n# Parent group help — shows subgroups and commands\n$ vibes config --help\n\nUsage: vibes config [options] [command]\n\nConfiguration management\n\nCommands:\n  profile     Manage configuration profiles\n  env         Environment variable management\n  help [command]  display help for command\n\n# Nested group help\n$ vibes config profile --help\n\nUsage: vibes config profile [options] [command]\n\nManage configuration profiles\n\nCommands:\n  list      List all profiles\n  create    Create a new profile\n  use       Switch active profile\n  delete    Delete a profile\n  info      Show profile details\n  help [command]  display help for command\n\\`\\`\\`\n\n## Group resolution\n\nThe CLI surface resolves groups at runtime:\n\n1. **Discovery** — Query \\`runtime.assets('cli/group')\\` for all group descriptors\n2. **Filtering** — Apply surface and hardware filters\n3. **Sorting** — Order by \\`descriptor.order\\`\n4. **Registration** — Attach to Commander.js parent command\n\n\\`\\`\\`ts\n// cli/src/surface/register-groups.ts\nconst discovery = getCLIDiscovery(runtime, options);\nconst groups = discovery.sortedGroups;\n\nfor (const group of groups) {\n  await registerGroup(params, group);\n}\n\\`\\`\\`\n\n### Parent resolution\n\nIf a group references a missing parent:\n\n- **Strict mode** (the host's \\`strict\\` option, or \\`CLISurfaceOptions.strictGroupParents\\`): throws error\n- **Lenient mode** (default): logs warning, attaches to root\n\n## Pattern-based groups\n\nGroups can use patterns for dynamic behavior:\n\n\\`\\`\\`ts\nconst runtimeGroup: CLIPatternDescriptor = {\n  kind: 'cli/group',\n  id: 'runtime',\n  name: 'runtime',\n  description: 'Runtime management',\n  pattern: 'crud',  // auto-generates list/create/delete commands\n  patternConfig: {\n    entityType: 'runtime/plugin',\n    listFields: ['id', 'name', 'version']\n  }\n};\n\\`\\`\\`\n\nPatterns are resolved by the pattern resolver:\n\n\\`\\`\\`ts\n// cli/src/surface/register-groups.ts\nif (params.patternResolver && isPatternDescriptor(descriptor)) {\n  const ctx = await params.buildContext();\n  await params.patternResolver.resolve(\n    descriptor as CLIPatternDescriptor,\n    groupCmd,\n    ctx\n  );\n}\n\\`\\`\\`\n\n## Common patterns\n\n### Flat structure\n\nSimple commands without nesting:\n\n\\`\\`\\`ts\nconst completionGroup: CLIGroupAssetDescriptor = {\n  kind: 'cli/group',\n  id: 'shell-integration',\n  name: 'shell-integration',\n  description: 'Shell completions and integrations'\n};\n\\`\\`\\`\n\n### Deep nesting\n\nMulti-level command trees:\n\n\\`\\`\\`ts\n// vibes → dev → server → start\nconst serverGroup: CLIGroupAssetDescriptor = {\n  kind: 'cli/group',\n  id: 'dev.server',\n  name: 'server',\n  description: 'Development server',\n  parent: 'dev'\n};\n\\`\\`\\`\n\n### Aliased groups\n\nMultiple access paths:\n\n\\`\\`\\`ts\nconst profileGroup: CLIGroupAssetDescriptor = {\n  kind: 'cli/group',\n  id: 'profile',\n  name: 'profile',\n  description: 'Manage profiles',\n  aliases: ['prof', 'p']\n};\n\n// All equivalent:\nvibes profile list\nvibes prof list\nvibes p list\n\\`\\`\\`\n\n## WRONG patterns\n\n### ❌ Missing description\n\n\\`\\`\\`ts\n// BAD — help text is empty\nconst group = {\n  kind: 'cli/group',\n  id: 'mystery',\n  name: 'mystery',\n  description: ''  // ← shows as blank in help\n};\n\\`\\`\\`\n\n### ❌ Circular parent references\n\n\\`\\`\\`ts\n// BAD — creates infinite loop\nconst groupA = { id: 'a', parent: 'b' };\nconst groupB = { id: 'b', parent: 'a' };  // ← circular!\n\\`\\`\\`\n\n### ❌ Duplicate IDs\n\n\\`\\`\\`ts\n// BAD — second registration overwrites first\nconst group1 = { id: 'profile', name: 'profile' };\nconst group2 = { id: 'profile', name: 'prof' };  // ← conflict!\n\\`\\`\\`\n\n### ❌ Non-existent parent\n\n\\`\\`\\`ts\n// BAD — parent 'config' doesn't exist\nconst profileGroup = {\n  id: 'profile',\n  parent: 'config'  // ← warning in lenient mode, error in strict\n};\n\\`\\`\\`\n\n## Related\n\n:::card{title=\"See also\"}\n- [\\`cli.commands\\`](cli.commands) — Command structure and execution\n- [\\`cli.output\\`](cli.output) — Output formatting and display\n- \\`runtime.assets\\` — Asset discovery API\n:::\n"

package/dist/commands/docs/content/cli-output.json

@@ -0,0 +1 @@
+"---\ntitle: CLI Output\nsummary: Output formatting, UI toolkit integration, tables, and colors\ntags: [cli, output, formatting, ui, tables, colors]\nparent: cli\norder: 3\n---\n\n# CLI Output\n\nThe vibes CLI provides consistent output formatting through the \\`VibesUIToolkit\\`. Commands use the toolkit to render tables, JSON, YAML, and formatted text with proper colorization and structure.\n\n## Overview\n\nOutput formatting is handled by \\`VibesUIToolkit\\`, a unified interface for CLI output that supports multiple formats and interactive prompts.\n\n\\`\\`\\`ts\nimport { VibesUIToolkit } from '@vibesdotdev/cli/support/ui-toolkit';\nimport { getRuntimeStdio } from '@vibesdotdev/kernel';\n\n// output is where the toolkit writes: the handed runtime's text output.\nconst ui = VibesUIToolkit.createSync({ mode: 'plain', output: await getRuntimeStdio(runtime) });\nui.info('Starting process...');\nui.table(data);\nui.success('Done!');\n\\`\\`\\`\n\n## Runtime-owned command output\n\nUse `writeStdout(runtime, text)`, `writeStdoutLine(runtime, text)` and\n`writeJson(runtime, payload, options?)` from `@vibesdotdev/cli/output`.\nThey select the handed runtime's stdio and await its output-plane flush.\nWrite and flush failures propagate; failed JSON delivery never marks the\ninvocation's JSON document as successfully written.\n\nEvery writer names the runtime it writes through; there is no runtime-free\noverload. `beginJsonPayloadLedger(runtime)` opens an invocation, and\n`hasWrittenJsonPayload(runtime)` / `resetJsonPayloadLedger(runtime)` name the\nruntime they read or clear. Pre-bootstrap native text output comes from the\npublic `@vibesdotdev/host-node/stdio` owner (`createNodeRuntimeStdio`).\n\nInteractive action selection uses captured runtime terminal facts. Explicit\n`--non-interactive`, `--no-interactive`, `--json`, `--format json` and\n`--format=json` take the supported fallback even under force settings.\nProfile deletion resolves the runtime's registered terminal transport before\nconfirmation. Cancellation or refusal preserves the profile; piped confirmation\nuses a runtime stdin read bounded to 4096 bytes. Native prompts resolve the public\n`@vibesdotdev/host-node/terminal-input` owner through the runtime. Explicit\n`cli/terminal-input` overrides take precedence over the production default.\nLine and hidden input preserve cancellation and EOF, restore raw mode and\nlisteners, and release active prompts through the runtime client lifecycle.\nTerminal observations are captured by the host; prompt consumers do not read\nambient process TTY state.\n\n`runtime export PATH` keeps absolute destinations unchanged. Relative paths\nuse the workspace root first, then the runtime's declared cwd. Without either,\nthe command refuses `UNAVAILABLE / cwd-unavailable` before writing.\n\n## Static loader generation\n\n`runtime codegen [destination]` resolves the Workspace static-loader generator through the runtime. Hosts that need generation compose @vibesdotdev/workspace/static-loader/plugin; without it the command refuses UNAVAILABLE / static-loader-generator-unavailable before writing.\nHosts supply optional generation input and the required canonical owner result schema through `cli/runtime-codegen-input`.\nWorkspace hosts pass `StaticLoaderResultSchema` from `@vibesdotdev/workspace/static-loader`;\ndirect `generate` calls may provide `input`; they still require the host\ncontext's result schema. The complete owner result is validated before writing; its source is used for the generated file and omitted from returned metadata;\nowner fields stay flat alongside destination, filters, counts and structured\ndiagnostics. Invalid results refuse INTERNAL / runtime-codegen-result-invalid,\nand a missing schema refuses UNAVAILABLE / runtime-codegen-result-schema-unavailable.\nGenerated modules export an\nexecutable plugin and registration helper with lazy implementation imports.\nCanonical surface/hardware constraints drive filtering and structured diagnostics.\nThe default destination is `dist/runtime-loader.generated.ts`, following the\nsame workspace/cwd rules as runtime export.\n\n## VibesUIToolkit API\n\n### Creation\n\n\\`\\`\\`ts\n// Synchronous creation (most common)\nconst ui = VibesUIToolkit.createSync({\n  output: await getRuntimeStdio(runtime), // required: the runtime's text output\n  mode: 'plain',    // or 'rich' for TUI apps\n  compact: false,   // reduce whitespace\n  autoExit: true    // exit after command completes\n});\n\\`\\`\\`\n\n### Output methods\n\n| Method | Description | Output |\n|--------|-------------|--------|\n| \\`ui.info(message)\\` | Informational message | stdout |\n| \\`ui.success(message)\\` | Success message | stdout |\n| \\`ui.warn(message)\\` | Warning message | stderr |\n| \\`ui.error(message)\\` | Error message | stderr |\n| \\`ui.log(message)\\` | Raw log output | stdout |\n\n### Format-aware rendering\n\nThe CLI registers json, yaml, table, markdown, text, and raw formatters. Plugins may register additional ids or replace a built-in. Global --format uses an open id; CLI resolves the selected runtime formatter before execution and refuses NOT_FOUND / cli-output-format-unavailable when it cannot render that id. Malformed ids refuse INVALID_INPUT / cli-output-format-invalid before dispatch. Returned-data commands render once through the selected formatter and use\nthe inherited table format by default. --json uses the selected JSON formatter,\nincluding host replacements, and delivers one rendered document. Runtime-UI\ncommands honor the selected formatter. A command implementation declaring outputBoundary: 'direct' owns its bytes and refuses a global non-JSON format as INVALID_INPUT / cli-output-format-boundary-unsupported before action work. --json takes precedence, and a command-local --format remains command-owned.\n\n\\`\\`\\`ts\nui.setFormat('json');   // or 'yaml', 'table', 'markdown'\nui.render(data);        // outputs in selected format\n\\`\\`\\`\n\n**Format examples:**\n\n\\`\\`\\`ts\nconst data = [\n  { id: 'tools.list', description: 'List tools' },\n  { id: 'tools.info', description: 'Show tool info' }\n];\n\n// JSON output\nui.setFormat('json');\nui.render(data);\n// [{ \"id\": \"tools.list\", \"description\": \"List tools\" }, ...]\n\n// YAML output\nui.setFormat('yaml');\nui.render(data);\n// - id: tools.list\n//   description: List tools\n\n// Table output\nui.setFormat('table');\nui.render(data);\n// ┌─────────────┬──────────────────┐\n// │    id       │   description    │\n// ├─────────────┼──────────────────┤\n// │ tools.list  │  List tools      │\n// │ tools.info  │  Show tool info  │\n// └─────────────┴──────────────────┘\n\\`\\`\\`\n\n## Table rendering\n\nTables are the primary output format for list commands:\n\n\\`\\`\\`ts\n// Basic table\nui.table(data);\n\n// With column selection\nui.table(data, { columns: ['id', 'name'] });\n\n// With title\nui.table(data, { title: 'Registered Tools' });\n\n// Column names only (shorthand)\nui.table(data, ['id', 'name', 'status']);\n\\`\\`\\`\n\n### Table options\n\n\\`\\`\\`ts\ninterface TableOptions {\n  columns?: string[];   // subset of fields to display\n  title?: string;       // table header\n}\n\n// Usage\nui.table(rows, {\n  columns: ['id', 'description', 'enabled'],\n  title: 'Available Commands'\n});\n\\`\\`\\`\n\n### Example: Command list\n\n\\`\\`\\`ts\nconst commands = [\n  { id: 'profile.list', group: 'profile', description: 'List profiles' },\n  { id: 'profile.create', group: 'profile', description: 'Create profile' },\n  { id: 'completion', description: 'Generate completions' }\n];\n\nui.table(commands, {\n  columns: ['id', 'group', 'description'],\n  title: 'Registered Commands'\n});\n\\`\\`\\`\n\n**Output:**\n\n\\`\\`\\`\nRegistered Commands\n┌─────────────────┬───────────────────┬────────────────────┐\n│       id        │      group        │    description     │\n├─────────────────┼───────────────────┼────────────────────┤\n│  profile.list   │     profile       │   List profiles    │\n│ profile.create  │     profile       │   Create profile   │\n│   completion    │                   │ Generate completions│\n└─────────────────┴───────────────────┴────────────────────┘\n\\`\\`\\`\n\n## JSON/YAML output\n\nThe toolkit renders JSON and YAML; each command descriptor defines its accepted flags.\n\n\\`\\`\\`ts\n// Command implementation pattern\nasync function listProfiles(options: { json?: boolean }) {\n  const profiles = await getProfiles();\n  \n  if (options.json) {\n    ui.setFormat('json');\n    ui.render(profiles);\n  } else {\n    ui.table(profiles, { columns: ['name', 'active', 'created'] });\n  }\n}\n\\`\\`\\`\n\n**Usage:**\n\n\\`\\`\\`bash\n# Default table output\n$ vibes profile list\n\n# JSON for scripting\n$ vibes profile list --json | jq '.[] | select(.active == true)'\n\n# Save profile data as JSON\n$ vibes profile list --json > profiles.json\n\\`\\`\\`\n\n## Interactive prompts\n\nThe toolkit provides interactive prompts for user input:\n\n\\`\\`\\`ts\n// Text input\nconst name = await ui.prompt('Profile name:', { default: 'default' });\n\n// Confirmation\nconst confirmed = await ui.confirm('Delete this profile?', false);\n\n// Single selection\nconst choice = await ui.select('Select profile:', [\n  { label: 'Development', value: 'dev' },\n  { label: 'Production', value: 'prod' }\n]);\n\n// Multiple selection\nconst profiles = await ui.multiselect('Select profiles to delete:', [\n  { label: 'Old Dev', value: 'old-dev' },\n  { label: 'Test', value: 'test' }\n], false);\n\\`\\`\\`\n\n### Non-interactive fallback\n\nPrompts gracefully degrade in non-TTY environments:\n\n\\`\\`\\`ts\n// Returns default in CI/pipes\nconst name = await ui.prompt('Name:', { default: 'default' });\n// → 'default' if not interactive\n\n// Returns empty array in CI\nconst choices = await ui.multiselect('Choose:', options);\n// → [] if not interactive and not required\n\\`\\`\\`\n\n## Progress indicators\n\nSimple progress tracking for long operations:\n\n\\`\\`\\`ts\nconst progress = ui.progress('Building...');\nprogress.update('Compiling modules...');\nprogress.complete('Build complete!');\n\n// Or with failure\ntry {\n  await build();\n  progress.complete('Success!');\n} catch (error) {\n  progress.fail('Build failed');\n  throw error;\n}\n\\`\\`\\`\n\n## Color and formatting\n\nThe toolkit respects environment variables and options:\n\n\\`\\`\\`bash\n# Environment variable\nVIBES_NO_COLOR=1 vibes profile list\n\n# Command flag\nvibes profile list --no-color\n\\`\\`\\`\n\n### Color methods\n\n\\`\\`\\`ts\n// Built-in colorization (when enabled)\nui.info('ℹ️  Information');    // blue\nui.success('✅ Success');       // green\nui.warn('⚠️  Warning');         // yellow\nui.error('❌ Error');           // red\n\\`\\`\\`\n\n## Integration with commands\n\nCommands receive a UI toolkit through the context:\n\n\\`\\`\\`ts\n// cli/src/commands/profile/profile.list.impl.ts\nimport { getRuntimeStdio } from '@vibesdotdev/kernel';\nimport { VibesUIToolkit } from '../../support/ui-toolkit';\n\nexport async function execute(\n  args: Record<string, unknown>,\n  opts: { json?: boolean },\n  context: CommandContext\n): Promise<void> {\n  const ui = VibesUIToolkit.createSync({ mode: 'plain', output: await getRuntimeStdio(context.runtime) });\n  \n  if (opts.json) ui.setFormat('json');\n\n  const profiles = await listProfiles();\n  \n  if (opts.json) {\n    ui.render(profiles);\n  } else {\n    ui.table(profiles, {\n      columns: ['name', 'active', 'created'],\n      title: 'Configuration Profiles'\n    });\n  }\n}\n\\`\\`\\`\n\n## Log buffer integration\n\nCommands can buffer output during execution:\n\n\\`\\`\\`ts\n// Descriptor with log buffer config\nconst command: CLICommandAssetDescriptor = {\n  kind: 'cli/command',\n  id: 'dev.build',\n  name: 'build',\n  description: 'Build the project',\n  group: 'dev',\n  logBuffer: {\n    enabled: true,\n    sinks: ['file', 'memory'],\n    fallbackToStdout: true\n  }\n};\n\\`\\`\\`\n\nBuffered output is held until command completion, then flushed:\n\n\\`\\`\\`bash\n# Output appears all at once when command finishes\n$ vibes dev build\n[build output buffered...]\n✅ Build complete!\n\\`\\`\\`\n\n## WRONG patterns\n\n### ❌ Direct console.log\n\n\\`\\`\\`ts\n// BAD — bypasses formatting, breaks --json\nconsole.log('Profile:', profile.name);\n\n// GOOD — uses toolkit\nui.info(\\`Profile: \\${profile.name}\\`);\n\\`\\`\\`\n\n### ❌ Mixed output streams\n\n\\`\\`\\`ts\n// BAD — data on stdout, errors mixed in\nconsole.log(data);\nconsole.error('Warning: deprecated');\n\n// GOOD — separate concerns\nui.render(data);      // data to stdout\nui.warn('Warning');   // warnings to stderr\n\\`\\`\\`\n\n### ❌ Unawaited JSON writes\n\n\\`\\`\\`ts\n// BAD — command can resolve before a large pipe drains\nconsole.log(JSON.stringify(data, null, 2));\n\n// GOOD — machine-readable stdout is part of the async command contract\nimport { writeJson } from '@vibesdotdev/cli/output';\n\nawait writeJson(context.runtime, data);\n\\`\\`\\`\n\n### ❌ Ignoring format flags\n\n\\`\\`\\`ts\n// BAD — always outputs table\nui.table(profiles);\n\n// GOOD — respects the declared JSON option\nif (opts.json) {\n  ui.setFormat('json');\n  ui.render(profiles);\n} else {\n  ui.table(profiles);\n}\n\\`\\`\\`\n\n### ❌ Hardcoded colors\n\n\\`\\`\\`ts\n// BAD — ignores VIBES_NO_COLOR\nprocess.stdout.write('\\\\x1b[32mSuccess\\\\x1b[0m');\n\n// GOOD — use toolkit methods\nui.success('Success');\n\\`\\`\\`\n\n## Environment variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| \\`VIBES_NO_COLOR\\` | Disable ANSI colors | \\`false\\` |\n| \\`VIBES_OUTPUT_FORMAT\\` | Default output format | \\`table\\` |\n| \\`VIBES_INTERACTIVE\\` | Force interactive mode | auto-detect |\n| \\`CI\\` | CI mode (non-interactive) | auto-detect |\n\n## Related\n\n:::card{title=\"See also\"}\n- [\\`cli.commands\\`](cli.commands) — Command structure and execution\n- [\\`cli.groups\\`](cli.groups) — Command group organization\n- [\\`tools.list\\`](tools.list) — Example command using output formatting\n:::\n"

package/dist/commands/docs/doc-paths.d.ts

@@ -0,0 +1,11 @@
+/** Doc-tree paths: where a command or group page lives, and the `vibes …` invocation it documents. */
+import type { CLICommandAssetDescriptor, CLIGroupAssetDescriptor } from '../../schemas/descriptors.ts';
+/**
+ * Compute the group path segments (parent-most → leaf) for a group.
+ */
+export declare function groupPathSegments(group: CLIGroupAssetDescriptor, groupsById: Map<string, CLIGroupAssetDescriptor>): string[];
+export declare function commandInvocation(command: CLICommandAssetDescriptor, groupsById: Map<string, CLIGroupAssetDescriptor>): string;
+export declare function commandDocPath(command: CLICommandAssetDescriptor, groupsById: Map<string, CLIGroupAssetDescriptor>): string;
+export declare function groupDocPath(group: CLIGroupAssetDescriptor, groupsById: Map<string, CLIGroupAssetDescriptor>): string;
+export declare function sanitizeForPath(name: string): string;
+//# sourceMappingURL=doc-paths.d.ts.map

package/dist/commands/docs/doc-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-paths.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/doc-paths.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvG;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,uBAAuB,EAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC9C,MAAM,EAAE,CAQV;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,yBAAyB,EAClC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC9C,MAAM,CAIR;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,yBAAyB,EAClC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC9C,MAAM,CAMR;AAED,wBAAgB,YAAY,CAC3B,KAAK,EAAE,uBAAuB,EAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC9C,MAAM,CAGR;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/commands/docs/doc-paths.js

@@ -0,0 +1,32 @@
+/**
+ * Compute the group path segments (parent-most → leaf) for a group.
+ */
+export function groupPathSegments(group, groupsById) {
+    const chain = [];
+    let cursor = group;
+    while (cursor) {
+        chain.unshift(cursor);
+        cursor = cursor.parent ? groupsById.get(cursor.parent) : undefined;
+    }
+    return chain.map((g) => g.name);
+}
+export function commandInvocation(command, groupsById) {
+    const group = groupsById.get(command.group);
+    const groupSegments = group ? groupPathSegments(group, groupsById) : [];
+    return ['vibes', ...groupSegments, command.name].join(' ');
+}
+export function commandDocPath(command, groupsById) {
+    const group = groupsById.get(command.group);
+    const groupSegments = group ? groupPathSegments(group, groupsById) : [];
+    const dir = ['commands', ...groupSegments].join('/');
+    const safeName = sanitizeForPath(command.name);
+    return `${dir}/${safeName}.md`;
+}
+export function groupDocPath(group, groupsById) {
+    const segments = groupPathSegments(group, groupsById);
+    return ['commands', ...segments, 'README.md'].join('/');
+}
+export function sanitizeForPath(name) {
+    return name.replace(/[^a-z0-9_.-]/gi, '_');
+}
+//# sourceMappingURL=doc-paths.js.map

package/dist/commands/docs/doc-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-paths.js","sourceRoot":"","sources":["../../../src/commands/docs/doc-paths.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAChC,KAA8B,EAC9B,UAAgD;IAEhD,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,IAAI,MAAM,GAAwC,KAAK,CAAC;IACxD,OAAO,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,OAAkC,EAClC,UAAgD;IAEhD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO,CAAC,OAAO,EAAE,GAAG,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,OAAkC,EAClC,UAAgD;IAEhD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,GAAG,GAAG,IAAI,QAAQ,KAAK,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,KAA8B,EAC9B,UAAgD;IAEhD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACtD,OAAO,CAAC,UAAU,EAAE,GAAG,QAAQ,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC"}