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

package/lib/base/cuneiform-command.js

@@ -0,0 +1,326 @@
+/*
+ * 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 { SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import { createConnectionFacade } from '../adapters/connection-facade.js';
+import { SoqlQueryAdapter } from '../adapters/soql/soql-query-adapter.js';
+import { RestApiAdapter } from '../adapters/rest/rest-api-adapter.js';
+import { ToolingApiAdapter } from '../adapters/tooling/tooling-api-adapter.js';
+import { UserReadinessService } from '../services/UserReadinessService.js';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const accessMessages = Messages.loadMessages('@peernova/cuneiform-sf', 'cuneiform.access');
+/**
+ * Creates the standard adapter stack from a connection facade.
+ *
+ * Single source of truth for adapter instantiation. All commands, operations,
+ * and MCP tools should use this instead of constructing adapters inline.
+ *
+ * @param facade - The connection facade for the target org
+ * @returns Object containing all three adapter instances
+ */
+export function createAdapterStack(facade) {
+    return {
+        soqlAdapter: new SoqlQueryAdapter(facade),
+        restAdapter: new RestApiAdapter(facade),
+        toolingAdapter: new ToolingApiAdapter(facade),
+    };
+}
+/**
+ * Abstract base class for all Cuneiform CLI commands.
+ *
+ * Provides a shared access gate that validates the authenticated user has
+ * the required Cuneiform permission sets and that Global Profiling is enabled
+ * before allowing command execution.
+ *
+ * Subclasses call `this.enforceAccessGate(facade)` at the start of their
+ * `run()` method after obtaining the connection facade. Commands that should
+ * bypass the gate (e.g., `user details`, which IS the diagnostic tool) simply
+ * omit the `enforceAccessGate()` call.
+ *
+ * The `skipAccessGate` static property is used by the UX snapshot test
+ * harness to auto-stub the gate for non-access-gate test scenarios.
+ *
+ * @template T The command result type
+ *
+ * @example
+ * ```typescript
+ * export default class MyCommand extends CuneiformCommand<MyResult> {
+ *   public async run(): Promise<MyResult> {
+ *     const { flags } = await this.parse(MyCommand);
+ *     const { facade, soqlAdapter, restAdapter } = await this.initConnection(flags);
+ *
+ *     // Business logic follows — adapters and access gate already handled
+ *     const service = new MyService({ soqlAdapter, restAdapter });
+ *   }
+ * }
+ * ```
+ */
+// eslint-disable-next-line sf-plugin/command-summary, sf-plugin/command-example -- abstract base class has no summary or examples; subclasses provide these
+export class CuneiformCommand extends SfCommand {
+    /**
+     * Set to `true` in subclasses that should bypass the access gate.
+     * Example: `user details` is exempt because it IS the diagnostic tool.
+     */
+    static skipAccessGate = false;
+    /**
+     * Resolves an error code to an i18n message using a command-specific error code map.
+     *
+     * Looks up the error code in the provided map, retrieves the corresponding i18n
+     * message, and returns it. If the message contains a `%s` placeholder, interpolates
+     * the fallback string. Messages with `%d` placeholders return the fallback directly
+     * since numeric interpolation requires context the caller must provide.
+     *
+     * Returns the fallback directly when errorCode is undefined or not in the map.
+     *
+     * @param errorCodeMap - Command-specific mapping of error codes to message bundle keys
+     * @param errorCode - The error code from the operation result
+     * @param fallback - The pre-formatted message from the operation layer
+     * @param msgs - The command's Messages instance for i18n lookup
+     * @returns The resolved user-facing error message
+     */
+    static resolveErrorMessage(errorCodeMap, errorCode, fallback, msgs) {
+        if (!errorCode || !(errorCode in errorCodeMap))
+            return fallback;
+        try {
+            const messageKey = errorCodeMap[errorCode];
+            const i18nMessage = msgs.getMessage(messageKey);
+            if (i18nMessage.includes('%s'))
+                return msgs.getMessage(messageKey, [fallback]);
+            if (i18nMessage.includes('%d'))
+                return fallback;
+            return i18nMessage;
+        }
+        catch {
+            return fallback;
+        }
+    }
+    /**
+     * Normalizes a multi-value string flag: splits on commas, trims whitespace, and
+     * deduplicates. Used by commands that accept comma-separated values in flags
+     * (e.g., `--request-ids`, `--definition-names`).
+     *
+     * @param raw - The raw flag value array from oclif flag parsing
+     * @param options - Optional configuration
+     * @param options.caseInsensitive - When true, deduplicates case-insensitively while preserving the casing of the first occurrence
+     * @returns Deduplicated array of trimmed values, or undefined if input is empty
+     */
+    static parseMultiValueFlag(raw, options) {
+        if (!raw || raw.length === 0)
+            return undefined;
+        const caseInsensitive = options?.caseInsensitive ?? false;
+        const seen = new Set();
+        const parsed = raw
+            .flatMap((v) => v.split(','))
+            .map((v) => v.trim())
+            .filter((v) => {
+            if (v.length === 0)
+                return false;
+            const key = caseInsensitive ? v.toLowerCase() : v;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        return parsed.length === 0 ? undefined : parsed;
+    }
+    /**
+     * Resolves the user-facing error message for an access gate failure.
+     *
+     * Maps service error codes to message bundle keys for actionable
+     * error messages that guide the user toward resolution.
+     */
+    static resolveAccessGateMessage(errorCode, serviceMessage) {
+        switch (errorCode) {
+            case ServiceErrorCodes.FEATURE_NOT_ENABLED:
+                return accessMessages.getMessage('error.featureNotEnabled');
+            case ServiceErrorCodes.PROFILING_ACCESS_DENIED:
+                return accessMessages.getMessage('error.profilingAccessDenied');
+            case ServiceErrorCodes.GLOBAL_PROFILING_NOT_ENABLED:
+                return accessMessages.getMessage('error.globalProfilingNotEnabled');
+            case ServiceErrorCodes.SELF_REGISTRATION_NOT_ENABLED:
+                return accessMessages.getMessage('error.selfRegistrationNotEnabled');
+            case ServiceErrorCodes.USER_CUNEIFORM_NAMESPACE_NOT_FOUND:
+                return accessMessages.getMessage('error.cuneiformNotInstalled');
+            default:
+                return accessMessages.getMessage('error.accessCheckFailed', [serviceMessage]);
+        }
+    }
+    /**
+     * Sanitizes JSON output by stripping stack traces and error causes.
+     *
+     * Prevents exposing Node.js stack traces and absolute filesystem paths
+     * in `--json` error output. Success JSON output is unaffected since it
+     * never contains `stack` or `cause` properties.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- oclif logJson signature uses AnyJson | unknown
+    logJson(json) {
+        if (json && typeof json === 'object') {
+            const sanitized = { ...json };
+            delete sanitized.stack;
+            delete sanitized.cause;
+            super.logJson(sanitized);
+            return;
+        }
+        super.logJson(json);
+    }
+    /**
+     * Intercepts oclif parse errors to fix misleading "Try this" suggestions for
+     * boolean flags declared with `allowNo: true` (CLI-3379).
+     *
+     * When a user passes a value to a boolean flag (e.g., `--skip-empty false`),
+     * oclif rejects the value as an unexpected argument and upstream
+     * `SfCommandError.appendErrorSuggestions` produces a misleading suggestion
+     * like `--skip-empty "--skip-empty false"` — the result of two upstream bugs:
+     * (1) `k.input` is wrongly prepended to args; (2) the suggestion logic has no
+     * awareness of `--[no-]` boolean flags.
+     *
+     * This override pre-processes the raw parse-output token stream BEFORE
+     * delegating to `super.catch`. For each FlagToken→ArgToken pair where the
+     * flag is a boolean with `allowNo: true`, it always splices the ArgToken out
+     * of `error.parse.output.raw` (suppressing upstream's buggy suggestion), and
+     * — only when the arg is a recognized boolean literal (true/false/yes/no/1/0)
+     * — also pushes the corrected `--no-<flag>` or `--<flag>` onto `error.actions`.
+     *
+     * Unrecognized values (e.g., `--skip-empty bogus`) get the silent splice
+     * (no fabricated suggestion, no misleading upstream output). Non-boolean
+     * flags and booleans without `allowNo` are left untouched.
+     */
+    async catch(error) {
+        rewriteBooleanFlagSuggestion(error, this.constructor);
+        return super.catch(error);
+    }
+    /**
+     * Enforces the Cuneiform profiling access gate.
+     *
+     * Validates that the authenticated user has:
+     * 1. Cuneiform for Salesforce installed in the org
+     * 2. Required permission sets assigned
+     * 3. Global Profiling enabled
+     *
+     * Throws an SfError with an actionable, user-friendly error message
+     * from the `cuneiform.access` message bundle if any check fails.
+     *
+     * @param facade - The connection facade for the target org
+     * @throws {SfError} If the user cannot use Cuneiform commands
+     */
+    // eslint-disable-next-line class-methods-use-this -- instance method so subclasses can call this.enforceAccessGate()
+    async enforceAccessGate(facade) {
+        let userId;
+        try {
+            const identity = await facade.identity();
+            userId = identity.user_id;
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            const sfError = new SfError(accessMessages.getMessage('error.connectionFailed', [detail]));
+            sfError.code = 'E2001';
+            throw sfError;
+        }
+        // Gate 0: Check feature status via ISV REST endpoint
+        const { restAdapter, soqlAdapter } = createAdapterStack(facade);
+        const service = new UserReadinessService({ soqlAdapter });
+        const featureResult = await service.checkFeatureStatus(restAdapter);
+        if (featureResult.success && !featureResult.data.featureEnabled) {
+            const message = CuneiformCommand.resolveAccessGateMessage(ServiceErrorCodes.FEATURE_NOT_ENABLED, '');
+            const sfError = new SfError(message);
+            sfError.code = ServiceErrorCodes.FEATURE_NOT_ENABLED;
+            throw sfError;
+        }
+        // If the feature status check fails (non-404), log warning but don't block (graceful degradation)
+        // Gates 1-3: Validate profiling access (installed, permissions, global profiling)
+        const result = await service.validateProfilingAccess(userId);
+        if (!result.success) {
+            const errorCode = result.errorCode ?? ServiceErrorCodes.USER_READINESS_QUERY_FAILED;
+            const message = CuneiformCommand.resolveAccessGateMessage(errorCode, result.message ?? '');
+            const sfError = new SfError(message);
+            sfError.code = errorCode;
+            throw sfError;
+        }
+    }
+    /**
+     * Initializes the connection facade and standard adapters for a command.
+     *
+     * Encapsulates the common 5-line boilerplate shared by 16 of 18 commands:
+     * get connection, create facade, enforce access gate, create adapters.
+     *
+     * Commands that bypass the access gate (e.g., `user details` with
+     * `skipAccessGate = true`) will skip the gate check automatically.
+     *
+     * @param flags - The parsed command flags containing target-org and api-version
+     * @returns Connection context with facade and pre-built adapters
+     * @throws {SfError} If the access gate check fails
+     */
+    async initConnection(flags) {
+        const connection = flags['target-org'].getConnection(flags['api-version']);
+        const facade = createConnectionFacade(connection);
+        if (!this.constructor.skipAccessGate) {
+            await this.enforceAccessGate(facade);
+        }
+        const adapters = createAdapterStack(facade);
+        return { facade, ...adapters };
+    }
+}
+/**
+ * Maps the literal arg value attached to a boolean flag to its corrected
+ * `--<flag>` / `--no-<flag>` form. Returns null for unrecognized values so
+ * upstream behavior is preserved as fallback.
+ */
+function booleanFlagSuggestion(flag, argInput) {
+    switch (argInput.toLowerCase()) {
+        case 'false':
+        case 'no':
+        case '0':
+            return `--no-${flag}`;
+        case 'true':
+        case 'yes':
+        case '1':
+            return `--${flag}`;
+        default:
+            return null;
+    }
+}
+/**
+ * Pre-processes an oclif parse error in place to fix misleading "Try this"
+ * suggestions for boolean flags declared with `allowNo: true` (CLI-3379).
+ *
+ * For each `FlagToken` immediately followed by an `ArgToken` where the flag is
+ * a known boolean with `allowNo`, this function:
+ * 1. Splices the `ArgToken` out of `error.parse.output.raw` so upstream `SfCommandError.appendErrorSuggestions` emits no suggestion for that pair — preventing the misleading `--<flag> "--<flag> <value>"` output regardless of value.
+ * 2. If the arg value is a recognized boolean literal (true/false/yes/no/1/0), appends the corrected `--no-<flag>` or `--<flag>` suggestion to `error.actions`. Unrecognized values yield no fabricated suggestion — we splice silently because we don't know what the user meant.
+ *
+ * Non-matching cases (missing parse output, unknown flag, non-boolean flag,
+ * boolean without `allowNo`) are left untouched — upstream's behavior is
+ * preserved as fallback.
+ */
+function rewriteBooleanFlagSuggestion(error, commandClass) {
+    const parseError = error;
+    const raw = parseError.parse?.output?.raw;
+    if (!Array.isArray(raw) || raw.length === 0)
+        return;
+    const flags = commandClass.flags ?? {};
+    for (let i = 0; i < raw.length; i++) {
+        const flagToken = raw[i];
+        if (flagToken?.type !== 'flag')
+            continue;
+        const argToken = raw[i + 1];
+        if (argToken?.type !== 'arg')
+            continue;
+        const flagDef = flags[flagToken.flag];
+        if (!flagDef || flagDef.type !== 'boolean' || flagDef.allowNo !== true)
+            continue;
+        const suggestion = booleanFlagSuggestion(flagToken.flag, argToken.input);
+        if (suggestion !== null) {
+            parseError.actions = [...(parseError.actions ?? []), suggestion];
+        }
+        raw.splice(i + 1, 1);
+        // Do not decrement i — the next outer iteration moves to i+1 which is now
+        // the next token after the spliced arg, exactly what we want to evaluate.
+    }
+}
+//# sourceMappingURL=cuneiform-command.js.map

package/lib/base/cuneiform-command.js.map

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

package/lib/commands/cuneiform/compatibility/check.d.ts

@@ -0,0 +1,43 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type CompatibilityResult } from '../../../operations/CompatibilityCheckOperation.js';
+/** Result type returned for `--json` output. */
+export type CompatibilityCheckResult = CompatibilityResult;
+/**
+ * Reports the Cuneiform For Salesforce app version required by this CLI build,
+ * and (when `--target-org` is supplied) verifies whether the target org has a
+ * compatible version installed.
+ *
+ * Two-mode UX:
+ * - No flag: prints the required app version and CLI version. No auth.
+ * - With `--target-org <alias>`: queries the org for the installed `pnova` package via Tooling API, computes compatibility state, exits non-zero on mismatch.
+ *
+ * Exit codes:
+ * - `0` for default mode, `installed-match`, `installed-newer`
+ * - `1` for `installed-older`, `not-installed`, runtime errors
+ *
+ * Extends `SfCommand` directly (not `CuneiformCommand`): the compatibility check
+ * is a meta query that runs without authentication in default mode and bypasses
+ * the access gate even when an org is supplied — knowing whether you can run
+ * Cuneiform commands is the very thing this command answers.
+ *
+ * @example Local-only readout: `sf cuneiform compatibility check`
+ * @example Verify a target org: `sf cuneiform compatibility check --target-org myOrg`
+ * @example Machine-readable: `sf cuneiform compatibility check --target-org myOrg --json`
+ */
+export default class CompatibilityCheck extends SfCommand<CompatibilityCheckResult> {
+    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>;
+    };
+    run(): Promise<CompatibilityCheckResult>;
+    /**
+     * Render the compatibility check result to the user.
+     *
+     * Default mode (no installed): prints the required app version and CLI version.
+     * Org-checked mode: adds the installed version and a state line with an indicator.
+     */
+    private displayResult;
+}

package/lib/commands/cuneiform/compatibility/check.js

@@ -0,0 +1,114 @@
+/*
+ * 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 { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { createAdapterStack } from '../../../base/cuneiform-command.js';
+import { createConnectionFacade } from '../../../adapters/connection-facade.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { CompatibilityService } from '../../../services/CompatibilityService.js';
+import { CompatibilityCheckOperation, } from '../../../operations/CompatibilityCheckOperation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'compatibility.check');
+/**
+ * Reports the Cuneiform For Salesforce app version required by this CLI build,
+ * and (when `--target-org` is supplied) verifies whether the target org has a
+ * compatible version installed.
+ *
+ * Two-mode UX:
+ * - No flag: prints the required app version and CLI version. No auth.
+ * - With `--target-org <alias>`: queries the org for the installed `pnova` package via Tooling API, computes compatibility state, exits non-zero on mismatch.
+ *
+ * Exit codes:
+ * - `0` for default mode, `installed-match`, `installed-newer`
+ * - `1` for `installed-older`, `not-installed`, runtime errors
+ *
+ * Extends `SfCommand` directly (not `CuneiformCommand`): the compatibility check
+ * is a meta query that runs without authentication in default mode and bypasses
+ * the access gate even when an org is supplied — knowing whether you can run
+ * Cuneiform commands is the very thing this command answers.
+ *
+ * @example Local-only readout: `sf cuneiform compatibility check`
+ * @example Verify a target org: `sf cuneiform compatibility check --target-org myOrg`
+ * @example Machine-readable: `sf cuneiform compatibility check --target-org myOrg --json`
+ */
+export default class CompatibilityCheck extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.optionalOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            char: 'a',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CompatibilityCheck);
+        const compatibilityService = new CompatibilityService();
+        const operation = new CompatibilityCheckOperation(compatibilityService);
+        const targetOrg = flags['target-org'];
+        let orgInfoService;
+        if (targetOrg) {
+            const connection = targetOrg.getConnection(flags['api-version']);
+            const facade = createConnectionFacade(connection);
+            const { soqlAdapter, restAdapter, toolingAdapter } = createAdapterStack(facade);
+            orgInfoService = new OrgInfoService({
+                connectionFacade: facade,
+                soqlAdapter,
+                restAdapter,
+                toolingAdapter,
+            });
+        }
+        const operationResult = await operation.execute(orgInfoService ? { orgInfoService } : undefined);
+        if (!operationResult.success) {
+            this.error(operationResult.message ?? messages.getMessage('errors.manifestInvalid'), {
+                code: operationResult.errorCode,
+            });
+        }
+        const result = operationResult.data;
+        this.displayResult(result);
+        // CLI-3118: return result (not throw) so --json includes the structured result object.
+        if (result.installed &&
+            (result.installed.state === 'installed-older' || result.installed.state === 'not-installed')) {
+            process.exitCode = 1;
+        }
+        return result;
+    }
+    /**
+     * Render the compatibility check result to the user.
+     *
+     * Default mode (no installed): prints the required app version and CLI version.
+     * Org-checked mode: adds the installed version and a state line with an indicator.
+     */
+    displayResult(data) {
+        this.log(`CLI version:     ${data.cliVersion}`);
+        this.log(`App name:        ${data.appName}`);
+        this.log(`Required:        ${data.requiredAppVersion}`);
+        if (!data.installed)
+            return;
+        const installedDisplay = data.installed.version ??
+            (data.installed.state === 'installed-version-unknown' ? '(detected via namespace)' : '(not installed)');
+        this.log(`Installed:       ${installedDisplay}`);
+        const stateLine = messages.getMessage(`state.${data.installed.state}`);
+        const passingStates = new Set([
+            'installed-match',
+            'installed-newer',
+            'installed-version-unknown',
+        ]);
+        if (passingStates.has(data.installed.state)) {
+            this.log(stateLine);
+        }
+        else {
+            this.warn(stateLine);
+        }
+    }
+}
+//# sourceMappingURL=check.js.map

package/lib/commands/cuneiform/compatibility/check.js.map

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

package/lib/commands/cuneiform/definition/create.d.ts

@@ -0,0 +1,120 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import { type ObjectResult } from '../../../operations/DefinitionCreateOperation.js';
+import { type AvailabilityGrid } from '../../../services/DataAvailabilityService.js';
+/**
+ * Command result type for JSON output.
+ */
+export type DefinitionCreateResult = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Number of definitions created */
+    created: number;
+    /** Number of definitions that failed to create */
+    failed: number;
+    /** Number of objects skipped (already have definitions) */
+    skipped: number;
+    /** Total number of objects processed */
+    total: number;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** List of creation failures with details */
+    failures: Array<{
+        objectName: string;
+        error: string;
+        errorCode: string;
+    }>;
+    /** Per-definition results with status indicators */
+    results: ObjectResult[];
+    /** Data availability grid (present when --method comparative/recordtype/full) */
+    availabilityGrid?: AvailabilityGrid;
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Creates profiling definitions for Salesforce objects.
+ */
+export default class DefinitionCreate extends CuneiformCommand<DefinitionCreateResult> {
+    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>;
+        objects: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'from-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<"standard" | "custom" | "all", import("@oclif/core/interfaces").CustomOptions>;
+        pattern: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        namespace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        classification: import("@oclif/core/interfaces").OptionFlag<"all" | "customer" | "internal", import("@oclif/core/interfaces").CustomOptions>;
+        'with-records': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'without-records': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'with-record-types': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'min-records': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        method: import("@oclif/core/interfaces").OptionFlag<"metadata" | "historical" | "comparative" | "recordtype" | "outcome" | "full", import("@oclif/core/interfaces").CustomOptions>;
+        recordtype: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'record-type-status': import("@oclif/core/interfaces").OptionFlag<"all" | "active" | "inactive", import("@oclif/core/interfaces").CustomOptions>;
+        year: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        depth: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-value-frequency': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'use-prior': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'lifetime-primary': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'date-literal': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-field': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profiled: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-prompt': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        logs: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'name-prefix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'name-suffix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'time-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'segment-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        origin: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Determines the effective --with-records value.
+     *
+     * When --method full is used and no explicit scope/filter flags are supplied by the user,
+     * defaults withRecords to true so the default scope is "customer objects with records."
+     * This prevents full profiling from targeting empty or system-only objects.
+     *
+     * Scope flags that suppress the default: --with-records, --without-records, --filter (non-default),
+     * --objects, --pattern.
+     */
+    private static resolveWithRecords;
+    /**
+     * Executes the create command.
+     *
+     * @returns DefinitionCreateResult with success status and creation statistics
+     */
+    run(): Promise<DefinitionCreateResult>;
+    /**
+     * Two-stage confirmation: summary then detailed preview table.
+     */
+    private handlePreviewReady;
+    /**
+     * Handles operation failure by translating error codes to user-friendly messages.
+     */
+    private handleOperationFailure;
+    /**
+     * Handles post-creation actions: --profile, --open, --logs.
+     */
+    private handlePostCreationActions;
+    /**
+     * Triggers fire-and-forget profiling for successfully created definitions.
+     */
+    private triggerProfiling;
+    /**
+     * Opens the first created definition in the default browser.
+     */
+    private openInBrowser;
+    /**
+     * Writes session logs to a timestamped directory.
+     */
+    private writeSessionLogs;
+}