@jterrats/smart-deployment 1.3.1 → 1.5.0

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/lib/waves/wave-priority-policy.js

@@ -1,26 +1,4 @@
-const TYPE_DEPLOYMENT_ORDER = [
-    'CustomObject',
-    'CustomField',
-    'RecordType',
-    'BusinessProcess',
-    'Queue',
-    'CompactLayout',
-    'Layout',
-    'ApexClass',
-    'ApexTrigger',
-    'Flow',
-    'ValidationRule',
-    'WorkflowRule',
-    'EmailTemplate',
-    'BrandingSet',
-    'CustomSite',
-    'Network',
-    'DigitalExperienceBundle',
-    'EmbeddedServiceConfig',
-    'FlexiPage',
-    'Profile',
-    'PermissionSet',
-];
+import { getDeploymentPriority } from '../constants/deployment-order.js';
 export function buildEdgeTypesByFrom(dependencyEdges) {
     const edgeTypesByFrom = new Map();
     for (const edge of dependencyEdges) {
@@ -54,8 +32,7 @@ function createWavePriorityProfile(edgeTypesByFrom, nodeId) {
     };
 }
 function getMetadataTypeDeploymentOrder(type) {
-    const order = TYPE_DEPLOYMENT_ORDER.indexOf(type);
-    return order === -1 ? 9999 : order;
+    return getDeploymentPriority(type);
 }
 function getDependencyRiskProfile(edgeTypesByFrom, nodeId) {
     const edgeTypes = edgeTypesByFrom.get(nodeId) ?? [];

package/lib/waves/wave-priority-policy.js.map

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

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/resume.json

@@ -1,10 +1,12 @@
 {
-  "summary": "Resume a failed deployment",
+  "summary": "Resume a failed or paused deployment",
   "examples": [
     "<%= config.bin %> <%= command.id %> --source-path force-app",
-    "<%= config.bin %> <%= command.id %> --source-path force-app --retry-strategy quick"
+    "<%= config.bin %> <%= command.id %> --source-path force-app --retry-strategy quick",
+    "<%= config.bin %> <%= command.id %> --source-path . --approve-checkpoint activate-decision-table"
   ],
   "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"
+  "flags.retry-strategy.summary": "Retry strategy to use when resuming the deployment",
+  "flags.approve-checkpoint.summary": "Approve a paused manual checkpoint and continue the remaining waves"
 }

package/messages/start.json

@@ -29,6 +29,8 @@
   "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",

package/messages/validate.json

@@ -7,5 +7,7 @@
   "flags.source-path.summary": "Path to the Salesforce project to validate",
   "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.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."
 }