npm - @qodalis/cli-server-node - Versions diffs - 1.0.0-beta.4 → 1.0.0-beta.5 - Mend

@qodalis/cli-server-node 1.0.0-beta.4 → 1.0.0-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (95) hide show

package/dist/src/processors/cli-http-command-processor.js CHANGED Viewed

@@ -3,19 +3,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliHttpCommandProcessor = void 0;
 const cli_command_processor_1 = require("../abstractions/cli-command-processor");
 const cli_command_parameter_descriptor_1 = require("../abstractions/cli-command-parameter-descriptor");
+/** Sub-processor that performs HTTP GET requests. */
 class HttpGetProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'get';
     description = 'Performs an HTTP GET request';
     parameters = [
         new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('headers', 'Show response headers', false, 'boolean'),
     ];
-    async handleAsync(command) {
+    async handleAsync(command, signal) {
         const url = command.value;
         if (!url)
             return 'Usage: http get <url>';
-        return doRequest(url, 'GET', undefined, 'headers' in (command.args ?? {}));
+        return doRequest(url, 'GET', undefined, 'headers' in (command.args ?? {}), signal);
+    }
+    async handleStreamAsync(command, emit, signal) {
+        const url = command.value;
+        if (!url) {
+            emit({ type: 'text', value: 'Usage: http get <url>' });
+            return 1;
+        }
+        return doStreamRequest(url, 'GET', undefined, 'headers' in (command.args ?? {}), emit, signal);
     }
 }
+/** Sub-processor that performs HTTP POST requests. */
 class HttpPostProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'post';
     description = 'Performs an HTTP POST request';
@@ -23,21 +33,42 @@ class HttpPostProcessor extends cli_command_processor_1.CliCommandProcessor {
         new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('body', 'Request body (JSON string)', false, 'string', ['-b']),
         new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('headers', 'Show response headers', false, 'boolean'),
     ];
-    async handleAsync(command) {
+    async handleAsync(command, signal) {
         const url = command.value;
         if (!url)
             return "Usage: http post <url> --body '{\"key\":\"value\"}'";
         const body = command.args?.body;
-        return doRequest(url, 'POST', body, 'headers' in (command.args ?? {}));
+        return doRequest(url, 'POST', body, 'headers' in (command.args ?? {}), signal);
+    }
+    async handleStreamAsync(command, emit, signal) {
+        const url = command.value;
+        if (!url) {
+            emit({ type: 'text', value: "Usage: http post <url> --body '{\"key\":\"value\"}'" });
+            return 1;
+        }
+        const body = command.args?.body;
+        return doStreamRequest(url, 'POST', body, 'headers' in (command.args ?? {}), emit, signal);
     }
 }
-async function doRequest(url, method, body, showHeaders) {
+/**
+ * Executes an HTTP request and formats the response as a human-readable string.
+ * @param url - Target URL.
+ * @param method - HTTP method (GET, POST, etc.).
+ * @param body - Optional JSON request body.
+ * @param showHeaders - Whether to include response headers in output.
+ * @returns Formatted response string (truncated to 5000 chars).
+ */
+async function doRequest(url, method, body, showHeaders, signal) {
     try {
+        const timeoutSignal = AbortSignal.timeout(30000);
+        const combinedSignal = signal
+            ? AbortSignal.any([signal, timeoutSignal])
+            : timeoutSignal;
         const init = {
             method,
             headers: body ? { 'Content-Type': 'application/json' } : undefined,
             body: body ?? undefined,
-            signal: AbortSignal.timeout(30000),
+            signal: combinedSignal,
         };
         const resp = await fetch(url, init);
         const contentType = resp.headers.get('content-type') ?? 'unknown';
@@ -66,6 +97,54 @@ async function doRequest(url, method, body, showHeaders) {
         return `Error: ${err.message ?? err}`;
     }
 }
+/**
+ * Executes an HTTP request and emits output incrementally via the `emit` callback.
+ * @param url - Target URL.
+ * @param method - HTTP method (GET, POST, etc.).
+ * @param body - Optional JSON request body.
+ * @param showHeaders - Whether to include response headers in output.
+ * @param emit - Callback to send a single output chunk.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+async function doStreamRequest(url, method, body, showHeaders, emit, signal) {
+    try {
+        emit({ type: 'text', value: `Fetching ${method} ${url}...`, style: 'info' });
+        const timeoutSignal = AbortSignal.timeout(30000);
+        const combinedSignal = signal
+            ? AbortSignal.any([signal, timeoutSignal])
+            : timeoutSignal;
+        const init = {
+            method,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+            body: body ?? undefined,
+            signal: combinedSignal,
+        };
+        const resp = await fetch(url, init);
+        const contentType = resp.headers.get('content-type') ?? 'unknown';
+        emit({ type: 'text', value: `Status: ${resp.status}` });
+        emit({ type: 'text', value: `Content-Type: ${contentType}` });
+        if (showHeaders) {
+            emit({ type: 'text', value: 'Headers:' });
+            resp.headers.forEach((value, key) => {
+                emit({ type: 'text', value: `  ${key}: ${value}` });
+            });
+        }
+        let respBody = await resp.text();
+        if (contentType.includes('json')) {
+            try {
+                respBody = JSON.stringify(JSON.parse(respBody), null, 2);
+            }
+            catch { /* keep raw */ }
+        }
+        emit({ type: 'text', value: respBody.substring(0, 5000) });
+        return 0;
+    }
+    catch (err) {
+        emit({ type: 'text', value: `Error: ${err.message ?? err}`, style: 'error' });
+        return 1;
+    }
+}
+/** Command processor for server-side HTTP requests with `get` and `post` sub-commands. */
 class CliHttpCommandProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'http';
     description = 'Makes HTTP requests from the server';

package/dist/src/processors/cli-http-command-processor.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-http-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-http-command-processor.ts"],"names":[],"mappings":";;;AAAA,iFAA4E;AAC5E,uGAAiG;~~AAIjG~~,MAAM,gBAAiB,SAAQ,2CAAmB;IAC9C,OAAO,GAAG,KAAK,CAAC;IAChB,WAAW,GAAG,8BAA8B,CAAC;IAC7C,UAAU,GAAG;QACT,IAAI,gEAA6B,CAAC,SAAS,EAAE,uBAAuB,EAAE,KAAK,EAAE,SAAS,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,WAAW,CAAC,OAA0B;~~QACxC~~,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,OAAO,uBAAuB,CAAC;QACzC,OAAO,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;~~IAC/E~~,CAAC;CACJ;AAED,MAAM,iBAAkB,SAAQ,2CAAmB;IAC/C,OAAO,GAAG,MAAM,CAAC;IACjB,WAAW,GAAG,+BAA+B,CAAC;IAC9C,UAAU,GAAG;QACT,IAAI,gEAA6B,CAAC,MAAM,EAAE,4BAA4B,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;QAChG,IAAI,gEAA6B,CAAC,SAAS,EAAE,uBAAuB,EAAE,KAAK,EAAE,SAAS,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,WAAW,CAAC,OAA0B;~~QACxC~~,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,OAAO,qDAAqD,CAAC;QACvE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAA0B,CAAC;QACtD,OAAO,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;~~IAC3E~~,CAAC;CACJ;AAED,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,MAAc,EAAE,IAAa,EAAE,WAAqB;~~IACtF~~,IAAI,CAAC;QACD,MAAM,IAAI,GAAgB;YACtB,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS;YAClE,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,MAAM,EAAE,~~WAAW,CAAC,OAAO,CAAC,KAAK,CAAC~~;~~SACrC~~,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;QAClE,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEjC,MAAM,KAAK,GAAa;YACpB,WAAW,IAAI,CAAC,MAAM,EAAE;YACxB,iBAAiB,WAAW,EAAE;SACjC,CAAC;QAEF,IAAI,WAAW,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAChC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACP,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACD,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,UAAU,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;IAC1C,CAAC;AACL,CAAC;AAED,MAAa,uBAAwB,SAAQ,2CAAmB;IAC5D,OAAO,GAAG,MAAM,CAAC;IACjB,WAAW,GAAG,qCAAqC,CAAC;IACpD,qBAAqB,GAAG,KAAK,CAAC;IAC9B,UAAU,GAA2B,CAAC,IAAI,gBAAgB,EAAE,EAAE,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAEvF,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,OAAO,wDAAwD,CAAC;IACpE,CAAC;CACJ;AATD,0DASC"}
1	+ {"version":3,"file":"cli-http-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-http-command-processor.ts"],"names":[],"mappings":"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"}

package/dist/src/processors/cli-status-command-processor.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 import { CliCommandProcessor, CliProcessCommand } from '../abstractions';
+/** Command processor that reports server status including uptime, OS, and Node.js version. */
 export declare class CliStatusCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

package/dist/src/processors/cli-status-command-processor.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-status-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-status-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAqC;IAE1C,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlE"}
1	+ {"version":3,"file":"cli-status-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-status-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,8FAA8F;AAC9F,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAqC;IAE1C,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlE"}

package/dist/src/processors/cli-status-command-processor.js CHANGED Viewed

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliStatusCommandProcessor = void 0;
 const abstractions_1 = require("../abstractions");
 const os_1 = __importDefault(require("os"));
+/** Command processor that reports server status including uptime, OS, and Node.js version. */
 class CliStatusCommandProcessor extends abstractions_1.CliCommandProcessor {
     command = 'status';
     description = 'Shows server status information';

package/dist/src/processors/cli-status-command-processor.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-status-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-status-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyE;AACzE,4CAAoB;AAEpB,MAAa,yBAA0B,SAAQ,kCAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,iCAAiC,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,QAA2B;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,OAAO,4BAA4B,MAAM,UAAU,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7G,CAAC;CACJ;AARD,8DAQC"}
1	+ {"version":3,"file":"cli-status-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-status-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyE;AACzE,4CAAoB;AAEpB,8FAA8F;AAC9F,MAAa,yBAA0B,SAAQ,kCAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,iCAAiC,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,QAA2B;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,OAAO,4BAA4B,MAAM,UAAU,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7G,CAAC;CACJ;AARD,8DAQC"}

package/dist/src/processors/cli-system-command-processor.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { CliCommandProcessor } from '../abstractions/cli-command-processor';
 import { CliProcessCommand } from '../abstractions/cli-process-command';
+/** Command processor that displays detailed system information (hostname, OS, CPU, memory, uptime). */
 export declare class CliSystemCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

package/dist/src/processors/cli-system-command-processor.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-system-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-system-command-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAIxE,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAqC;IAE1C,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBjE"}
1	+ {"version":3,"file":"cli-system-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-system-command-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAIxE,uGAAuG;AACvG,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAqC;IAE1C,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBjE"}

package/dist/src/processors/cli-system-command-processor.js CHANGED Viewed

@@ -7,6 +7,7 @@ exports.CliSystemCommandProcessor = void 0;
 const os_1 = __importDefault(require("os"));
 const cli_command_processor_1 = require("../abstractions/cli-command-processor");
 const startTime = Date.now();
+/** Command processor that displays detailed system information (hostname, OS, CPU, memory, uptime). */
 class CliSystemCommandProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'system';
     description = 'Shows server system information';

package/dist/src/processors/cli-system-command-processor.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-system-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-system-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,iFAA4E;AAG5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE7B,MAAa,yBAA0B,SAAQ,2CAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,iCAAiC,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,UAAU,GAAG,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,CAAC,YAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,CAAC,YAAE,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG;YACV,kBAAkB,YAAE,CAAC,QAAQ,EAAE,EAAE;YACjC,kBAAkB,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,EAAE;YAC7C,kBAAkB,YAAE,CAAC,IAAI,EAAE,EAAE;YAC7B,kBAAkB,YAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;YACpC,kBAAkB,OAAO,cAAc,QAAQ,WAAW;YAC1D,kBAAkB,OAAO,CAAC,OAAO,EAAE;YACnC,kBAAkB,KAAK,KAAK,OAAO,KAAK,OAAO,GAAG;SACrD,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACJ;AAxBD,8DAwBC"}
1	+ {"version":3,"file":"cli-system-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-system-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,iFAA4E;AAG5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE7B,uGAAuG;AACvG,MAAa,yBAA0B,SAAQ,2CAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,iCAAiC,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,UAAU,GAAG,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,CAAC,YAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,CAAC,YAAE,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG;YACV,kBAAkB,YAAE,CAAC,QAAQ,EAAE,EAAE;YACjC,kBAAkB,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,EAAE;YAC7C,kBAAkB,YAAE,CAAC,IAAI,EAAE,EAAE;YAC7B,kBAAkB,YAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;YACpC,kBAAkB,OAAO,cAAc,QAAQ,WAAW;YAC1D,kBAAkB,OAAO,CAAC,OAAO,EAAE;YACnC,kBAAkB,KAAK,KAAK,OAAO,KAAK,OAAO,GAAG;SACrD,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACJ;AAxBD,8DAwBC"}

package/dist/src/server.js CHANGED Viewed

@@ -2,6 +2,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const create_cli_server_1 = require("./create-cli-server");
+const logger_1 = require("./utils/logger");
+const logger = (0, logger_1.createLogger)('Server');
 const cli_echo_command_processor_1 = require("./processors/cli-echo-command-processor");
 const cli_status_command_processor_1 = require("./processors/cli-status-command-processor");
 const cli_system_command_processor_1 = require("./processors/cli-system-command-processor");
@@ -23,15 +25,15 @@ const { app, eventSocketManager } = (0, create_cli_server_1.createCliServer)({
     },
 });
 const server = app.listen(port, () => {
-    console.log(`CLI server (Node.js) listening on http://localhost:${port}`);
-    console.log(`  Commands:     http://localhost:${port}/api/v1/qcli/commands`);
-    console.log(`  Execute:      http://localhost:${port}/api/v1/qcli/execute`);
-    console.log(`  Capabilities: http://localhost:${port}/api/v1/qcli/capabilities`);
-    console.log(`  Events:       ws://localhost:${port}/ws/v1/qcli/events`);
+    logger.info(`CLI server (Node.js) listening on http://localhost:${port}`);
+    logger.info(`  Commands:     http://localhost:${port}/api/v1/qcli/commands`);
+    logger.info(`  Execute:      http://localhost:${port}/api/v1/qcli/execute`);
+    logger.info(`  Capabilities: http://localhost:${port}/api/v1/qcli/capabilities`);
+    logger.info(`  Events:       ws://localhost:${port}/ws/v1/qcli/events`);
 });
 eventSocketManager.attach(server);
 process.on('SIGINT', async () => {
-    console.log('\nShutting down...');
+    logger.info('Shutting down...');
     await eventSocketManager.broadcastDisconnect();
     server.close();
     process.exit(0);

package/dist/src/server.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";;;AAEA,2DAAsD;AACtD,wFAAkF;AAClF,4FAAsF;AACtF,4FAAsF;AACtF,wFAAkF;AAClF,wFAAkF;AAClF,4FAAsF;AACtF,kFAAmE;AAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;AAEtC,MAAM,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,IAAA,mCAAe,EAAC;IAChD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACnB,OAAO;aACF,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,SAAS,CAAC,IAAI,yCAAa,EAAE,CAAC,CAAC;IACxC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACjC,~~OAAO~~,CAAC,~~GAAG~~,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IAC1E,~~OAAO~~,CAAC,~~GAAG~~,CAAC,oCAAoC,IAAI,uBAAuB,CAAC,CAAC;IAC7E,~~OAAO~~,CAAC,~~GAAG~~,CAAC,oCAAoC,IAAI,sBAAsB,CAAC,CAAC;IAC5E,~~OAAO~~,CAAC,~~GAAG~~,CAAC,oCAAoC,IAAI,2BAA2B,CAAC,CAAC;IACjF,~~OAAO~~,CAAC,~~GAAG~~,CAAC,kCAAkC,IAAI,oBAAoB,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAElC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC5B,~~OAAO~~,CAAC,~~GAAG~~,CAAC,~~oBAAoB~~,CAAC,CAAC;~~IAClC~~,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC7B,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";;;AAEA,2DAAsD;AACtD,2CAA8C;AAE9C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,QAAQ,CAAC,CAAC;AACtC,wFAAkF;AAClF,4FAAsF;AACtF,4FAAsF;AACtF,wFAAkF;AAClF,wFAAkF;AAClF,4FAAsF;AACtF,kFAAmE;AAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;AAEtC,MAAM,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,IAAA,mCAAe,EAAC;IAChD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACnB,OAAO;aACF,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,SAAS,CAAC,IAAI,yCAAa,EAAE,CAAC,CAAC;IACxC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACjC,MAAM,CAAC,IAAI,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,uBAAuB,CAAC,CAAC;IAC7E,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,sBAAsB,CAAC,CAAC;IAC5E,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,2BAA2B,CAAC,CAAC;IACjF,MAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,oBAAoB,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAElC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC5B,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChC,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC7B,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/src/services/cli-command-executor-service.d.ts CHANGED Viewed

@@ -1,12 +1,33 @@
-import { CliProcessCommand } from '../abstractions';
+import { CliProcessCommand, ICliCommandProcessor, ICliProcessorFilter } from '../abstractions';
 import { CliServerResponse } from '../models';
 import { ICliCommandRegistry } from './cli-command-registry';
+/** Service contract for executing parsed CLI commands. */
 export interface ICliCommandExecutorService {
-    executeAsync(command: CliProcessCommand): Promise<CliServerResponse>;
+    /**
+     * Executes a parsed command by routing it to the appropriate processor.
+     * @param command - Parsed command to execute.
+     * @param signal - Optional AbortSignal to cancel the operation.
+     * @returns Structured response with exit code and outputs.
+     */
+    executeAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<CliServerResponse>;
+    /**
+     * Adds a processor filter that can block command execution at runtime.
+     * @param filter - The filter to add.
+     */
+    addFilter(filter: ICliProcessorFilter): void;
+    /**
+     * Returns true if any registered filter blocks the given processor.
+     * @param processor - The processor to check.
+     */
+    isBlocked(processor: ICliCommandProcessor): boolean;
 }
+/** Default executor that resolves processors from the registry and delegates command handling. */
 export declare class CliCommandExecutorService implements ICliCommandExecutorService {
     private readonly _registry;
+    private readonly _filters;
     constructor(_registry: ICliCommandRegistry);
-    executeAsync(command: CliProcessCommand): Promise<CliServerResponse>;
+    addFilter(filter: ICliProcessorFilter): void;
+    isBlocked(processor: ICliCommandProcessor): boolean;
+    executeAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<CliServerResponse>;
 }
 //# sourceMappingURL=cli-command-executor-service.d.ts.map

package/dist/src/services/cli-command-executor-service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-command-executor-service.d.ts","sourceRoot":"","sources":["../../../src/services/cli-command-executor-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;~~AACpD~~,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;~~AAE7D~~,MAAM,WAAW,0BAA0B;IACvC,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;~~CACxE~~;AAED,qBAAa,yBAA0B,YAAW,0BAA0B;~~IAC5D~~,OAAO,CAAC,QAAQ,CAAC,SAAS;~~gBAAT~~,SAAS,EAAE,mBAAmB;~~IAErD~~,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;~~CAsC7E~~"}
1	+ {"version":3,"file":"cli-command-executor-service.d.ts","sourceRoot":"","sources":["../../../src/services/cli-command-executor-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAK7D,0DAA0D;AAC1D,MAAM,WAAW,0BAA0B;IACvC;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3F;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC;CACvD;AAED,kGAAkG;AAClG,qBAAa,yBAA0B,YAAW,0BAA0B;IAG5D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAEzB,SAAS,EAAE,mBAAmB;IAE3D,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAI5C,SAAS,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO;IAI7C,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA8DnG"}

package/dist/src/services/cli-command-executor-service.js CHANGED Viewed

@@ -1,12 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliCommandExecutorService = void 0;
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('CommandExecutor');
+/** Default executor that resolves processors from the registry and delegates command handling. */
 class CliCommandExecutorService {
     _registry;
+    _filters = [];
     constructor(_registry) {
         this._registry = _registry;
     }
-    async executeAsync(command) {
+    addFilter(filter) {
+        this._filters.push(filter);
+    }
+    isBlocked(processor) {
+        return this._filters.some(f => !f.isAllowed(processor));
+    }
+    async executeAsync(command, signal) {
+        logger.debug('Executing command: %s', command.command);
         const processor = this._registry.findProcessor(command.command, command.chainCommands?.length ? command.chainCommands : undefined);
         if (!processor) {
             return {
@@ -20,14 +31,35 @@ class CliCommandExecutorService {
                 ],
             };
         }
-        try {
-            const result = await processor.handleAsync(command);
+        if (this.isBlocked(processor)) {
+            logger.warn('Command blocked by filter (plugin disabled): %s', command.command);
             return {
+                exitCode: 1,
+                outputs: [
+                    {
+                        type: 'text',
+                        value: `Command '${command.command}' is currently disabled.`,
+                        style: 'error',
+                    },
+                ],
+            };
+        }
+        try {
+            if (processor.handleStructuredAsync) {
+                const response = await processor.handleStructuredAsync(command, signal);
+                logger.debug('Command completed: %s (exitCode=%d)', command.command, response.exitCode);
+                return response;
+            }
+            const result = await processor.handleAsync(command, signal);
+            const response = {
                 exitCode: 0,
                 outputs: [{ type: 'text', value: result }],
             };
+            logger.debug('Command completed: %s (exitCode=%d)', command.command, response.exitCode);
+            return response;
         }
         catch (err) {
+            logger.error('Command execution failed: %s - %s', command.command, err.message ?? err);
             return {
                 exitCode: 1,
                 outputs: [

package/dist/src/services/cli-command-executor-service.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-command-executor-service.js","sourceRoot":"","sources":["../../../src/services/cli-command-executor-service.ts"],"names":[],"mappings":";;;~~AAQA~~,MAAa,yBAAyB;~~IACL~~;~~IAA7B~~,YAA6B,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,YAAY,CAAC,OAA0B;~~QACzC~~,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAC1C,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CACpE,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO;gBACH,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,KAAK,EAAE,oBAAoB,OAAO,CAAC,OAAO,EAAE;wBAC5C,KAAK,EAAE,OAAO;qBACjB;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;~~YACpD~~,~~OAAO~~;~~gBACH~~,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;aAC7C,CAAC;~~QACN~~,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,OAAO;gBACH,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,KAAK,EAAE,4BAA4B,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE;wBACvD,KAAK,EAAE,OAAO;qBACjB;iBACJ;aACJ,CAAC;QACN,CAAC;IACL,CAAC;CACJ;~~AAzCD~~,~~8DAyCC~~"}
1	+ {"version":3,"file":"cli-command-executor-service.js","sourceRoot":"","sources":["../../../src/services/cli-command-executor-service.ts"],"names":[],"mappings":"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"}

package/dist/src/services/cli-command-registry.d.ts CHANGED Viewed

@@ -1,14 +1,25 @@
 import { ICliCommandProcessor } from '../abstractions';
+/** Registry that stores and looks up CLI command processors by command name. */
 export interface ICliCommandRegistry {
+    /** All registered top-level processors. */
     readonly processors: ReadonlyArray<ICliCommandProcessor>;
+    /** Registers a command processor. */
     register(processor: ICliCommandProcessor): void;
+    /**
+     * Finds a processor by command name, optionally resolving a sub-command chain.
+     * @param command - Top-level command name.
+     * @param chainCommands - Optional sub-command chain to resolve.
+     * @returns Matching processor, or undefined if not found.
+     */
     findProcessor(command: string, chainCommands?: string[]): ICliCommandProcessor | undefined;
 }
+/** Default in-memory implementation of {@link ICliCommandRegistry}. */
 export declare class CliCommandRegistry implements ICliCommandRegistry {
     private _processors;
     get processors(): ReadonlyArray<ICliCommandProcessor>;
     register(processor: ICliCommandProcessor): void;
     findProcessor(command: string, chainCommands?: string[]): ICliCommandProcessor | undefined;
+    /** Walks the sub-processor tree to resolve a chain of sub-commands. */
     private resolveChain;
 }
 //# sourceMappingURL=cli-command-registry.d.ts.map

package/dist/src/services/cli-command-registry.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-command-registry.d.ts","sourceRoot":"","sources":["../../../src/services/cli-command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;~~AAEvD~~,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,SAAS,CAAC;CAC9F;AAED,qBAAa,kBAAmB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,WAAW,CAAgD;IAEnE,IAAI,UAAU,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAEpD;IAED,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;~~IAI~~/C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,SAAS;IAS1F,OAAO,CAAC,YAAY;CAkBvB"}
1	+ {"version":3,"file":"cli-command-registry.d.ts","sourceRoot":"","sources":["../../../src/services/cli-command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAKvD,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACzD,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,SAAS,CAAC;CAC9F;AAED,uEAAuE;AACvE,qBAAa,kBAAmB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,WAAW,CAAgD;IAEnE,IAAI,UAAU,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAEpD;IAED,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,SAAS;IAS1F,uEAAuE;IACvE,OAAO,CAAC,YAAY;CAkBvB"}

package/dist/src/services/cli-command-registry.js CHANGED Viewed

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliCommandRegistry = void 0;
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('CommandRegistry');
+/** Default in-memory implementation of {@link ICliCommandRegistry}. */
 class CliCommandRegistry {
     _processors = new Map();
     get processors() {
@@ -8,6 +11,7 @@ class CliCommandRegistry {
     }
     register(processor) {
         this._processors.set(processor.command.toLowerCase(), processor);
+        logger.debug('Registered processor: %s', processor.command);
     }
     findProcessor(command, chainCommands) {
         const processor = this._processors.get(command.toLowerCase());
@@ -16,6 +20,7 @@ class CliCommandRegistry {
         }
         return this.resolveChain(processor, chainCommands);
     }
+    /** Walks the sub-processor tree to resolve a chain of sub-commands. */
     resolveChain(processor, chainCommands) {
         let current = processor;
         for (const sub of chainCommands) {

package/dist/src/services/cli-command-registry.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-command-registry.js","sourceRoot":"","sources":["../../../src/services/cli-command-registry.ts"],"names":[],"mappings":";;;~~AAQA~~,MAAa,kBAAkB;IACnB,WAAW,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEnE,IAAI,UAAU;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,SAA+B;QACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;~~IACrE~~,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,aAAwB;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;~~IAEO~~,YAAY,CAChB,SAA+B,EAC/B,aAAuB;QAEvB,IAAI,OAAO,GAAG,SAAS,CAAC;QAExB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CACvD,CAAC;YACF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/D,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ;~~AAtCD~~,~~gDAsCC~~"}
1	+ {"version":3,"file":"cli-command-registry.js","sourceRoot":"","sources":["../../../src/services/cli-command-registry.ts"],"names":[],"mappings":";;;AACA,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,iBAAiB,CAAC,CAAC;AAiB/C,uEAAuE;AACvE,MAAa,kBAAkB;IACnB,WAAW,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEnE,IAAI,UAAU;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,SAA+B;QACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,aAAwB;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;IAED,uEAAuE;IAC/D,YAAY,CAChB,SAA+B,EAC/B,aAAuB;QAEvB,IAAI,OAAO,GAAG,SAAS,CAAC;QAExB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CACvD,CAAC;YACF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/D,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ;AAxCD,gDAwCC"}

package/dist/src/services/cli-event-socket-manager.d.ts CHANGED Viewed

@@ -1,10 +1,15 @@
 import type { Server } from 'http';
+/** Information about a connected WebSocket event client. */
 export interface CliWebSocketClientInfo {
     id: string;
     connectedAt: string;
     remoteAddress: string;
     type: 'events';
 }
+/**
+ * Manages WebSocket connections for server-push events and interactive shell sessions.
+ * Handles upgrades on `/ws/v1/qcli/events` and `/ws/v1/qcli/shell` paths.
+ */
 export declare class CliEventSocketManager {
     private _wss;
     private readonly _clients;
@@ -30,6 +35,7 @@ export declare class CliEventSocketManager {
      * Return information about all currently connected event clients.
      */
     getClients(): CliWebSocketClientInfo[];
+    /** Terminates all connections and closes the WebSocket server. */
     dispose(): void;
 }
 //# sourceMappingURL=cli-event-socket-manager.d.ts.map

package/dist/src/services/cli-event-socket-manager.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-event-socket-manager.d.ts","sourceRoot":"","sources":["../../../src/services/cli-event-socket-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,MAAM,CAAC;~~AAIpD~~,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;CAClB;AAQD,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAGhC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAGhC;IAEH;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;~~IAwD5B~~;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASxD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;~~IAuB1C~~;;OAEG;IACH,UAAU,IAAI,sBAAsB,EAAE;IAkBtC,OAAO,IAAI,IAAI;CAQlB"}
1	+ {"version":3,"file":"cli-event-socket-manager.d.ts","sourceRoot":"","sources":["../../../src/services/cli-event-socket-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,MAAM,CAAC;AAOpD,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;CAClB;AAQD;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAGhC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAGhC;IAEH;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA8D5B;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASxD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB1C;;OAEG;IACH,UAAU,IAAI,sBAAsB,EAAE;IAkBtC,kEAAkE;IAClE,OAAO,IAAI,IAAI;CAQlB"}

package/dist/src/services/cli-event-socket-manager.js CHANGED Viewed

@@ -4,6 +4,12 @@ exports.CliEventSocketManager = void 0;
 const ws_1 = require("ws");
 const url_1 = require("url");
 const cli_shell_session_manager_1 = require("./cli-shell-session-manager");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('EventSocket');
+/**
+ * Manages WebSocket connections for server-push events and interactive shell sessions.
+ * Handles upgrades on `/ws/v1/qcli/events` and `/ws/v1/qcli/shell` paths.
+ */
 class CliEventSocketManager {
     _wss = null;
     _clients = new Set();
@@ -50,21 +56,27 @@ class CliEventSocketManager {
                 });
                 return;
             }
-            // Not our path — let other handlers deal with it
+            // Unrecognized path; leave for other upgrade handlers
         });
         this._wss.on('connection', (ws, request) => {
             this._clients.add(ws);
+            const id = `evt-${this._nextClientId++}`;
             this._clientMeta.set(ws, {
-                id: `evt-${this._nextClientId++}`,
+                id,
                 connectedAt: new Date(),
                 remoteAddress: request.socket.remoteAddress ?? 'unknown',
             });
+            logger.info('Client connected (id=%s)', id);
             ws.send(JSON.stringify({ type: 'connected' }));
             ws.on('close', () => {
+                const meta = this._clientMeta.get(ws);
+                logger.info('Client disconnected (id=%s)', meta?.id ?? 'unknown');
                 this._clients.delete(ws);
                 this._clientMeta.delete(ws);
             });
             ws.on('error', () => {
+                const meta = this._clientMeta.get(ws);
+                logger.info('Client disconnected (id=%s)', meta?.id ?? 'unknown');
                 this._clients.delete(ws);
                 this._clientMeta.delete(ws);
             });
@@ -85,6 +97,7 @@ class CliEventSocketManager {
      * Broadcast a disconnect event to all connected clients and close sockets.
      */
     async broadcastDisconnect() {
+        logger.info('Broadcasting disconnect to %d clients', this._clients.size);
         const message = JSON.stringify({ type: 'disconnect' });
         const promises = [];
         for (const ws of this._clients) {
@@ -121,6 +134,7 @@ class CliEventSocketManager {
         }
         return result;
     }
+    /** Terminates all connections and closes the WebSocket server. */
     dispose() {
         for (const ws of this._clients) {
             ws.terminate();

package/dist/src/services/cli-event-socket-manager.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-event-socket-manager.js","sourceRoot":"","sources":["../../../src/services/cli-event-socket-manager.ts"],"names":[],"mappings":";;;AAAA,2BAAgD;AAEhD,6BAA0B;AAC1B,2EAAqE;~~AAerE~~,MAAa,qBAAqB;IACtB,IAAI,GAA2B,IAAI,CAAC;IAC3B,QAAQ,GAAG,IAAI,GAAG,EAAa,CAAC;IAChC,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,aAAa,GAAG,IAAI,kDAAsB,EAAE,CAAC;IACtD,aAAa,GAAG,CAAC,CAAC;IAElB,MAAM,CAAU,WAAW,GAAG,IAAI,GAAG,CAAC;QAC1C,oBAAoB;QACpB,iBAAiB;KACpB,CAAC,CAAC;IAEK,MAAM,CAAU,WAAW,GAAG,IAAI,GAAG,CAAC;QAC1C,mBAAmB;QACnB,gBAAgB;KACnB,CAAC,CAAC;IAEH;;;OAGG;IACH,MAAM,CAAC,MAAc;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,oBAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,IAAI,SAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAEjC,IAAI,qBAAqB,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;oBACnD,IAAI,CAAC,IAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;YAED,IAAI,qBAAqB,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;oBACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;oBACzE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;oBACzE,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;oBAExD,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;wBAChE,IAAI,CAAC;4BACD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;4BACjE,EAAE,CAAC,KAAK,EAAE,CAAC;wBACf,CAAC;wBAAC,MAAM,CAAC;4BACL,SAAS;wBACb,CAAC;oBACL,CAAC,CAAC,CAAC;gBACP,CAAC,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;YAED,~~iDAAiD~~;~~QACrD~~,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,OAAwB,EAAE,EAAE;YACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtB,~~IAAI~~,~~CAAC~~,~~WAAW~~,~~CAAC~~,~~GAAG~~,CAAC,EAAE,EAAE;~~gBACrB~~,~~EAAE~~,~~EAAE~~,~~OAAO~~,~~IAAI~~,CAAC,~~aAAa~~,EAAE,EAAE;~~gBACjC~~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~~AA/IL~~,~~sDAgJC~~"}
1	+ {"version":3,"file":"cli-event-socket-manager.js","sourceRoot":"","sources":["../../../src/services/cli-event-socket-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/services/cli-log-socket-manager.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 import type { Server } from 'http';
+/** Information about a connected WebSocket log-streaming client. */
 export interface CliLogWebSocketClientInfo {
     id: string;
     connectedAt: string;
@@ -45,6 +46,7 @@ export declare class CliLogSocketManager {
      * Return information about all currently connected log clients.
      */
     getClients(): CliLogWebSocketClientInfo[];
+    /** Terminates all connections and closes the WebSocket server. */
     dispose(): void;
     private _handleConnection;
 }

package/dist/src/services/cli-log-socket-manager.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-log-socket-manager.d.ts","sourceRoot":"","sources":["../../../src/services/cli-log-socket-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,MAAM,CAAC;~~AAGpD~~,MAAM,WAAW,yBAAyB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CAChB;AAsCD;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAG9B;IAEH;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAY3E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAUzF;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB5B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAsB5E;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;~~IAqB1C~~;;OAEG;IACH,UAAU,IAAI,yBAAyB,EAAE;IAgBzC,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,iBAAiB;~~CAsB5B~~"}
1	+ {"version":3,"file":"cli-log-socket-manager.d.ts","sourceRoot":"","sources":["../../../src/services/cli-log-socket-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,MAAM,CAAC;AAMpD,oEAAoE;AACpE,MAAM,WAAW,yBAAyB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CAChB;AAsCD;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAG9B;IAEH;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAY3E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAUzF;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB5B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAsB5E;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB1C;;OAEG;IACH,UAAU,IAAI,yBAAyB,EAAE;IAgBzC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,iBAAiB;CAyB5B"}

package/dist/src/services/cli-log-socket-manager.js CHANGED Viewed

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliLogSocketManager = void 0;
 const ws_1 = require("ws");
 const url_1 = require("url");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('LogSocket');
 /**
  * Level ordering from lowest to highest severity.
  * Matches the Python/C# implementations.
@@ -115,6 +117,7 @@ class CliLogSocketManager {
      * Send a disconnect message to all clients and close connections.
      */
     async broadcastDisconnect() {
+        logger.info('Broadcasting disconnect to %d log clients', this._clients.size);
         const disconnectMsg = JSON.stringify({ type: 'disconnect' });
         const promises = [];
         for (const entry of this._clients.values()) {
@@ -148,6 +151,7 @@ class CliLogSocketManager {
         }
         return result;
     }
+    /** Terminates all connections and closes the WebSocket server. */
     dispose() {
         for (const entry of this._clients.values()) {
             entry.ws.terminate();
@@ -166,10 +170,13 @@ class CliLogSocketManager {
         };
         this._clients.set(id, entry);
         ws.send(JSON.stringify({ type: 'connected' }));
+        logger.info('Log client connected (id=%s, level=%s)', id, levelFilter ?? 'all');
         ws.on('close', () => {
+            logger.info('Log client disconnected (id=%s)', id);
             this._clients.delete(id);
         });
         ws.on('error', () => {
+            logger.info('Log client disconnected (id=%s)', id);
             this._clients.delete(id);
         });
     }