@calltelemetry/cli 0.15.1 → 1.1.0

package/README.md

@@ -166,6 +166,20 @@ ct diag db-watch --interval 2       # Live database activity monitor
 ct diag capture <seconds> [filter]  # Packet capture via tcpdump
 ```
 
+### CUBE Diagnostics
+
+```bash
+ct cube diag --monitor 60 --pcap 30     # Evidence bundle
+ct cube doctor                          # Step-by-step registration/keepalive check
+ct cube doctor --cube cucm-pub --reconnect --wait 90 --pcap 60
+```
+
+`ct cube doctor` reports XCC enabled, provider URL, registration state,
+keepalive freshness, probing interval, and liveness confidence. `--reconnect`
+uses the appliance's real reconnect path to re-register with the CUBE, then
+waits for the first `SolicitXccProbing` keepalive. See
+[docs/cube-doctor.md](docs/cube-doctor.md).
+
 ### JTAPI (Cisco Phone Control)
 
 ```bash
@@ -270,6 +284,39 @@ ct seed status --org-id 1           # Seed counts and recent runs
 ct seed cleanup --org-id 1 --all    # Remove seeded data
 ```
 
+### SFTP Tooling
+
+Manage SFTP Action Accounts and the surrounding operational surface. Commands
+read the OpenAPI document generated by the installed appliance release, so they
+follow the routes that release actually exposes.
+
+```bash
+ct sftp status                              # Accounts, storage, monitoring, daemon
+ct sftp doctor                              # Connectivity and compatibility checks
+ct sftp accounts list                       # List accounts
+ct sftp accounts create --username backups --description "CUCM backups" --quota-gb 25
+ct sftp accounts update backups --disable
+ct sftp accounts password backups --generate
+ct sftp accounts delete backups --yes
+ct sftp accounts export --output accounts.csv
+ct sftp accounts import accounts.csv --validate-only
+ct sftp monitoring enable backups --schedule daily --hour 2 --minute 5
+ct sftp storage status
+ct sftp activity --limit 25
+ct sftp api --list                          # Every SFTP operation in this release
+```
+
+`create` generates and displays a strong password when none is supplied. Use
+`--password-stdin` for automation. All read commands support `--json`.
+
+Human invocations prompt for an appliance admin email and password, then use a
+short-lived session JWT that is kept only in memory. For automation, set
+`CT_API_TOKEN`, or `CT_API_EMAIL` + `CT_API_PASSWORD` to skip the prompts.
+
+See [docs/sftp.md](docs/sftp.md) for account actions, monitoring, storage,
+analytics, report schedules, authentication, and the generic OpenAPI escape
+hatch.
+
 ## Interactive TUI
 
 When run without arguments on a TTY, `ct` launches an interactive menu built with [Ink](https://github.com/vadimdemedes/ink). Navigate with arrow keys, select with Enter, quit with `q`.

package/dist/commands/cube.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cube.d.ts","sourceRoot":"","sources":["../../src/commands/cube.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA0CnD"}
+{"version":3,"file":"cube.d.ts","sourceRoot":"","sources":["../../src/commands/cube.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAgInD"}

package/dist/commands/cube.js

@@ -1,4 +1,6 @@
 import { collectCubeDiag } from '../lib/cube-diag.js';
+import { ApplianceApi, DEFAULT_API_URL, DEFAULT_TIMEOUT_MS, parsePositiveInt, } from '../lib/appliance-api.js';
+import { applianceCubeDoctorBackend, cubeDoctorExitCode, renderCubeDoctorReport, runCubeDoctor, } from '../lib/cube-doctor.js';
 import { parseNonNegativeSecs } from '../utils/parseSecs.js';
 import * as out from '../utils/output.js';
 /**
@@ -48,5 +50,71 @@ export function registerCubeCommand(program) {
             out.fail(`Cube diagnostics failed: ${message}`);
         }
     });
+    cube
+        .command('doctor')
+        .description('Step-by-step CUBE/XCC health check: registration, keepalive, intervals, optional reconnect/pcap')
+        .option('--cube <id|name>', 'Check one CUBE instead of all xcc-enabled CUBEs')
+        .option('--wait <secs>', 'Wait up to N seconds for registration/keepalive', '30')
+        .option('--interval <secs>', 'Poll interval while waiting', '5')
+        .option('--reconnect', 'Ask the appliance to re-register with the CUBE, then wait for the first keepalive')
+        .option('--pcap <secs>', 'Capture XCC wire (bridge + host TLS ingress) during the check', '0')
+        .option('--pcap-dir <path>', 'Directory for pcap files')
+        .option('--url <url>', `Appliance API base URL (default: ${DEFAULT_API_URL})`)
+        .option('--token <token>', 'Machine API token for automation (prefer interactive login)')
+        .option('--email <email>', 'Admin email for interactive session login (or CT_API_EMAIL)')
+        .option('--org <id>', 'Organization ID (or CT_ORG_ID)')
+        .option('--timeout <ms>', 'Request timeout in milliseconds', String(DEFAULT_TIMEOUT_MS))
+        .option('--verify-tls', 'Verify the appliance TLS certificate')
+        .option('--json', 'Output a structured JSON report')
+        .action(async (opts) => {
+        let waitSecs;
+        let intervalSecs;
+        let pcapSecs;
+        try {
+            waitSecs = parseNonNegativeSecs(opts.wait, '--wait');
+            intervalSecs = parseNonNegativeSecs(opts.interval, '--interval');
+            pcapSecs = parseNonNegativeSecs(opts.pcap, '--pcap');
+            if (waitSecs > 0 && intervalSecs === 0) {
+                throw new Error('--interval must be at least 1 when --wait is greater than 0');
+            }
+        }
+        catch (err) {
+            out.fail(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const api = await ApplianceApi.connect({
+                baseUrl: opts.url,
+                token: opts.token,
+                email: opts.email,
+                orgId: parsePositiveInt(opts.org, '--org'),
+                timeoutMs: parsePositiveInt(opts.timeout, '--timeout'),
+                verifyTls: opts.verifyTls ? true : undefined,
+            });
+            const spec = await api.fetchSpec();
+            const backend = applianceCubeDoctorBackend(api, spec);
+            const report = await runCubeDoctor(backend, {
+                cube: opts.cube,
+                waitSecs,
+                intervalSecs,
+                reconnect: opts.reconnect === true,
+                pcapSecs,
+                pcapDir: opts.pcapDir,
+            });
+            if (opts.json) {
+                console.log(JSON.stringify(report, null, 2));
+            }
+            else {
+                out.header('CUBE Doctor');
+                console.log(renderCubeDoctorReport(report));
+            }
+            process.exitCode = cubeDoctorExitCode(report);
+        }
+        catch (err) {
+            out.fail(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+        }
+    });
 }
 //# sourceMappingURL=cube.js.map

package/dist/commands/cube.js.map

@@ -1 +1 @@
-{"version":3,"file":"cube.js","sourceRoot":"","sources":["../../src/commands/cube.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAEnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;SACjB,WAAW,CAAC,4EAA4E,CAAC;SACzF,MAAM,CAAC,iBAAiB,EAAE,gEAAgE,CAAC;SAC3F,MAAM,CAAC,kBAAkB,EAAE,8DAA8D,EAAE,GAAG,CAAC;SAC/F,MAAM,CAAC,kBAAkB,EAAE,2DAA2D,EAAE,GAAG,CAAC;SAC5F,MAAM,CAAC,eAAe,EAAE,yEAAyE,EAAE,GAAG,CAAC;SACvG,MAAM,CAAC,KAAK,EAAE,IAA4E,EAAE,EAAE;QAC7F,yEAAyE;QACzE,uEAAuE;QACvE,oCAAoC;QACpC,IAAI,WAAmB,CAAC;QACxB,IAAI,WAAmB,CAAC;QACxB,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC9D,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC9D,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC;gBACjC,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,WAAW;gBACX,WAAW;gBACX,QAAQ;aACT,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"cube.js","sourceRoot":"","sources":["../../src/commands/cube.ts"],"names":[],"mappings":"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"}

package/dist/commands/sftp.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSftpCommand(program: Command): void;
+//# sourceMappingURL=sftp.d.ts.map

package/dist/commands/sftp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sftp.d.ts","sourceRoot":"","sources":["../../src/commands/sftp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmxEpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB1D"}