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

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

@@ -0,0 +1,58 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+/**
+ * Command result type for JSON output.
+ */
+export type DefinitionUpdateCommandResult = {
+    /** Whether the update was successful */
+    success: boolean;
+    /** The Salesforce record ID of the updated definition */
+    definitionId: string;
+    /** Whether any attributes were updated */
+    updated: boolean;
+    /** Names of the attributes that were written */
+    updatedAttributes: string[];
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Updates metadata attributes on a profiling definition.
+ *
+ * Use this command to change the name, category, time category, segment category,
+ * or description of an existing definition without touching its field selection.
+ *
+ * @example
+ * ```bash
+ * # Rename a definition
+ * sf cuneiform definition update --target-org myOrg --id a00xx --name "Q1 Revenue Analysis"
+ * ```
+ */
+export default class DefinitionUpdate extends CuneiformCommand<DefinitionUpdateCommandResult> {
+    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>;
+        id: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        category: 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>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<"table" | "json", import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Executes the update command.
+     *
+     * @returns DefinitionUpdateCommandResult with success status and updated attributes
+     */
+    run(): Promise<DefinitionUpdateCommandResult>;
+    private validateAttributeLengths;
+    /**
+     * Displays update results in the requested format.
+     *
+     * @param data - Update result data
+     * @param format - Output format: 'table' for prose, 'json' for structured JSON
+     */
+    private displayResults;
+}

package/lib/commands/cuneiform/definition/update.js

@@ -0,0 +1,209 @@
+/*
+ * 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 { ProfilingDefinitionService } from '../../../services/ProfilingDefinitionService.js';
+import { DefinitionUpdateOperation } from '../../../operations/DefinitionUpdateOperation.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { validateSalesforceId } from '../../../services/validation.js';
+import { renderOrgContext } from '../../../utils/formatting/index.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'definition.update');
+/**
+ * Updates metadata attributes on a profiling definition.
+ *
+ * Use this command to change the name, category, time category, segment category,
+ * or description of an existing definition without touching its field selection.
+ *
+ * @example
+ * ```bash
+ * # Rename a definition
+ * sf cuneiform definition update --target-org myOrg --id a00xx --name "Q1 Revenue Analysis"
+ * ```
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class DefinitionUpdate 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(),
+        id: Flags.string({
+            summary: messages.getMessage('flags.id.summary'),
+            required: true,
+            aliases: ['definition-id'],
+            deprecateAliases: true,
+        }),
+        name: Flags.string({
+            summary: messages.getMessage('flags.name.summary'),
+            required: false,
+        }),
+        category: Flags.string({
+            summary: messages.getMessage('flags.category.summary'),
+            required: false,
+        }),
+        'time-category': Flags.string({
+            summary: messages.getMessage('flags.time-category.summary'),
+            required: false,
+        }),
+        'segment-category': Flags.string({
+            summary: messages.getMessage('flags.segment-category.summary'),
+            required: false,
+        }),
+        description: Flags.string({
+            summary: messages.getMessage('flags.description.summary'),
+            required: false,
+        }),
+        format: Flags.option({
+            summary: messages.getMessage('flags.format.summary'),
+            options: ['table', 'json'],
+            default: 'table',
+        })(),
+    };
+    /**
+     * Executes the update command.
+     *
+     * @returns DefinitionUpdateCommandResult with success status and updated attributes
+     */
+    async run() {
+        const { flags } = await this.parse(DefinitionUpdate);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error('Could not determine target org username');
+        }
+        const definitionId = flags.id;
+        // Validate definition ID format
+        const idValidationError = validateSalesforceId(definitionId);
+        if (idValidationError) {
+            this.error(messages.getMessage('errors.invalidDefinitionId', [definitionId]), {
+                code: 'INVALID_DEFINITION_ID',
+            });
+        }
+        const format = flags.format ?? 'table';
+        const isTable = format === 'table';
+        // Collect supplied attributes
+        const name = flags.name;
+        const category = flags.category;
+        const timeCategory = flags['time-category'];
+        const segmentCategory = flags['segment-category'];
+        const description = flags.description;
+        // Validate at least one attribute was supplied
+        if (name === undefined &&
+            category === undefined &&
+            timeCategory === undefined &&
+            segmentCategory === undefined &&
+            description === undefined) {
+            this.error(messages.getMessage('errors.noAttributesProvided'), {
+                code: 'NO_ATTRIBUTES_PROVIDED',
+            });
+        }
+        // Validate length constraints
+        this.validateAttributeLengths(name, category, timeCategory, segmentCategory, description);
+        // Initialize services
+        const { facade, soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const definitionService = new ProfilingDefinitionService({ soqlAdapter, restAdapter });
+        // Fetch and display org identity
+        const orgInfoService = new OrgInfoService({ connectionFacade: facade, soqlAdapter });
+        const orgIdentityResult = await orgInfoService.getOrgIdentity();
+        if (isTable && orgIdentityResult.success) {
+            this.log('');
+            this.log(renderOrgContext({
+                orgName: orgIdentityResult.data.organizationName,
+                orgId: orgIdentityResult.data.organizationId,
+                instanceUrl: facade.instanceUrl ?? '',
+                isSandbox: orgIdentityResult.data.isSandbox ?? false,
+            }));
+        }
+        // Create operation
+        const operation = new DefinitionUpdateOperation(definitionService);
+        if (isTable)
+            this.log(`Updating definition ${definitionId}...`);
+        // Execute operation
+        if (isTable)
+            this.spinner.start('Updating');
+        const result = await operation.execute({
+            definitionId,
+            attributes: { name, category, timeCategory, segmentCategory, description },
+        });
+        if (isTable)
+            this.spinner.stop();
+        // Handle failure
+        if (!result.success) {
+            this.error(messages.getMessage('errors.updateFailed', [definitionId, result.message ?? 'Unknown error']), {
+                code: result.errorCode ?? 'UPDATE_FAILED',
+            });
+        }
+        // Display results
+        this.displayResults(result.data, format);
+        return {
+            success: true,
+            definitionId: result.data.definitionId,
+            updated: result.data.updated,
+            updatedAttributes: result.data.updatedAttributes,
+        };
+    }
+    validateAttributeLengths(name, category, timeCategory, segmentCategory, description) {
+        if (name !== undefined && name.length > 255) {
+            this.error(messages.getMessage('errors.nameTooLong', [String(name.length)]), { code: 'NAME_TOO_LONG' });
+        }
+        if (category !== undefined && category.length > 255) {
+            this.error(messages.getMessage('errors.categoryTooLong', [String(category.length)]), {
+                code: 'CATEGORY_TOO_LONG',
+            });
+        }
+        if (timeCategory !== undefined && timeCategory.length > 255) {
+            this.error(messages.getMessage('errors.timeCategoryTooLong', [String(timeCategory.length)]), {
+                code: 'TIME_CATEGORY_TOO_LONG',
+            });
+        }
+        if (segmentCategory !== undefined && segmentCategory.length > 255) {
+            this.error(messages.getMessage('errors.segmentCategoryTooLong', [String(segmentCategory.length)]), {
+                code: 'SEGMENT_CATEGORY_TOO_LONG',
+            });
+        }
+        if (description !== undefined && description.length > 8192) {
+            this.error(messages.getMessage('errors.descriptionTooLong', [String(description.length)]), {
+                code: 'DESCRIPTION_TOO_LONG',
+            });
+        }
+    }
+    /**
+     * Displays update results in the requested format.
+     *
+     * @param data - Update result data
+     * @param format - Output format: 'table' for prose, 'json' for structured JSON
+     */
+    displayResults(data, format) {
+        this.log('');
+        if (format === 'json') {
+            const output = {
+                success: true,
+                definitionId: data.definitionId,
+                updated: data.updated,
+                updatedAttributes: data.updatedAttributes,
+            };
+            this.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        if (data.updated) {
+            this.log(`Successfully updated definition ${data.definitionId}.`);
+            this.log(`Updated attributes: ${data.updatedAttributes.join(', ')}`);
+        }
+        else {
+            this.log(`Definition ${data.definitionId} was not updated.`);
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

package/lib/commands/cuneiform/definition/update.js.map

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

package/lib/commands/cuneiform/mcp/serve.d.ts

@@ -0,0 +1,56 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+/**
+ * Command result type for JSON output.
+ */
+export type McpServeResult = {
+    /** Server status */
+    readonly status: 'started';
+    /** Server configuration */
+    readonly config: {
+        readonly name: string;
+        readonly version: string;
+        readonly targetOrg: string;
+        readonly apiVersion?: string;
+    };
+};
+/**
+ * Starts the Cuneiform MCP (Model Context Protocol) server.
+ *
+ * The MCP server exposes Cuneiform CLI commands as MCP tools, enabling
+ * LLM clients (like Claude Desktop or Cursor) to invoke Salesforce operations
+ * through natural language interactions.
+ *
+ * Use this command to:
+ * - Enable Claude Desktop integration with Cuneiform
+ * - Provide LLMs with direct access to Salesforce metadata
+ * - Execute read-only operations from AI assistants
+ *
+ * @example
+ * ```bash
+ * # Start MCP server for a specific org
+ * sf cuneiform mcp serve --target-org myOrg
+ *
+ * # Start with debug logging
+ * sf cuneiform mcp serve --target-org myOrg --debug
+ *
+ * # Start with specific API version
+ * sf cuneiform mcp serve --target-org myOrg --api-version 59.0
+ * ```
+ */
+export default class McpServe extends CuneiformCommand<McpServeResult> {
+    static readonly hidden = true;
+    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>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    /**
+     * Executes the MCP serve command.
+     *
+     * @returns McpServeResult with server status
+     */
+    run(): Promise<McpServeResult>;
+}

package/lib/commands/cuneiform/mcp/serve.js

@@ -0,0 +1,109 @@
+/*
+ * 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 { createConnectionFacade } from '../../../adapters/connection-facade.js';
+import { createMcpConfig } from '../../../mcp/config/mcp-config.js';
+import { createMcpServer, startMcpServer } from '../../../mcp/server.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'mcp.serve');
+/**
+ * Starts the Cuneiform MCP (Model Context Protocol) server.
+ *
+ * The MCP server exposes Cuneiform CLI commands as MCP tools, enabling
+ * LLM clients (like Claude Desktop or Cursor) to invoke Salesforce operations
+ * through natural language interactions.
+ *
+ * Use this command to:
+ * - Enable Claude Desktop integration with Cuneiform
+ * - Provide LLMs with direct access to Salesforce metadata
+ * - Execute read-only operations from AI assistants
+ *
+ * @example
+ * ```bash
+ * # Start MCP server for a specific org
+ * sf cuneiform mcp serve --target-org myOrg
+ *
+ * # Start with debug logging
+ * sf cuneiform mcp serve --target-org myOrg --debug
+ *
+ * # Start with specific API version
+ * sf cuneiform mcp serve --target-org myOrg --api-version 59.0
+ * ```
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class McpServe extends CuneiformCommand {
+    static hidden = true;
+    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({
+            summary: messages.getMessage('flags.api-version.summary'),
+            char: 'a',
+        }),
+        debug: Flags.boolean({
+            summary: messages.getMessage('flags.debug.summary'),
+            char: 'd',
+            default: false,
+        }),
+    };
+    /**
+     * Executes the MCP serve command.
+     *
+     * @returns McpServeResult with server status
+     */
+    async run() {
+        const { flags } = await this.parse(McpServe);
+        try {
+            // Get connection
+            const connection = flags['target-org'].getConnection(flags['api-version']);
+            const facade = createConnectionFacade(connection);
+            await this.enforceAccessGate(facade);
+            // Create MCP config
+            const config = createMcpConfig(flags['target-org'].getUsername() ?? flags['target-org'].getOrgId(), flags['api-version'], flags.debug);
+            // Create and start MCP server
+            const server = createMcpServer(config, connection);
+            /* eslint-disable no-console -- MCP uses stderr for logging */
+            // Log server startup (stderr - stdout is reserved for MCP JSON-RPC)
+            if (flags.debug) {
+                console.error(`[MCP] Starting Cuneiform MCP server for org: ${config.targetOrg}`);
+                console.error('[MCP] Available tools: cuneiform_org_details, cuneiform_object_list, cuneiform_user_details');
+            }
+            /* eslint-enable no-console */
+            // Start server (this blocks until the server is stopped)
+            await startMcpServer(server, flags.debug);
+            // If we reach here, server has stopped
+            return {
+                status: 'started',
+                config: {
+                    name: config.name,
+                    version: config.version,
+                    targetOrg: config.targetOrg,
+                    apiVersion: config.apiVersion,
+                },
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Log error to stderr
+            /* eslint-disable-next-line no-console -- MCP uses stderr for logging */
+            console.error(`[MCP] Server error: ${errorMessage}`);
+            // Throw to ensure non-zero exit code for scripts and CI/CD
+            this.error(`MCP server failed: ${errorMessage}`, { code: 'MCP_SERVER_ERROR' });
+        }
+    }
+}
+//# sourceMappingURL=serve.js.map

package/lib/commands/cuneiform/mcp/serve.js.map

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

package/lib/commands/cuneiform/object/describe.d.ts

@@ -0,0 +1,61 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import type { FieldInfo, ObjectResult, ObjectSummary, FieldSummary, RelationshipInfo, ProfilingStatusInfo, ObjectDescribeTotals, ObjectDescribeCommandResult } from '../../../models/object-describe-types.js';
+export type { FieldInfo, ObjectResult, ObjectSummary, FieldSummary, RelationshipInfo, ProfilingStatusInfo, ObjectDescribeTotals, ObjectDescribeCommandResult, };
+/**
+ * Describes Salesforce objects with comprehensive metadata and field analysis.
+ *
+ * Use this command to:
+ * - Understand object structure before creating profiling definitions
+ * - Analyze field inventory by type and namespace
+ * - Review record types and their configurations
+ * - Identify how many other objects reference this object
+ * - Assess record age distribution
+ * - Check existing profiling definitions
+ *
+ * @example
+ * ```bash
+ * # Describe Account object
+ * sf cuneiform object describe --object Account
+ *
+ * # Describe multiple objects
+ * sf cuneiform object describe --object Account,Contact,Opportunity
+ *
+ * # Include field listing
+ * sf cuneiform object describe --object Account --with-fields
+ *
+ * # Filter to lookup fields, sorted by type
+ * sf cuneiform object describe --object Account --with-fields --field-type lookup --sort type
+ * ```
+ */
+export default class ObjectDescribe extends CuneiformCommand<ObjectDescribeCommandResult> {
+    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>;
+        object: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'with-fields': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'field-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'field-pattern': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sort: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Computes aggregate totals across all described objects.
+     */
+    private static computeTotals;
+    /**
+     * Executes the object describe command.
+     *
+     * @returns ObjectDescribeCommandResult with object metadata
+     */
+    run(): Promise<ObjectDescribeCommandResult>;
+    /**
+     * Enriches business processes with per-process record age distributions.
+     */
+    private enrichBusinessProcesses;
+    /**
+     * Describes an object and formats the result.
+     */
+    private describeAndFormat;
+}