@jterrats/smart-deployment 1.1.0 → 1.2.1

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

@@ -0,0 +1,14 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type SpecialDeploymentPlan } from '../deployment/special-deployment-plan.js';
+export default class CiPublish extends SfCommand<SpecialDeploymentPlan> {
+    static readonly summary = "Build a coordinated metadata, Agentforce, LWR, and OmniStudio publish plan for CI.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'source-path': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'auto-activate': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<SpecialDeploymentPlan>;
+    private reportPlan;
+}

package/lib/commands/ci-publish.js

@@ -0,0 +1,69 @@
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { SpecialDeploymentPlanService } from '../deployment/special-deployment-plan.js';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('CiPublishCommand');
+export default class CiPublish extends SfCommand {
+    static summary = 'Build a coordinated metadata, Agentforce, LWR, and OmniStudio publish plan for CI.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --since origin/main --dry-run',
+        '<%= config.bin %> <%= command.id %> --source-path force-app --since HEAD~1 --json',
+    ];
+    static flags = {
+        'source-path': Flags.string({
+            summary: 'Path inside a Salesforce DX project to scan.',
+        }),
+        since: Flags.string({
+            summary: 'Git revision used as the previous green deploy SHA for change detection.',
+        }),
+        'dry-run': Flags.boolean({
+            summary: 'Print the coordinated publish plan without executing external commands.',
+            default: true,
+            allowNo: true,
+        }),
+        'auto-activate': Flags.boolean({
+            summary: 'Include Agentforce activation commands after authoring bundle publish.',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CiPublish);
+        const sourcePath = typeof flags['source-path'] === 'string' ? flags['source-path'] : undefined;
+        const since = typeof flags.since === 'string' ? flags.since : undefined;
+        const dryRun = flags['dry-run'] !== false;
+        const autoActivate = flags['auto-activate'] === true;
+        logger.info('Building CI publish plan', { sourcePath, since, dryRun, autoActivate });
+        const plan = await new SpecialDeploymentPlanService().buildPlan({
+            sourcePath,
+            since,
+            dryRun,
+            autoActivate,
+        });
+        this.reportPlan(plan);
+        return plan;
+    }
+    reportPlan(plan) {
+        this.log('Coordinated publish plan');
+        this.log(`Project: ${plan.projectRoot}`);
+        this.log(`Mode: ${plan.dryRun ? 'dry-run' : 'plan-only'}`);
+        if (plan.since) {
+            this.log(`Since: ${plan.since}`);
+        }
+        for (const phase of plan.phases) {
+            this.log('');
+            this.log(`${phase.label}${phase.skipped ? ' (skipped)' : ''}`);
+            if (phase.skipReason) {
+                this.log(`  ${phase.skipReason}`);
+            }
+            for (const command of phase.commands) {
+                this.log(`  ${command.tool} ${command.args.join(' ')}`);
+            }
+        }
+        if (plan.warnings.length > 0) {
+            this.log('');
+            for (const warning of plan.warnings) {
+                this.warn(warning);
+            }
+        }
+    }
+}
+//# sourceMappingURL=ci-publish.js.map

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

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

package/lib/deployment/special-deployment-plan.d.ts

@@ -0,0 +1,41 @@
+import { MetadataScannerService } from '../services/metadata-scanner-service.js';
+export type SpecialDeploymentPhaseKind = 'core-metadata' | 'agentforce-publish' | 'agentforce-activate' | 'ai-evaluations' | 'community-publish' | 'omnistudio-vlocity';
+export type SpecialDeploymentCommand = {
+    tool: 'sf' | 'vlocity';
+    args: string[];
+    reason: string;
+};
+export type SpecialDeploymentPhase = {
+    kind: SpecialDeploymentPhaseKind;
+    label: string;
+    components: string[];
+    excludedTypes?: string[];
+    changedPaths?: string[];
+    commands: SpecialDeploymentCommand[];
+    skipped: boolean;
+    skipReason?: string;
+    errors?: string[];
+    warnings?: string[];
+};
+export type SpecialDeploymentPlan = {
+    success: boolean;
+    projectRoot: string;
+    apiVersion: string;
+    since?: string;
+    dryRun: boolean;
+    autoActivate: boolean;
+    phases: SpecialDeploymentPhase[];
+    warnings: string[];
+    errors: string[];
+};
+export type SpecialDeploymentPlanOptions = {
+    sourcePath?: string;
+    since?: string;
+    dryRun?: boolean;
+    autoActivate?: boolean;
+    scanner?: Pick<MetadataScannerService, 'scan'>;
+    changedPathProvider?: (projectRoot: string, since?: string) => Promise<string[]>;
+};
+export declare class SpecialDeploymentPlanService {
+    buildPlan(options?: SpecialDeploymentPlanOptions): Promise<SpecialDeploymentPlan>;
+}

package/lib/deployment/special-deployment-plan.js

@@ -0,0 +1,265 @@
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { promisify } from 'node:util';
+import { XMLParser } from 'fast-xml-parser';
+import { glob } from 'glob';
+import { MetadataScannerService } from '../services/metadata-scanner-service.js';
+const execFileAsync = promisify(execFile);
+const CORE_EXCLUDED_TYPES = ['Bot', 'BotVersion', 'GenAiPlannerBundle', 'AiAuthoringBundle'];
+export class SpecialDeploymentPlanService {
+    async buildPlan(options = {}) {
+        const scanner = options.scanner ?? new MetadataScannerService();
+        const scanResult = await scanner.scan({ sourcePath: options.sourcePath });
+        const projectRoot = scanResult.projectRoot;
+        const changedPathProvider = options.changedPathProvider ?? getChangedPaths;
+        const changedPaths = await changedPathProvider(projectRoot, options.since);
+        const context = {
+            projectRoot,
+            apiVersion: scanResult.apiVersion,
+            components: scanResult.components,
+            changedPaths,
+            since: options.since,
+            dryRun: options.dryRun ?? true,
+            autoActivate: options.autoActivate ?? false,
+        };
+        const providers = [
+            new CoreMetadataProvider(),
+            new AgentforcePublishProvider(),
+            new AgentforceActivationProvider(),
+            new AiEvaluationProvider(),
+            new CommunityPublishProvider(),
+            new OmniStudioVlocityProvider(),
+        ];
+        const phases = await Promise.all(providers.map(async (provider) => provider.plan(context)));
+        const phaseErrors = phases.flatMap((phase) => phase.errors ?? []);
+        const warnings = [...scanResult.warnings, ...phases.flatMap((phase) => phase.warnings ?? [])];
+        if (!context.dryRun) {
+            warnings.push('Execution is not implemented in this release slice; generated plan only.');
+        }
+        return {
+            success: scanResult.errors.length === 0 && phaseErrors.length === 0,
+            projectRoot,
+            apiVersion: scanResult.apiVersion,
+            since: options.since,
+            dryRun: context.dryRun,
+            autoActivate: context.autoActivate,
+            phases,
+            warnings,
+            errors: [...scanResult.errors, ...phaseErrors],
+        };
+    }
+}
+class CoreMetadataProvider {
+    async plan(context) {
+        const components = context.components
+            .filter((component) => !CORE_EXCLUDED_TYPES.includes(component.type))
+            .map(toComponentKey)
+            .sort();
+        return {
+            kind: 'core-metadata',
+            label: 'Phase 1: Core metadata deploy',
+            components,
+            excludedTypes: [...CORE_EXCLUDED_TYPES],
+            commands: [
+                {
+                    tool: 'sf',
+                    args: ['project', 'deploy', 'start', '--manifest', '<generated-core-manifest>'],
+                    reason: 'Deploy regular Salesforce metadata after excluding lifecycle-owned provider artifacts.',
+                },
+            ],
+            skipped: components.length === 0,
+            skipReason: components.length === 0 ? 'No core metadata components detected.' : undefined,
+        };
+    }
+}
+class AgentforcePublishProvider {
+    async plan(context) {
+        const bundles = findChangedNames(context, /(?:^|\/)aiAuthoringBundles\/([^/]+)\//u);
+        return {
+            kind: 'agentforce-publish',
+            label: 'Phase 2: Agentforce authoring bundle publish',
+            components: bundles.map((name) => `AiAuthoringBundle:${name}`),
+            changedPaths: changedPathsFor(context.changedPaths, 'aiAuthoringBundles/'),
+            commands: bundles.map((name) => ({
+                tool: 'sf',
+                args: ['agent', 'publish', 'authoring-bundle', '-n', name, '--skip-retrieve'],
+                reason: 'Publish changed Agentforce authoring bundle without retrieving generated version artifacts.',
+            })),
+            skipped: bundles.length === 0,
+            skipReason: bundles.length === 0 ? 'No changed aiAuthoringBundles detected.' : undefined,
+        };
+    }
+}
+class AgentforceActivationProvider {
+    async plan(context) {
+        const bundles = context.autoActivate ? findChangedNames(context, /(?:^|\/)aiAuthoringBundles\/([^/]+)\//u) : [];
+        return {
+            kind: 'agentforce-activate',
+            label: 'Phase 3: Agentforce activation',
+            components: bundles.map((name) => `AiAuthoringBundle:${name}`),
+            changedPaths: changedPathsFor(context.changedPaths, 'aiAuthoringBundles/'),
+            commands: bundles.map((name) => ({
+                tool: 'sf',
+                args: ['agent', 'activate', '-n', name, '--version', '<published-version>'],
+                reason: 'Activate the newly published Agentforce version only when explicitly requested.',
+            })),
+            skipped: bundles.length === 0,
+            skipReason: context.autoActivate
+                ? 'No changed aiAuthoringBundles detected.'
+                : 'Activation is disabled by default.',
+        };
+    }
+}
+class AiEvaluationProvider {
+    async plan(context) {
+        const files = await glob('**/aiEvaluationDefinitions/**/*.xml', {
+            cwd: context.projectRoot,
+            nodir: true,
+            ignore: ['**/node_modules/**', '**/.git/**'],
+        });
+        const changedFiles = files.filter((file) => isChanged(context, file)).sort();
+        const sourceSubjects = new Set(context.components
+            .filter((component) => component.type === 'AiAuthoringBundle' || component.type === 'Bot')
+            .map((component) => component.name));
+        const precheckErrors = await findMissingEvaluationSubjects(context.projectRoot, changedFiles, sourceSubjects);
+        return {
+            kind: 'ai-evaluations',
+            label: 'Phase 4: AI evaluation metadata deploy',
+            components: changedFiles.map((file) => `AiEvaluationDefinition:${path.basename(file, '.xml')}`),
+            changedPaths: changedFiles,
+            commands: changedFiles.length > 0
+                ? [
+                    {
+                        tool: 'sf',
+                        args: ['project', 'deploy', 'start', '--manifest', '<generated-ai-evaluation-manifest>'],
+                        reason: 'Deploy AI evaluations after Agentforce bundle publish/precheck ordering.',
+                    },
+                ]
+                : [],
+            skipped: changedFiles.length === 0,
+            skipReason: changedFiles.length === 0 ? 'No changed AiEvaluationDefinition files detected.' : undefined,
+            errors: precheckErrors,
+            warnings: changedFiles.length > 0
+                ? ['AiEvaluationDefinition target-org subject lookup is not executed in dry-run planning mode.']
+                : undefined,
+        };
+    }
+}
+class CommunityPublishProvider {
+    async plan(context) {
+        const sites = findChangedNames(context, /(?:^|\/)digitalExperiences\/site\/([^/]+)\//u);
+        return {
+            kind: 'community-publish',
+            label: 'Phase 5: Experience Cloud community publish',
+            components: sites.map((name) => `DigitalExperience:${name}`),
+            changedPaths: changedPathsFor(context.changedPaths, 'digitalExperiences/site/'),
+            commands: sites.map((name) => ({
+                tool: 'sf',
+                args: ['community', 'publish', '-n', name],
+                reason: 'Publish changed LWR site to register route/view bindings after metadata deployment.',
+            })),
+            skipped: sites.length === 0,
+            skipReason: sites.length === 0 ? 'No changed digitalExperiences/site directories detected.' : undefined,
+        };
+    }
+}
+class OmniStudioVlocityProvider {
+    omniPathPattern = /(?:^|\/)(vlocity|omnistudio|omniScripts|dataRaptors|integrationProcedures|flexCards)(?:\/|$)/iu;
+    async plan(context) {
+        const changedPaths = context.changedPaths.filter((filePath) => this.omniPathPattern.test(filePath)).sort();
+        return {
+            kind: 'omnistudio-vlocity',
+            label: 'Optional phase: OmniStudio managed-package DataPacks',
+            components: [...new Set(changedPaths.map((filePath) => firstPathSegment(filePath)))].sort(),
+            changedPaths,
+            commands: changedPaths.length > 0
+                ? [
+                    {
+                        tool: 'vlocity',
+                        args: ['packDeploy', '--job', '<generated-vlocity-job.yaml>'],
+                        reason: 'Deploy managed-package OmniStudio DataPacks outside Salesforce core metadata deploy.',
+                    },
+                ]
+                : [],
+            skipped: changedPaths.length === 0,
+            skipReason: changedPaths.length === 0 ? 'No changed OmniStudio managed-package/DataPack paths detected.' : undefined,
+        };
+    }
+}
+async function getChangedPaths(projectRoot, since) {
+    if (!since) {
+        const files = await glob('**/*', {
+            cwd: projectRoot,
+            nodir: true,
+            ignore: ['**/node_modules/**', '**/.git/**', '**/lib/**'],
+        });
+        return files.sort();
+    }
+    const { stdout } = await execFileAsync('git', ['diff', '--name-only', since, 'HEAD', '--'], { cwd: projectRoot });
+    return stdout
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .sort();
+}
+function findChangedNames(context, pattern) {
+    const names = new Set();
+    for (const changedPath of context.changedPaths) {
+        const match = pattern.exec(normalizePath(changedPath));
+        if (match?.[1]) {
+            names.add(match[1]);
+        }
+    }
+    return [...names].sort();
+}
+function changedPathsFor(changedPaths, segment) {
+    return changedPaths.filter((changedPath) => normalizePath(changedPath).includes(segment)).sort();
+}
+function isChanged(context, filePath) {
+    if (!context.since) {
+        return true;
+    }
+    return context.changedPaths.includes(filePath);
+}
+function toComponentKey(component) {
+    return `${component.type}:${component.name}`;
+}
+function normalizePath(filePath) {
+    return filePath.split(path.sep).join('/');
+}
+function firstPathSegment(filePath) {
+    return normalizePath(filePath).split('/')[0] ?? filePath;
+}
+async function findMissingEvaluationSubjects(projectRoot, files, sourceSubjects) {
+    const parser = new XMLParser({ ignoreAttributes: false });
+    const errors = [];
+    for (const file of files) {
+        const absolutePath = path.join(projectRoot, file);
+        const content = await readFile(absolutePath, 'utf8');
+        const parsed = parser.parse(content);
+        const subjectName = findXmlValue(parsed, 'subjectName');
+        if (subjectName && !sourceSubjects.has(subjectName)) {
+            errors.push(`${file}: subjectName "${subjectName}" was not found in source Agentforce bundles or Bots.`);
+        }
+    }
+    return errors;
+}
+function findXmlValue(value, key) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = value;
+    const directValue = record[key];
+    if (typeof directValue === 'string') {
+        return directValue;
+    }
+    for (const nested of Object.values(record)) {
+        const found = findXmlValue(nested, key);
+        if (found) {
+            return found;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=special-deployment-plan.js.map

package/lib/deployment/special-deployment-plan.js.map

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

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@jterrats/smart-deployment",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@jterrats/smart-deployment",
-      "version": "1.1.0",
+      "version": "1.2.1",
       "hasInstallScript": true,
       "license": "BSD-3-Clause",
       "dependencies": {

package/oclif.manifest.json

@@ -109,6 +109,76 @@
         "analyze"
       ]
     },
+    "ci-publish": {
+      "aliases": [],
+      "args": {},
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --since origin/main --dry-run",
+        "<%= config.bin %> <%= command.id %> --source-path force-app --since HEAD~1 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-path": {
+          "name": "source-path",
+          "summary": "Path inside a Salesforce DX project to scan.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "name": "since",
+          "summary": "Git revision used as the previous green deploy SHA for change detection.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Print the coordinated publish plan without executing external commands.",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "auto-activate": {
+          "name": "auto-activate",
+          "summary": "Include Agentforce activation commands after authoring bundle publish.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ci-publish",
+      "pluginAlias": "@jterrats/smart-deployment",
+      "pluginName": "@jterrats/smart-deployment",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Build a coordinated metadata, Agentforce, LWR, and OmniStudio publish plan for CI.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "ci-publish.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "ci-publish"
+      ]
+    },
     "config": {
       "aliases": [],
       "args": {},
@@ -585,5 +655,5 @@
       ]
     }
   },
-  "version": "1.1.0"
+  "version": "1.2.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jterrats/smart-deployment",
   "description": "Intelligent Salesforce metadata deployment plugin that automatically analyzes dependencies, generates optimal deployment",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "dependencies": {
     "@oclif/core": "4.11.2",
     "@salesforce/core": "^8.29.0",