@jterrats/smart-deployment 1.4.0 → 1.5.0

package/lib/types/manual-checkpoint.js

@@ -0,0 +1,89 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir, stat } from 'node:fs/promises';
+import * as path from 'node:path';
+export function validateManualCheckpoints(checkpoints, waves) {
+    const waveNumbers = new Set(waves.map((wave) => wave.number));
+    const ids = new Set();
+    const positions = new Set();
+    for (const checkpoint of checkpoints) {
+        if (!checkpoint.id.trim()) {
+            throw new Error('Manual checkpoint id must not be empty.');
+        }
+        if (checkpoint.phase !== 'before' && checkpoint.phase !== 'after') {
+            throw new Error(`Manual checkpoint ${checkpoint.id} has invalid phase: ${String(checkpoint.phase)}`);
+        }
+        if (ids.has(checkpoint.id)) {
+            throw new Error(`Duplicate manual checkpoint id: ${checkpoint.id}`);
+        }
+        if (!waveNumbers.has(checkpoint.waveNumber)) {
+            throw new Error(`Manual checkpoint ${checkpoint.id} references missing wave ${checkpoint.waveNumber}.`);
+        }
+        const position = `${checkpoint.phase}:${checkpoint.waveNumber}`;
+        if (positions.has(position)) {
+            throw new Error(`Multiple manual checkpoints target ${position}.`);
+        }
+        ids.add(checkpoint.id);
+        positions.add(position);
+    }
+}
+export function createDeploymentPlanFingerprint(options) {
+    const value = JSON.stringify({
+        waves: options.waves.map((wave) => ({ number: wave.number, components: [...wave.components].sort() })),
+        checkpoints: [...options.checkpoints].sort((left, right) => left.id.localeCompare(right.id)),
+        destructive: options.destructive,
+        skipTests: options.skipTests,
+        apiVersion: options.apiVersion,
+        sourceFingerprint: options.sourceFingerprint,
+    });
+    return `sha256:${createHash('sha256').update(value).digest('hex')}`;
+}
+export async function createSourceFingerprint(components) {
+    const entries = await Promise.all([...components.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(async ([nodeId, component]) => {
+        try {
+            return [nodeId, await hashComponentSource(component.filePath)];
+        }
+        catch {
+            return [nodeId, 'unreadable'];
+        }
+    }));
+    return `sha256:${createHash('sha256').update(JSON.stringify(entries)).digest('hex')}`;
+}
+async function hashComponentSource(componentPath) {
+    const componentStats = await stat(componentPath);
+    if (componentStats.isDirectory()) {
+        return hashSourcePath(componentPath);
+    }
+    const directoryPath = path.dirname(componentPath);
+    const basename = path.basename(componentPath);
+    const stem = basename.split('.')[0];
+    const siblingPaths = (await readdir(directoryPath, { withFileTypes: true }))
+        .filter((entry) => entry.isFile() && (entry.name === basename || entry.name.startsWith(`${stem}.`)))
+        .map((entry) => path.join(directoryPath, entry.name))
+        .sort();
+    const contents = await Promise.all(siblingPaths.map(async (filePath) => [path.basename(filePath), await readFile(filePath, 'base64')]));
+    return createHash('sha256').update(JSON.stringify(contents)).digest('hex');
+}
+async function hashSourcePath(sourcePath) {
+    const sourceStats = await stat(sourcePath);
+    if (sourceStats.isFile()) {
+        return createHash('sha256')
+            .update(await readFile(sourcePath))
+            .digest('hex');
+    }
+    const files = await collectFiles(sourcePath);
+    const contents = await Promise.all(files.map(async (filePath) => [path.relative(sourcePath, filePath), await readFile(filePath, 'base64')]));
+    return createHash('sha256').update(JSON.stringify(contents)).digest('hex');
+}
+async function collectFiles(directoryPath) {
+    const entries = await readdir(directoryPath, { withFileTypes: true });
+    const nested = await Promise.all(entries
+        .sort((left, right) => left.name.localeCompare(right.name))
+        .map(async (entry) => {
+        const entryPath = path.join(directoryPath, entry.name);
+        return entry.isDirectory() ? collectFiles(entryPath) : [entryPath];
+    }));
+    return nested.flat();
+}
+//# sourceMappingURL=manual-checkpoint.js.map

package/lib/types/manual-checkpoint.js.map

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

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":"AAcA,MAAM,qBAAqB,GAAmB;IAC5C,cAAc;IACd,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,OAAO;IACP,eAAe;IACf,QAAQ;IACR,WAAW;IACX,aAAa;IACb,MAAM;IACN,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,aAAa;IACb,YAAY;IACZ,SAAS;IACT,yBAAyB;IACzB,uBAAuB;IACvB,WAAW;IACX,SAAS;IACT,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,eAA0C;IAE1C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEzE,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,eAAmE,EACnE,CAAS,EACT,CAAS;IAET,MAAM,SAAS,GAAG,yBAAyB,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,yBAAyB,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,mBAAmB,GAAG,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IACtE,IAAI,mBAAmB,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,cAAc,GAAG,0BAA0B,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAChG,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAiB,CAAC;AAC9C,CAAC;AAED,SAAS,yBAAyB,CAChC,eAAmE,EACnE,MAAc;IAEd,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO;QACL,SAAS,EAAE,8BAA8B,CAAC,YAAY,CAAC;QACvD,WAAW,EAAE,wBAAwB,CAAC,eAAe,EAAE,MAAM,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,IAAkB;IACxD,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACrC,CAAC;AAED,SAAS,wBAAwB,CAC/B,eAAmE,EACnE,MAAc;IAEd,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAEpD,OAAO,SAAS,CAAC,MAAM,CACrB,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,GAAG,WAAW;QACd,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;KAC9B,CAAC,EACF;QACE,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,CAAC;KACZ,CACF,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,IAA2B,EAAE,KAA4B;IAC3F,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACxC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"wave-priority-policy.js","sourceRoot":"","sources":["../../src/waves/wave-priority-policy.ts"],"names":[],"mappings":"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"}

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/npm-shrinkwrap.json

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

package/oclif.manifest.json

@@ -537,7 +537,8 @@
       "args": {},
       "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": {
         "json": {
@@ -582,6 +583,13 @@
             "validate-only"
           ],
           "type": "option"
+        },
+        "approve-checkpoint": {
+          "name": "approve-checkpoint",
+          "summary": "Approve a paused manual checkpoint and continue the remaining waves",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -591,7 +599,7 @@
       "pluginName": "@jterrats/smart-deployment",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a failed deployment",
+      "summary": "Resume a failed or paused deployment",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1332,77 +1340,6 @@
         "export:graph"
       ]
     },
-    "metadata:gaps": {
-      "aliases": [
-        "smart-deployment:metadata:gaps"
-      ],
-      "args": {},
-      "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": {
-        "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": {
-          "description": "Path used to locate sfdx-project.json and scan configured package directories.",
-          "name": "source-path",
-          "summary": "Salesforce project or source path to scan",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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.",
-          "name": "ai-explain",
-          "summary": "Include workflow-ready AI explanation context",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "metadata:gaps",
-      "pluginAlias": "@jterrats/smart-deployment",
-      "pluginName": "@jterrats/smart-deployment",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Analyze unsupported Salesforce metadata types",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "metadata",
-        "gaps.js"
-      ],
-      "aliasPermutations": [
-        "smart-deployment:metadata:gaps",
-        "metadata:smart-deployment:gaps",
-        "metadata:gaps:smart-deployment",
-        "smart-deployment:gaps:metadata",
-        "gaps:smart-deployment:metadata",
-        "gaps:metadata:smart-deployment"
-      ],
-      "permutations": [
-        "metadata:gaps",
-        "gaps:metadata"
-      ]
-    },
     "plan:explain": {
       "aliases": [
         "smart-deployment:plan:explain"
@@ -1555,7 +1492,78 @@
         "plan:explain",
         "explain:plan"
       ]
+    },
+    "metadata:gaps": {
+      "aliases": [
+        "smart-deployment:metadata:gaps"
+      ],
+      "args": {},
+      "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": {
+        "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": {
+          "description": "Path used to locate sfdx-project.json and scan configured package directories.",
+          "name": "source-path",
+          "summary": "Salesforce project or source path to scan",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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.",
+          "name": "ai-explain",
+          "summary": "Include workflow-ready AI explanation context",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "metadata:gaps",
+      "pluginAlias": "@jterrats/smart-deployment",
+      "pluginName": "@jterrats/smart-deployment",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Analyze unsupported Salesforce metadata types",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "metadata",
+        "gaps.js"
+      ],
+      "aliasPermutations": [
+        "smart-deployment:metadata:gaps",
+        "metadata:smart-deployment:gaps",
+        "metadata:gaps:smart-deployment",
+        "smart-deployment:gaps:metadata",
+        "gaps:smart-deployment:metadata",
+        "gaps:metadata:smart-deployment"
+      ],
+      "permutations": [
+        "metadata:gaps",
+        "gaps:metadata"
+      ]
     }
   },
-  "version": "1.4.0"
+  "version": "1.5.0"
 }

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.4.0",
+  "version": "1.5.0",
   "dependencies": {
     "@oclif/core": "4.11.4",
     "@salesforce/core": "^8.31.0",