@jterrats/smart-deployment 1.3.1 → 1.4.0

package/lib/analysis/metadata-gap-analysis-service.js

@@ -0,0 +1,277 @@
+import * as path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { SfdxProjectDetector } from '../scanner/sfdx-project-detector.js';
+import { findDirectories, findFiles, fileExists } from '../services/scanners/scanner-runtime.js';
+import { parseXml } from '../utils/xml.js';
+import { metadataCapabilityRegistry } from './metadata-capability-registry.js';
+const SOURCE_DIRECTORY_TYPES = {
+    aiAuthoringBundles: 'AiAuthoringBundle',
+    aura: 'AuraDefinitionBundle',
+    bots: 'Bot',
+    brandingSets: 'BrandingSet',
+    classes: 'ApexClass',
+    customMetadata: 'CustomMetadataRecord',
+    digitalExperiences: 'DigitalExperienceBundle',
+    email: 'EmailTemplate',
+    embeddedServiceConfigs: 'EmbeddedServiceConfig',
+    flexipages: 'FlexiPage',
+    flows: 'Flow',
+    genAiPlannerBundles: 'GenAiPlannerBundle',
+    genAiPromptTemplates: 'GenAiPromptTemplate',
+    layouts: 'Layout',
+    lwc: 'LightningComponentBundle',
+    networks: 'Network',
+    objects: 'CustomObject',
+    applications: 'CustomApplication',
+    pages: 'VisualforcePage',
+    permissionsets: 'PermissionSet',
+    profiles: 'Profile',
+    queues: 'Queue',
+    sites: 'CustomSite',
+    standardValueSets: 'StandardValueSet',
+    triggers: 'ApexTrigger',
+};
+const FILE_SUFFIX_TYPES = [
+    ['.cls-meta.xml', 'ApexClass'],
+    ['.trigger-meta.xml', 'ApexTrigger'],
+    ['.flow-meta.xml', 'Flow'],
+    ['.flexipage-meta.xml', 'FlexiPage'],
+    ['.layout-meta.xml', 'Layout'],
+    ['.permissionset-meta.xml', 'PermissionSet'],
+    ['.profile-meta.xml', 'Profile'],
+    ['.bot-meta.xml', 'Bot'],
+    ['.botVersion-meta.xml', 'BotVersion'],
+    ['.site-meta.xml', 'CustomSite'],
+    ['.network-meta.xml', 'Network'],
+    ['.queue-meta.xml', 'Queue'],
+    ['.standardValueSet-meta.xml', 'StandardValueSet'],
+    ['.embeddedServiceConfig-meta.xml', 'EmbeddedServiceConfig'],
+    ['.app-meta.xml', 'CustomApplication'],
+    ['.matchingRule-meta.xml', 'MatchingRules'],
+];
+export class MetadataGapAnalysisService {
+    capabilityRegistry;
+    constructor(capabilityRegistry = metadataCapabilityRegistry) {
+        this.capabilityRegistry = capabilityRegistry;
+    }
+    async analyze(options = {}) {
+        const sourcePath = options.sourcePath ?? process.cwd();
+        const project = await SfdxProjectDetector.detect(sourcePath);
+        if (!project.detected) {
+            throw new Error(`SFDX project not found in ${sourcePath}`);
+        }
+        const evidenceByType = new Map();
+        await this.collectManifestTypes(project.projectRoot, evidenceByType);
+        await Promise.all(project.packageDirectories.map((packageDir) => this.collectSourceTypes(packageDir, project.projectRoot, evidenceByType)));
+        const detectedTypes = [...evidenceByType.values()]
+            .map((entry) => this.toDetectedType(project.projectRoot, project.apiVersion, entry))
+            .sort((left, right) => left.metadataType.localeCompare(right.metadataType));
+        const gaps = detectedTypes.filter((type) => type.supportStatus !== 'supported').map((type) => this.toGap(type));
+        const result = {
+            success: true,
+            analysisMode: options.aiExplain === true ? 'deterministic-with-ai-context' : 'deterministic',
+            projectRoot: project.projectRoot,
+            apiVersion: project.apiVersion,
+            detectedTypes,
+            gaps,
+            summary: {
+                detectedTypeCount: detectedTypes.length,
+                supportedTypeCount: detectedTypes.filter((type) => type.supportStatus === 'supported').length,
+                gapCount: gaps.length,
+                humanReviewCount: gaps.filter((gap) => gap.requiresHumanReview).length,
+            },
+        };
+        if (options.aiExplain === true) {
+            result.aiContext = this.buildAIContext(result);
+        }
+        return result;
+    }
+    async collectManifestTypes(projectRoot, evidenceByType) {
+        const manifestFiles = await findFiles(projectRoot, '**/{package,destructiveChanges,destructiveChangesPre,destructiveChangesPost}.xml');
+        await Promise.all(manifestFiles.map(async (manifestPath) => {
+            const parsed = parseXml(await readFile(manifestPath, 'utf-8'));
+            const entries = toArray(parsed.Package?.types);
+            for (const entry of entries) {
+                if (typeof entry.name !== 'string' || entry.name.length === 0) {
+                    continue;
+                }
+                const members = toArray(entry.members);
+                const memberCount = members.length;
+                this.addEvidence(evidenceByType, entry.name, `${manifestPath}${memberCount > 0 ? ` (${memberCount} members)` : ''}`, 'package-manifest');
+            }
+        }));
+    }
+    async collectSourceTypes(packageDir, projectRoot, evidenceByType) {
+        if (!(await fileExists(packageDir))) {
+            return;
+        }
+        const metadataFiles = await findFiles(packageDir, '**/*-meta.xml');
+        for (const filePath of metadataFiles) {
+            const inferredType = inferTypeFromFilePath(filePath);
+            if (inferredType) {
+                this.addEvidence(evidenceByType, inferredType, filePath, 'source-path');
+            }
+        }
+        const directories = await findDirectories(packageDir, '**/*');
+        for (const directoryPath of directories) {
+            const relativeParts = path.relative(projectRoot, directoryPath).split(path.sep);
+            const type = relativeParts.map((part) => SOURCE_DIRECTORY_TYPES[part]).find((value) => value !== undefined);
+            if (type) {
+                this.addEvidence(evidenceByType, type, directoryPath, 'source-path');
+            }
+        }
+    }
+    addEvidence(evidenceByType, metadataType, evidence, detectedFrom) {
+        const entry = evidenceByType.get(metadataType) ??
+            {
+                metadataType,
+                evidence: new Set(),
+                detectedFrom: new Set(),
+            };
+        entry.evidence.add(evidence);
+        entry.detectedFrom.add(detectedFrom);
+        evidenceByType.set(metadataType, entry);
+    }
+    toDetectedType(projectRoot, apiVersion, entry) {
+        return {
+            metadataType: entry.metadataType,
+            supportStatus: getSupportStatus(this.capabilityRegistry, entry.metadataType, apiVersion),
+            evidence: [...entry.evidence].map((evidence) => relativizeEvidence(projectRoot, evidence)).sort(),
+            detectedFrom: [...entry.detectedFrom].sort(),
+        };
+    }
+    toGap(type) {
+        const classification = classifyGap(type.metadataType, type.supportStatus);
+        return {
+            ...type,
+            classification,
+            reason: describeClassification(type.metadataType, type.supportStatus, classification),
+            suggestedImplementation: suggestImplementation(type.metadataType, type.supportStatus, classification),
+            requiresHumanReview: classification === 'provider-owned' || classification === 'human-review-required',
+        };
+    }
+    buildAIContext(result) {
+        const gapLines = result.gaps.length === 0
+            ? ['No metadata support gaps detected.']
+            : result.gaps.map((gap) => `- ${gap.metadataType}: ${gap.classification}, ${gap.supportStatus}, evidence=${gap.evidence.join(', ')}`);
+        return {
+            mode: 'workflow-prompt',
+            directProviderApiAllowed: false,
+            recommendedCommand: 'sf setup-agents workflow run --story PLUGIN-AI-METADATA-GAP-DETECTION',
+            prompt: [
+                'Analyze this deterministic smart-deployment metadata gap report.',
+                'Do not call provider APIs from the plugin runtime.',
+                'For safe gaps, propose scoped code, fixture, and test changes.',
+                'For provider-owned or human-review gaps, keep them blocked and explain the review evidence needed.',
+                '',
+                `Project root: ${result.projectRoot}`,
+                `API version: ${result.apiVersion}`,
+                `Detected metadata types: ${result.summary.detectedTypeCount}`,
+                `Gap count: ${result.summary.gapCount}`,
+                '',
+                ...gapLines,
+            ].join('\n'),
+        };
+    }
+}
+function inferTypeFromFilePath(filePath) {
+    const fileName = path.basename(filePath);
+    const explicit = FILE_SUFFIX_TYPES.find(([suffix]) => fileName.endsWith(suffix));
+    if (explicit) {
+        return explicit[1];
+    }
+    const genericSuffix = /\.([A-Za-z][A-Za-z0-9]*)-meta\.xml$/u.exec(fileName);
+    return genericSuffix ? toMetadataTypeName(genericSuffix[1]) : undefined;
+}
+function toMetadataTypeName(rawType) {
+    return rawType
+        .split(/[-_]/u)
+        .filter((part) => part.length > 0)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+function getSupportStatus(registry, metadataType, apiVersion) {
+    const entry = registry.resolve(metadataType, apiVersion);
+    if (entry?.capabilities.discovery.status === 'proven') {
+        return 'supported';
+    }
+    return entry?.capabilities.ordering.status === 'proven' ? 'ordered-only' : 'unsupported';
+}
+function classifyGap(metadataType, supportStatus) {
+    if (isProviderOwned(metadataType)) {
+        return 'provider-owned';
+    }
+    if (isHumanReviewRequired(metadataType)) {
+        return 'human-review-required';
+    }
+    if (isOrderingSpecial(metadataType)) {
+        return 'ordering-special';
+    }
+    if (supportStatus === 'ordered-only' || needsDependencyRules(metadataType)) {
+        return 'dependency-rule';
+    }
+    return 'registry-only';
+}
+function isProviderOwned(metadataType) {
+    return /(Ai|Einstein|GenAi|Ml|Bot|DigitalExperience|Experience|Network|Site|Lwr)/u.test(metadataType);
+}
+function isHumanReviewRequired(metadataType) {
+    return /(Profile|Permission|Sharing|Territory|License|AuthProvider|ConnectedApp|Certificate|Credential)/u.test(metadataType);
+}
+function isOrderingSpecial(metadataType) {
+    return /(Settings|Credential|RemoteSite|ExternalData|DataSource|CspTrusted|CorsWhitelist)/u.test(metadataType);
+}
+function needsDependencyRules(metadataType) {
+    return /(Rule|Layout|Field|Object|Flow|Action|Application|RecordType|Duplicate|Matching|Assignment|Escalation)/u.test(metadataType);
+}
+function describeClassification(metadataType, supportStatus, classification) {
+    if (supportStatus === 'ordered-only') {
+        return `${metadataType} has deployment ordering but no scanner/parser coverage, so dependency behavior is not proven.`;
+    }
+    const descriptions = {
+        'registry-only': `${metadataType} appears to be a simple metadata type that may only need registry and fixture coverage.`,
+        'dependency-rule': `${metadataType} likely references other metadata and needs parser or dependency rules before it is safe.`,
+        'ordering-special': `${metadataType} likely has deployment ordering constraints that must be validated before support is enabled.`,
+        'provider-owned': `${metadataType} may require provider publish, activation, or lifecycle handling outside standard metadata deploy.`,
+        'human-review-required': `${metadataType} affects security, access, credentials, or org-level behavior and requires explicit review.`,
+    };
+    return descriptions[classification];
+}
+function suggestImplementation(metadataType, supportStatus, classification) {
+    const suggestions = [
+        `Add ${metadataType} fixtures covering package.xml and source-path detection.`,
+        'Add metadata gap analysis unit coverage before marking the type supported.',
+    ];
+    if (supportStatus === 'unsupported') {
+        suggestions.push('Add deployment ordering only after fixture validation proves safe ordering.');
+    }
+    if (classification === 'dependency-rule') {
+        suggestions.push('Add parser or dependency extraction rules for referenced metadata.');
+    }
+    else if (classification === 'ordering-special') {
+        suggestions.push('Add explicit ordering tests and deploy-validate evidence.');
+    }
+    else if (classification === 'provider-owned') {
+        suggestions.push('Define publish/activate lifecycle handling or keep the type blocked.');
+    }
+    else if (classification === 'human-review-required') {
+        suggestions.push('Require human review before enabling deploy automation for this type.');
+    }
+    else {
+        suggestions.push('Register the type as scanner-supported only after deterministic fixture tests pass.');
+    }
+    return suggestions;
+}
+function toArray(value) {
+    if (value === undefined) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function relativizeEvidence(projectRoot, evidence) {
+    const suffix = evidence.match(/ \(\d+ members\)$/u)?.[0] ?? '';
+    const pathPart = suffix ? evidence.slice(0, -suffix.length) : evidence;
+    const relative = path.isAbsolute(pathPart) ? path.relative(projectRoot, pathPart) : pathPart;
+    return suffix ? `${relative}${suffix}` : relative;
+}
+//# sourceMappingURL=metadata-gap-analysis-service.js.map

package/lib/analysis/metadata-gap-analysis-service.js.map

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

package/lib/commands/ci-publish.d.ts

@@ -1,6 +1,8 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
 import { type SpecialDeploymentPlan } from '../deployment/special-deployment-plan.js';
-export default class CiPublish extends SfCommand<SpecialDeploymentPlan> {
+import { type ReleaseReportCommandOutput } from '../reports/release-report-command-adapter.js';
+type CiPublishResult = SpecialDeploymentPlan & ReleaseReportCommandOutput;
+export default class CiPublish extends SfCommand<CiPublishResult> {
     static readonly aliases: string[];
     static readonly summary = "Build a coordinated metadata, Agentforce, LWR, and OmniStudio publish plan for CI.";
     static readonly examples: string[];
@@ -11,7 +13,9 @@ export default class CiPublish extends SfCommand<SpecialDeploymentPlan> {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'auto-activate': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<SpecialDeploymentPlan>;
+    run(): Promise<CiPublishResult>;
+    private finalizeReleaseReport;
     private reportPlan;
     private reportExecutionFailure;
 }
+export {};

package/lib/commands/ci-publish.js

@@ -1,8 +1,11 @@
 import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
-import { SpecialDeploymentPlanExecutor } from '../deployment/special-deployment-executor.js';
+import { SpecialDeploymentPlanExecutor, } from '../deployment/special-deployment-executor.js';
 import { SpecialDeploymentPlanService } from '../deployment/special-deployment-plan.js';
+import { ReleaseReportCommandAdapter, } from '../reports/release-report-command-adapter.js';
+import { buildCiPublishReportFacts } from '../reports/release-report-facts-factory.js';
 import { getLogger } from '../utils/logger.js';
 const logger = getLogger('CiPublishCommand');
+const releaseReportAdapter = new ReleaseReportCommandAdapter();
 export default class CiPublish extends SfCommand {
     static aliases = ['smart-deployment ci-publish'];
     static summary = 'Build a coordinated metadata, Agentforce, LWR, and OmniStudio publish plan for CI.';
@@ -47,22 +50,34 @@ export default class CiPublish extends SfCommand {
             autoActivate,
         });
         this.reportPlan(plan);
+        let execution;
+        let resultPlan = plan;
+        let executionFailure;
         if (!dryRun) {
-            const execution = await new SpecialDeploymentPlanExecutor().execute(plan);
+            execution = await new SpecialDeploymentPlanExecutor().execute(plan);
             if (!execution.success) {
                 const message = execution.errors[0] ?? 'Coordinated publish failed.';
-                const failedPlan = {
+                executionFailure = message;
+                resultPlan = {
                     ...plan,
                     success: false,
                     errors: [...plan.errors, message],
                 };
                 this.reportExecutionFailure(execution.failedPhase, execution.exitCode, message);
-                return failedPlan;
             }
-            this.log('');
-            this.log('Coordinated publish execution completed successfully.');
+            else {
+                this.log('');
+                this.log('Coordinated publish execution completed successfully.');
+            }
         }
-        return plan;
+        const result = await this.finalizeReleaseReport(resultPlan, execution);
+        if (executionFailure)
+            this.error(executionFailure);
+        return result;
+    }
+    async finalizeReleaseReport(plan, execution) {
+        const releaseReport = await releaseReportAdapter.finalize(this, { kind: 'succeeded', value: plan }, buildCiPublishReportFacts(plan, execution), { projectRoot: plan.projectRoot });
+        return { ...plan, ...releaseReport };
     }
     reportPlan(plan) {
         this.log('Coordinated publish plan');
@@ -93,7 +108,7 @@ export default class CiPublish extends SfCommand {
     }
     reportExecutionFailure(failedPhase, exitCode, message) {
         this.log('');
-        this.error(`Coordinated publish failed in phase ${failedPhase ?? 'unknown'} with exit code ${exitCode ?? 'unknown'}: ${message}`);
+        this.warn(`Coordinated publish failed in phase ${failedPhase ?? 'unknown'} with exit code ${exitCode ?? 'unknown'}: ${message}`);
     }
 }
 //# sourceMappingURL=ci-publish.js.map

package/lib/commands/ci-publish.js.map

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

package/lib/commands/metadata/gaps.d.ts

@@ -0,0 +1,15 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type MetadataGapAnalysisResult } from '../../analysis/metadata-gap-analysis-service.js';
+export default class MetadataGaps extends SfCommand<MetadataGapAnalysisResult> {
+    static readonly aliases: string[];
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'source-path': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ai-explain': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<MetadataGapAnalysisResult>;
+    private withJsonConsoleSuppressed;
+    private reportResult;
+}

package/lib/commands/metadata/gaps.js

@@ -0,0 +1,84 @@
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { MetadataGapAnalysisService, } from '../../analysis/metadata-gap-analysis-service.js';
+import { getLogger } from '../../utils/logger.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@jterrats/smart-deployment', 'metadata.gaps');
+const logger = getLogger('MetadataGapsCommand');
+const metadataGapAnalysisService = new MetadataGapAnalysisService();
+export default class MetadataGaps extends SfCommand {
+    static aliases = ['smart-deployment metadata gaps'];
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'source-path': Flags.string({
+            summary: messages.getMessage('flags.source-path.summary'),
+            description: messages.getMessage('flags.source-path.description'),
+        }),
+        'ai-explain': Flags.boolean({
+            summary: messages.getMessage('flags.ai-explain.summary'),
+            description: messages.getMessage('flags.ai-explain.description'),
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(MetadataGaps);
+        try {
+            const result = await this.withJsonConsoleSuppressed(async () => metadataGapAnalysisService.analyze({
+                sourcePath: typeof flags['source-path'] === 'string' ? flags['source-path'] : undefined,
+                aiExplain: flags['ai-explain'] === true,
+            }));
+            if (!this.jsonEnabled()) {
+                this.reportResult(result);
+            }
+            return result;
+        }
+        catch (error) {
+            logger.error('Metadata gap analysis failed', { error });
+            this.error(`Metadata gap analysis failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async withJsonConsoleSuppressed(operation) {
+        if (!this.jsonEnabled()) {
+            return operation();
+        }
+        // eslint-disable-next-line no-console
+        const originalLog = console.log;
+        // eslint-disable-next-line no-console
+        const originalWarn = console.warn;
+        try {
+            // eslint-disable-next-line no-console
+            console.log = () => { };
+            // eslint-disable-next-line no-console
+            console.warn = () => { };
+            return await operation();
+        }
+        finally {
+            // eslint-disable-next-line no-console
+            console.log = originalLog;
+            // eslint-disable-next-line no-console
+            console.warn = originalWarn;
+        }
+    }
+    reportResult(result) {
+        this.log('Smart deployment metadata gaps');
+        this.log(`Analysis mode: ${result.analysisMode}`);
+        this.log(`Detected metadata types: ${result.summary.detectedTypeCount}`);
+        this.log(`Supported metadata types: ${result.summary.supportedTypeCount}`);
+        this.log(`Gaps: ${result.summary.gapCount}`);
+        this.log(`Human review required: ${result.summary.humanReviewCount}`);
+        if (result.gaps.length > 0) {
+            this.log('');
+            this.log('Unsupported or incomplete metadata support');
+            for (const gap of result.gaps) {
+                this.log(`- ${gap.metadataType}: ${gap.classification} (${gap.supportStatus})`);
+            }
+        }
+        if (result.aiContext) {
+            this.log('');
+            this.log(`AI workflow context: ${result.aiContext.recommendedCommand}`);
+        }
+    }
+}
+//# sourceMappingURL=gaps.js.map

package/lib/commands/metadata/gaps.js.map

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

package/lib/commands/resume.js

@@ -26,6 +26,7 @@ export default class Resume extends SfCommand {
     static flags = {
         'target-org': Flags.string({
             summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
         }),
         'source-path': Flags.directory({
             summary: messages.getMessage('flags.source-path.summary'),
@@ -38,15 +39,15 @@ export default class Resume extends SfCommand {
         }),
     };
     async run() {
-        const { flags } = await this.parse(Resume);
+        const parseResult = await this.parse(Resume);
+        const { flags } = parseResult;
         const sourcePath = typeof flags['source-path'] === 'string' ? flags['source-path'] : undefined;
+        const targetOrg = this.getTargetOrgIdentifier(flags['target-org']);
         try {
             logger.info('Resuming deployment', { flags });
             const retryStrategy = flags['retry-strategy'];
             const resumeService = new ResumeDeploymentService(new StateManager({ baseDir: sourcePath }));
-            const summary = await resumeService.prepareResume(retryStrategy, {
-                targetOrg: this.getTargetOrgIdentifier(flags['target-org']),
-            });
+            const summary = await resumeService.prepareResume(retryStrategy, { targetOrg });
             presenter.reportResumePreparation(this, summary, retryStrategy);
             return {
                 success: true,

package/lib/commands/resume.js.map

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

package/lib/commands/start.d.ts

@@ -17,6 +17,7 @@
  */
 import { type Interfaces } from '@oclif/core';
 import { SfCommand } from '@salesforce/sf-plugins-core';
+import type { ReleaseReportV1 } from '../types/release-report.js';
 /**
  * @ac US-046-AC-1: Analyzes metadata automatically
  * @ac US-046-AC-2: Generates deployment waves
@@ -34,8 +35,10 @@ type StartResult = {
         commits: string[];
         changedComponents: string[];
         dependencyComponents: string[];
+        explicitComponents: string[];
         includedComponents: string[];
         ignoredComponents: string[];
+        manifestPath?: string;
     };
     rollback?: {
         enabled: boolean;
@@ -54,6 +57,9 @@ type StartResult = {
         inferredDependencies?: number;
         inferenceFallback?: boolean;
     };
+    releaseReport?: ReleaseReportV1;
+    releaseReportPath?: string;
+    releaseReportWarning?: string;
 };
 export default class Start extends SfCommand<StartResult> {
     static readonly aliases: string[];