@jterrats/smart-deployment 1.2.6 → 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/analysis/project-analysis-service.d.ts

@@ -1,5 +1,6 @@
 import { AgentforcePriorityService } from '../ai/agentforce-priority-service.js';
 import { DependencyInferenceService, type InferredDependency } from '../ai/dependency-inference-service.js';
+import { CommitScopeService, type CommitScopeOptions, type CommitScopeSummary } from '../deployment/commit-scope-service.js';
 import { MetadataScannerService, type ScanResult } from '../services/metadata-scanner-service.js';
 import type { PriorityOverride } from '../types/deployment-plan.js';
 import type { MetadataComponent } from '../types/metadata.js';
@@ -26,6 +27,7 @@ export type ProjectAnalysisResult = {
     orderedWaves: Wave[];
     priorityOverrides: Record<string, PriorityOverride>;
     aiContext?: ProjectAnalysisAIContext;
+    commitScope?: CommitScopeSummary;
     messages: ProjectAnalysisMessages;
 };
 export type ProjectAnalysisBuildOptions = {
@@ -33,16 +35,19 @@ export type ProjectAnalysisBuildOptions = {
     useAI?: boolean;
     orgType?: string;
     industry?: string;
+    commitScope?: CommitScopeOptions;
 };
 type ProjectAnalysisServiceDependencies = {
     scanner?: MetadataScannerService;
     createInferenceService?: (baseDir: string) => Pick<DependencyInferenceService, 'inferDependencies'>;
     createPriorityService?: (baseDir: string) => AgentforcePriorityService;
+    commitScopeService?: Pick<CommitScopeService, 'apply'>;
 };
 export declare class ProjectAnalysisService {
     private readonly scanner;
     private readonly createInferenceService;
     private readonly createPriorityService;
+    private readonly commitScopeService;
     constructor(dependencies?: ProjectAnalysisServiceDependencies);
     buildAnalysis(options?: ProjectAnalysisBuildOptions): Promise<ProjectAnalysisResult>;
     static applyInferredDependencies(components: MetadataComponent[], inferredDependencies: InferredDependency[]): MetadataComponent[];

package/lib/analysis/project-analysis-service.js

@@ -1,6 +1,7 @@
 import { AgentforcePriorityService } from '../ai/agentforce-priority-service.js';
 import { DependencyInferenceService } from '../ai/dependency-inference-service.js';
 import { DependencyGraphBuilder } from '../dependencies/dependency-graph-builder.js';
+import { CommitScopeService, } from '../deployment/commit-scope-service.js';
 import { MetadataScannerService } from '../services/metadata-scanner-service.js';
 import { AIEnhancedPriorityWaveGenerator } from '../waves/priority-wave-generator-ai.js';
 import { getWavesInExecutionOrder } from '../waves/wave-executor.js';
@@ -9,6 +10,7 @@ export class ProjectAnalysisService {
     scanner;
     createInferenceService;
     createPriorityService;
+    commitScopeService;
     constructor(dependencies = {}) {
         this.scanner = dependencies.scanner ?? new MetadataScannerService();
         this.createInferenceService =
@@ -17,6 +19,7 @@ export class ProjectAnalysisService {
         this.createPriorityService =
             dependencies.createPriorityService ??
                 ((baseDir) => new AgentforcePriorityService({ baseDir }));
+        this.commitScopeService = dependencies.commitScopeService ?? new CommitScopeService();
     }
     async buildAnalysis(options = {}) {
         const scanResult = await this.scanner.scan({ sourcePath: options.sourcePath });
@@ -41,6 +44,20 @@ export class ProjectAnalysisService {
                 scanResult.dependencyResult = dependencyResult;
             }
         }
+        let commitScope;
+        const hasCommitScope = (options.commitScope?.commits?.length ?? 0) > 0 || options.commitScope?.manifestPath !== undefined;
+        if (hasCommitScope) {
+            const scoped = await this.commitScopeService.apply(scanResult, options.commitScope);
+            scanResult.components = scoped.scanResult.components;
+            scanResult.dependencyResult = scoped.scanResult.dependencyResult;
+            dependencyResult = scoped.scanResult.dependencyResult;
+            commitScope = scoped.summary;
+            messages.logs.push([
+                `  Scope: ${commitScope.includedComponents.length} component(s) selected`,
+                `from ${commitScope.commits.length} commit(s);`,
+                `${commitScope.ignoredComponents.length} ignored.`,
+            ].join(' '));
+        }
         const waveBuilder = new WaveBuilder({
             dependencyEdges: dependencyResult.edges,
         });
@@ -92,6 +109,7 @@ export class ProjectAnalysisService {
             orderedWaves,
             priorityOverrides,
             aiContext,
+            commitScope,
             messages,
         };
     }

package/lib/analysis/project-analysis-service.js.map

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

package/lib/commands/ci/preset.d.ts

@@ -0,0 +1,25 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type CiPresetResult } from '../../deployment/ci-preset-service.js';
+export default class CiPreset extends SfCommand<CiPresetResult> {
+    static readonly aliases: string[];
+    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>;
+        'source-path': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'report-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'validation-mode': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'skip-tests': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'use-ai': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'org-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        industry: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'scope-commits': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'scope-manifest': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CiPresetResult>;
+    private getCommitScopeOptions;
+    private getTargetOrgIdentifier;
+    private writeGithubOutputs;
+    private reportResult;
+}

package/lib/commands/ci/preset.js

@@ -0,0 +1,125 @@
+import { appendFile } from 'node:fs/promises';
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand, optionalOrgFlagWithDeprecations } from '@salesforce/sf-plugins-core';
+import { CiPresetService, } from '../../deployment/ci-preset-service.js';
+import { getLogger } from '../../utils/logger.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@jterrats/smart-deployment', 'ci.preset');
+const logger = getLogger('CiPresetCommand');
+const ciPresetService = new CiPresetService();
+export default class CiPreset extends SfCommand {
+    static aliases = ['smart-deployment ci preset'];
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': optionalOrgFlagWithDeprecations,
+        'source-path': Flags.string({
+            summary: messages.getMessage('flags.source-path.summary'),
+            description: messages.getMessage('flags.source-path.description'),
+        }),
+        'report-dir': Flags.string({
+            summary: messages.getMessage('flags.report-dir.summary'),
+            description: messages.getMessage('flags.report-dir.description'),
+        }),
+        'validation-mode': Flags.string({
+            summary: messages.getMessage('flags.validation-mode.summary'),
+            description: messages.getMessage('flags.validation-mode.description'),
+            options: ['strict', 'warn-only', 'local-only'],
+            default: 'strict',
+        }),
+        'skip-tests': Flags.boolean({
+            summary: messages.getMessage('flags.skip-tests.summary'),
+            default: false,
+        }),
+        'use-ai': Flags.boolean({
+            summary: messages.getMessage('flags.use-ai.summary'),
+            default: false,
+        }),
+        'org-type': Flags.string({
+            summary: messages.getMessage('flags.org-type.summary'),
+            options: ['Production', 'Sandbox', 'Developer'],
+        }),
+        industry: Flags.string({
+            summary: messages.getMessage('flags.industry.summary'),
+        }),
+        'scope-commits': Flags.string({
+            summary: messages.getMessage('flags.scope-commits.summary'),
+            description: messages.getMessage('flags.scope-commits.description'),
+        }),
+        'scope-manifest': Flags.string({
+            summary: messages.getMessage('flags.scope-manifest.summary'),
+            description: messages.getMessage('flags.scope-manifest.description'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CiPreset);
+        const validationMode = flags['validation-mode'];
+        const sourcePath = typeof flags['source-path'] === 'string' ? flags['source-path'] : undefined;
+        const targetOrg = this.getTargetOrgIdentifier(flags['target-org']);
+        const commitScope = this.getCommitScopeOptions(flags);
+        let result;
+        try {
+            logger.info('Running CI preset', { sourcePath, targetOrg, validationMode });
+            result = await ciPresetService.run({
+                sourcePath,
+                targetOrg,
+                reportDir: typeof flags['report-dir'] === 'string' ? flags['report-dir'] : undefined,
+                validationMode,
+                skipTests: flags['skip-tests'] === true,
+                useAI: flags['use-ai'] === true,
+                orgType: typeof flags['org-type'] === 'string' ? flags['org-type'] : undefined,
+                industry: typeof flags.industry === 'string' ? flags.industry : undefined,
+                commitScope,
+            });
+            await this.writeGithubOutputs(result);
+        }
+        catch (error) {
+            logger.error('CI preset failed', { error });
+            this.error(`CI preset failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        this.reportResult(result);
+        if (result.exitCode !== 0) {
+            this.exit(result.exitCode);
+        }
+        return result;
+    }
+    getCommitScopeOptions(flags) {
+        const commits = typeof flags['scope-commits'] === 'string' ? [flags['scope-commits']] : undefined;
+        const manifestPath = typeof flags['scope-manifest'] === 'string' ? flags['scope-manifest'] : undefined;
+        return commits !== undefined || manifestPath !== undefined ? { commits, manifestPath } : undefined;
+    }
+    getTargetOrgIdentifier(value) {
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+        if (typeof value === 'object' && value !== null && 'getUsername' in value) {
+            const getUsername = value.getUsername;
+            return typeof getUsername === 'function' ? getUsername.call(value) : undefined;
+        }
+        return undefined;
+    }
+    async writeGithubOutputs(result) {
+        const outputFile = process.env.GITHUB_OUTPUT;
+        if (!outputFile) {
+            return;
+        }
+        const content = Object.entries(result.githubOutputs)
+            .map(([name, value]) => `${name}=${value}`)
+            .join('\n');
+        await appendFile(outputFile, `${content}\n`, 'utf8');
+    }
+    reportResult(result) {
+        this.log('Smart deployment CI preset');
+        this.log(`Mode: ${result.validationMode}`);
+        this.log(`Status: ${result.summary.conclusion}`);
+        this.log(`Components: ${result.summary.components}`);
+        this.log(`Waves: ${result.summary.waves}`);
+        this.log(`Blockers: ${result.summary.blockers}`);
+        this.log(`Warnings: ${result.summary.warnings}`);
+        this.log(`JSON report: ${result.artifacts.jsonPath}`);
+        this.log(`HTML report: ${result.artifacts.htmlPath}`);
+        this.log(`Exit code: ${result.exitCode}`);
+    }
+}
+//# sourceMappingURL=preset.js.map

package/lib/commands/ci/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../../../src/commands/ci/preset.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 {};