@calltelemetry/cli 0.5.7 → 0.5.10

package/dist/shell/commands/registry.js

@@ -14,116 +14,169 @@ export const commandTree = {
     name: 'root',
     description: 'CallTelemetry Voice OS',
     children: [
-        // ── show ──────────────────────────────────────────────
+        // ── config ───────────────────────────────────────────
         {
-            name: 'show',
-            description: 'Display system information',
+            name: 'config',
+            description: 'Configuration management',
             children: [
-                { name: 'health', description: 'Overall system health status', handler: showHealth },
-                { name: 'version', description: 'Software version information', handler: showVersion },
-                { name: 'services', description: 'Running services and status', handler: showServices },
-                { name: 'connections', description: 'Active MCP connections', handler: showConnections },
                 {
-                    name: 'phones',
-                    description: 'Phone registration status',
-                    options: [
-                        { name: '--last', description: 'Time range filter', hasValue: true },
+                    name: 'audit',
+                    description: 'Configuration audit',
+                    children: [
+                        { name: 'report', description: 'Show last audit report' },
+                        { name: 'run', description: 'Run configuration audit' },
                     ],
                 },
+                { name: 'certs', description: 'TLS certificate management' },
+                { name: 'ipv6', description: 'Enable/disable IPv6' },
+                { name: 'logging', description: 'Configure logging levels' },
+                { name: 'otel', description: 'Configure OpenTelemetry' },
+                { name: 'postgres', description: 'Configure PostgreSQL settings' },
+            ],
+        },
+        // ── database ─────────────────────────────────────────
+        {
+            name: 'database',
+            description: 'Database operations',
+            children: [
                 {
-                    name: 'cdr',
-                    description: 'Call detail records',
+                    name: 'backup',
+                    description: 'Create database backup',
                     options: [
-                        { name: '--last', description: 'Time range filter', hasValue: true },
-                    ],
-                },
-                {
-                    name: 'db',
-                    description: 'Database information',
-                    children: [
-                        { name: 'status', description: 'Database connection and pool status', handler: showDbStatus },
-                        { name: 'size', description: 'Database size breakdown', handler: showDbSize },
-                        { name: 'tables', description: 'Table row counts and sizes', handler: showDbTables },
-                        { name: 'backups', description: 'List database backups', handler: showDbBackups },
+                        { name: '--path', description: 'Target directory for backup', hasValue: true },
                     ],
                 },
+                { name: 'compact', description: 'Vacuum and reclaim space' },
                 {
                     name: 'migrate',
-                    description: 'Migration status',
-                    children: [
-                        { name: 'status', description: 'Pending and applied migrations', handler: showMigrateStatus },
-                        { name: 'history', description: 'Migration history log', handler: showMigrateHistory },
-                    ],
-                },
-                {
-                    name: 'docker',
-                    description: 'Docker container information',
-                    children: [
-                        { name: 'status', description: 'Container status summary', handler: showDockerStatus },
-                        { name: 'network', description: 'Docker network list', handler: showDockerNetwork },
-                        { name: 'images', description: 'Local image inventory' },
-                        { name: 'volumes', description: 'Volume usage' },
-                    ],
-                },
-                {
-                    name: 'config',
-                    description: 'Configuration settings',
-                    children: [
-                        { name: 'logging', description: 'Current logging configuration', handler: showConfigLogging },
-                        { name: 'ipv6', description: 'IPv6 status', handler: showConfigIpv6 },
-                        { name: 'otel', description: 'OpenTelemetry configuration', handler: showConfigOtel },
-                        { name: 'postgres', description: 'PostgreSQL configuration', handler: showConfigPostgres },
-                        { name: 'certs', description: 'TLS certificate status', handler: showConfigCerts },
-                        { name: 'secrets', description: 'Secrets and overrides status', handler: showConfigSecrets },
-                    ],
-                },
-                { name: 'license', description: 'License status and details', handler: showLicense },
-                { name: 'config-audit', description: 'Configuration audit results' },
-                {
-                    name: 'jtapi',
-                    description: 'JTAPI phone control status',
+                    description: 'Run migrations',
                     children: [
-                        { name: 'status', description: 'JTAPI connection status', handler: showJtapiStatus },
-                        { name: 'devices', description: 'Controlled devices list' },
+                        { name: 'down', description: 'Rollback last migration' },
+                        { name: 'status', description: 'Show migration status' },
+                        { name: 'up', description: 'Run pending migrations' },
+                        { name: 'watch', description: 'Watch migration count (poll every 5s)' },
                     ],
                 },
                 {
-                    name: 'k8s',
-                    description: 'Kubernetes cluster information',
-                    children: [
-                        { name: 'status', description: 'Cluster status overview', handler: showK8sStatus },
-                        { name: 'pods', description: 'Pod status' },
-                        { name: 'nodes', description: 'Node status' },
+                    name: 'purge',
+                    description: 'Purge old data',
+                    options: [
+                        { name: '--before', description: 'Purge data before date', hasValue: true },
                     ],
                 },
+                { name: 'restore', description: 'Restore database from backup' },
+            ],
+        },
+        // ── debug ────────────────────────────────────────────
+        {
+            name: 'debug',
+            description: 'Debugging and diagnostics',
+            children: [
+                { name: 'database', description: 'Database connectivity diagnostics' },
+                { name: 'network', description: 'Network connectivity diagnostics' },
                 {
-                    name: 'os-updates',
-                    description: 'OS update information',
+                    name: 'packet-capture',
+                    description: 'Packet capture operations',
                     children: [
-                        { name: 'available', description: 'Available OS updates', handler: showOsUpdatesStatus },
-                        { name: 'history', description: 'Update history' },
+                        { name: 'list', description: 'List capture files' },
+                        { name: 'start', description: 'Start packet capture' },
+                        { name: 'stop', description: 'Stop packet capture' },
                     ],
                 },
-                { name: 'users', description: 'User accounts list', handler: showUsers },
-                { name: 'network', description: 'Network configuration', handler: showNetwork },
+                { name: 'ris', description: 'RIS query for device status', requiresMcp: 'cucm' },
+                { name: 'sdl-trace', description: 'SDL trace call flow analysis', requiresMcp: 'cucm' },
+                { name: 'service', description: 'Service health diagnostics' },
+                { name: 'showtech', description: 'Generate support bundle' },
                 {
-                    name: 'loadtest',
-                    description: 'Load test information',
+                    name: 'trace',
+                    description: 'Trace operations',
                     children: [
-                        { name: 'summary', description: 'Last load test summary' },
+                        { name: 'level', description: 'Set trace level' },
+                        { name: 'sdl', description: 'SDL trace analysis' },
+                        { name: 'sip', description: 'SIP trace analysis' },
                     ],
                 },
             ],
         },
+        // ── docker ───────────────────────────────────────────
+        {
+            name: 'docker',
+            description: 'Docker management',
+            children: [
+                { name: 'network', description: 'Docker network information' },
+                { name: 'prune', description: 'Clean up unused resources' },
+                { name: 'status', description: 'Container and daemon status' },
+            ],
+        },
+        // ── jtapi ────────────────────────────────────────────
+        {
+            name: 'jtapi',
+            description: 'JTAPI phone control',
+            children: [
+                { name: 'disable', description: 'Disable JTAPI integration' },
+                { name: 'enable', description: 'Enable JTAPI integration' },
+                { name: 'status', description: 'JTAPI connection status' },
+                { name: 'troubleshoot', description: 'JTAPI troubleshooting wizard' },
+            ],
+        },
+        // ── k8s ──────────────────────────────────────────────
+        {
+            name: 'k8s',
+            description: 'Kubernetes operations',
+            children: [
+                { name: 'destroy', description: 'Destroy namespace resources' },
+                { name: 'diff', description: 'Diff local vs cluster state' },
+                { name: 'logs', description: 'View pod logs' },
+                { name: 'pods', description: 'List pods' },
+                { name: 'restart', description: 'Restart deployment' },
+                { name: 'runbook', description: 'Execute operational runbook' },
+                { name: 'scale', description: 'Scale deployment replicas' },
+                { name: 'status', description: 'Cluster status' },
+                { name: 'sync', description: 'Sync manifests to cluster' },
+            ],
+        },
+        // ── loadtest ─────────────────────────────────────────
+        {
+            name: 'loadtest',
+            description: 'Load testing',
+            children: [
+                { name: 'probe', description: 'Quick health probe' },
+                { name: 'run', description: 'Run load test' },
+                { name: 'summary', description: 'Last test summary' },
+            ],
+        },
+        // ── network ──────────────────────────────────────────
+        {
+            name: 'network',
+            description: 'Network configuration',
+            children: [
+                { name: 'address', description: 'Set static IP  <iface> <ip/prefix> <gateway>', interfacePositional: true, positionalArgs: ['<ip/prefix>', '<gateway>'] },
+                { name: 'dhcp', description: 'Switch to DHCP', interfacePositional: true },
+                { name: 'dns-servers', description: 'Set DNS servers  <dns1> [dns2 ...]', positionalArgs: ['<dns1>', '[dns2 ...]'] },
+                { name: 'domain', description: 'Set DNS search domain  <domain>', positionalArgs: ['<domain>'] },
+                { name: 'ping', description: 'Ping an IPv4 address  <ip>', positionalArgs: ['<ip>'] },
+                { name: 'ping6', description: 'Ping an IPv6 address  <ip>', positionalArgs: ['<ip>'] },
+                { name: 'status', description: 'Network interface status' },
+                { name: 'traceroute', description: 'Traceroute to an IPv4 address  <ip>', positionalArgs: ['<ip>'] },
+                { name: 'traceroute6', description: 'Traceroute to an IPv6 address  <ip>', positionalArgs: ['<ip>'] },
+            ],
+        },
+        // ── secrets ──────────────────────────────────────────
+        {
+            name: 'secrets',
+            description: 'Credential management',
+            children: [
+                { name: 'reset-password', description: 'Reset admin password' },
+                { name: 'setup', description: 'Initial secrets setup' },
+                { name: 'status', description: 'Show secrets status' },
+            ],
+        },
         // ── services ─────────────────────────────────────────
         {
             name: 'services',
             description: 'Manage application services',
             handler: servicesDefault,
             children: [
-                { name: 'start', description: 'Start a service', handler: servicesStart },
-                { name: 'stop', description: 'Stop a service', handler: servicesStop },
-                { name: 'restart', description: 'Restart a service', handler: servicesRestart },
                 {
                     name: 'logs',
                     description: 'View service logs',
@@ -133,108 +186,110 @@ export const commandTree = {
                         { name: '--last', description: 'Time range', hasValue: true },
                     ],
                 },
+                { name: 'restart', description: 'Restart a service', handler: servicesRestart },
+                { name: 'start', description: 'Start a service', handler: servicesStart },
+                { name: 'stop', description: 'Stop a service', handler: servicesStop },
             ],
         },
-        // ── database ─────────────────────────────────────────
+        // ── show ──────────────────────────────────────────────
         {
-            name: 'database',
-            description: 'Database operations',
+            name: 'show',
+            description: 'Display system information',
             children: [
                 {
-                    name: 'backup',
-                    description: 'Create database backup',
+                    name: 'cdr',
+                    description: 'Call detail records',
                     options: [
-                        { name: '--path', description: 'Target directory for backup', hasValue: true },
+                        { name: '--last', description: 'Time range filter', hasValue: true },
                     ],
                 },
-                { name: 'restore', description: 'Restore database from backup' },
-                { name: 'compact', description: 'Vacuum and reclaim space' },
                 {
-                    name: 'purge',
-                    description: 'Purge old data',
-                    options: [
-                        { name: '--before', description: 'Purge data before date', hasValue: true },
+                    name: 'config',
+                    description: 'Configuration settings',
+                    children: [
+                        { name: 'certs', description: 'TLS certificate status', handler: showConfigCerts },
+                        { name: 'ipv6', description: 'IPv6 status', handler: showConfigIpv6 },
+                        { name: 'logging', description: 'Current logging configuration', handler: showConfigLogging },
+                        { name: 'otel', description: 'OpenTelemetry configuration', handler: showConfigOtel },
+                        { name: 'postgres', description: 'PostgreSQL configuration', handler: showConfigPostgres },
+                        { name: 'secrets', description: 'Secrets and overrides status', handler: showConfigSecrets },
                     ],
                 },
+                { name: 'config-audit', description: 'Configuration audit results' },
+                { name: 'connections', description: 'Active MCP connections', handler: showConnections },
                 {
-                    name: 'migrate',
-                    description: 'Run migrations',
+                    name: 'db',
+                    description: 'Database information',
                     children: [
-                        { name: 'up', description: 'Run pending migrations' },
-                        { name: 'down', description: 'Rollback last migration' },
-                        { name: 'watch', description: 'Watch migration count (poll every 5s)' },
-                        { name: 'status', description: 'Show migration status' },
+                        { name: 'backups', description: 'List database backups', handler: showDbBackups },
+                        { name: 'size', description: 'Database size breakdown', handler: showDbSize },
+                        { name: 'status', description: 'Database connection and pool status', handler: showDbStatus },
+                        { name: 'tables', description: 'Table row counts and sizes', handler: showDbTables },
                     ],
                 },
-            ],
-        },
-        // ── config ───────────────────────────────────────────
-        {
-            name: 'config',
-            description: 'Configuration management',
-            children: [
-                { name: 'logging', description: 'Configure logging levels' },
-                { name: 'ipv6', description: 'Enable/disable IPv6' },
-                { name: 'otel', description: 'Configure OpenTelemetry' },
-                { name: 'postgres', description: 'Configure PostgreSQL settings' },
-                { name: 'certs', description: 'TLS certificate management' },
                 {
-                    name: 'audit',
-                    description: 'Configuration audit',
+                    name: 'docker',
+                    description: 'Docker container information',
                     children: [
-                        { name: 'run', description: 'Run configuration audit' },
-                        { name: 'report', description: 'Show last audit report' },
+                        { name: 'images', description: 'Local image inventory' },
+                        { name: 'network', description: 'Docker network list', handler: showDockerNetwork },
+                        { name: 'status', description: 'Container status summary', handler: showDockerStatus },
+                        { name: 'volumes', description: 'Volume usage' },
                     ],
                 },
-            ],
-        },
-        // ── debug ────────────────────────────────────────────
-        {
-            name: 'debug',
-            description: 'Debugging and diagnostics',
-            children: [
-                { name: 'network', description: 'Network connectivity diagnostics' },
-                { name: 'database', description: 'Database connectivity diagnostics' },
-                { name: 'service', description: 'Service health diagnostics' },
-                { name: 'showtech', description: 'Generate support bundle' },
+                { name: 'health', description: 'Overall system health status', handler: showHealth },
                 {
-                    name: 'packet-capture',
-                    description: 'Packet capture operations',
+                    name: 'jtapi',
+                    description: 'JTAPI phone control status',
                     children: [
-                        { name: 'start', description: 'Start packet capture' },
-                        { name: 'stop', description: 'Stop packet capture' },
-                        { name: 'list', description: 'List capture files' },
+                        { name: 'devices', description: 'Controlled devices list' },
+                        { name: 'status', description: 'JTAPI connection status', handler: showJtapiStatus },
                     ],
                 },
                 {
-                    name: 'trace',
-                    description: 'Trace operations',
+                    name: 'k8s',
+                    description: 'Kubernetes cluster information',
                     children: [
-                        { name: 'sip', description: 'SIP trace analysis' },
-                        { name: 'sdl', description: 'SDL trace analysis' },
-                        { name: 'level', description: 'Set trace level' },
+                        { name: 'nodes', description: 'Node status' },
+                        { name: 'pods', description: 'Pod status' },
+                        { name: 'status', description: 'Cluster status overview', handler: showK8sStatus },
                     ],
                 },
-                { name: 'ris', description: 'RIS query for device status', requiresMcp: 'cucm' },
-                { name: 'sdl-trace', description: 'SDL trace call flow analysis', requiresMcp: 'cucm' },
-            ],
-        },
-        // ── test ─────────────────────────────────────────────
-        {
-            name: 'test',
-            description: 'Integration tests',
-            children: [
-                { name: 'axl', description: 'Test AXL connectivity', requiresMcp: 'cucm' },
+                { name: 'license', description: 'License status and details', handler: showLicense },
                 {
-                    name: 'jtapi',
-                    description: 'JTAPI connectivity tests',
+                    name: 'loadtest',
+                    description: 'Load test information',
                     children: [
-                        { name: 'connect', description: 'Test JTAPI connection' },
-                        { name: 'dial', description: 'Test dial operation' },
+                        { name: 'summary', description: 'Last load test summary' },
                     ],
                 },
-                { name: 'sip', description: 'Test SIP connectivity' },
-                { name: 'curri', description: 'Test CURRI integration' },
+                {
+                    name: 'migrate',
+                    description: 'Migration status',
+                    children: [
+                        { name: 'history', description: 'Migration history log', handler: showMigrateHistory },
+                        { name: 'status', description: 'Pending and applied migrations', handler: showMigrateStatus },
+                    ],
+                },
+                { name: 'network', description: 'Network configuration', handler: showNetwork },
+                {
+                    name: 'os-updates',
+                    description: 'OS update information',
+                    children: [
+                        { name: 'available', description: 'Available OS updates', handler: showOsUpdatesStatus },
+                        { name: 'history', description: 'Update history' },
+                    ],
+                },
+                {
+                    name: 'phones',
+                    description: 'Phone registration status',
+                    options: [
+                        { name: '--last', description: 'Time range filter', hasValue: true },
+                    ],
+                },
+                { name: 'services', description: 'Running services and status', handler: showServices },
+                { name: 'users', description: 'User accounts list', handler: showUsers },
+                { name: 'version', description: 'Software version information', handler: showVersion },
             ],
         },
         // ── system ───────────────────────────────────────────
@@ -242,87 +297,46 @@ export const commandTree = {
             name: 'system',
             description: 'System management',
             children: [
-                {
-                    name: 'update',
-                    description: 'System updates',
-                    children: [
-                        { name: 'check', description: 'Check for available updates' },
-                        { name: 'apply', description: 'Apply pending updates' },
-                        { name: 'rollback', description: 'Rollback to previous version' },
-                        { name: 'history', description: 'Update history' },
-                    ],
-                },
-                { name: 'self-update', description: 'Update the ct CLI tool' },
                 { name: 'backup', description: 'Full system backup' },
-                { name: 'restore', description: 'Restore from system backup' },
                 {
                     name: 'os-updates',
                     description: 'Operating system updates',
                     children: [
-                        { name: 'enable', description: 'Enable automatic OS updates' },
                         { name: 'disable', description: 'Disable automatic OS updates' },
+                        { name: 'enable', description: 'Enable automatic OS updates' },
                         { name: 'run', description: 'Run OS updates now' },
                     ],
                 },
+                { name: 'restore', description: 'Restore from system backup' },
+                { name: 'self-update', description: 'Update the ct CLI tool' },
+                {
+                    name: 'update',
+                    description: 'System updates',
+                    children: [
+                        { name: 'apply', description: 'Apply pending updates' },
+                        { name: 'check', description: 'Check for available updates' },
+                        { name: 'history', description: 'Update history' },
+                        { name: 'rollback', description: 'Rollback to previous version' },
+                    ],
+                },
             ],
         },
-        // ── docker ───────────────────────────────────────────
-        {
-            name: 'docker',
-            description: 'Docker management',
-            children: [
-                { name: 'status', description: 'Container and daemon status' },
-                { name: 'prune', description: 'Clean up unused resources' },
-                { name: 'network', description: 'Docker network information' },
-            ],
-        },
-        // ── network ──────────────────────────────────────────
-        {
-            name: 'network',
-            description: 'Network configuration',
-            children: [
-                { name: 'status', description: 'Network interface status' },
-                { name: 'address', description: 'Set static IP  <iface> <ip/prefix> <gateway>', interfacePositional: true, positionalArgs: ['<ip/prefix>', '<gateway>'] },
-                { name: 'dns-servers', description: 'Set DNS servers  <dns1> [dns2 ...]', positionalArgs: ['<dns1>', '[dns2 ...]'] },
-                { name: 'domain', description: 'Set DNS search domain  <domain>', positionalArgs: ['<domain>'] },
-                { name: 'dhcp', description: 'Switch to DHCP', interfacePositional: true },
-            ],
-        },
-        // ── k8s ──────────────────────────────────────────────
-        {
-            name: 'k8s',
-            description: 'Kubernetes operations',
-            children: [
-                { name: 'status', description: 'Cluster status' },
-                { name: 'pods', description: 'List pods' },
-                { name: 'logs', description: 'View pod logs' },
-                { name: 'restart', description: 'Restart deployment' },
-                { name: 'scale', description: 'Scale deployment replicas' },
-                { name: 'sync', description: 'Sync manifests to cluster' },
-                { name: 'diff', description: 'Diff local vs cluster state' },
-                { name: 'destroy', description: 'Destroy namespace resources' },
-                { name: 'runbook', description: 'Execute operational runbook' },
-            ],
-        },
-        // ── jtapi ────────────────────────────────────────────
-        {
-            name: 'jtapi',
-            description: 'JTAPI phone control',
-            children: [
-                { name: 'enable', description: 'Enable JTAPI integration' },
-                { name: 'disable', description: 'Disable JTAPI integration' },
-                { name: 'status', description: 'JTAPI connection status' },
-                { name: 'troubleshoot', description: 'JTAPI troubleshooting wizard' },
-            ],
-        },
-        // ── secrets ──────────────────────────────────────────
+        // ── test ─────────────────────────────────────────────
         {
-            name: 'secrets',
-            description: 'Credential management',
+            name: 'test',
+            description: 'Integration tests',
             children: [
-                { name: 'status', description: 'Show secrets status' },
-                { name: 'setup', description: 'Initial secrets setup' },
-                { name: 'reset-password', description: 'Reset admin password' },
+                { name: 'axl', description: 'Test AXL connectivity', requiresMcp: 'cucm' },
+                { name: 'curri', description: 'Test CURRI integration' },
+                {
+                    name: 'jtapi',
+                    description: 'JTAPI connectivity tests',
+                    children: [
+                        { name: 'connect', description: 'Test JTAPI connection' },
+                        { name: 'dial', description: 'Test dial operation' },
+                    ],
+                },
+                { name: 'sip', description: 'Test SIP connectivity' },
             ],
         },
         // ── users ────────────────────────────────────────────
@@ -334,26 +348,13 @@ export const commandTree = {
                 { name: 'reset-password', description: 'Reset user password' },
             ],
         },
-        // ── loadtest ─────────────────────────────────────────
-        {
-            name: 'loadtest',
-            description: 'Load testing',
-            children: [
-                { name: 'run', description: 'Run load test' },
-                { name: 'probe', description: 'Quick health probe' },
-                { name: 'summary', description: 'Last test summary' },
-            ],
-        },
-        // ── connection management ────────────────────────────
-        { name: 'connect', description: 'Connect to an MCP server' },
-        { name: 'disconnect', description: 'Disconnect from an MCP server' },
         // ── shell builtins ───────────────────────────────────
-        { name: 'help', description: 'Show available commands' },
-        { name: 'history', description: 'Show command history' },
         { name: 'clear', description: 'Clear the terminal screen' },
-        { name: 'whoami', description: 'Show current user and context' },
         { name: 'exit', description: 'Exit the shell' },
+        { name: 'help', description: 'Show available commands' },
+        { name: 'history', description: 'Show command history' },
         { name: 'quit', description: 'Exit the shell' },
+        { name: 'whoami', description: 'Show current user and context' },
     ],
 };
 // ── Wire command handlers from feature modules ────────────────────────────