@vibesdotdev/cli 0.0.1

package/dist/core/schemas/manifest.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLI Core Schema Manifest
+ * Compatibility shim for command manifests
+ */
+export interface CommandDoc {
+    path: string;
+    title: string;
+}
+export interface CommandEntry {
+    name: string;
+    description: string;
+    schema?: unknown;
+    access?: {
+        auth?: 'required' | 'optional' | 'none';
+    };
+    docs?: CommandDoc[];
+}
+export interface CommandManifest {
+    namespace: string;
+    description: string;
+    commands: CommandEntry[];
+    docs?: CommandDoc[];
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/schemas/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;KACzC,CAAC;IACF,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;CACrB"}

package/dist/core/schemas/manifest.js

@@ -0,0 +1,6 @@
+/**
+ * CLI Core Schema Manifest
+ * Compatibility shim for command manifests
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/core/schemas/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/core/schemas/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/core/schemas/types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI Core Schema Types
+ * Compatibility shim
+ */
+export type { CLIContext } from '../../providers.ts';
+export type { RuntimeContext } from '../runtime/context.ts';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/schemas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/schemas/types.js

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

package/dist/core/schemas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/schemas/types.ts"],"names":[],"mappings":""}

package/dist/core/ui/interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI UI Interface
+ * Compatibility shim for UI handles
+ */
+export interface IUIHandles {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    success(message: string): void;
+    log(message: string): void;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/core/ui/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/core/ui/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/core/ui/interface.js

@@ -0,0 +1,6 @@
+/**
+ * CLI UI Interface
+ * Compatibility shim for UI handles
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/core/ui/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/core/ui/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

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

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

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

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

@@ -0,0 +1,207 @@
+/**
+ * Descriptor for cli.commands
+ * Auto-generated by `vibes docs generate`
+ */
+const cli_commandsMarkdown = `---
+title: CLI Commands
+summary: Complete reference for vibes CLI commands and groups
+tags: [cli, commands, reference, man-pages]
+parent: cli
+order: 1
+---
+
+# CLI Commands
+
+The vibes CLI provides command-line access to runtime features, documentation, and development tools.
+
+## Overview
+
+The CLI is organized into **groups** and **commands**:
+
+\`\`\`
+vibes <group> <command> [options]
+\`\`\`
+
+## Available groups
+
+### \`vibes tools\`
+
+Tool management and invocation:
+
+- \`vibes tools list\` — List all registered tools
+- \`vibes tools invoke <id>\` — Invoke a tool by id
+- \`vibes tools info <id>\` — Show tool metadata
+
+### \`vibes docs\`
+
+Documentation browsing:
+
+- \`vibes docs show <topic>\` — Render a topic to stdout
+- \`vibes docs list\` — List all topics
+- \`vibes docs search <query>\` — Search topics
+- \`vibes docs open <topic>\` — Open topic in browser
+- \`vibes docs generate <package> <topic>\` — Scaffold new descriptor
+
+### \`vibes man\`
+
+Manual pages (alias for \`vibes docs show\`):
+
+- \`vibes man <topic>\` — Show man-page for topic
+- \`vibes man <kind> <id>\` — Show by subject reference
+
+### \`vibes dev\`
+
+Development commands:
+
+- \`vibes dev start\` — Start development server
+- \`vibes dev build\` — Build for production
+- \`vibes dev test\` — Run tests
+- \`vibes dev lint\` — Run linter
+
+### \`vibes workspace\`
+
+Workspace management:
+
+- \`vibes workspace info\` — Show workspace metadata
+- \`vibes workspace list\` — List workspace slices
+- \`vibes workspace switch <slice>\` — Switch active slice
+
+## Common options
+
+These options are available across most commands:
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| \`--help\` | Show help for command | \`vibes tools list --help\` |
+| \`--json\` | Output as JSON | \`vibes tools list --json\` |
+| \`--verbose\` | Enable verbose logging | \`vibes dev start --verbose\` |
+| \`--no-color\` | Disable ANSI colors | \`vibes man tools.list --no-color\` |
+| \`--bare\` | Skip envelope/formatting | \`vibes man tools.list --bare\` |
+
+## Examples
+
+### List all tools as JSON
+
+\`\`\`bash
+vibes tools list --json | jq '.[] | { id: .id, description: .description }'
+\`\`\`
+
+### View documentation
+
+\`\`\`bash
+# By topic id
+vibes man tools.list
+
+# By subject reference
+vibes man tools/tool tools.list
+
+# Open in browser
+vibes docs open tools.list
+\`\`\`
+
+### Search documentation
+
+\`\`\`bash
+# Search by keyword
+vibes docs search "runtime query"
+
+# Filter by tag
+vibes docs list --tag=tools
+
+# Filter by parent
+vibes docs list --parent=runtime
+\`\`\`
+
+### Generate new descriptor
+
+\`\`\`bash
+# Inline pattern (default)
+vibes docs generate ai providers.anthropic
+
+# Package-sourced pattern
+vibes docs generate storage adapters.drizzle --pattern package
+
+# With custom metadata
+vibes docs generate tools my-tool \\
+  --parent tools \\
+  --title "My Custom Tool" \\
+  --dry-run
+\`\`\`
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments |
+| 3 | Topic not found |
+| 4 | Permission denied |
+
+## Environment variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| \`VIBES_HOME\` | Vibes configuration directory | \`~/.vibes\` |
+| \`VIBES_LOG_LEVEL\` | Logging level | \`info\` |
+| \`VIBES_NO_COLOR\` | Disable colors | \`false\` |
+| \`VIBES_HARDWARE\` | Hardware surface | \`consumer\` |
+
+## Related
+
+:::card{title="See also"}
+- [\`cli.groups\`](cli.groups) — Command group structure
+- [\`runtime.query\`](runtime.query) — Runtime discovery API
+- [\`docs.topic\`](docs.topic) — Descriptor schema
+:::
+`;
+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: cli_commandsMarkdown
+    },
+    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/docs/cli.commands.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.commands.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/cli.commands.docs.descriptor.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwJ5B,CAAC;AAEF,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,oBAAoB;KAC7B;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/docs/cli.groups.docs.descriptor.d.ts

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.groups.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/cli.groups.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkS1B,CAAC;AAEF,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,kBAAkB;KAC1B;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/docs/cli.output.docs.descriptor.d.ts

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

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

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