@sonisoft/now-sdk-ext-cli 2.0.0-alpha.0 → 2.1.0

package/dist/commands/flow/status.js

@@ -0,0 +1,52 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { FlowManager } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { FlowDisplayService } from '../../services/flow-display.service.js';
+export class FlowStatus extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Get the status of a flow execution context.\n\n' +
+        'Queries sys_flow_context to retrieve the current state of a flow execution.\n\n' +
+        'Possible states: QUEUED, IN_PROGRESS, WAITING, COMPLETE, CANCELLED, ERROR';
+    static examples = [
+        {
+            description: 'Check flow execution status',
+            command: '<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev',
+        },
+    ];
+    static flags = {
+        'context-id': Flags.string({
+            char: 'c',
+            description: 'Flow execution context sys_id',
+            required: true,
+        }),
+        'scope': Flags.string({
+            description: 'Scope context for script execution',
+            required: false,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FlowStatus);
+        const displayService = new FlowDisplayService();
+        try {
+            const flowManager = new FlowManager(this.instance, flags.scope);
+            this.log(`Checking flow context status: ${flags['context-id']}`);
+            const result = await flowManager.getFlowContextStatus(flags['context-id']);
+            const lines = displayService.formatStatusResult(result, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error getting flow status.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/flow/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/flow/status.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAE3E,MAAM,OAAO,UAAW,SAAQ,oBAAuC;IAErE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAA;IAClB,MAAM,CAAC,WAAW,GAAG,iDAAiD;QAClE,iFAAiF;QACjF,2EAA2E,CAAC;IAChF,MAAM,CAAC,QAAQ,GAAG;QACd;YACE,WAAW,EAAE,6BAA6B;YAC1C,OAAO,EAAE,0EAA0E;SACpF;KACF,CAAA;IACH,MAAM,CAAC,KAAK,GAAG;QACX,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,cAAc,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAEhE,IAAI,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAEjE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YAE3E,MAAM,KAAK,GAAG,cAAc,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;YAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7D,CAAC;QAEH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAc,CAAC,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC"}

package/dist/commands/flow/subflow.d.ts

@@ -0,0 +1,19 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class FlowSubflow extends AuthenticatedCommand<typeof FlowSubflow> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        name: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        inputs: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        mode: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        quick: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=subflow.d.ts.map

package/dist/commands/flow/subflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subflow.d.ts","sourceRoot":"","sources":["../../../src/commands/flow/subflow.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,WAAY,SAAQ,oBAAoB,CAAC,OAAO,WAAW,CAAC;IAEvE,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SAQgD;IAClE,MAAM,CAAC,QAAQ;;;QASZ;IACH,MAAM,CAAC,KAAK;;;;;;;MAiCT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC3B"}

package/dist/commands/flow/subflow.js

@@ -0,0 +1,94 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { FlowManager } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { FlowDisplayService } from '../../services/flow-display.service.js';
+export class FlowSubflow extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Execute a published Flow Designer subflow by scoped name.\n\n' +
+        'Runs a subflow using the sn_fd.FlowAPI ScriptableFlowRunner.\n\n' +
+        'Note: This command requires the subflow to be published. For testing flows that ' +
+        'are not yet published (draft/saved state), use `flow test` instead.\n\n' +
+        'Features:\n' +
+        '  \u2022 Execute subflows by scoped name\n' +
+        '  \u2022 Pass input values as JSON\n' +
+        '  \u2022 Foreground or background execution mode\n' +
+        '  \u2022 Returns context ID, outputs, and debug information';
+    static examples = [
+        {
+            description: 'Run a subflow',
+            command: '<%= config.bin %> <%= command.id %> --name global.my_subflow --auth dev',
+        },
+        {
+            description: 'Run with inputs',
+            command: '<%= config.bin %> <%= command.id %> --name x_myapp.process_record --inputs \'{"table":"incident","sys_id":"abc123"}\' --auth dev',
+        },
+    ];
+    static flags = {
+        'name': Flags.string({
+            char: 'n',
+            description: 'Scoped name of the subflow (e.g. global.my_subflow)',
+            required: true,
+        }),
+        'inputs': Flags.string({
+            char: 'i',
+            description: 'JSON object of input name-value pairs',
+            required: false,
+        }),
+        'mode': Flags.string({
+            char: 'm',
+            description: 'Execution mode',
+            required: false,
+            default: 'foreground',
+            options: ['foreground', 'background'],
+        }),
+        'scope': Flags.string({
+            description: 'Scope context for script execution',
+            required: false,
+        }),
+        'quick': Flags.boolean({
+            description: 'Skip execution detail records for better performance',
+            required: false,
+            default: false,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FlowSubflow);
+        const displayService = new FlowDisplayService();
+        try {
+            let inputs;
+            if (flags.inputs) {
+                try {
+                    inputs = JSON.parse(flags.inputs);
+                }
+                catch {
+                    this.error('Invalid JSON in --inputs flag.');
+                    return;
+                }
+            }
+            const flowManager = new FlowManager(this.instance, flags.scope);
+            this.log(`Executing subflow: ${flags.name} (${flags.mode})`);
+            const result = await flowManager.executeSubflow({
+                scopedName: flags.name,
+                inputs,
+                mode: flags.mode,
+                quick: flags.quick,
+            });
+            const lines = displayService.formatExecutionResult(result, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error executing subflow.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=subflow.js.map

package/dist/commands/flow/subflow.js.map

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

package/dist/commands/flow/test.d.ts

@@ -0,0 +1,18 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class FlowTest extends AuthenticatedCommand<typeof FlowTest> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        'flow-id': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'output-map': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        synchronous: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=test.d.ts.map

package/dist/commands/flow/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/commands/flow/test.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,QAAS,SAAQ,oBAAoB,CAAC,OAAO,QAAQ,CAAC;IAEjE,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SASmC;IACrD,MAAM,CAAC,QAAQ;;;QAaZ;IACH,MAAM,CAAC,KAAK;;;;;;MA2BT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkC3B"}

package/dist/commands/flow/test.js

@@ -0,0 +1,91 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { FlowManager } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { FlowDisplayService } from '../../services/flow-display.service.js';
+export class FlowTest extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Test a Flow Designer flow without requiring it to be published.\n\n' +
+        'Invokes the same API as the "Test" button in Flow Designer, running the flow ' +
+        'in its current saved (draft) state. Unlike `flow run` which requires a published ' +
+        'flow and uses sn_fd.FlowAPI, `flow test` works on unpublished drafts via the ' +
+        'ProcessFlow REST API.\n\n' +
+        'Features:\n' +
+        '  \u2022 Test flows by sys_id or scoped name\n' +
+        '  \u2022 Pass trigger output values as JSON via --output-map\n' +
+        '  \u2022 Auto-resolves scope from flow definition if not provided\n' +
+        '  \u2022 Synchronous or asynchronous execution';
+    static examples = [
+        {
+            description: 'Test a flow by sys_id',
+            command: '<%= config.bin %> <%= command.id %> --flow-id 887dda5583237210fdb8f7b6feaad32c --output-map \'{"current":"0ecd7552db252200a6a2b31be0b8f5e6","table_name":"change_request"}\' --auth dev',
+        },
+        {
+            description: 'Test a flow by scoped name with explicit scope',
+            command: '<%= config.bin %> <%= command.id %> -f x_myapp.my_flow -o \'{"current":"abc123","table_name":"incident"}\' --scope x_myapp --auth dev',
+        },
+        {
+            description: 'Test with JSON output',
+            command: '<%= config.bin %> <%= command.id %> -f 887dda5583237210fdb8f7b6feaad32c -o \'{"current":"abc123"}\' --json --auth dev',
+        },
+    ];
+    static flags = {
+        'flow-id': Flags.string({
+            char: 'f',
+            description: 'Flow sys_id or scoped name (e.g. x_myapp.my_flow)',
+            required: true,
+        }),
+        'output-map': Flags.string({
+            char: 'o',
+            description: 'JSON mapping of trigger output variable names to test values (e.g. \'{"current":"<sys_id>","table_name":"change_request"}\')',
+            required: true,
+        }),
+        'scope': Flags.string({
+            description: 'Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)',
+            required: false,
+        }),
+        'synchronous': Flags.boolean({
+            description: 'Run test synchronously (default: true)',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FlowTest);
+        const displayService = new FlowDisplayService();
+        try {
+            let outputMap;
+            try {
+                outputMap = JSON.parse(flags['output-map']);
+            }
+            catch {
+                this.error('Invalid JSON in --output-map flag.');
+            }
+            // Constructor scope sets the auth/session context; testFlow scope sets the transaction scope
+            const flowManager = new FlowManager(this.instance, flags.scope);
+            this.log(`Testing flow: ${flags['flow-id']} (${flags.synchronous ? 'synchronous' : 'asynchronous'})`);
+            const result = await flowManager.testFlow({
+                flowId: flags['flow-id'],
+                outputMap,
+                scope: flags.scope,
+                runOnThread: flags.synchronous,
+            });
+            const lines = displayService.formatTestResult(result, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error testing flow.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/flow/test.js.map

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

package/dist/commands/health/check.d.ts

@@ -0,0 +1,20 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class HealthCheck extends AuthenticatedCommand<typeof HealthCheck> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        'include-version': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'include-cluster': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'include-stuck-jobs': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'include-semaphores': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'include-operational-counts': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'stuck-job-threshold': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/health/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/commands/health/check.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,WAAY,SAAQ,oBAAoB,CAAC,OAAO,WAAW,CAAC;IAEvE,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SAU8B;IAChD,MAAM,CAAC,QAAQ;;;QAiBZ;IACH,MAAM,CAAC,KAAK;;;;;;;;MA0CT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B3B"}

package/dist/commands/health/check.js

@@ -0,0 +1,105 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { InstanceHealth } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { HealthDisplayService } from '../../services/health-display.service.js';
+export class HealthCheck extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Run a consolidated health check on a ServiceNow instance.\n\n' +
+        'Performs comprehensive diagnostics including version info, cluster status, stuck job detection, ' +
+        'semaphore counts, and operational record counts.\n\n' +
+        'Features:\n' +
+        '  \u2022 Instance version and build information\n' +
+        '  \u2022 Cluster node status\n' +
+        '  \u2022 Stuck job detection with configurable threshold\n' +
+        '  \u2022 Active semaphore count\n' +
+        '  \u2022 Operational counts (incidents, changes, problems)\n' +
+        '  \u2022 Color-coded status indicators\n' +
+        '  \u2022 JSON output for CI/CD monitoring';
+    static examples = [
+        {
+            description: 'Run full health check',
+            command: '<%= config.bin %> <%= command.id %> --auth dev',
+        },
+        {
+            description: 'Check only version and stuck jobs',
+            command: '<%= config.bin %> <%= command.id %> --include-version --include-stuck-jobs --no-include-cluster --no-include-semaphores --no-include-operational-counts --auth dev',
+        },
+        {
+            description: 'Health check with custom stuck job threshold',
+            command: '<%= config.bin %> <%= command.id %> --stuck-job-threshold 60 --auth dev',
+        },
+        {
+            description: 'Health check as JSON',
+            command: '<%= config.bin %> <%= command.id %> --json --auth dev',
+        },
+    ];
+    static flags = {
+        'include-version': Flags.boolean({
+            description: 'Include instance version information',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'include-cluster': Flags.boolean({
+            description: 'Include cluster node status',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'include-stuck-jobs': Flags.boolean({
+            description: 'Include stuck job detection',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'include-semaphores': Flags.boolean({
+            description: 'Include active semaphore count',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'include-operational-counts': Flags.boolean({
+            description: 'Include operational record counts (incidents, changes, problems)',
+            required: false,
+            default: true,
+            allowNo: true,
+        }),
+        'stuck-job-threshold': Flags.integer({
+            description: 'Minutes threshold for a job to be considered stuck',
+            required: false,
+            default: 30,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(HealthCheck);
+        const displayService = new HealthDisplayService();
+        try {
+            const instanceHealth = new InstanceHealth(this.instance);
+            this.log('Running instance health check...');
+            const result = await instanceHealth.checkHealth({
+                includeVersion: flags['include-version'],
+                includeCluster: flags['include-cluster'],
+                includeStuckJobs: flags['include-stuck-jobs'],
+                includeSemaphores: flags['include-semaphores'],
+                includeOperationalCounts: flags['include-operational-counts'],
+                stuckJobThresholdMinutes: flags['stuck-job-threshold'],
+            });
+            const lines = displayService.formatHealthResult(result, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error occurred when running health check.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/health/check.js.map

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

package/dist/commands/log/index.d.ts

@@ -12,35 +12,11 @@ export declare class Log extends AuthenticatedCommand<typeof Log> {
         'no-color': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         filter: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };
-    private _logger;
     private filterRules;
+    private filterService;
+    private formatter;
     private syslogReader?;
     run(): Promise<void>;
-    private displayHeader;
-    private displayLog;
     private handleExit;
-    private highlightKeywords;
-    /**
-     * Check if a log record matches a single filter rule
-     * @param log The log record to check
-     * @param rule The filter rule to apply
-     * @returns true if the log matches the filter, false otherwise
-     */
-    private matchesFilter;
-    /**
-     * Check if a log record matches all filter rules
-     * @param log The log record to check
-     * @returns true if the log matches all filters (AND logic), false otherwise
-     */
-    private matchesFilters;
-    /**
-     * Parse a filter string into a FilterRule object
-     * Supports formats:
-     *   - "field OPERATOR value"
-     *   - "OPERATOR value" (defaults to message field)
-     * @param filterStr The filter string to parse
-     * @returns A FilterRule object
-     */
-    private parseFilter;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/log/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/log/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAiB5E,qBAAa,GAAI,SAAQ,oBAAoB,CAAC,OAAO,GAAG,CAAC;IAEvD,MAAM,CAAC,IAAI,KAAK;IAEhB,MAAM,CAAC,WAAW,SAoCiD;IAEnE,MAAM,CAAC,QAAQ;;;QAiCd;IAED,MAAM,CAAC,KAAK;;;;;MA0BX;IAED,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,YAAY,CAAC,CAAe;IAE9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA6D1B,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,UAAU;IA0ElB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,iBAAiB;IAYzB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAyErB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAatB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAsDpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/log/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAI5E,qBAAa,GAAI,SAAQ,oBAAoB,CAAC,OAAO,GAAG,CAAC;IAEvD,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SAoCmD;IACrE,MAAM,CAAC,QAAQ;;;QAiCZ;IACH,MAAM,CAAC,KAAK;;;;;MA0BT;IACH,OAAO,CAAC,WAAW,CAAoB;IACrC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAC,CAAe;IAE9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE1B,OAAO,CAAC,UAAU;CAgBnB"}