sf-decomposer 7.2.0 → 7.3.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [7.3.0](https://github.com/mcarvin8/sf-decomposer/compare/v7.2.0...v7.3.0) (2026-08-24)
+
+
+### Features
+
+* **action:** add a GitHub Action wrapping decompose/recompose/verify ([#572](https://github.com/mcarvin8/sf-decomposer/issues/572)) ([b32391d](https://github.com/mcarvin8/sf-decomposer/commit/b32391dff7dd2d77868b4a67cc70f7563dd1e55b))
+
 ## [7.2.0](https://github.com/mcarvin8/sf-decomposer/compare/v7.1.1...v7.2.0) (2026-08-24)
 
 

package/README.md

@@ -8,7 +8,10 @@
 [![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fmcarvin8%2Fsf-decomposer%2Fmain)](https://dashboard.stryker-mutator.io/reports/github.com/mcarvin8/sf-decomposer/main)
 [![Performance](https://img.shields.io/badge/Performance-Dashboard-58a6ff)](https://mcarvin8.github.io/sf-decomposer/dev/bench/runtime/)
 
-A Salesforce CLI plugin that **decomposes** large metadata XML files into smaller, version-control–friendly files (XML, JSON, YAML, JSON5), and **recomposes** them back into deployment-ready metadata.
+**Decomposes** large Salesforce metadata XML files into smaller, version-control–friendly files (XML, JSON, YAML, JSON5), and **recomposes** them back into deployment-ready metadata — as a Salesforce CLI plugin, or as a GitHub Action that needs neither the CLI nor a plugin install.
+
+- Using the Salesforce CLI? Start at [Setup](#setup).
+- Running this in CI without the CLI? Skip straight to [GitHub Action](#github-action).
 
 <!-- TABLE OF CONTENTS -->
 <details>
@@ -21,6 +24,7 @@ A Salesforce CLI plugin that **decomposes** large metadata XML files into smalle
   - [4. Configure Hooks](#4-configure-hooks-recommended)
 - [Daily Workflow](#daily-workflow)
 - [Commands](#commands)
+- [GitHub Action](#github-action)
 - [Reference](#reference)
   - [Decompose Strategies](#decompose-strategies)
   - [Supported Metadata](#supported-metadata)
@@ -215,7 +219,7 @@ EXAMPLES
   `sf decomposer decompose -x "manifest/package.xml" -m "flow"`
 ```
 
-_See code: [src/commands/decomposer/decompose.ts](https://github.com/mcarvin8/sf-decomposer/blob/v7.2.0/src/commands/decomposer/decompose.ts)_
+_See code: [src/commands/decomposer/decompose.ts](https://github.com/mcarvin8/sf-decomposer/blob/v7.3.0/src/commands/decomposer/decompose.ts)_
 
 ## `sf decomposer recompose`
 
@@ -261,7 +265,7 @@ EXAMPLES
   `sf decomposer recompose -x "manifest/package.xml" -m "flow"`
 ```
 
-_See code: [src/commands/decomposer/recompose.ts](https://github.com/mcarvin8/sf-decomposer/blob/v7.2.0/src/commands/decomposer/recompose.ts)_
+_See code: [src/commands/decomposer/recompose.ts](https://github.com/mcarvin8/sf-decomposer/blob/v7.3.0/src/commands/decomposer/recompose.ts)_
 
 ## `sf decomposer verify`
 
@@ -325,11 +329,59 @@ EXAMPLES
   `sf decomposer verify -x "manifest/package.xml" --config`
 ```
 
-_See code: [src/commands/decomposer/verify.ts](https://github.com/mcarvin8/sf-decomposer/blob/v7.2.0/src/commands/decomposer/verify.ts)_
+_See code: [src/commands/decomposer/verify.ts](https://github.com/mcarvin8/sf-decomposer/blob/v7.3.0/src/commands/decomposer/verify.ts)_
 <!-- commandsstop -->
 
 ---
 
+## GitHub Action
+
+`decompose`, `recompose`, and `verify` are also available as a GitHub Action — a container action, so it needs **no Salesforce CLI and no `sf-decomposer` plugin install**. One action, dispatched by a `mode` input, mirrors the three CLI commands one-for-one: same flags (as inputs), same `.sfdecomposer.config.json` support via `config: true`.
+
+```yaml
+- uses: actions/checkout@v7
+
+- name: Decompose retrieved metadata
+  uses: mcarvin8/sf-decomposer@v7
+  with:
+    mode: decompose
+    metadata-type: |
+      permissionset
+      flow
+    postpurge: 'true'
+
+- name: Verify the round trip before merging
+  uses: mcarvin8/sf-decomposer@v7
+  with:
+    mode: verify
+    config: 'true'
+```
+
+Or point it at an existing `.sfdecomposer.config.json` for either step instead of listing flags: `with: { mode: decompose, config: 'true' }`.
+
+**Inputs** (all optional except `mode`; multi-value inputs are newline-separated, matching `actions/checkout`'s own multiline convention):
+
+| Input                          | Used by              | Description                                                                       |
+|--------------------------------|----------------------|-----------------------------------------------------------------------------------|
+| `mode`                         | all                  | `decompose`, `recompose`, or `verify`.                                            |
+| `metadata-type`                | all                  | Metadata suffix(es) to process, one per line.                                     |
+| `manifest`                     | all                  | Path to a package.xml manifest to scope the run to.                               |
+| `ignore-package-directory`     | all                  | Package director(y/ies) to skip, one per line.                                    |
+| `config`                       | all                  | Read settings from `.sfdecomposer.config.json`, same as the CLI's `--config`.     |
+| `format`                       | decompose, verify    | `xml`, `json`, `json5`, or `yaml`. Default `xml`.                                 |
+| `strategy`                     | decompose, verify    | `unique-id` or `grouped-by-tag`. Default `unique-id`.                             |
+| `decompose-nested-permissions` | decompose, verify    | With `grouped-by-tag`, further decompose permission set object/field permissions. |
+| `prepurge`                     | decompose            | Remove existing decomposed files before decomposing.                              |
+| `postpurge`                    | decompose, recompose | After decompose, remove originals; after recompose, remove decomposed files.      |
+| `update-forceignore`           | decompose            | Append decomposed file patterns to `.forceignore`.                                |
+| `update-gitattributes`         | decompose            | Mark decomposed files as generated in `.gitattributes`.                           |
+
+**Outputs:** `metadata` (newline-separated list of processed suffixes), `types-count`; `verify` additionally sets `drift-count` and `reordered-count`, and fails the step when `drift-count` is greater than 0.
+
+See [`action.yml`](action.yml) for the full input/output reference.
+
+---
+
 ## Reference
 
 ### Decompose Strategies

package/lib/action/decompose.d.ts

@@ -0,0 +1 @@
+export declare function runDecompose(): Promise<void>;

package/lib/action/decompose.js

@@ -0,0 +1,57 @@
+'use strict';
+import * as core from '@actions/core';
+import { decomposeMetadataTypes } from '../core/decomposeMetadataTypes.js';
+import { loadConfigFile, parseConfigSuffixes, resolveDefaultConfigPath, validateConfigManifest, } from '../helpers/configOverrides.js';
+import { multilineInput, optionalInput, requireMetadataTypesOrManifest } from './inputs.js';
+export async function runDecompose() {
+    let metadataTypes = multilineInput('metadata-type');
+    let manifest = optionalInput('manifest');
+    let ignoreDirs = multilineInput('ignore-package-directory');
+    let format = optionalInput('format') ?? 'xml';
+    let strategy = optionalInput('strategy') ?? 'unique-id';
+    let prepurge = core.getBooleanInput('prepurge');
+    let postpurge = core.getBooleanInput('postpurge');
+    let decomposeNestedPerms = core.getBooleanInput('decompose-nested-permissions');
+    let updateForceignore = core.getBooleanInput('update-forceignore');
+    let updateGitattributes = core.getBooleanInput('update-gitattributes');
+    let overrides;
+    if (core.getBooleanInput('config')) {
+        const config = await loadConfigFile(await resolveDefaultConfigPath());
+        metadataTypes ??= parseConfigSuffixes(config.metadataSuffixes);
+        const configManifest = !manifest ? config.manifest : undefined;
+        manifest ??= config.manifest;
+        ignoreDirs ??= parseConfigSuffixes(config.ignorePackageDirectories);
+        format = optionalInput('format') ?? config.decomposedFormat ?? 'xml';
+        strategy = optionalInput('strategy') ?? config.strategy ?? 'unique-id';
+        prepurge = prepurge || (config.prePurge ?? false);
+        postpurge = postpurge || (config.postPurge ?? false);
+        decomposeNestedPerms = decomposeNestedPerms || (config.decomposeNestedPermissions ?? false);
+        updateForceignore = updateForceignore || (config.updateForceignore ?? false);
+        updateGitattributes = updateGitattributes || (config.updateGitattributes ?? false);
+        overrides = config.overrides;
+        manifest = await validateConfigManifest({
+            configManifest,
+            metadataTypes,
+            manifest,
+            warn: (msg) => core.warning(msg),
+        });
+    }
+    requireMetadataTypesOrManifest(metadataTypes, manifest);
+    const result = await decomposeMetadataTypes({
+        metadataTypes,
+        prepurge,
+        postpurge,
+        format,
+        ignoreDirs,
+        strategy,
+        decomposeNestedPerms,
+        manifest,
+        overrides,
+        updateForceignore,
+        updateGitattributes,
+        log: (msg) => core.info(msg),
+    });
+    core.setOutput('metadata', result.metadata.join('\n'));
+    core.setOutput('types-count', result.metadata.length);
+}
+//# sourceMappingURL=decompose.js.map

package/lib/action/decompose.js.map

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

package/lib/action/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/action/index.js

@@ -0,0 +1,4 @@
+'use strict';
+import { run } from './main.js';
+void run();
+//# sourceMappingURL=index.js.map

package/lib/action/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/action/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,KAAK,GAAG,EAAE,CAAC"}

package/lib/action/inputs.d.ts

@@ -0,0 +1,3 @@
+export declare function multilineInput(name: string): string[] | undefined;
+export declare function optionalInput(name: string): string | undefined;
+export declare function requireMetadataTypesOrManifest(metadataTypes: string[] | undefined, manifest: string | undefined): void;

package/lib/action/inputs.js

@@ -0,0 +1,19 @@
+'use strict';
+import * as core from '@actions/core';
+export function multilineInput(name) {
+    const values = core
+        .getMultilineInput(name)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    return values.length > 0 ? values : undefined;
+}
+export function optionalInput(name) {
+    const value = core.getInput(name);
+    return value === '' ? undefined : value;
+}
+export function requireMetadataTypesOrManifest(metadataTypes, manifest) {
+    if (!metadataTypes?.length && !manifest) {
+        throw new Error("Either the 'metadata-type' or 'manifest' input must be set, or 'config' must be true with a config file that specifies metadataSuffixes or manifest.");
+    }
+}
+//# sourceMappingURL=inputs.js.map

package/lib/action/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../src/action/inputs.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAEtC,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,IAAI;SAChB,iBAAiB,CAAC,IAAI,CAAC;SACvB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,aAAmC,EACnC,QAA4B;IAE5B,IAAI,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,sJAAsJ,CACvJ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/action/main.d.ts

@@ -0,0 +1 @@
+export declare function run(): Promise<void>;

package/lib/action/main.js

@@ -0,0 +1,26 @@
+'use strict';
+import * as core from '@actions/core';
+import { runDecompose } from './decompose.js';
+import { runRecompose } from './recompose.js';
+import { runVerify } from './verify.js';
+export async function run() {
+    try {
+        const mode = core.getInput('mode', { required: true });
+        if (mode === 'decompose') {
+            await runDecompose();
+        }
+        else if (mode === 'recompose') {
+            await runRecompose();
+        }
+        else if (mode === 'verify') {
+            await runVerify();
+        }
+        else {
+            core.setFailed(`Invalid mode "${mode}". Expected "decompose", "recompose", or "verify".`);
+        }
+    }
+    catch (error) {
+        core.setFailed(error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=main.js.map

package/lib/action/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/action/main.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,SAAS,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,iBAAiB,IAAI,oDAAoD,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/lib/action/recompose.d.ts

@@ -0,0 +1 @@
+export declare function runRecompose(): Promise<void>;

package/lib/action/recompose.js

@@ -0,0 +1,36 @@
+'use strict';
+import * as core from '@actions/core';
+import { recomposeMetadataTypes } from '../core/recomposeMetadataTypes.js';
+import { loadConfigFile, parseConfigSuffixes, resolveDefaultConfigPath, validateConfigManifest, } from '../helpers/configOverrides.js';
+import { multilineInput, optionalInput, requireMetadataTypesOrManifest } from './inputs.js';
+export async function runRecompose() {
+    let metadataTypes = multilineInput('metadata-type');
+    let manifest = optionalInput('manifest');
+    let ignoreDirs = multilineInput('ignore-package-directory');
+    let postpurge = core.getBooleanInput('postpurge');
+    if (core.getBooleanInput('config')) {
+        const config = await loadConfigFile(await resolveDefaultConfigPath());
+        metadataTypes ??= parseConfigSuffixes(config.metadataSuffixes);
+        const configManifest = !manifest ? config.manifest : undefined;
+        manifest ??= config.manifest;
+        ignoreDirs ??= parseConfigSuffixes(config.ignorePackageDirectories);
+        postpurge = postpurge || (config.postPurge ?? false);
+        manifest = await validateConfigManifest({
+            configManifest,
+            metadataTypes,
+            manifest,
+            warn: (msg) => core.warning(msg),
+        });
+    }
+    requireMetadataTypesOrManifest(metadataTypes, manifest);
+    const result = await recomposeMetadataTypes({
+        metadataTypes,
+        postpurge,
+        ignoreDirs,
+        manifest,
+        log: (msg) => core.info(msg),
+    });
+    core.setOutput('metadata', result.metadata.join('\n'));
+    core.setOutput('types-count', result.metadata.length);
+}
+//# sourceMappingURL=recompose.js.map

package/lib/action/recompose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recompose.js","sourceRoot":"","sources":["../../src/action/recompose.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAE5F,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,aAAa,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,UAAU,GAAG,cAAc,CAAC,0BAA0B,CAAC,CAAC;IAC5D,IAAI,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAElD,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,wBAAwB,EAAE,CAAC,CAAC;QACtE,aAAa,KAAK,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC/D,MAAM,cAAc,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC;QAC7B,UAAU,KAAK,mBAAmB,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACpE,SAAS,GAAG,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;QAErD,QAAQ,GAAG,MAAM,sBAAsB,CAAC;YACtC,cAAc;YACd,aAAa;YACb,QAAQ;YACR,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;QAC1C,aAAa;QACb,SAAS;QACT,UAAU;QACV,QAAQ;QACR,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC"}

package/lib/action/verify.d.ts

@@ -0,0 +1 @@
+export declare function runVerify(): Promise<void>;

package/lib/action/verify.js

@@ -0,0 +1,53 @@
+'use strict';
+import * as core from '@actions/core';
+import { verifyMetadataTypes } from '../core/verifyMetadataTypes.js';
+import { loadConfigFile, parseConfigSuffixes, resolveDefaultConfigPath, validateConfigManifest, } from '../helpers/configOverrides.js';
+import { multilineInput, optionalInput, requireMetadataTypesOrManifest } from './inputs.js';
+export async function runVerify() {
+    let metadataTypes = multilineInput('metadata-type');
+    let manifest = optionalInput('manifest');
+    let ignoreDirs = multilineInput('ignore-package-directory');
+    let format = optionalInput('format') ?? 'xml';
+    let strategy = optionalInput('strategy') ?? 'unique-id';
+    let decomposeNestedPerms = core.getBooleanInput('decompose-nested-permissions');
+    let overrides;
+    if (core.getBooleanInput('config')) {
+        const config = await loadConfigFile(await resolveDefaultConfigPath());
+        metadataTypes ??= parseConfigSuffixes(config.metadataSuffixes);
+        const configManifest = !manifest ? config.manifest : undefined;
+        manifest ??= config.manifest;
+        ignoreDirs ??= parseConfigSuffixes(config.ignorePackageDirectories);
+        format = optionalInput('format') ?? config.decomposedFormat ?? 'xml';
+        strategy = optionalInput('strategy') ?? config.strategy ?? 'unique-id';
+        decomposeNestedPerms = decomposeNestedPerms || (config.decomposeNestedPermissions ?? false);
+        overrides = config.overrides;
+        manifest = await validateConfigManifest({
+            configManifest,
+            metadataTypes,
+            manifest,
+            warn: (msg) => core.warning(msg),
+        });
+    }
+    requireMetadataTypesOrManifest(metadataTypes, manifest);
+    const result = await verifyMetadataTypes({
+        metadataTypes,
+        format,
+        ignoreDirs,
+        strategy,
+        decomposeNestedPerms,
+        manifest,
+        overrides,
+        log: (msg) => core.info(msg),
+    });
+    core.setOutput('metadata', result.metadata.join('\n'));
+    core.setOutput('types-count', result.metadata.length);
+    core.setOutput('drift-count', result.drift.length);
+    core.setOutput('reordered-count', result.reordered.length);
+    if (result.drift.length > 0) {
+        for (const { path, reason } of result.drift) {
+            core.error(`${path}: ${reason}`);
+        }
+        core.setFailed(`Round-trip verify failed: ${result.drift.length} file(s) drifted between the original tree and the round-tripped output. See the log above for the offending paths.`);
+    }
+}
+//# sourceMappingURL=verify.js.map

package/lib/action/verify.js.map

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

package/oclif.manifest.json

@@ -364,5 +364,5 @@
       ]
     }
   },
-  "version": "7.2.0"
+  "version": "7.3.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sf-decomposer",
   "description": "Decompose Salesforce metadata into granular, VCS-friendly files; recompose for deployment.",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "dependencies": {
     "@oclif/core": "4.13.5",
     "@salesforce/core": "9.1.2",
@@ -9,6 +9,7 @@
     "config-disassembler": "3.3.0"
   },
   "devDependencies": {
+    "@actions/core": "3.0.1",
     "@biomejs/biome": "2.5.9",
     "@commitlint/cli": "21.2.2",
     "@commitlint/config-conventional": "21.2.2",