@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.8

package/lib/services/BulkExecutionService.js

@@ -0,0 +1,535 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { createSuccessResult, createFailureResult } from '../models/service-result.js';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+import { CuneiformQueryBuilder } from '../adapters/soql/cuneiform-query-builder.js';
+import { TERMINAL_STATUSES } from '../models/profiling-execution-types.js';
+import { validateObjectName } from './validation.js';
+/**
+ * Default bulk execution options.
+ */
+const DEFAULT_BULK_OPTIONS = {
+    parallel: 5,
+    skipEmpty: true,
+    pollInterval: 5000,
+    waitForCompletion: true,
+};
+/**
+ * Minimum and maximum parallel threads for bulk execution.
+ */
+const MIN_PARALLEL = 1;
+const MAX_PARALLEL = 10;
+/**
+ * Error resolution mappings for common Apex errors.
+ * Maps error patterns to user-friendly resolution guidance.
+ */
+const ERROR_RESOLUTIONS = [
+    {
+        pattern: /FIELD_CUSTOM_VALIDATION_EXCEPTION/i,
+        resolution: 'Grant FLS (Field-Level Security) access or exclude the field from profiling.',
+    },
+    {
+        pattern: /INSUFFICIENT_ACCESS|NO_ACCESS/i,
+        resolution: 'Verify that required permission sets are assigned to the running user.',
+    },
+    {
+        pattern: /QUERY_TIMEOUT|System\.QueryException.*[Tt]imeout/i,
+        resolution: 'Reduce the number of records by adding filters or reduce the number of fields.',
+    },
+    {
+        pattern: /APEX_CPU_TIME_LIMIT|System\.LimitException.*CPU/i,
+        resolution: 'Reduce parallel threads using the --parallel flag to lower CPU pressure.',
+    },
+    {
+        pattern: /TOO_MANY_SOQL_QUERIES|System\.LimitException.*SOQL/i,
+        resolution: 'Reduce parallel threads or wait for other operations to complete.',
+    },
+    {
+        pattern: /TOO_MANY_DML_STATEMENTS|System\.LimitException.*DML/i,
+        resolution: 'Reduce parallel threads or simplify the profiling definition.',
+    },
+    {
+        pattern: /REQUIRED_FIELD_MISSING/i,
+        resolution: 'Ensure all required fields are populated in the profiling definition.',
+    },
+    {
+        pattern: /DUPLICATE_VALUE|already exists/i,
+        resolution: 'A profiling request already exists. Cancel the existing request or wait for completion.',
+    },
+    {
+        pattern: /INVALID_CROSS_REFERENCE_KEY|Record Type.*not found/i,
+        resolution: 'Verify that the Record Type exists and is accessible to the running user.',
+    },
+    {
+        pattern: /ENTITY_IS_DELETED/i,
+        resolution: 'The profiling definition has been deleted. Refresh and select a valid definition.',
+    },
+];
+/**
+ * Semaphore for controlling concurrent execution.
+ *
+ * Implements a counting semaphore pattern to limit the number of
+ * concurrent operations. Used to control parallel profiling threads.
+ */
+class Semaphore {
+    permits;
+    waitQueue = [];
+    /**
+     * Creates a new semaphore with the specified number of permits.
+     *
+     * @param permits - Maximum number of concurrent operations allowed
+     */
+    constructor(permits) {
+        this.permits = permits;
+    }
+    /**
+     * Acquires a permit, blocking if none are available.
+     *
+     * @returns Promise that resolves when a permit is acquired
+     */
+    acquire() {
+        return new Promise((resolve) => {
+            if (this.permits > 0) {
+                this.permits--;
+                resolve();
+            }
+            else {
+                this.waitQueue.push(resolve);
+            }
+        });
+    }
+    /**
+     * Releases a permit, allowing a waiting operation to proceed.
+     */
+    release() {
+        const next = this.waitQueue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.permits++;
+        }
+    }
+}
+/**
+ * Service for bulk execution of profiling definitions with controlled concurrency.
+ *
+ * Orchestrates parallel execution of multiple profiling definitions using a
+ * semaphore-based concurrency model. Receives an `IProfilingExecutor`
+ * callback object to decouple bulk orchestration from single-execution mechanics.
+ *
+ * Responsibilities:
+ * - Semaphore-based concurrency control (1-10 parallel threads)
+ * - Skip-empty logic (check record count before profiling)
+ * - Progress reporting via callbacks
+ * - Error resolution mapping for user-friendly guidance
+ * - Aggregate result summary (successful, failed, skipped)
+ *
+ * @example
+ * ```typescript
+ * const bulkService = new BulkExecutionService({
+ *   soqlAdapter,
+ *   pollingService,
+ * });
+ *
+ * const executor = {
+ *   execute: (defId: string) => executionService.execute(defId),
+ *   getStatus: (reqId: string) => executionService.getStatus(reqId),
+ * };
+ *
+ * const result = await bulkService.executeBulk(
+ *   definitions,
+ *   executor,
+ *   { parallel: 5, skipEmpty: true },
+ *   (update) => console.log(`${update.index + 1}/${update.total}: ${update.message}`)
+ * );
+ * ```
+ */
+export class BulkExecutionService {
+    soqlAdapter;
+    pollingService;
+    logger;
+    constructor(config) {
+        this.soqlAdapter = config.soqlAdapter;
+        this.pollingService = config.pollingService;
+        this.logger = config.logger;
+    }
+    /**
+     * Maps an error message to user-friendly resolution guidance.
+     *
+     * Searches through known error patterns and returns appropriate resolution
+     * guidance. If no pattern matches, returns undefined.
+     *
+     * @param errorMessage - The error message to analyze
+     * @returns User-friendly resolution guidance or undefined
+     */
+    static getErrorResolution(errorMessage) {
+        for (const { pattern, resolution } of ERROR_RESOLUTIONS) {
+            if (pattern.test(errorMessage)) {
+                return resolution;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Reports progress update via callback.
+     *
+     * @param onProgress - Optional progress callback
+     * @param definition - Current definition
+     * @param status - Current status
+     * @param index - Index in batch
+     * @param total - Total count
+     * @param summary - Running summary
+     * @param message - Optional message
+     */
+    static reportProgress(onProgress, definition, status, index, total, summary, message) {
+        if (onProgress) {
+            onProgress({
+                current: definition,
+                status,
+                index,
+                total,
+                summary: { ...summary },
+                message,
+            });
+        }
+    }
+    /**
+     * Executes profiling for multiple definitions in parallel with controlled concurrency.
+     *
+     * Implements semaphore-based concurrency control, progress callbacks, skip-empty
+     * logic, and error resolution mapping. Returns an aggregated summary of results.
+     *
+     * @param definitions - Array of profiling definitions to execute
+     * @param executor - Executor interface for triggering and monitoring profiling
+     * @param options - Bulk execution options (parallel, skipEmpty, pollInterval)
+     * @param onProgress - Optional callback for progress updates
+     * @returns ServiceResult containing BulkExecutionResult with summary and per-definition results
+     */
+    async executeBulk(definitions, executor, options = {}, onProgress) {
+        const startTime = Date.now();
+        const emptyResult = {
+            summary: { total: 0, successful: 0, failed: 0, skipped: 0 },
+            definitions: [],
+        };
+        // Validate definitions array is non-empty
+        if (!definitions || definitions.length === 0) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.PROFILING_BULK_EMPTY_DEFINITIONS, 'Bulk execution requires at least one definition', { metadata: { duration: Date.now() - startTime } });
+        }
+        // Merge options with defaults
+        const mergedOptions = {
+            ...DEFAULT_BULK_OPTIONS,
+            ...options,
+        };
+        // Validate parallel option
+        if (mergedOptions.parallel < MIN_PARALLEL || mergedOptions.parallel > MAX_PARALLEL) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.PROFILING_BULK_INVALID_PARALLEL, `Invalid parallel option: ${String(mergedOptions.parallel)}. Must be between ${String(MIN_PARALLEL)} and ${String(MAX_PARALLEL)}.`, { metadata: { duration: Date.now() - startTime } });
+        }
+        this.logger?.log(`Starting bulk execution of ${String(definitions.length)} definitions with ${String(mergedOptions.parallel)} parallel threads`);
+        // Initialize tracking - use local variables to avoid no-param-reassign
+        let successfulCount = 0;
+        let failedCount = 0;
+        let skippedCount = 0;
+        const results = [];
+        const semaphore = new Semaphore(mergedOptions.parallel);
+        // Process all definitions concurrently with semaphore control
+        const processingPromises = definitions.map(async (definition, index) => {
+            const summary = () => ({
+                total: definitions.length,
+                successful: successfulCount,
+                failed: failedCount,
+                skipped: skippedCount,
+            });
+            return this.processDefinition({ definition, index, total: definitions.length }, {
+                options: mergedOptions,
+                semaphore,
+                getSummary: summary,
+                incrementCounter: (incrementType) => {
+                    if (incrementType === 'successful')
+                        successfulCount++;
+                    else if (incrementType === 'failed')
+                        failedCount++;
+                    else if (incrementType === 'skipped')
+                        skippedCount++;
+                },
+            }, { executor, onProgress });
+        });
+        try {
+            const definitionResults = await Promise.all(processingPromises);
+            results.push(...definitionResults);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.error?.(`Bulk execution failed: ${errorMessage}`);
+            const finalSummary = {
+                total: definitions.length,
+                successful: successfulCount,
+                failed: failedCount,
+                skipped: skippedCount,
+            };
+            return createFailureResult({ summary: finalSummary, definitions: results }, ServiceErrorCodes.PROFILING_BULK_EXECUTION_FAILED, errorMessage, { metadata: { duration: Date.now() - startTime } });
+        }
+        const duration = Date.now() - startTime;
+        const finalSummary = {
+            total: definitions.length,
+            successful: successfulCount,
+            failed: failedCount,
+            skipped: skippedCount,
+        };
+        this.logger?.log(`Bulk execution completed: ${String(finalSummary.successful)} successful, ` +
+            `${String(finalSummary.failed)} failed, ${String(finalSummary.skipped)} skipped`);
+        // Determine overall success based on results
+        const allSucceeded = finalSummary.failed === 0;
+        const allFailed = finalSummary.successful === 0 && finalSummary.failed > 0;
+        if (allFailed) {
+            return createFailureResult({ summary: finalSummary, definitions: results }, ServiceErrorCodes.PROFILING_BULK_EXECUTION_FAILED, `All ${String(finalSummary.failed)} definitions failed to execute`, { metadata: { duration } });
+        }
+        if (!allSucceeded && finalSummary.successful > 0) {
+            // Partial success
+            return createSuccessResult({ summary: finalSummary, definitions: results }, {
+                message: `Bulk execution completed with ${String(finalSummary.successful)} successful, ${String(finalSummary.failed)} failed, ${String(finalSummary.skipped)} skipped`,
+                warnings: [`${String(finalSummary.failed)} definition(s) failed to execute`],
+                metadata: { duration },
+            });
+        }
+        return createSuccessResult({ summary: finalSummary, definitions: results }, {
+            message: `Bulk execution completed: ${String(finalSummary.successful)} successful, ${String(finalSummary.skipped)} skipped`,
+            metadata: { duration },
+        });
+    }
+    /**
+     * Checks the record count for an object.
+     *
+     * Used by skip-empty logic to determine if an object has records to profile.
+     *
+     * @param objectName - The Salesforce object API name
+     * @returns Typed result distinguishing success, validation failure, and query failure
+     */
+    async getRecordCount(objectName) {
+        // Validate object name before building SOQL
+        const validationError = validateObjectName(objectName);
+        if (validationError) {
+            this.logger?.warn?.(`Invalid object name for record count: ${objectName}`);
+            return { ok: false, reason: 'validation_failed', message: validationError };
+        }
+        const soql = new CuneiformQueryBuilder().count().from(objectName).toSOQL();
+        try {
+            const result = await this.soqlAdapter.query(soql);
+            if (result.success) {
+                return { ok: true, count: result.data.totalSize };
+            }
+            this.logger?.warn?.(`Record count query returned failure for ${objectName}: ${result.message ?? 'unknown'}`);
+            return { ok: false, reason: 'query_failed', message: result.message ?? 'Query returned failure' };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.warn?.(`Record count query threw for ${objectName}: ${errorMessage}`);
+            return { ok: false, reason: 'query_failed', message: errorMessage };
+        }
+    }
+    /**
+     * Checks if a definition should be skipped due to empty records.
+     *
+     * @param definition - The profiling definition to check
+     * @returns Skip info if should be skipped, null otherwise
+     */
+    async checkSkipEmpty(definition) {
+        const recordCountResult = await this.getRecordCount(definition.objectName);
+        if (!recordCountResult.ok) {
+            if (recordCountResult.reason === 'validation_failed') {
+                // Invalid object name — skip with error rather than proceeding to certain failure
+                return { skipReason: 'error', reason: `Invalid object name: ${recordCountResult.message}` };
+            }
+            // Query failed — proceed with execution and let it fail naturally
+            this.logger?.log(`Record count query failed for ${definition.objectName}, proceeding with execution`);
+            return null;
+        }
+        if (recordCountResult.count === 0) {
+            this.logger?.log(`Skipping ${definition.name}: ${definition.objectName} has no records`);
+            return { skipReason: 'empty', reason: `${definition.objectName} has no records` };
+        }
+        return null;
+    }
+    /**
+     * Processes a single definition within bulk execution.
+     *
+     * Acquires a semaphore permit, executes the definition, waits for completion,
+     * and releases the permit. Updates summary counts and calls progress callback.
+     *
+     * @param item - The definition and its position in the batch
+     * @param ctx - Shared batch execution state (options, semaphore, counters)
+     * @param callbacks - Caller-provided execution and status functions
+     * @returns The execution result for this definition
+     */
+    async processDefinition(item, ctx, callbacks) {
+        const { definition, index, total } = item;
+        const { options, semaphore, getSummary, incrementCounter } = ctx;
+        const { executor, onProgress } = callbacks;
+        const defStartTime = Date.now();
+        // Acquire semaphore permit
+        await semaphore.acquire();
+        try {
+            // Report progress - starting
+            BulkExecutionService.reportProgress(onProgress, definition, 'pending', index, total, getSummary(), 'Waiting to execute');
+            // Skip-empty check
+            if (options.skipEmpty) {
+                const skipResult = await this.checkSkipEmpty(definition);
+                if (skipResult) {
+                    incrementCounter('skipped');
+                    BulkExecutionService.reportProgress(onProgress, definition, 'skipped', index, total, getSummary(), `Skipped: ${skipResult.reason}`);
+                    return {
+                        definition,
+                        status: 'skipped',
+                        skipReason: skipResult.skipReason,
+                        durationMs: Date.now() - defStartTime,
+                    };
+                }
+            }
+            // Check if already in progress
+            if (definition.status === 'IN PROGRESS') {
+                incrementCounter('skipped');
+                BulkExecutionService.reportProgress(onProgress, definition, 'skipped', index, total, getSummary(), 'Already in progress');
+                return {
+                    definition,
+                    status: 'skipped',
+                    skipReason: 'in_progress',
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            // Report progress - executing
+            BulkExecutionService.reportProgress(onProgress, definition, 'executing', index, total, getSummary(), `Executing ${definition.name}`);
+            // Execute profiling via callback
+            const executeResult = await executor.execute(definition.id);
+            if (!executeResult.success) {
+                incrementCounter('failed');
+                const resolution = BulkExecutionService.getErrorResolution(executeResult.message ?? '');
+                BulkExecutionService.reportProgress(onProgress, definition, 'failed', index, total, getSummary(), executeResult.message);
+                return {
+                    definition,
+                    status: 'failed',
+                    errorMessage: executeResult.message,
+                    errorCode: executeResult.errorCode,
+                    resolution,
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            const requestId = executeResult.data;
+            // Enqueue-only mode: skip waiting for completion
+            if (!options.waitForCompletion) {
+                incrementCounter('successful');
+                BulkExecutionService.reportProgress(onProgress, definition, 'completed', index, total, getSummary(), `Request ${requestId} enqueued for ${definition.name}`);
+                return {
+                    definition,
+                    status: 'completed',
+                    requestId,
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            // Wait for completion via PollingService with custom initial delay from bulk options
+            const bulkCapture = { first: null };
+            const pollResult = await this.pollingService.poll(() => executor.getStatus(requestId), (status) => {
+                if (bulkCapture.first === null) {
+                    bulkCapture.first = status;
+                }
+                return TERMINAL_STATUSES.has(status.status);
+            }, { initialDelayMs: options.pollInterval });
+            if (!pollResult.success) {
+                incrementCounter('failed');
+                const resolution = BulkExecutionService.getErrorResolution(pollResult.message ?? '');
+                BulkExecutionService.reportProgress(onProgress, definition, 'failed', index, total, getSummary(), pollResult.message);
+                return {
+                    definition,
+                    status: 'failed',
+                    requestId,
+                    errorMessage: pollResult.message,
+                    errorCode: pollResult.errorCode,
+                    resolution,
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            // Guard: PollingService contract guarantees data on success path,
+            // but the type is optional — defend against contract violations
+            if (!pollResult.data) {
+                incrementCounter('failed');
+                return {
+                    definition,
+                    status: 'failed',
+                    requestId,
+                    errorMessage: 'Polling succeeded but returned no result envelope',
+                    errorCode: ServiceErrorCodes.PROFILING_POLL_FAILED,
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            const terminalStatus = pollResult.data.data;
+            if (terminalStatus === undefined) {
+                incrementCounter('failed');
+                return {
+                    definition,
+                    status: 'failed',
+                    requestId,
+                    errorMessage: 'Polling succeeded but returned no terminal status data',
+                    errorCode: ServiceErrorCodes.PROFILING_POLL_FAILED,
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            const profilingResult = {
+                requestId,
+                status: terminalStatus.status,
+                definitionId: terminalStatus.definitionId,
+                success: terminalStatus.status === 'Completed',
+                errorMessage: terminalStatus.errorMessage,
+                startedAt: bulkCapture.first?.createdDate,
+                completedAt: terminalStatus.lastModifiedDate,
+                durationMs: Date.now() - defStartTime,
+            };
+            if (!profilingResult.success) {
+                incrementCounter('failed');
+                const resolution = BulkExecutionService.getErrorResolution(profilingResult.errorMessage ?? '');
+                BulkExecutionService.reportProgress(onProgress, definition, 'failed', index, total, getSummary(), profilingResult.errorMessage ?? 'Profiling failed');
+                return {
+                    definition,
+                    status: 'failed',
+                    requestId,
+                    result: profilingResult,
+                    errorMessage: profilingResult.errorMessage,
+                    resolution,
+                    durationMs: Date.now() - defStartTime,
+                };
+            }
+            // Success
+            incrementCounter('successful');
+            BulkExecutionService.reportProgress(onProgress, definition, 'completed', index, total, getSummary(), `Completed ${definition.name}`);
+            return {
+                definition,
+                status: 'completed',
+                requestId,
+                result: profilingResult,
+                durationMs: Date.now() - defStartTime,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            incrementCounter('failed');
+            const resolution = BulkExecutionService.getErrorResolution(errorMessage);
+            BulkExecutionService.reportProgress(onProgress, definition, 'failed', index, total, getSummary(), errorMessage);
+            return {
+                definition,
+                status: 'failed',
+                errorMessage,
+                errorCode: ServiceErrorCodes.PROFILING_EXECUTION_FAILED,
+                resolution,
+                durationMs: Date.now() - defStartTime,
+            };
+        }
+        finally {
+            // Always release semaphore permit
+            semaphore.release();
+        }
+    }
+}
+//# sourceMappingURL=BulkExecutionService.js.map

package/lib/services/BulkExecutionService.js.map

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

package/lib/services/CompatibilityService.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Shape of the relevant slice of `package.json` consulted for compatibility
+ * metadata. `cuneiform.requiredAppVersion` is the minimum-required Cuneiform
+ * For Salesforce package version; `version` is the CLI plugin's own version
+ * (always populated by oclif/npm). Namespace/name are sourced from
+ * `namespace-constants.ts`.
+ */
+export type CompatibilityManifest = {
+    version?: string;
+    cuneiform?: {
+        requiredAppVersion?: string;
+    };
+};
+/** Required Cuneiform For Salesforce app version, parsed from the manifest. */
+export type RequiredAppVersion = {
+    /** Version string in Major.Minor (or Major.Minor.Patch.Build) form. */
+    version: string;
+};
+/**
+ * Comparison outcome produced by {@link CompatibilityService.compare} or set
+ * by the operation layer when the org is detected via namespace fallback but
+ * the version is unavailable (`installed-version-unknown`).
+ *
+ * Exit-code contract (set by the command layer): `installed-match`,
+ * `installed-newer`, and `installed-version-unknown` exit 0. `installed-older`
+ * and `not-installed` exit 1.
+ */
+export type CompatibilityState = 'installed-match' | 'installed-newer' | 'installed-older' | 'installed-version-unknown' | 'not-installed';
+/**
+ * Configuration for {@link CompatibilityService}.
+ */
+export type ICompatibilityServiceConfig = {
+    /**
+     * Optional injectable manifest reader. Defaults to reading the CLI plugin's
+     * `package.json` from disk. Tests inject a deterministic reader to avoid
+     * touching the filesystem.
+     */
+    manifestReader?: () => CompatibilityManifest;
+};
+/**
+ * Service for evaluating compatibility between the running CLI version and the
+ * Cuneiform For Salesforce managed package installed in a target org.
+ *
+ * Stateless. The required version is sourced from `package.json`; the installed
+ * version is supplied by the caller (typically via
+ * `OrgInfoService.getCuneiformPackageInfo`).
+ *
+ * Comparison semantics: version strings are parsed as integer tuples padded to
+ * four parts (`Major.Minor.Patch.Build`). Equality on the padded tuple yields
+ * `installed-match`; lexicographic order on the padded tuple yields
+ * `installed-newer` / `installed-older`. A null/undefined installed version
+ * yields `not-installed`.
+ */
+export declare class CompatibilityService {
+    private readonly manifestReader;
+    constructor(config?: ICompatibilityServiceConfig);
+    /**
+     * Compare a required version to an installed version. Pure function — exposed
+     * as a static method since it does not depend on instance state.
+     *
+     * @param required - required version string (`Major.Minor` or `Major.Minor.Patch.Build`)
+     * @param installed - installed version string, or `null`/`undefined` if absent
+     * @returns one of `installed-match`, `installed-newer`, `installed-older`, `not-installed`
+     * @throws SfError (E4682) when either version string contains a non-numeric component
+     */
+    static compare(required: string, installed: string | null | undefined): CompatibilityState;
+    /**
+     * Load the required Cuneiform For Salesforce app version from the manifest.
+     *
+     * @returns the parsed required version
+     * @throws SfError (E4681) when `cuneiform.requiredAppVersion` is missing or empty
+     */
+    loadRequired(): RequiredAppVersion;
+    /**
+     * Load the CLI plugin's own version from the manifest (`package.json` `version` field).
+     *
+     * @returns the CLI version string verbatim (e.g., "1.0.4-beta.1")
+     * @throws SfError (E4684) when `version` is missing or empty (should never happen for npm-published packages)
+     */
+    loadCliVersion(): string;
+}