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

package/lib/commands/cuneiform/summary/reprofile.js

@@ -0,0 +1,236 @@
+/*
+ * 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 { Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import { ProfilingSummaryService } from '../../../services/ProfilingSummaryService.js';
+import { SummaryReprofileOperation, SummaryReprofileErrorCodes, } from '../../../operations/SummaryReprofileOperation.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { displaySummaryBox } from '../../../utils/formatting/command-display.js';
+import { displayOrgIdentity } from '../../../utils/formatting/org-identity.js';
+import { formatNumber } from '../../../utils/formatting/numbers.js';
+import { statusSymbol } from '../../../utils/formatting/indicators.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'summary.reprofile');
+/**
+ * Reprofiles failed or stopped profiling summaries in a Salesforce org.
+ *
+ * Submits failed or stopped summaries for re-profiling. This is a
+ * fire-and-forget operation — the ISV backend handles the actual profiling.
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class SummaryReprofile extends CuneiformCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    // eslint-disable-next-line sf-plugin/spread-base-flags -- CuneiformCommand has no additional flags to spread
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion(),
+        ids: Flags.string({
+            summary: messages.getMessage('flags.ids.summary'),
+            char: 'i',
+            multiple: true,
+        }),
+        all: Flags.boolean({
+            summary: messages.getMessage('flags.all.summary'),
+            char: 'a',
+        }),
+        objects: Flags.string({
+            summary: messages.getMessage('flags.objects.summary'),
+            char: 'b',
+            multiple: true,
+        }),
+        'dry-run': Flags.boolean({
+            summary: messages.getMessage('flags.dry-run.summary'),
+            char: 'd',
+            default: false,
+        }),
+        'no-prompt': Flags.boolean({
+            summary: messages.getMessage('flags.no-prompt.summary'),
+            char: 'y',
+            default: false,
+        }),
+    };
+    /**
+     * Maps error codes to i18n message keys.
+     */
+    static ERROR_CODE_MAP = {
+        [SummaryReprofileErrorCodes.NO_SELECTION_CRITERIA]: 'errors.noSelectionCriteria',
+        [SummaryReprofileErrorCodes.MUTUALLY_EXCLUSIVE]: 'errors.mutuallyExclusive',
+        [SummaryReprofileErrorCodes.NO_ELIGIBLE_SUMMARIES]: 'errors.noEligibleSummaries',
+        [SummaryReprofileErrorCodes.QUERY_FAILED]: 'errors.queryFailed',
+        [SummaryReprofileErrorCodes.REPROFILE_FAILED]: 'errors.reprofileFailed',
+    };
+    /**
+     * Executes the summary reprofile command.
+     */
+    async run() {
+        const { flags } = await this.parse(SummaryReprofile);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error(messages.getMessage('errors.noTargetOrg'));
+        }
+        const dryRun = flags['dry-run'];
+        const noPrompt = flags['no-prompt'];
+        // Initialize services
+        const { facade, soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const summaryService = new ProfilingSummaryService({ soqlAdapter, restAdapter });
+        const orgInfoService = new OrgInfoService({ connectionFacade: facade, soqlAdapter });
+        const operation = new SummaryReprofileOperation(summaryService);
+        // Build operation options
+        const operationOptions = {
+            all: flags.all,
+            ids: SummaryReprofile.parseMultiValueFlag(flags.ids),
+            objects: SummaryReprofile.parseMultiValueFlag(flags.objects),
+            dryRun,
+            noPrompt,
+            onSummariesFound: (count) => {
+                this.spinner.stop(`${count} reprofilable summary(ies) found`);
+            },
+            onConfirm: async (count) => {
+                // For --json mode, skip interactive prompt
+                if (this.jsonEnabled())
+                    return true;
+                return this.confirm({
+                    message: count === 1
+                        ? messages.getMessage('prompt.confirm.singular')
+                        : messages.getMessage('prompt.confirm.plural', [String(count)]),
+                });
+            },
+        };
+        // Fetch org identity
+        const modeText = dryRun ? '(dry run) ' : '';
+        this.log(`Re-profiling Summaries ${modeText}...`);
+        this.spinner.start('Connecting');
+        const orgIdentityResult = await orgInfoService.getOrgIdentity();
+        this.spinner.stop();
+        if (orgIdentityResult.success) {
+            displayOrgIdentity(this.log.bind(this), orgIdentityResult.data, facade.instanceUrl);
+        }
+        else {
+            this.warn(`Could not retrieve org identity: ${orgIdentityResult.message ?? 'Unknown error'}. Verify you are targeting the correct org.`);
+        }
+        // Execute reprofile
+        this.log('');
+        this.spinner.start('Retrieving Eligible Summaries');
+        const result = await operation.execute(operationOptions);
+        this.spinner.stop();
+        // Handle no eligible summaries
+        if (!result.success && result.errorCode === SummaryReprofileErrorCodes.NO_ELIGIBLE_SUMMARIES) {
+            this.log('');
+            this.log(messages.getMessage('output.noEligible.message'));
+            this.log(messages.getMessage('output.noEligible.guidance'));
+            this.log('');
+            const zeroEntries = [
+                { key: messages.getMessage('output.summary.submitted'), value: formatNumber(0) },
+                { key: messages.getMessage('output.summary.failed'), value: formatNumber(0) },
+                { key: messages.getMessage('output.summary.total'), value: formatNumber(0) },
+            ];
+            displaySummaryBox(this.log.bind(this), {
+                title: messages.getMessage('output.summaryHeader'),
+                entries: zeroEntries,
+            });
+            return {
+                success: true,
+                submitted: 0,
+                failed: 0,
+                total: 0,
+                dryRun: dryRun ?? false,
+            };
+        }
+        // Handle user cancellation
+        if (result.success && result.data.cancelled) {
+            this.log('');
+            this.log(messages.getMessage('output.cancelled'));
+            return {
+                success: true,
+                submitted: 0,
+                failed: 0,
+                total: result.data.total,
+                dryRun: dryRun ?? false,
+                cancelled: true,
+            };
+        }
+        // Handle other failures
+        if (!result.success) {
+            const errorMessage = SummaryReprofile.resolveErrorMessage(SummaryReprofile.ERROR_CODE_MAP, result.errorCode, result.message ?? 'Unknown error', messages);
+            this.error(errorMessage, { code: result.errorCode });
+        }
+        const data = result.data;
+        // Display results
+        this.displayResults(data, dryRun);
+        return {
+            success: true,
+            submitted: data.submitted,
+            failed: data.failed,
+            total: data.total,
+            dryRun: dryRun ?? false,
+            results: data.apiResults?.results,
+        };
+    }
+    /**
+     * Displays reprofile results.
+     */
+    displayResults(data, dryRun) {
+        this.log('');
+        // Dry-run banner
+        if (dryRun && data.preview) {
+            this.log(messages.getMessage('output.dryRunBanner', [String(data.preview.length)]));
+            this.log('');
+            if (data.preview.length > 0) {
+                this.table({
+                    data: data.preview.map((s) => ({
+                        definitionKey: s.definitionKey,
+                        summaryKey: s.summaryKey,
+                        object: s.objectName,
+                        status: s.overallStatus,
+                        action: 'REPROFILE',
+                    })),
+                    columns: [
+                        { key: 'definitionKey', name: 'DEF KEY' },
+                        { key: 'summaryKey', name: 'SUMMARY KEY' },
+                        { key: 'object', name: 'OBJECT' },
+                        { key: 'status', name: 'STATUS' },
+                        { key: 'action', name: 'ACTION' },
+                    ],
+                });
+            }
+        }
+        // Per-item results table (non-dry-run)
+        if (!dryRun && data.apiResults) {
+            this.table({
+                data: data.apiResults.results.map((r) => ({
+                    id: r.id,
+                    requestId: r.requestId ?? '--',
+                    result: r.success ? `${statusSymbol('success')}` : `${statusSymbol('error')} ${r.message ?? 'Failed'}`,
+                })),
+                columns: [
+                    { key: 'id', name: 'SUMMARY ID' },
+                    { key: 'requestId', name: 'REQUEST ID' },
+                    { key: 'result', name: 'RESULT' },
+                ],
+            });
+        }
+        // Summary box
+        const summaryEntries = [
+            { key: messages.getMessage('output.summary.submitted'), value: formatNumber(data.submitted) },
+            { key: messages.getMessage('output.summary.failed'), value: formatNumber(data.failed) },
+            { key: messages.getMessage('output.summary.total'), value: formatNumber(data.total) },
+        ];
+        displaySummaryBox(this.log.bind(this), {
+            title: messages.getMessage('output.summaryHeader'),
+            entries: summaryEntries,
+        });
+    }
+}
+//# sourceMappingURL=reprofile.js.map

package/lib/commands/cuneiform/summary/reprofile.js.map

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

package/lib/commands/cuneiform/summary/stop.d.ts

@@ -0,0 +1,59 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+/**
+ * Command result type for JSON output.
+ */
+export type SummaryStopCommandResult = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Number of summaries stopped */
+    stopped: number;
+    /** Number of summaries that failed to stop */
+    failed: number;
+    /** Total number of summaries processed */
+    total: number;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** Whether the operation was cancelled by the user */
+    cancelled?: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Per-item results for JSON output */
+    results?: Array<{
+        id: string;
+        success: boolean;
+        errorCode?: string;
+        message?: string;
+    }>;
+};
+/**
+ * Stops profiling for in-progress summaries in a Salesforce org.
+ *
+ * Sends a stop signal to in-progress profiling summaries. This is a
+ * fire-and-forget operation — the ISV backend handles the actual stop.
+ */
+export default class SummaryStop extends CuneiformCommand<SummaryStopCommandResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ids: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        objects: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-prompt': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    /**
+     * Maps error codes to i18n message keys.
+     */
+    private static readonly ERROR_CODE_MAP;
+    /**
+     * Executes the summary stop command.
+     */
+    run(): Promise<SummaryStopCommandResult>;
+    /**
+     * Displays stop results.
+     */
+    private displayResults;
+}

package/lib/commands/cuneiform/summary/stop.js

@@ -0,0 +1,234 @@
+/*
+ * 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 { Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import { ProfilingSummaryService } from '../../../services/ProfilingSummaryService.js';
+import { SummaryStopOperation, SummaryStopErrorCodes, } from '../../../operations/SummaryStopOperation.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { displaySummaryBox } from '../../../utils/formatting/command-display.js';
+import { displayOrgIdentity } from '../../../utils/formatting/org-identity.js';
+import { formatNumber } from '../../../utils/formatting/numbers.js';
+import { statusSymbol } from '../../../utils/formatting/indicators.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'summary.stop');
+/**
+ * Stops profiling for in-progress summaries in a Salesforce org.
+ *
+ * Sends a stop signal to in-progress profiling summaries. This is a
+ * fire-and-forget operation — the ISV backend handles the actual stop.
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class SummaryStop extends CuneiformCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    // eslint-disable-next-line sf-plugin/spread-base-flags -- CuneiformCommand has no additional flags to spread
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion(),
+        ids: Flags.string({
+            summary: messages.getMessage('flags.ids.summary'),
+            char: 'i',
+            multiple: true,
+        }),
+        all: Flags.boolean({
+            summary: messages.getMessage('flags.all.summary'),
+            char: 'a',
+        }),
+        objects: Flags.string({
+            summary: messages.getMessage('flags.objects.summary'),
+            char: 'b',
+            multiple: true,
+        }),
+        'dry-run': Flags.boolean({
+            summary: messages.getMessage('flags.dry-run.summary'),
+            char: 'd',
+            default: false,
+        }),
+        'no-prompt': Flags.boolean({
+            summary: messages.getMessage('flags.no-prompt.summary'),
+            char: 'y',
+            default: false,
+        }),
+    };
+    /**
+     * Maps error codes to i18n message keys.
+     */
+    static ERROR_CODE_MAP = {
+        [SummaryStopErrorCodes.NO_SELECTION_CRITERIA]: 'errors.noSelectionCriteria',
+        [SummaryStopErrorCodes.MUTUALLY_EXCLUSIVE]: 'errors.mutuallyExclusive',
+        [SummaryStopErrorCodes.NO_ELIGIBLE_SUMMARIES]: 'errors.noEligibleSummaries',
+        [SummaryStopErrorCodes.QUERY_FAILED]: 'errors.queryFailed',
+        [SummaryStopErrorCodes.STOP_FAILED]: 'errors.stopFailed',
+    };
+    /**
+     * Executes the summary stop command.
+     */
+    async run() {
+        const { flags } = await this.parse(SummaryStop);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error(messages.getMessage('errors.noTargetOrg'));
+        }
+        const dryRun = flags['dry-run'];
+        const noPrompt = flags['no-prompt'];
+        // Initialize services
+        const { facade, soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const summaryService = new ProfilingSummaryService({ soqlAdapter, restAdapter });
+        const orgInfoService = new OrgInfoService({ connectionFacade: facade, soqlAdapter });
+        const operation = new SummaryStopOperation(summaryService);
+        // Build operation options
+        const operationOptions = {
+            all: flags.all,
+            ids: SummaryStop.parseMultiValueFlag(flags.ids),
+            objects: SummaryStop.parseMultiValueFlag(flags.objects),
+            dryRun,
+            noPrompt,
+            onSummariesFound: (count) => {
+                this.spinner.stop(`${count} in-progress summary(ies) found`);
+            },
+            onConfirm: async (count) => {
+                // For --json mode, skip interactive prompt
+                if (this.jsonEnabled())
+                    return true;
+                return this.confirm({
+                    message: count === 1
+                        ? messages.getMessage('prompt.confirm.singular')
+                        : messages.getMessage('prompt.confirm.plural', [String(count)]),
+                });
+            },
+        };
+        // Fetch org identity
+        const modeText = dryRun ? '(dry run) ' : '';
+        this.log(`Stopping Profiling Summaries ${modeText}...`);
+        this.spinner.start('Connecting');
+        const orgIdentityResult = await orgInfoService.getOrgIdentity();
+        this.spinner.stop();
+        if (orgIdentityResult.success) {
+            displayOrgIdentity(this.log.bind(this), orgIdentityResult.data, facade.instanceUrl);
+        }
+        else {
+            this.warn(`Could not retrieve org identity: ${orgIdentityResult.message ?? 'Unknown error'}. Verify you are targeting the correct org.`);
+        }
+        // Execute stop
+        this.log('');
+        this.spinner.start('Retrieving In-Progress Summaries');
+        const result = await operation.execute(operationOptions);
+        this.spinner.stop();
+        // Handle no eligible summaries
+        if (!result.success && result.errorCode === SummaryStopErrorCodes.NO_ELIGIBLE_SUMMARIES) {
+            this.log('');
+            this.log(messages.getMessage('output.noEligible.message'));
+            this.log(messages.getMessage('output.noEligible.guidance'));
+            this.log('');
+            const zeroEntries = [
+                { key: messages.getMessage('output.summary.stopped'), value: formatNumber(0) },
+                { key: messages.getMessage('output.summary.failed'), value: formatNumber(0) },
+                { key: messages.getMessage('output.summary.total'), value: formatNumber(0) },
+            ];
+            displaySummaryBox(this.log.bind(this), {
+                title: messages.getMessage('output.summaryHeader'),
+                entries: zeroEntries,
+            });
+            return {
+                success: true,
+                stopped: 0,
+                failed: 0,
+                total: 0,
+                dryRun: dryRun ?? false,
+            };
+        }
+        // Handle user cancellation
+        if (result.success && result.data.cancelled) {
+            this.log('');
+            this.log(messages.getMessage('output.cancelled'));
+            return {
+                success: true,
+                stopped: 0,
+                failed: 0,
+                total: result.data.total,
+                dryRun: dryRun ?? false,
+                cancelled: true,
+            };
+        }
+        // Handle other failures
+        if (!result.success) {
+            const errorMessage = SummaryStop.resolveErrorMessage(SummaryStop.ERROR_CODE_MAP, result.errorCode, result.message ?? 'Unknown error', messages);
+            this.error(errorMessage, { code: result.errorCode });
+        }
+        const data = result.data;
+        // Display results
+        this.displayResults(data, dryRun);
+        return {
+            success: true,
+            stopped: data.stopped,
+            failed: data.failed,
+            total: data.total,
+            dryRun: dryRun ?? false,
+            results: data.apiResults?.results,
+        };
+    }
+    /**
+     * Displays stop results.
+     */
+    displayResults(data, dryRun) {
+        this.log('');
+        // Dry-run banner
+        if (dryRun && data.preview) {
+            this.log(messages.getMessage('output.dryRunBanner', [String(data.preview.length)]));
+            this.log('');
+            if (data.preview.length > 0) {
+                this.table({
+                    data: data.preview.map((s) => ({
+                        definitionKey: s.definitionKey,
+                        summaryKey: s.summaryKey,
+                        object: s.objectName,
+                        status: s.overallStatus,
+                        action: 'STOP',
+                    })),
+                    columns: [
+                        { key: 'definitionKey', name: 'DEF KEY' },
+                        { key: 'summaryKey', name: 'SUMMARY KEY' },
+                        { key: 'object', name: 'OBJECT' },
+                        { key: 'status', name: 'STATUS' },
+                        { key: 'action', name: 'ACTION' },
+                    ],
+                });
+            }
+        }
+        // Per-item results table (non-dry-run)
+        if (!dryRun && data.apiResults) {
+            this.table({
+                data: data.apiResults.results.map((r) => ({
+                    id: r.id,
+                    result: r.success ? `${statusSymbol('success')}` : `${statusSymbol('error')} ${r.message ?? 'Failed'}`,
+                })),
+                columns: [
+                    { key: 'id', name: 'SUMMARY ID' },
+                    { key: 'result', name: 'RESULT' },
+                ],
+            });
+        }
+        // Summary box
+        const summaryEntries = [
+            { key: messages.getMessage('output.summary.stopped'), value: formatNumber(data.stopped) },
+            { key: messages.getMessage('output.summary.failed'), value: formatNumber(data.failed) },
+            { key: messages.getMessage('output.summary.total'), value: formatNumber(data.total) },
+        ];
+        displaySummaryBox(this.log.bind(this), {
+            title: messages.getMessage('output.summaryHeader'),
+            entries: summaryEntries,
+        });
+    }
+}
+//# sourceMappingURL=stop.js.map

package/lib/commands/cuneiform/summary/stop.js.map

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

package/lib/commands/cuneiform/user/details.d.ts

@@ -0,0 +1,73 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import type { OrgContextResult, UserIdentityResult, PrerequisitesResult, PermissionSetAssignmentResult, ConfigProfileResult, ReadinessResult, ResolutionGuidanceItem, ConfigurationActionResult, ConfigurationResult, LinksResult, UserDetailsResult } from '../../../models/user-details-types.js';
+import { type UserInfo, type UserReadiness } from '../../../services/UserReadinessService.js';
+import { type OrgIdentity } from '../../../services/OrgInfoService.js';
+export type { OrgContextResult, UserIdentityResult, PrerequisitesResult, PermissionSetAssignmentResult, ConfigProfileResult, ReadinessResult, ResolutionGuidanceItem, ConfigurationActionResult, ConfigurationResult, LinksResult, UserDetailsResult, };
+/**
+ * Displays authenticated user context and Cuneiform readiness status.
+ *
+ * Use this command to:
+ * - Verify user identity (ID, username, email, profile, role)
+ * - Check required Cuneiform permission set assignments
+ * - Validate Configuration Profile settings for API-only profiling
+ * - Diagnose readiness issues before running other Cuneiform commands
+ *
+ * @example
+ * ```bash
+ * # Display user details and readiness status
+ * sf cuneiform user details --target-org myOrg
+ *
+ * # Output as JSON for programmatic use
+ * sf cuneiform user details --target-org myOrg --json
+ * ```
+ */
+export default class Details extends CuneiformCommand<UserDetailsResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        configure: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        unconfigure: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected static skipAccessGate: boolean;
+    /**
+     * Builds the command result from service data.
+     */
+    static buildResult(userInfo: UserInfo, readiness: UserReadiness, orgIdentity: OrgIdentity | undefined, instanceUrl: string): UserDetailsResult;
+    /**
+     * Builds resolution guidance items from readiness state.
+     * Extracted from buildResult to reduce cyclomatic complexity.
+     */
+    private static buildResolutionGuidance;
+    /**
+     * Maps the service-level UserConfigurationResult to the command-level ConfigurationResult.
+     */
+    private static mapConfigurationResult;
+    /**
+     * Executes the user details command.
+     *
+     * @returns UserDetailsResult with user identity and readiness status
+     */
+    run(): Promise<UserDetailsResult>;
+    /**
+     * Establishes connection to the Salesforce org and retrieves the current user ID.
+     * Wraps the identity call with a user-friendly error message on failure.
+     */
+    private connectToOrg;
+    /**
+     * Fetches org identity, user info, and readiness in parallel.
+     * Wraps the API calls with a user-friendly error message on failure.
+     */
+    private fetchOrgData;
+    /**
+     * Runs the --configure phase: assigns permission sets and enables API-only profiling.
+     */
+    private runConfigurePhase;
+    /**
+     * Runs the --unconfigure phase: unassigns permission sets and disables API-only profiling.
+     */
+    private runUnconfigurePhase;
+}