sf-plugin-cms 0.1.0 → 0.3.0

package/README.md

@@ -32,40 +32,59 @@ For a sandbox or org that uses a custom login host, add `--instance-url <login-u
 
 ### Install the plugin
 
-The normal installation command for a published Salesforce CLI plugin will be:
+Install the plugin with Salesforce CLI:
 
 ```sh
 sf plugins install sf-plugin-cms
 ```
 
-This package is not currently documented as published to npm, so do not expect that command to work yet. For the current source-checkout workflow, run these commands from the repository's `sf-plugin-cms` directory:
+For contributor work or local development from a source checkout, run these commands from the repository's `sf-plugin-cms` directory:
 
 ```sh
-npm install --no-workspaces
+npm install
 npm run compile
 sf plugins link .
 ```
 
 Linked ESM plugins use the compiled files. Run `npm run compile` again after source changes, or keep `npm run compile -- --watch` running while developing.
 
-Confirm that the plugin loads without making an org request:
+Confirm that the plugin loads and inspect its frozen machine-contract capabilities without making an org request:
 
 ```sh
-sf cms info
+sf cms info --json
 ```
 
+Machine consumers should run this command first and select a mutually supported command-result major before invoking an org-backed operation.
+
 ## Command reference
 
+| Command | Details |
+|---|---|
+| `sf cms info` | [Plugin information](#sf-cms-info) |
+| `sf cms list workspace` | [List workspaces](#sf-cms-list-workspace) |
+| `sf cms get workspace` | [Get a workspace](#sf-cms-get-workspace) |
+| `sf cms list channel` | [List workspace channels](#sf-cms-list-channel) |
+| `sf cms get channel` | [Get a channel](#sf-cms-get-channel) |
+| `sf cms get content` | [Get content](#sf-cms-get-content) |
+| `sf cms get variant` | [Get a variant](#sf-cms-get-variant) |
+| `sf cms export workspace` | [Export a workspace](#sf-cms-export-workspace) |
+| `sf cms import workspace` | [Import a workspace](#sf-cms-import-workspace) |
+
 All org-backed commands require `--target-org <username-or-alias>` (short form `-o`). They use API version `67.0` by default; pass `--api-version <version>` only when you need to override it. Add `--json` for machine-readable Salesforce CLI output. Without `--json`, list commands print compact tables and get commands print formatted JSON records.
 
 ### `sf cms info`
 
-Checks that the plugin entrypoint loads. This is the safest first command because it does not contact an org.
+Returns the offline `sf-cms-info@1` capability envelope. This is the safest first command because it does not contact an org.
 
 ```sh
-sf cms info
+sf cms info --json
+sf cms info --contract-version 1 --json
 ```
 
+The result advertises command-result versions separately from compatible workspace-package manifest majors. It currently reports API `67.0` as both the default and sole tested version. Bulk export is implemented; external-reference correlation and import mapping remain experimental because only evidenced CMS reference kinds can be resolved. Installation alone does not prove org permissions or endpoint availability.
+
+`--contract-version <major>` defaults to `1`. Any unsupported major returns a `blocked` `sf-cms-info` envelope with diagnostic code `UNSUPPORTED_CONTRACT_VERSION` and exit `1`, without org access.
+
 ### `sf cms list workspace`
 
 Lists one bounded page of CMS workspaces. Use `--name-fragment` to filter workspace names, and use `--page` with `--page-size` to request a specific page.
@@ -156,27 +175,35 @@ Required selector: `--variant-id <id>`.
 
 ### `sf cms export workspace`
 
-Runs an experimental, read-only, best-effort export of the variants currently observed for one CMS workspace. The destination must not already exist. This output is not a complete or guaranteed backup.
+Runs an experimental, read-only, best-effort export of the variants currently observed for one CMS workspace or every workspace. This output is not a complete or guaranteed backup.
 
 ```sh
-sf cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export
-sf cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export --json
+sf cms export workspace --target-org my-org --workspace-name "Main Site"
+sf cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./custom-export --json
+sf cms export workspace --target-org my-org --all --workspace-type Marketing --output-dir ./cms --contract-version 1 --json
 ```
 
-Required flags:
+Choose either single or bulk mode:
+
+- Single mode requires exactly one of `--workspace-id <id>` or `--workspace-name <name>`. Name matching is exact but case-insensitive. Case-only or Unicode-normalization-equivalent duplicates are ambiguous. The canonical fetched workspace name is always used for the default folder, preserving its casing.
+- Bulk mode uses `--all`, which is mutually exclusive with both single selectors. Optional `--workspace-type Marketing|Content` is valid only with `--all`; input casing is ignored and output is normalized to `Marketing` or `Content`.
+
+In single mode, `--output-dir <path>` remains the exact new destination. When omitted, export writes to `./cms/<safe-canonical-workspace-name>`. In bulk mode, `--output-dir` is the parent directory and defaults to `./cms`; each workspace is written beneath it using the canonical fetched name. Safe segments preserve Unicode and case, replace path/control/Windows-invalid characters, and trim unsafe trailing dots or spaces.
 
-- `--workspace-id <id>`: CMS workspace content-space ID. The command validates that the returned workspace ID exactly matches this value before export begins.
-- `--output-dir <path>`: new destination directory for `manifest.json` and the exported `items/*.json` files. There is no overwrite option.
+Bulk mode performs a strict global preflight before the first workspace export: it enumerates until an empty page, canonicalizes every workspace by ID, validates IDs, names, and actual types, applies the optional type filter, sorts by canonical ID, checks the output parent and every destination, and rejects collisions after sanitization, Unicode normalization, and case folding. Any preflight failure creates no destinations and makes no export calls.
 
-Every service warning is emitted to stderr. Human output reports the destination and exported-versus-expected counts; `--json` suppresses that human summary and returns one clean structured result.
+After preflight, each workspace export remains atomic. Execution continues after individual failures. Manifest warnings count as successful exports. JSON and human modes both return the complete deterministic aggregate with discovered, selected, succeeded, and failed counts plus per-workspace status, manifest, or redacted single-line error. A partial execution sets a nonzero process exit code only after the aggregate is emitted.
+
+This bulk command is also the delegation target for tools such as `sf-plugin-mcnext` that need a complete CMS workspace handoff without duplicating CMS export logic; no `sf-plugin-mcnext` changes are required.
 
 Export layout:
 
 ```text
-cms-export/
-├── manifest.json
-└── items/
-    └── <variant-id>.json
+cms/
+└── Main Site/
+    ├── manifest.json
+    └── items/
+        └── <variant-id>.json
 ```
 
 `manifest.json` records the source workspace, search provenance, counts, warnings, rejected IDs, failed IDs, and the exact item-file mapping. Each item file contains one observed variant representation. Treat the package as best-effort evidence from that run, not as a guaranteed backup.
@@ -188,21 +215,21 @@ Plans or applies a create-only import from an export package. Dry-run is the def
 Safe dry run:
 
 ```sh
-sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms-export
-sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms-export --json
+sf cms import workspace --target-org my-org --workspace-name "Destination" --source-dir "./cms/Source"
+sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir "./cms/Source" --contract-version 1 --json
 ```
 
 Explicit apply:
 
 ```sh
-sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms-export --apply --report-dir ./cms-import-report
+sf cms import workspace --target-org my-org --workspace-name "Destination" --source-dir "./cms/Source" --apply --report-dir ./cms-import-report
 ```
 
 Required flags:
 
 - `--target-org <username-or-alias>`: explicit destination org; no implicit target is accepted.
-- `--workspace-id <id>`: exact destination CMS workspace content-space ID.
-- `--source-dir <path>`: existing export package containing `manifest.json` and exactly the mapped `items/*.json` files.
+- Exactly one destination selector: `--workspace-id <id>` or exact case-sensitive `--workspace-name <name>`. This identity is the destination and is independent of the source workspace recorded in the export manifest.
+- `--source-dir <path>`: existing source export package containing `manifest.json` and exactly the mapped `items/*.json` files. Its manifest identifies the source workspace only; it does not select the destination.
 
 Safety flags:
 
@@ -227,7 +254,7 @@ Import limitations and conflicts:
 - Every content group must contain exactly one variant matching the destination workspace's `defaultLanguage`. There is no primary-language fallback.
 - Child variants are created sequentially after their primary parent. There is no concurrency.
 - Media-specific migration is not supported.
-- The command does not publish or unpublish content; newly created records are expected to remain draft/unpublished.
+- The command does not change publication state; newly created records are expected to remain drafts.
 - `--allow-partial` accepts known source omissions but does not make the missing records recoverable.
 
 Recovery guidance:
@@ -254,14 +281,103 @@ Use `sf <command> --help` to inspect the installed command's current flags, for
 sf cms get content --help
 ```
 
+## Versioned machine contracts
+
+### Integration boundary and ownership
+
+The supported v0.3.0 integration boundary is the Salesforce CLI subprocess. A consumer such as an MCN orchestrator should:
+
+1. Run `sf cms info --json`, require the needed capability, and choose a mutually supported command-result major.
+2. Run bulk export or workspace import with `--contract-version 1 --json`.
+3. Consume the returned CMS mappings and rewrite only fields owned by that consumer.
+
+CMS owns CMS artifact identity, source-to-target CMS mappings, import ordering, and CMS-internal reference rewriting. Dependency discovery and closure are unavailable in v0.3.0: exports preserve only evidenced opaque identity inventory and do not expose dependency edges. Consumers must not inspect package payloads to reconstruct CMS identity, infer dependencies or mappings, or rewrite CMS-owned references. No public JavaScript API is part of v0.3.0; the CLI JSON boundary is sufficient and avoids a second integration surface.
+
+### Authoritative envelope
+
+`sf cms info --json`, aggregate `sf cms export workspace --all --json`, and `sf cms import workspace --json` return exactly these top-level fields:
+
+```json
+{
+  "contract": "<operation-contract>",
+  "contractVersion": "1.0.0",
+  "status": "success",
+  "metadata": {
+    "operation": "<cms.info|workspace.export.bulk|workspace.import>",
+    "plugin": { "name": "sf-plugin-cms", "version": "0.3.0" },
+    "apiVersion": "67.0"
+  },
+  "diagnostics": { "warnings": [], "errors": [] },
+  "provenance": {
+    "producer": "sf-plugin-cms",
+    "sourceOrgId": "<org-id-or-offline>",
+    "pluginVersion": "0.3.0",
+    "command": "sf cms <operation>",
+    "generatedAt": "<ISO-8601>"
+  },
+  "result": {}
+}
+```
+
+Statuses are `success`, `partial`, `failed`, or `blocked`. Diagnostics contain bounded, redacted entries shaped as `{ code, message, scope?, reference?, retryable? }`. `result` is `null` only when a failed or blocked command has no usable operation result. Aggregate export provenance additionally contains deterministic `exportSetId`.
+
+The `--contract-version <major>` flag selects the command envelope/result major and defaults to `1`; it does not select the independently declared package-manifest version. Unsupported command-result majors block with `UNSUPPORTED_CONTRACT_VERSION` before org access. Import also validates the package-declared manifest major before org access and blocks unsupported packages with `UNSUPPORTED_PACKAGE_VERSION`.
+
+### Exact operation results
+
+`sf-cms-info@1` reports plugin/API versions, supported command results, supported package manifests, result-to-manifest compatibility, and these capability IDs:
+
+- `workspace.export.bulk` — `implemented`, contract `sf-cms-workspace-export-set@1`.
+- `workspace.export.dependency-closure` — `unavailable`; v0.3.0 does not discover or traverse CMS relationships.
+- `workspace.export.external-reference-correlation` — `experimental`, embedded contract `sf-cms-external-reference-correlations@1`.
+- `workspace.import.mapping` — `experimental`, contract `sf-cms-workspace-import@1`.
+
+`sf-cms-workspace-export-set@1` contains `workspaceType`, a portable `outputDirectory`, selection and summary counts, `externalReferenceCorrelations`, and deterministic per-workspace entries. Workspace entries include canonical source identity, `success|partial|failed` status, relative artifact/manifest paths and hashes when finalized, and structured diagnostics. Any finalized omission or unresolved/unsupported reference makes that workspace and aggregate partial.
+
+The correlation table exists only at `result.externalReferenceCorrelations`. Each `sf-cms-external-reference-correlations@1` row has exactly five fields:
+
+```json
+{
+  "sourceWorkspaceId": "0Zu...",
+  "sourceReference": "<exact opaque value>",
+  "referenceKind": "cms.content",
+  "referenceId": "ref:<sha256>",
+  "packageManifestSha256": "<64 lowercase hex>"
+}
+```
+
+`sourceReference` is serialized unchanged and matched by exact string equality only—no trimming, case folding, decoding, hashing, or fuzzy matching. Rows bind to a canonical CMS reference, source workspace, and verified package manifest. Envelope provenance binds the entire set to its producer, source org, plugin version, and export-set identity. Duplicate or conflicting correlations block the contract. Unresolved and unsupported values appear only as diagnostics/references and never as correlation rows or resolved mappings.
+
+`sf-cms-workspace-import@1` contains the verified source package identity, explicit target org/workspace, integrity counts, deterministic mappings, and unresolved/unsupported references. A resolved mapping supplies `target.targetReference`; consumers must use that value rather than derive one from IDs. Rewriting is limited to the evidenced CMS-owned `contentBody.*.ref.contentKey` shape. `cmsReferencesRewritten: true` is reported only when every required target mapping was available before the outgoing mutation and inspection of the exact outgoing parent and variant payloads proves that no relevant source key remains. Forward, self, and unknown references stay unresolved or unsupported. Dry-run remains truthful and does not claim target resolution that requires a mutation.
+
+### Package layout and integrity
+
+A v1 workspace export package contains `manifest.json` plus regular item files. `manifest.json` is the sole package control file and the sole regular file excluded from `items[]`. Every other regular file must occur exactly once in `items[]`; directories are excluded, while symlinks and other special filesystem entries are rejected. Paths are relative POSIX-style paths.
+
+Each item records exactly `{ path, sha256, kind, referenceId? }`, with lowercase SHA-256 calculated over the finalized exact file bytes. Import independently validates the manifest major, enumerates the package, rejects missing, substituted, duplicate-path, or unlisted files, and verifies every item hash. Only after the listed set and hashes are verified does it hash the exact `manifest.json` bytes and use that hash as package identity.
+
+Opaque reference descriptors remain CMS-owned identity inventory. Their portable values must not be interpreted by consumers, and `dependencies` remains empty because relationship discovery is unavailable. Only evidenced kinds can be `included` or become resolved mappings; unresolved or unsupported relationship classes are emitted only when the exported payload actually contains that evidence. This experimental export proves only the artifacts observed during that run and is not a complete backup.
+
+### Exit codes and automation
+
+- Exit `0`: command-owned contract status `success`.
+- Exit `2`: contract status `partial`; usable aggregate/result data is still returned.
+- Exit `1`: command-owned status `failed` or `blocked`.
+- Salesforce CLI framework parse, configuration, or authentication failures can retain the framework's standard JSON/error shape and exit behavior; they are outside the command-result contract.
+
+Automation should parse stdout JSON and inspect the process exit code. It must not infer status by scraping stderr. Human and JSON modes report the same status, counts, and artifact paths.
+
 ## Development
 
 ```sh
 npm install --no-workspaces
+npm run lint:fix
 npm run lint
 npm run build
 npm run intake:check
+npm run generate:check
 npm test
+npm run validate:package
 ```
 
 ## Contributor notes: experimental workspace export
@@ -270,7 +386,9 @@ The experimental export uses the v67 `GET /connect/cms/items/search` operation.
 
 String-array query values such as `contentSpaceOrFolderIds` and `languages` are serialized as repeated keys. Pagination reconstructs each request from the original filters instead of trusting `nextPageUri`, which was observed to remain present after an empty page. Delivery responses do not prove workspace ownership and exclude drafts. SOQL omitted a known record that remained readable through Connect REST, and CMS `9Pu` folders exposed no child-enumeration operation, so none of those alternatives establishes a complete inventory.
 
-Current shipped export guards are deliberately narrow: one explicit workspace whose lookup ID must match exactly; zero-based paging with `pageSize=250`; at most 1,000 pages and no more than two pages beyond the advertised-count calculation; stop when the advertised count is reached, a page is empty, or a nonempty page adds no new IDs; deduplicate repeated variant IDs; verify `managedContentSpaceId` in search rows and `contentSpace.id` in variant details; record ownership rejections and detail failures; refuse an existing destination; write stable JSON to a temporary sibling directory; remove staging after failure; and rename staging only after all output is written. The command emits all recorded warnings, prints only a compact human summary outside JSON mode, and returns one structured result in JSON mode.
+Current shipped export guards include an explicit single-workspace mode and a strict bulk preflight. Workspace enumeration is zero-based with `pageSize=250`, deduplicates exact IDs, ignores advertised totals as a termination signal, and continues until an empty page. It fails closed on repeated pages, no progress, malformed IDs, case/Unicode-equivalent IDs, or the 1,000-page cap. Bulk preflight canonicalizes every workspace with a GET, validates canonical ID, name, and `spaceType`, filters by actual type, sorts by canonical ID, and rejects unsafe or colliding destinations before any export starts.
+
+Per-workspace variant export remains atomic and best-effort: it verifies `managedContentSpaceId` in search rows and `contentSpace.id` in variant details, records ownership rejections and detail failures, refuses an existing destination, writes stable JSON to a temporary sibling directory, removes staging after failure, and renames staging only after all output is written. Bulk execution continues across workspace failures and emits a deterministic complete aggregate in both human and JSON modes.
 
 For every API-version upgrade, recheck the operation path and required parameters, wildcard behavior, repeated-key serialization, inventory counts and statuses, empty-page/`nextPageUri` behavior, both ownership fields, draft visibility, delivery coverage, SOQL parity, folder enumeration, duplicate-page handling, and all stop conditions before retaining export support.
 

package/lib/{commands/cms/command-base.d.ts → command-base.d.ts}

@@ -1,11 +1,12 @@
 import { Org } from '@salesforce/core';
 import { SfCommand } from '@salesforce/sf-plugins-core';
-import type { CmsPage, CmsRecord } from '../../services/read.js';
+import type { CmsPage, CmsRecord } from './services/read.js';
 export declare const targetOrgFlag: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
 export declare const apiVersionFlag: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
 export declare const pageFlag: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
 export declare const pageSizeFlag: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
 export declare abstract class CmsCommand<T> extends SfCommand<T> {
+    protected toSuccessJson(result: T): SfCommand.Json<T>;
     protected getConnection(targetOrg: string, apiVersion: string): Promise<ReturnType<Org['getConnection']>>;
     protected getOrgContext(targetOrg: string, apiVersion: string): Promise<{
         connection: ReturnType<Org['getConnection']>;

package/lib/{commands/cms/command-base.js → command-base.js}

@@ -12,6 +12,9 @@ export const apiVersionFlag = Flags.orgApiVersion({
 export const pageFlag = Flags.integer({ min: 0, summary: 'Zero-based page number.' });
 export const pageSizeFlag = Flags.integer({ min: 1, summary: 'Maximum items requested per page.' });
 export class CmsCommand extends SfCommand {
+    toSuccessJson(result) {
+        return result;
+    }
     async getConnection(targetOrg, apiVersion) {
         const context = await this.getOrgContext(targetOrg, apiVersion);
         return context.connection;

package/lib/command-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-base.js","sourceRoot":"","sources":["../src/command-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG/D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,iDAAiD;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC;IAChD,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,+CAA+C;CACzD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;AAEpG,MAAM,OAAgB,UAAc,SAAQ,SAAY;IAC5C,aAAa,CAAC,MAAS;QAC/B,OAAO,MAA2B,CAAC;IACrC,CAAC;IACS,KAAK,CAAC,aAAa,CAC3B,SAAiB,EACjB,UAAkB;QAElB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,SAAiB,EACjB,UAAkB;QAElB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9E,CAAC;IAES,QAAQ,CAAC,KAAa,EAAE,IAAa;QAC7C,IAAI,CAAC,KAAK,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;gBAC3B,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;gBAC7D,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YACH,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAES,UAAU,CAAC,MAAiB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;CACF;AAED,SAAS,WAAW,CAAC,MAAiB,EAAE,GAAW;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/lib/commands/cms/export/workspace.d.ts

@@ -1,14 +1,22 @@
+import { type WorkspaceExportSetResult } from '../../../contracts/workspace-export.js';
+import { type CmsEnvelope } from '../../../contracts/shared.js';
 import { type ExportWorkspaceResult } from '../../../services/export-workspace.js';
-import { CmsCommand } from '../command-base.js';
-export default class ExportWorkspace extends CmsCommand<ExportWorkspaceResult> {
-    static readonly summary = "Experimentally export a CMS workspace using a read-only, best-effort process.";
-    static readonly description = "Reads a Marketing Cloud CMS workspace and writes the variants observed by an experimental, best-effort search. This is not a complete or guaranteed backup and does not mutate org data.";
+import { CmsCommand } from '../../../command-base.js';
+type WorkspaceExportCommandResult = CmsEnvelope<WorkspaceExportSetResult> | ExportWorkspaceResult;
+export default class ExportWorkspace extends CmsCommand<WorkspaceExportCommandResult> {
+    static readonly summary = "Experimentally export one or all CMS workspaces using a read-only, best-effort process.";
+    static readonly description = "Experimentally exports one Marketing Cloud CMS workspace selected by exact ID or case-insensitive exact name, or preflights and exports all workspaces under a parent directory. Canonical fetched names and casing are preserved. Bulk preflight is global and strict; execution then continues across individual failures and returns a complete aggregate. This is not a complete or guaranteed backup and does not mutate org data.";
     static readonly examples: string[];
     static readonly flags: {
         'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'api-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'workspace-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'output-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'contract-version': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'workspace-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'workspace-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'workspace-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<ExportWorkspaceResult>;
+    run(): Promise<WorkspaceExportCommandResult>;
 }
+export {};

package/lib/commands/cms/export/workspace.js

@@ -1,31 +1,103 @@
 import { Flags } from '@salesforce/sf-plugins-core';
-import { exportWorkspace, } from '../../../services/export-workspace.js';
-import { getWorkspace } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+import { assertWorkspaceExportSetResult, } from '../../../contracts/workspace-export.js';
+import { assertSupportedMajor } from '../../../contracts/shared.js';
+import { exportAllWorkspaces, normalizeWorkspaceType, } from '../../../services/bulk-export-workspaces.js';
+import { defaultWorkspaceDestination, exportWorkspace, } from '../../../services/export-workspace.js';
+import { assertWorkspaceSelector, resolveWorkspace } from '../../../services/resolve-workspace.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../../../command-base.js';
 export default class ExportWorkspace extends CmsCommand {
-    static summary = 'Experimentally export a CMS workspace using a read-only, best-effort process.';
-    static description = 'Reads a Marketing Cloud CMS workspace and writes the variants observed by an experimental, best-effort search. This is not a complete or guaranteed backup and does not mutate org data.';
+    static summary = 'Experimentally export one or all CMS workspaces using a read-only, best-effort process.';
+    static description = 'Experimentally exports one Marketing Cloud CMS workspace selected by exact ID or case-insensitive exact name, or preflights and exports all workspaces under a parent directory. Canonical fetched names and casing are preserved. Bulk preflight is global and strict; execution then continues across individual failures and returns a complete aggregate. This is not a complete or guaranteed backup and does not mutate org data.';
     static examples = [
+        '<%= config.bin %> cms export workspace --target-org my-org --workspace-name "Main Site"',
         '<%= config.bin %> cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export',
+        '<%= config.bin %> cms export workspace --target-org my-org --all --workspace-type Marketing --output-dir ./cms --contract-version 1 --json',
     ];
     static flags = {
         'target-org': targetOrgFlag,
         'api-version': apiVersionFlag,
-        'workspace-id': Flags.string({ required: true, summary: 'CMS workspace content-space ID.' }),
+        'contract-version': Flags.integer({
+            default: 1,
+            min: 1,
+            summary: 'Machine contract major version (supported: 1).',
+        }),
+        all: Flags.boolean({
+            exclusive: ['workspace-id', 'workspace-name'],
+            summary: 'Export every CMS workspace after a strict global preflight.',
+        }),
+        'workspace-id': Flags.string({
+            exclusive: ['all', 'workspace-name'],
+            summary: 'Exact CMS workspace content-space ID.',
+        }),
+        'workspace-name': Flags.string({
+            exclusive: ['all', 'workspace-id'],
+            summary: 'Exact case-insensitive CMS workspace name.',
+        }),
+        'workspace-type': Flags.string({
+            dependsOn: ['all'],
+            parse: async (input) => normalizeWorkspaceType(input),
+            summary: 'Bulk-only workspace type filter: Marketing or Content (case-insensitive).',
+        }),
         'output-dir': Flags.directory({
             exists: false,
-            required: true,
-            summary: 'New directory to receive the experimental best-effort export.',
+            summary: 'Single: exact new destination. Bulk: parent directory. Defaults to ./cms/<name> or ./cms.',
         }),
     };
     async run() {
         const { flags } = await this.parse(ExportWorkspace);
+        const isBulk = flags.all === true;
+        const contractVersion = flags['contract-version'] ?? 1;
+        if (contractVersion !== 1) {
+            const blocked = blockedEnvelope(contractVersion, flags['api-version']);
+            if (!this.jsonEnabled())
+                this.styledJSON(blocked);
+            process.exitCode = 1;
+            return blocked;
+        }
+        if (isBulk)
+            assertSupportedMajor(contractVersion);
+        if (!isBulk) {
+            assertWorkspaceSelector({
+                workspaceId: flags['workspace-id'],
+                workspaceName: flags['workspace-name'],
+            });
+            if (flags['workspace-type'] !== undefined) {
+                throw new Error('--workspace-type is valid only with --all.');
+            }
+        }
+        if (isBulk) {
+            const { connection, orgId } = await this.getOrgContext(flags['target-org'], flags['api-version']);
+            const workspaceType = normalizeWorkspaceType(flags['workspace-type'] ?? 'Marketing');
+            const result = await exportAllWorkspaces(connection, flags['output-dir'] ?? './cms', workspaceType, {
+                apiVersion: flags['api-version'],
+                pluginVersion: '0.3.0',
+                sourceOrgId: orgId,
+            });
+            assertWorkspaceExportSetResult(result.result, result.provenance);
+            if (!this.jsonEnabled())
+                this.styledJSON(result);
+            if (result.status === 'success')
+                process.exitCode = 0;
+            else if (result.status === 'partial')
+                process.exitCode = 2;
+            else
+                process.exitCode = 1;
+            return result;
+        }
         const connection = await this.getConnection(flags['target-org'], flags['api-version']);
-        const workspace = await getWorkspace(connection, flags['workspace-id']);
-        if (workspace.id !== flags['workspace-id']) {
-            throw new Error(`Workspace validation returned ID ${String(workspace.id)} instead of requested ID ${flags['workspace-id']}.`);
+        const selected = await resolveWorkspace(connection, {
+            workspaceId: flags['workspace-id'],
+            workspaceName: flags['workspace-name'],
+        });
+        let destination = flags['output-dir'];
+        if (destination === undefined) {
+            const workspaceName = selected.workspace.name;
+            if (typeof workspaceName !== 'string' || workspaceName.length === 0) {
+                throw new Error('Selected workspace has no usable name. Pass --output-dir explicitly.');
+            }
+            destination = defaultWorkspaceDestination(workspaceName);
         }
-        const result = await exportWorkspace(connection, flags['workspace-id'], flags['output-dir']);
+        const result = await exportWorkspace(connection, selected.id, destination);
         for (const warning of result.manifest.warnings)
             this.warn(formatWarning(warning));
         if (!this.jsonEnabled()) {
@@ -35,6 +107,36 @@ export default class ExportWorkspace extends CmsCommand {
         return result;
     }
 }
+function blockedEnvelope(requestedVersion, apiVersion) {
+    return {
+        contract: 'sf-cms-workspace-export-set',
+        contractVersion: '1.0.0',
+        status: 'blocked',
+        metadata: {
+            operation: 'workspace.export.bulk',
+            plugin: { name: 'sf-plugin-cms', version: '0.3.0' },
+            apiVersion,
+        },
+        diagnostics: {
+            warnings: [],
+            errors: [
+                {
+                    code: 'UNSUPPORTED_CONTRACT_VERSION',
+                    message: `Contract major ${requestedVersion} is unsupported; supported major is 1.`,
+                    retryable: false,
+                },
+            ],
+        },
+        provenance: {
+            producer: 'sf-plugin-cms',
+            sourceOrgId: 'unresolved-org',
+            pluginVersion: '0.3.0',
+            command: 'sf cms export workspace',
+            generatedAt: new Date().toISOString(),
+        },
+        result: null,
+    };
+}
 function formatWarning(warning) {
     const variantIds = warning.variantIds?.length ? ` (${warning.variantIds.join(', ')})` : '';
     return `[${warning.code}] ${warning.message}${variantIds}`;

package/lib/commands/cms/export/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/export/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EACL,eAAe,GAGhB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,UAAiC;IACrE,MAAM,CAAU,OAAO,GAC5B,+EAA+E,CAAC;IAC3E,MAAM,CAAU,WAAW,GAChC,0LAA0L,CAAC;IACtL,MAAM,CAAU,QAAQ,GAAG;QAChC,4GAA4G;KAC7G,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;QAC5F,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,+DAA+D;SACzE,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QACxE,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,4BAA4B,KAAK,CAAC,cAAc,CAAC,GAAG,CAC7G,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7F,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QAElF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,CACN,sBAAsB,MAAM,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,WAAW,CAChG,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;;AAGH,SAAS,aAAa,CAAC,OAA+B;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,UAAU,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/export/workspace.ts"],"names":[],"mappings":"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"}

package/lib/commands/cms/get/channel.d.ts

@@ -1,5 +1,5 @@
 import { type CmsRecord } from '../../../services/read.js';
-import { CmsCommand } from '../command-base.js';
+import { CmsCommand } from '../../../command-base.js';
 export default class GetChannel extends CmsCommand<CmsRecord> {
     static readonly summary = "Get a CMS channel.";
     static readonly description = "Retrieves a channel by its identifier.";

package/lib/commands/cms/get/channel.js

@@ -1,6 +1,6 @@
 import { Flags } from '@salesforce/sf-plugins-core';
 import { getChannel } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../../../command-base.js';
 export default class GetChannel extends CmsCommand {
     static summary = 'Get a CMS channel.';
     static description = 'Retrieves a channel by its identifier.';

package/lib/commands/cms/get/channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,oBAAoB,CAAC;IAC/C,MAAM,CAAU,WAAW,GAAG,wCAAwC,CAAC;IACvE,MAAM,CAAU,QAAQ,GAAG;QAChC,2EAA2E;KAC5E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KACnF,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErF,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,oBAAoB,CAAC;IAC/C,MAAM,CAAU,WAAW,GAAG,wCAAwC,CAAC;IACvE,MAAM,CAAU,QAAQ,GAAG;QAChC,2EAA2E;KAC5E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KACnF,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/cms/get/content.d.ts

@@ -1,5 +1,5 @@
 import { type CmsRecord } from '../../../services/read.js';
-import { CmsCommand } from '../command-base.js';
+import { CmsCommand } from '../../../command-base.js';
 export default class GetContent extends CmsCommand<CmsRecord> {
     static readonly summary = "Get CMS content.";
     static readonly description = "Retrieves content by its key or identifier.";

package/lib/commands/cms/get/content.js

@@ -1,6 +1,6 @@
 import { Flags } from '@salesforce/sf-plugins-core';
 import { getContent } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../../../command-base.js';
 export default class GetContent extends CmsCommand {
     static summary = 'Get CMS content.';
     static description = 'Retrieves content by its key or identifier.';

package/lib/commands/cms/get/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,kBAAkB,CAAC;IAC7C,MAAM,CAAU,WAAW,GAAG,6CAA6C,CAAC;IAC5E,MAAM,CAAU,QAAQ,GAAG;QAChC,uFAAuF;KACxF,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC;YAChC,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,gCAAgC;SAC1C,CAAC;QACF,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QACzE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;QACjE,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QACzE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;KACjE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE;YACtE,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC;YACxC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErF,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,kBAAkB,CAAC;IAC7C,MAAM,CAAU,WAAW,GAAG,6CAA6C,CAAC;IAC5E,MAAM,CAAU,QAAQ,GAAG;QAChC,uFAAuF;KACxF,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC;YAChC,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,gCAAgC;SAC1C,CAAC;QACF,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QACzE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;QACjE,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QACzE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;KACjE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE;YACtE,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC;YACxC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/cms/get/variant.d.ts

@@ -1,5 +1,5 @@
 import { type CmsRecord } from '../../../services/read.js';
-import { CmsCommand } from '../command-base.js';
+import { CmsCommand } from '../../../command-base.js';
 export default class GetVariant extends CmsCommand<CmsRecord> {
     static readonly summary = "Get a CMS content variant.";
     static readonly description = "Retrieves a content variant by its identifier.";

package/lib/commands/cms/get/variant.js

@@ -1,6 +1,6 @@
 import { Flags } from '@salesforce/sf-plugins-core';
 import { getVariant } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../../../command-base.js';
 export default class GetVariant extends CmsCommand {
     static summary = 'Get a CMS content variant.';
     static description = 'Retrieves a content variant by its identifier.';

package/lib/commands/cms/get/variant.js.map

@@ -1 +1 @@
-{"version":3,"file":"variant.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/variant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,4BAA4B,CAAC;IACvD,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAC;IAC/E,MAAM,CAAU,QAAQ,GAAG;QAChC,2EAA2E;KAC5E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;KAC3F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"variant.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/variant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErF,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,4BAA4B,CAAC;IACvD,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAC;IAC/E,MAAM,CAAU,QAAQ,GAAG;QAChC,2EAA2E;KAC5E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;KAC3F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/cms/get/workspace.d.ts

@@ -1,5 +1,5 @@
 import { type CmsRecord } from '../../../services/read.js';
-import { CmsCommand } from '../command-base.js';
+import { CmsCommand } from '../../../command-base.js';
 export default class GetWorkspace extends CmsCommand<CmsRecord> {
     static readonly summary = "Get a Marketing Cloud CMS workspace.";
     static readonly description = "Retrieves one CMS workspace by its content-space ID.";

package/lib/commands/cms/get/workspace.js

@@ -1,6 +1,6 @@
 import { Flags } from '@salesforce/sf-plugins-core';
 import { getWorkspace } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../../../command-base.js';
 export default class GetWorkspace extends CmsCommand {
     static summary = 'Get a Marketing Cloud CMS workspace.';
     static description = 'Retrieves one CMS workspace by its content-space ID.';