@jterrats/smart-deployment 1.2.6 → 1.4.0

package/lib/services/scanners/automation-ai-metadata-scanner.d.ts

@@ -1,5 +1,7 @@
-import type { MetadataComponent } from '../../types/metadata.js';
+import type { AiEvaluationDefinition, MetadataComponent } from '../../types/metadata.js';
 export declare function parseFlowComponent(filePath: string): Promise<MetadataComponent | undefined>;
 export declare function parseBotComponent(filePath: string): Promise<MetadataComponent | undefined>;
 export declare function parseAiAuthoringBundleComponent(filePath: string): MetadataComponent;
+export declare function parseAiEvaluationDefinitionComponent(filePath: string): Promise<AiEvaluationDefinition>;
+export declare function parseGenAiPlannerBundleComponent(directoryPath: string): Promise<MetadataComponent>;
 export declare function parseGenAiPromptComponent(filePath: string): Promise<MetadataComponent | undefined>;

package/lib/services/scanners/automation-ai-metadata-scanner.js

@@ -3,6 +3,7 @@ import * as path from 'node:path';
 import { parseBot } from '../../parsers/bot-parser.js';
 import { parseFlow } from '../../parsers/flow-parser.js';
 import { parseGenAiPrompt } from '../../parsers/genai-prompt-parser.js';
+import { parseSalesforceMetadata } from '../../utils/xml.js';
 function addAll(target, values, defaultType) {
     for (const value of values) {
         target.add(defaultType && !value.includes(':') ? `${defaultType}:${value}` : value);
@@ -54,6 +55,92 @@ export function parseAiAuthoringBundleComponent(filePath) {
         priorityBoost: 0,
     };
 }
+export async function parseAiEvaluationDefinitionComponent(filePath) {
+    const parsed = await parseSalesforceMetadata(filePath);
+    const definition = parsed.AiEvaluationDefinition;
+    if (!definition) {
+        throw new Error('Expected AiEvaluationDefinition root element.');
+    }
+    const subjectName = requiredString(definition.subjectName, 'subjectName');
+    const subjectType = requiredString(definition.subjectType, 'subjectType');
+    if (subjectType !== 'AGENT') {
+        throw new Error(`Unsupported subjectType "${subjectType}"; expected "AGENT".`);
+    }
+    const subjectVersion = optionalString(definition.subjectVersion);
+    const dependencyNodeId = `Bot:${subjectName}`;
+    return {
+        name: path.basename(filePath, '.aiEvaluationDefinition-meta.xml'),
+        type: 'AiEvaluationDefinition',
+        filePath,
+        subjectName,
+        subjectType,
+        subjectVersion,
+        dependencies: new Set([dependencyNodeId]),
+        dependencyDetails: [
+            {
+                nodeId: dependencyNodeId,
+                kind: 'hard',
+                source: 'parser',
+                reason: 'AiEvaluationDefinition subjectName identifies the evaluated Agentforce Bot.',
+            },
+        ],
+        dependents: new Set(),
+        priorityBoost: 0,
+    };
+}
+export async function parseGenAiPlannerBundleComponent(directoryPath) {
+    const bundleName = path.basename(directoryPath);
+    const deps = await parseGenAiPlannerBundleDependencies(directoryPath);
+    return {
+        name: bundleName,
+        type: 'GenAiPlannerBundle',
+        filePath: directoryPath,
+        dependencies: deps,
+        dependents: new Set(),
+        priorityBoost: 0,
+    };
+}
+async function parseGenAiPlannerBundleDependencies(directoryPath) {
+    const deps = new Set();
+    const entries = await fs.readdir(directoryPath, { recursive: true, withFileTypes: true });
+    const files = entries
+        .filter((entry) => entry.isFile())
+        .map((entry) => path.join(entry.parentPath, entry.name))
+        .filter((filePath) => /\.(?:json|xml|yaml|yml)$/iu.test(filePath));
+    const contents = await Promise.all(files.map((filePath) => fs.readFile(filePath, 'utf8')));
+    for (const content of contents) {
+        collectNamedReferences(deps, content, ['flow', 'flowName', 'targetFlow', 'subflow'], 'Flow');
+        collectNamedReferences(deps, content, ['apexClass', 'apexAction', 'invocableApexClass'], 'ApexClass');
+        collectNamedReferences(deps, content, ['prompt', 'promptTemplate', 'genAiPromptTemplate'], 'GenAiPromptTemplate');
+    }
+    return deps;
+}
+function collectNamedReferences(dependencies, content, propertyNames, metadataType) {
+    for (const propertyName of propertyNames) {
+        const quotedProperty = new RegExp(`"${propertyName}"\\s*:\\s*"([^"/]+)"`, 'giu');
+        const xmlElement = new RegExp(`<${propertyName}>([^<]+)</${propertyName}>`, 'giu');
+        for (const match of content.matchAll(quotedProperty)) {
+            dependencies.add(`${metadataType}:${match[1]}`);
+        }
+        for (const match of content.matchAll(xmlElement)) {
+            dependencies.add(`${metadataType}:${match[1]}`);
+        }
+    }
+}
+function requiredString(value, fieldName) {
+    const normalized = optionalString(value);
+    if (!normalized) {
+        throw new Error(`Missing required ${fieldName}.`);
+    }
+    return normalized;
+}
+function optionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized || undefined;
+}
 export async function parseGenAiPromptComponent(filePath) {
     const promptName = path.basename(filePath, '.genAiPromptTemplate-meta.xml');
     const parsed = await parseGenAiPrompt(filePath, promptName);

package/lib/services/scanners/automation-ai-metadata-scanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"automation-ai-metadata-scanner.js","sourceRoot":"","sources":["../../../src/services/scanners/automation-ai-metadata-scanner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"automation-ai-metadata-scanner.js","sourceRoot":"","sources":["../../../src/services/scanners/automation-ai-metadata-scanner.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -5,6 +5,8 @@
  * This provides a single import source for consumers.
  */
 export * from './metadata.js';
+export * from './metadata-capability.js';
+export * from './release-report.js';
 export * from './dependency.js';
 export * from './deployment.js';
 export * from './graph.js';

package/lib/types/index.js

@@ -6,6 +6,8 @@
  */
 // Core metadata types
 export * from './metadata.js';
+export * from './metadata-capability.js';
+export * from './release-report.js';
 // Dependency graph types
 export * from './dependency.js';
 // Deployment types

package/lib/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sBAAsB;AACtB,cAAc,eAAe,CAAC;AAE9B,yBAAyB;AACzB,cAAc,iBAAiB,CAAC;AAEhC,mBAAmB;AACnB,cAAc,iBAAiB,CAAC;AAEhC,wBAAwB;AACxB,cAAc,YAAY,CAAC;AAE3B,0BAA0B;AAC1B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sBAAsB;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAEpC,yBAAyB;AACzB,cAAc,iBAAiB,CAAC;AAEhC,mBAAmB;AACnB,cAAc,iBAAiB,CAAC;AAEhC,wBAAwB;AACxB,cAAc,YAAY,CAAC;AAE3B,0BAA0B;AAC1B,cAAc,cAAc,CAAC"}

package/lib/types/metadata-capability.d.ts

@@ -0,0 +1,39 @@
+export type MetadataDeploymentChannel = 'metadata-api' | 'source-format-composite' | 'managed-package-data' | 'provider-lifecycle' | 'external-provider' | 'unknown';
+export type MetadataCanonicalOwner = 'C1' | 'C2' | 'C3' | 'C4' | 'C5' | 'C6' | 'C7' | 'legacy-repository';
+export type MetadataCapabilityStatus = 'proven' | 'partial' | 'absent' | 'not-applicable';
+export type MetadataCapabilityEvidenceSource = {
+    id: string;
+    kind: 'repository' | 'vendor-documentation' | 'org-validation';
+    locator: string;
+    retrievedAt?: string;
+};
+export type MetadataCapabilityEvidenceReference = {
+    sourceId: string;
+    detail: string;
+};
+export type MetadataCapabilityEvidence = {
+    status: MetadataCapabilityStatus;
+    evidence: readonly MetadataCapabilityEvidenceReference[];
+};
+export type MetadataCapabilities = {
+    discovery: MetadataCapabilityEvidence;
+    parsing: MetadataCapabilityEvidence;
+    dependencies: MetadataCapabilityEvidence;
+    ordering: MetadataCapabilityEvidence;
+    lifecycle: MetadataCapabilityEvidence;
+    fixtures: MetadataCapabilityEvidence;
+};
+export type MetadataCapabilityDefinition = {
+    apiVersion: string;
+    minimumApiVersion: string;
+    deploymentChannel: MetadataDeploymentChannel;
+    vendorType: string;
+    canonicalType: string;
+    internalAliases: readonly string[];
+    canonicalOwner: MetadataCanonicalOwner;
+    capabilities: MetadataCapabilities;
+    evidenceSources: readonly MetadataCapabilityEvidenceSource[];
+};
+export type MetadataCapabilityEntry = MetadataCapabilityDefinition & {
+    catalogKey: string;
+};

package/lib/types/metadata-capability.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadata-capability.js.map

package/lib/types/metadata-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-capability.js","sourceRoot":"","sources":["../../src/types/metadata-capability.ts"],"names":[],"mappings":""}

package/lib/types/metadata.d.ts

@@ -9,7 +9,7 @@
  *
  * @see https://developer.salesforce.com/docs/metadata-coverage/61
  */
-export type MetadataType = 'GlobalValueSet' | 'StandardValueSet' | 'CustomLabels' | 'Translations' | 'StandardValueSetTranslation' | 'CustomObject' | 'CustomSetting' | 'DataCategoryGroup' | 'CustomMetadata' | 'CustomMetadataRecord' | 'CustomField' | 'ObjectTranslation' | 'RecordType' | 'BusinessProcess' | 'ValidationRule' | 'WorkflowRule' | 'OrgSettings' | 'CorsWhitelistOrigin' | 'CspTrustedSite' | 'Role' | 'DelegateGroup' | 'Group' | 'CustomPermission' | 'ExternalCredential' | 'NamedCredential' | 'DataSourceObject' | 'StaticResource' | 'Document' | 'ContentAsset' | 'EmailTemplate' | 'ApexClass' | 'VisualforceComponent' | 'VisualforcePage' | 'LightningComponentBundle' | 'AuraDefinitionBundle' | 'ApexTrigger' | 'ServicePresenceStatus' | 'PresenceUserConfig' | 'Queue' | 'ServiceChannel' | 'QueueRoutingConfig' | 'ChannelLayout' | 'MilestoneType' | 'EntitlementProcess' | 'GenAiFunction' | 'GenAiPromptTemplate' | 'GenAiPlannerBundle' | 'Flow' | 'PathAssistant' | 'Layout' | 'Bot' | 'BotVersion' | 'AiAuthoringBundle' | 'GenAiPlugin' | 'FlexiPage' | 'QuickAction' | 'CompactLayout' | 'ListView' | 'WebLink' | 'LightningApp' | 'SearchCustomization' | 'CustomNotificationType' | 'BrandingSet' | 'DigitalExperienceConfig' | 'CustomSite' | 'Site' | 'DigitalExperience' | 'DigitalExperienceBundle' | 'NetworkBranding' | 'Network' | 'EmbeddedServiceConfig' | 'MessagingChannel' | 'OmniSupervisorConfig' | 'SharingRules' | 'PermissionSet' | 'MutingPermissionSet' | 'PermissionSetGroup' | 'Profile' | 'ApexTestSuite' | 'DataPackageKitDefinition' | 'DataPackageKitObject';
+export type MetadataType = 'GlobalValueSet' | 'StandardValueSet' | 'CustomLabels' | 'Translations' | 'StandardValueSetTranslation' | 'CustomObject' | 'CustomSetting' | 'DataCategoryGroup' | 'CustomMetadata' | 'CustomMetadataRecord' | 'CustomField' | 'ObjectTranslation' | 'RecordType' | 'BusinessProcess' | 'ValidationRule' | 'WorkflowRule' | 'OrgSettings' | 'CorsWhitelistOrigin' | 'CspTrustedSite' | 'Role' | 'DelegateGroup' | 'Group' | 'CustomPermission' | 'ExternalCredential' | 'NamedCredential' | 'DataSourceObject' | 'StaticResource' | 'Document' | 'ContentAsset' | 'EmailTemplate' | 'ApexClass' | 'VisualforceComponent' | 'VisualforcePage' | 'LightningComponentBundle' | 'AuraDefinitionBundle' | 'ApexTrigger' | 'ServicePresenceStatus' | 'PresenceUserConfig' | 'Queue' | 'ServiceChannel' | 'QueueRoutingConfig' | 'ChannelLayout' | 'MilestoneType' | 'EntitlementProcess' | 'GenAiFunction' | 'GenAiPromptTemplate' | 'GenAiPlannerBundle' | 'Flow' | 'PathAssistant' | 'Layout' | 'Bot' | 'BotVersion' | 'AiAuthoringBundle' | 'AiEvaluationDefinition' | 'GenAiPlugin' | 'FlexiPage' | 'QuickAction' | 'CompactLayout' | 'ListView' | 'WebLink' | 'LightningApp' | 'SearchCustomization' | 'CustomNotificationType' | 'BrandingSet' | 'DigitalExperienceConfig' | 'CustomSite' | 'Site' | 'DigitalExperience' | 'DigitalExperienceBundle' | 'NetworkBranding' | 'Network' | 'EmbeddedServiceConfig' | 'MessagingChannel' | 'OmniSupervisorConfig' | 'SharingRules' | 'PermissionSet' | 'MutingPermissionSet' | 'PermissionSetGroup' | 'Profile' | 'ApexTestSuite' | 'DataPackageKitDefinition' | 'DataPackageKitObject';
 export type MetadataDependencyKind = 'hard' | 'soft' | 'inferred';
 export type MetadataDependencyReference = {
     /** Target node ID in the graph, e.g. Type:Name */
@@ -87,6 +87,12 @@ export type CustomMetadataRecord = MetadataComponent & {
     type: 'CustomMetadataRecord';
     metadataTypeName: string;
 };
+export type AiEvaluationDefinition = MetadataComponent & {
+    type: 'AiEvaluationDefinition';
+    subjectName: string;
+    subjectType: 'AGENT';
+    subjectVersion?: string;
+};
 /**
  * Archivo de metadata físico en el proyecto
  */

package/lib/types/release-report.d.ts

@@ -0,0 +1,89 @@
+export declare const RELEASE_REPORT_SCHEMA_VERSION: "1.0";
+export declare const RELEASE_ANALYSIS_MODES: readonly ["deterministic", "ai_enriched"];
+export declare const RELEASE_ENRICHMENT_STATUSES: readonly ["available", "unavailable", "partial", "skipped"];
+export declare const RELEASE_OUTCOMES: readonly ["succeeded", "failed", "partial", "skipped"];
+export declare const RELEASE_OPERATIONS: readonly ["deploy", "publish", "activate", "validate"];
+export declare const RELEASE_STATUSES: readonly ["succeeded", "failed", "skipped", "needs_review"];
+export declare const RELEASE_PHASE_IDS: readonly ["core-metadata", "agentforce-publish", "agentforce-activate", "ai-evaluations", "community-publish", "omnistudio-vlocity", "validation"];
+export declare const RELEASE_ROUTES: readonly ["salesforce-metadata", "agentforce", "ai-evaluation", "experience-cloud", "omnistudio", "validation"];
+export declare const RELEASE_EVIDENCE_TOOLS: readonly ["sf", "vlocity", "smart-deployment"];
+export type ReleaseAnalysisMode = (typeof RELEASE_ANALYSIS_MODES)[number];
+export type ReleaseEnrichmentStatus = (typeof RELEASE_ENRICHMENT_STATUSES)[number];
+export type ReleaseOutcome = (typeof RELEASE_OUTCOMES)[number];
+export type ReleaseOperation = (typeof RELEASE_OPERATIONS)[number];
+export type ReleaseStatus = (typeof RELEASE_STATUSES)[number];
+export type ReleasePhaseId = (typeof RELEASE_PHASE_IDS)[number];
+export type ReleaseRoute = (typeof RELEASE_ROUTES)[number];
+export type ReleaseEvidenceTool = (typeof RELEASE_EVIDENCE_TOOLS)[number];
+export declare const RELEASE_PHASE_ORDER: Readonly<Record<ReleasePhaseId, number>>;
+export declare const RELEASE_ROUTE_ORDER: Readonly<Record<ReleaseRoute, number>>;
+export type ReleaseCommandEvidenceV1 = {
+    tool: ReleaseEvidenceTool;
+    operationId: string;
+    exitCode?: number;
+    deploymentId?: string;
+    artifact?: string;
+};
+export type ReleaseEnrichmentV1 = {
+    status: ReleaseEnrichmentStatus;
+    warnings?: string[];
+};
+export type ReleasePhaseV1 = {
+    id: ReleasePhaseId;
+    route: ReleaseRoute;
+    operation: ReleaseOperation;
+    status: ReleaseStatus;
+    evidence?: ReleaseCommandEvidenceV1[];
+    remediation?: string[];
+};
+export type ReleaseItemV1 = {
+    phaseId: ReleasePhaseId;
+    metadataType: string;
+    fullName: string;
+    route: ReleaseRoute;
+    operation: ReleaseOperation;
+    status: ReleaseStatus;
+    targetOrg?: string;
+    evidenceReferences?: string[];
+    remediation?: string[];
+};
+export type ReleaseSummaryV1 = {
+    total: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+    needsReview: number;
+};
+export type ReleaseReportV1 = {
+    schemaVersion: typeof RELEASE_REPORT_SCHEMA_VERSION;
+    generatedAt: string;
+    command: string;
+    targetOrg?: string;
+    analysisMode: ReleaseAnalysisMode;
+    enrichment: ReleaseEnrichmentV1;
+    outcome: ReleaseOutcome;
+    summary: ReleaseSummaryV1;
+    phases: ReleasePhaseV1[];
+    items: ReleaseItemV1[];
+    reportWarnings: string[];
+};
+export type ReleaseReportFacts = {
+    command: string;
+    targetOrg?: string;
+    analysisMode: ReleaseAnalysisMode;
+    enrichment: ReleaseEnrichmentV1;
+    outcome: ReleaseOutcome;
+    phases: ReleasePhaseFact[];
+    items: ReleaseItemFact[];
+    reportWarnings?: string[];
+};
+export type ReleaseFactStatus = ReleaseStatus | 'unknown' | 'inapplicable';
+export type ReleasePhaseFact = Omit<ReleasePhaseV1, 'status'> & {
+    status: ReleaseFactStatus;
+};
+export type ReleaseItemFact = Omit<ReleaseItemV1, 'status'> & {
+    status: ReleaseFactStatus;
+};
+export type ReleaseReportClock = {
+    now: () => Date;
+};

package/lib/types/release-report.js

@@ -0,0 +1,42 @@
+export const RELEASE_REPORT_SCHEMA_VERSION = '1.0';
+export const RELEASE_ANALYSIS_MODES = ['deterministic', 'ai_enriched'];
+export const RELEASE_ENRICHMENT_STATUSES = ['available', 'unavailable', 'partial', 'skipped'];
+export const RELEASE_OUTCOMES = ['succeeded', 'failed', 'partial', 'skipped'];
+export const RELEASE_OPERATIONS = ['deploy', 'publish', 'activate', 'validate'];
+export const RELEASE_STATUSES = ['succeeded', 'failed', 'skipped', 'needs_review'];
+export const RELEASE_PHASE_IDS = [
+    'core-metadata',
+    'agentforce-publish',
+    'agentforce-activate',
+    'ai-evaluations',
+    'community-publish',
+    'omnistudio-vlocity',
+    'validation',
+];
+export const RELEASE_ROUTES = [
+    'salesforce-metadata',
+    'agentforce',
+    'ai-evaluation',
+    'experience-cloud',
+    'omnistudio',
+    'validation',
+];
+export const RELEASE_EVIDENCE_TOOLS = ['sf', 'vlocity', 'smart-deployment'];
+export const RELEASE_PHASE_ORDER = {
+    'core-metadata': 0,
+    'agentforce-publish': 1,
+    'agentforce-activate': 2,
+    'ai-evaluations': 3,
+    'community-publish': 4,
+    'omnistudio-vlocity': 5,
+    validation: 6,
+};
+export const RELEASE_ROUTE_ORDER = {
+    'salesforce-metadata': 0,
+    agentforce: 1,
+    'ai-evaluation': 2,
+    'experience-cloud': 3,
+    omnistudio: 4,
+    validation: 5,
+};
+//# sourceMappingURL=release-report.js.map

package/lib/types/release-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-report.js","sourceRoot":"","sources":["../../src/types/release-report.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAc,CAAC;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,eAAe,EAAE,aAAa,CAAU,CAAC;AAChF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AACvG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAU,CAAC;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,eAAe;IACf,oBAAoB;IACpB,qBAAqB;IACrB,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,YAAY;CACJ,CAAC;AACX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,qBAAqB;IACrB,YAAY;IACZ,eAAe;IACf,kBAAkB;IAClB,YAAY;IACZ,YAAY;CACJ,CAAC;AACX,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAU,CAAC;AAWrF,MAAM,CAAC,MAAM,mBAAmB,GAA6C;IAC3E,eAAe,EAAE,CAAC;IAClB,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;IACxB,gBAAgB,EAAE,CAAC;IACnB,mBAAmB,EAAE,CAAC;IACtB,oBAAoB,EAAE,CAAC;IACvB,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAA2C;IACzE,qBAAqB,EAAE,CAAC;IACxB,UAAU,EAAE,CAAC;IACb,eAAe,EAAE,CAAC;IAClB,kBAAkB,EAAE,CAAC;IACrB,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;CACd,CAAC"}

package/messages/ci.preset.json

@@ -0,0 +1,22 @@
+{
+  "summary": "Run the CI deployment planning preset",
+  "description": "Builds a validation-safe deployment plan, writes JSON and HTML report artifacts, emits GitHub Actions output keys, and returns deterministic CI exit codes.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %> --source-path force-app --target-org dev --report-dir reports/deployment-plan",
+    "<%= config.bin %> smart-deployment ci preset --validation-mode warn-only --skip-tests"
+  ],
+  "flags.source-path.summary": "Salesforce source path to analyze",
+  "flags.source-path.description": "Path to the Salesforce source directory used to build the deployment plan.",
+  "flags.report-dir.summary": "Directory where JSON and HTML deployment plan reports are written",
+  "flags.report-dir.description": "Defaults to the deployment plan report service location under the analyzed project.",
+  "flags.validation-mode.summary": "CI exit-code policy for deployment planning blockers",
+  "flags.validation-mode.description": "strict exits non-zero for blockers, warn-only reports blockers with exit code 0, and local-only avoids org-dependent validation expectations.",
+  "flags.skip-tests.summary": "Record that Apex tests should be skipped by downstream validation",
+  "flags.use-ai.summary": "Use configured AI providers for dependency inference and wave priority analysis",
+  "flags.org-type.summary": "Target org type used by AI wave priority analysis",
+  "flags.industry.summary": "Industry context used by AI wave priority analysis",
+  "flags.scope-commits.summary": "Comma-separated commit SHAs or refs to include in the CI deployment scope",
+  "flags.scope-commits.description": "Limits CI plan artifacts to metadata changed by these commits plus required dependencies.",
+  "flags.scope-manifest.summary": "Path to a JSON commit or story scope manifest",
+  "flags.scope-manifest.description": "Reads commits from { commits: [] } and { stories: [{ commits: [] }] } for trunk-based validation."
+}

package/messages/graph.export.json

@@ -0,0 +1,20 @@
+{
+  "summary": "Export dependency and deployment wave graphs",
+  "description": "Builds the local dependency graph and deployment waves, then exports review-ready graph artifacts in Mermaid, DOT, JSON, or HTML format.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %> --source-path force-app --format mermaid --report-dir reports/graphs",
+    "<%= config.bin %> smart-deployment graph export --format html --output reports/dependency-graph.html",
+    "<%= config.bin %> smart-deployment graph export --json --format json"
+  ],
+  "flags.source-path.summary": "Salesforce source path to analyze",
+  "flags.source-path.description": "Path to the Salesforce source directory used to build the dependency and wave graph.",
+  "flags.report-dir.summary": "Directory where the selected graph artifact is written",
+  "flags.report-dir.description": "Defaults to .smart-deployment/reports/graph-export under the analyzed project root.",
+  "flags.output.summary": "Exact output file path for the selected graph format",
+  "flags.output.description": "Overrides --report-dir and writes the selected graph artifact to this file.",
+  "flags.format.summary": "Graph export format",
+  "flags.format.description": "Supported formats are mermaid, dot, json, and html.",
+  "flags.use-ai.summary": "Use configured AI providers for dependency inference and wave priority analysis before exporting",
+  "flags.org-type.summary": "Target org type used by AI wave priority analysis",
+  "flags.industry.summary": "Industry context used by AI wave priority analysis"
+}

package/messages/impact.json

@@ -0,0 +1,18 @@
+{
+  "summary": "Analyze deployment impact from git changes",
+  "description": "Maps git changes to Salesforce metadata components, expands transitive dependents, reports planned deployment waves, and suggests Apex tests for CI decisions.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %> --base origin/main --head HEAD --json",
+    "<%= config.bin %> smart-deployment impact --working-tree --source-path force-app"
+  ],
+  "flags.source-path.summary": "Salesforce source path to analyze",
+  "flags.source-path.description": "Path to the Salesforce source directory used to build the dependency graph and deployment waves.",
+  "flags.base.summary": "Base git ref for impact analysis",
+  "flags.base.description": "Git ref at the start of the comparison range. Must be provided with --head.",
+  "flags.head.summary": "Head git ref for impact analysis",
+  "flags.head.description": "Git ref at the end of the comparison range. Must be provided with --base.",
+  "flags.working-tree.summary": "Analyze current working-tree changes",
+  "flags.working-tree.description": "Uses git status to include staged, unstaged, and untracked working-tree changes. This is the default when --base and --head are omitted.",
+  "flags.max-depth.summary": "Maximum dependent traversal depth",
+  "flags.max-depth.description": "Limits transitive dependent traversal. Omit for unlimited depth."
+}

package/messages/init.json

@@ -0,0 +1,16 @@
+{
+  "summary": "Initialize Smart Deployment repository config",
+  "description": "Detects Salesforce project source settings and writes .smart-deployment.json defaults for cache policy, CI preset behavior, and report locations.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %>",
+    "<%= config.bin %> smart-deployment init --source-path force-app --validation-mode warn-only --non-interactive",
+    "<%= config.bin %> smart-deployment init --force --no-cache-enabled"
+  ],
+  "flags.source-path.summary": "Path used to detect the Salesforce project and default package directory",
+  "flags.force.summary": "Overwrite an existing .smart-deployment.json file",
+  "flags.cache-enabled.summary": "Enable file-hash cache defaults in generated config",
+  "flags.validation-mode.summary": "Default validation mode for the CI preset",
+  "flags.report-dir.summary": "Default report directory for CI preset plan artifacts",
+  "flags.skip-tests.summary": "Default skip-tests setting for CI preset config",
+  "flags.non-interactive.summary": "Run with deterministic defaults suitable for CI automation"
+}

package/messages/metadata.gaps.json

@@ -0,0 +1,12 @@
+{
+  "summary": "Analyze unsupported Salesforce metadata types",
+  "description": "Scans package manifests and Salesforce source paths, compares detected metadata types against smart-deployment support, and reports safe next steps for unsupported or partially supported metadata.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %> --source-path force-app --json",
+    "<%= config.bin %> smart-deployment metadata gaps --ai-explain"
+  ],
+  "flags.source-path.summary": "Salesforce project or source path to scan",
+  "flags.source-path.description": "Path used to locate sfdx-project.json and scan configured package directories.",
+  "flags.ai-explain.summary": "Include workflow-ready AI explanation context",
+  "flags.ai-explain.description": "Adds a deterministic prompt and setup-agents workflow command for Codex-assisted review. The plugin does not call an AI provider directly."
+}

package/messages/plan.explain.json

@@ -0,0 +1,20 @@
+{
+  "summary": "Explain why metadata components are placed in deployment waves",
+  "description": "Builds the same local plan used by start dry-run and explains wave placement, dependency edges, unresolved references, and provider-owned deployment decisions.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %> --source-path force-app",
+    "<%= config.bin %> smart-deployment plan explain --use-ai --org-type Sandbox --target-org dev"
+  ],
+  "flags.source-path.summary": "Salesforce source path to analyze",
+  "flags.dry-run.summary": "Accepted for parity with start dry-run; explain never deploys metadata",
+  "flags.validate-only.summary": "Accepted for parity with start validate-only; explain never deploys metadata",
+  "flags.skip-tests.summary": "Accepted for parity with start dry-run inputs; explain never runs tests",
+  "flags.allow-cycle-remediation.summary": "Accepted for parity with start dry-run inputs; explain does not modify sources",
+  "flags.use-ai.summary": "Use configured AI providers for dependency inference and wave priority analysis",
+  "flags.org-type.summary": "Target org type used by AI wave priority analysis",
+  "flags.industry.summary": "Industry context used by AI wave priority analysis",
+  "flags.since.summary": "Git ref used to explain changed provider-owned metadata decisions",
+  "flags.auto-activate.summary": "Include Agentforce activation decisions in provider-owned metadata planning",
+  "flags.scope-commits.summary": "Comma-separated commit SHAs or refs to include in the explained plan",
+  "flags.scope-manifest.summary": "Path to a JSON commit or story scope manifest"
+}

package/messages/resume.json

@@ -4,6 +4,7 @@
     "<%= config.bin %> <%= command.id %> --source-path force-app",
     "<%= config.bin %> <%= command.id %> --source-path force-app --retry-strategy quick"
   ],
+  "flags.target-org.summary": "Target Salesforce org alias or username for remote deployment resume",
   "flags.source-path.summary": "Path to the Salesforce project containing deployment state",
   "flags.retry-strategy.summary": "Retry strategy to use when resuming the deployment"
 }

package/messages/retrieve.json

@@ -0,0 +1,26 @@
+{
+  "summary": "Retrieve Salesforce metadata while enforcing .forceignore for bundle sub-paths",
+  "description": "Wraps sf project retrieve start, then restores any changed paths protected by .forceignore. This protects DigitalExperienceBundle, LightningComponentBundle, and AuraDefinitionBundle leaf paths that the Salesforce CLI can write as part of composite retrieves.",
+  "examples": [
+    "<%= config.bin %> <%= command.id %> --metadata DigitalExperienceBundle:site/PHP_Portal1 --target-org dev",
+    "<%= config.bin %> <%= command.id %> --metadata DigitalExperienceBundle:site/PHP_Portal1 --strict-ignore",
+    "<%= config.bin %> <%= command.id %> --metadata DigitalExperienceBundle:site/PHP_Portal1 --normalize-meta"
+  ],
+  "flags.source-path.summary": "Salesforce project path where retrieve should run",
+  "flags.source-path.description": "Defaults to the current working directory when omitted.",
+  "flags.metadata.summary": "Metadata component(s) to retrieve, comma-separated",
+  "flags.metadata.description": "Passed through to sf project retrieve start --metadata. Example: DigitalExperienceBundle:site/PHP_Portal1.",
+  "flags.manifest.summary": "Package manifest to retrieve",
+  "flags.manifest.description": "Passed through to sf project retrieve start --manifest.",
+  "flags.wait.summary": "Minutes to wait for Salesforce retrieve completion",
+  "flags.strict-ignore.summary": "Fail when retrieve touches .forceignore-protected paths",
+  "flags.strict-ignore.description": "Protected paths are still restored before the command fails.",
+  "flags.normalize-meta.summary": "Normalize DigitalExperienceBundle *_meta.json formatting after retrieve",
+  "flags.normalize-meta.description": "Formats JSON with two-space indentation and a trailing newline before forceignore restoration.",
+  "output.title": "Smart deployment retrieve",
+  "output.changed": "Changed paths after retrieve: %s",
+  "output.restored": ".forceignore-protected paths restored: %s",
+  "output.normalized": "DigitalExperience *_meta.json files normalized: %s",
+  "output.restoredHeader": "Restored protected paths",
+  "errors.strict-ignore": "Retrieve touched %s .forceignore-protected path(s). Workspace was restored, but --strict-ignore requires failure."
+}

package/messages/start.json

@@ -5,7 +5,9 @@
     "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg",
     "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg --dry-run",
     "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg --validate-only",
-    "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg --skip-tests"
+    "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg --skip-tests",
+    "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg --destructive",
+    "<%= config.bin %> <%= command.id %> --source-path force-app --target-org myorg --rollback-from v1.2.0 --rollback-to v1.2.1"
   ],
   "flags.target-org.summary": "Target Salesforce org for deployment",
   "flags.dry-run.summary": "Preview deployment without executing",
@@ -13,6 +15,8 @@
   "flags.skip-tests.summary": "Skip running tests during deployment",
   "flags.source-path.summary": "Path to the Salesforce project to analyze and deploy",
   "flags.source-path.description": "Defaults to the current working directory when omitted",
+  "flags.report-dir.summary": "Directory for dry-run deployment plan reports",
+  "flags.report-dir.description": "Defaults to .smart-deployment/reports/start-dry-run under the scanned project root",
   "flags.allow-cycle-remediation.summary": "Allow conservative cycle remediation for supported ApexClass cycles",
   "flags.allow-cycle-remediation.description": "Applies temporary reversible source edits for simple cycles only",
   "flags.use-ai.summary": "Use AI for intelligent priority weighting and dependency inference",
@@ -20,5 +24,17 @@
   "flags.org-type.summary": "Organization type context for AI analysis",
   "flags.org-type.description": "Helps AI provide context-aware recommendations",
   "flags.industry.summary": "Industry context for AI analysis",
-  "flags.industry.description": "Provides business context to AI for better prioritization"
+  "flags.industry.description": "Provides business context to AI for better prioritization",
+  "flags.scope-commits.summary": "Comma-separated commit SHAs or refs to include in the deployment scope",
+  "flags.scope-commits.description": "Limits the deployment plan to metadata changed by these commits plus required dependencies.",
+  "flags.scope-manifest.summary": "Path to a JSON commit or story scope manifest",
+  "flags.scope-manifest.description": "Reads commits from { commits: [] } and { stories: [{ commits: [] }] } to scope validation and deployment planning.",
+  "flags.scope-manifest-output.summary": "Write the resolved story scope manifest for CI review",
+  "flags.scope-manifest-output.description": "Creates a deterministic JSON contract containing commits, changed files, included metadata, dependency-retained metadata, explicitly included metadata, and ignored metadata.",
+  "flags.destructive.summary": "Delete metadata components using destructive wave manifests",
+  "flags.destructive.description": "Runs the normal analysis path, then executes destructiveChanges manifests in reverse wave order.",
+  "flags.rollback-from.summary": "Git ref or release tag that represents the rollback target state",
+  "flags.rollback-from.description": "Use with --rollback-to. Modified or deleted metadata is restored from this ref using normal deploy waves.",
+  "flags.rollback-to.summary": "Git ref or release tag that represents the release being rolled back",
+  "flags.rollback-to.description": "Use with --rollback-from. Metadata added between refs is deleted using destructive waves."
 }

package/messages/status.json

@@ -4,5 +4,6 @@
     "<%= config.bin %> <%= command.id %> --source-path force-app",
     "<%= config.bin %> <%= command.id %> --target-org myorg --source-path force-app"
   ],
+  "flags.target-org.summary": "Target Salesforce org alias or username for remote deployment status refresh",
   "flags.source-path.summary": "Path to the Salesforce project containing deployment state"
 }

package/messages/validate.json

@@ -5,5 +5,9 @@
     "<%= config.bin %> <%= command.id %> --source-path force-app --use-ai"
   ],
   "flags.source-path.summary": "Path to the Salesforce project to validate",
-  "flags.use-ai.summary": "Use AI wave validation with the configured provider when available"
+  "flags.use-ai.summary": "Use configured provider AI validation when available",
+  "flags.scope-commits.summary": "Comma-separated commit SHAs or refs to include in validation",
+  "flags.scope-manifest.summary": "Path to a JSON commit or story scope manifest",
+  "flags.scope-manifest-output.summary": "Write the resolved story scope manifest for CI review",
+  "flags.scope-manifest-output.description": "Creates a deterministic JSON contract containing commits, changed files, included metadata, dependency-retained metadata, explicitly included metadata, and ignored metadata."
 }