@sfship/plugin-ship 1.0.0-beta.2

package/lib/core/tasks/git/release/create.d.ts

@@ -0,0 +1,42 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: ({
+        name: string;
+        type: "string";
+        required: true;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "string";
+        required: false;
+        default: string;
+        description: string;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        default: false;
+        description: string;
+    } | {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        default: true;
+        description: string;
+    })[];
+    outputs: {
+        name: string;
+        type: "string";
+        description: string;
+    }[];
+    run({ flow, params, output }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/git/release/create.js

@@ -0,0 +1,197 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/* eslint-disable camelcase */
+import { getGithubToken, normalizeRepo, gh, fetchFirstCommitSha, resolveCommitSha, } from '../../../service.github.js';
+import { resolveDependencies } from '../../../package.dependencies.js';
+import { ExpectedError } from '../../../error.js';
+function buildInstallInfo(versionId, prerelease) {
+    const lines = [
+        '## Installation Info',
+        '',
+        '**Sandbox & Scratch Orgs:**',
+        `https://test.salesforce.com/packaging/installPackage.apexp?p0=${versionId}`,
+    ];
+    if (!prerelease) {
+        lines.push('', '**Production & Developer Edition Orgs:**', `https://login.salesforce.com/packaging/installPackage.apexp?p0=${versionId}`);
+    }
+    return lines.join('\n');
+}
+export default {
+    description: 'Creates an annotated git tag carrying the package version metadata, then a GitHub release pointing to it. Inherits CumulusCI’s tag annotation format so consumers resolve the version through a single path.',
+    params: [
+        {
+            name: 'tag',
+            type: 'string',
+            required: true,
+            description: 'Tag name to create (e.g. "v1.2.3").',
+        },
+        {
+            name: 'version-id',
+            type: 'string',
+            required: true,
+            description: '04t SubscriberPackageVersionId to embed in the tag annotation.',
+        },
+        {
+            name: 'package-type',
+            type: 'string',
+            required: false,
+            default: '2GP',
+            description: 'Package type written into the annotation (e.g. 2GP, Unlocked, 1GP).',
+        },
+        {
+            name: 'prerelease',
+            type: 'boolean',
+            required: false,
+            default: false,
+            description: 'Mark the GitHub release as a prerelease.',
+        },
+        {
+            name: 'name',
+            type: 'string',
+            required: false,
+            description: 'Release name. Defaults to the tag.',
+        },
+        {
+            name: 'body',
+            type: 'string',
+            required: false,
+            description: 'Release body. When omitted, GitHub auto-generates notes from PRs and commits since the previous release. Pass any value (including an empty string) to opt out of auto-generation and use your own.',
+        },
+        {
+            name: 'install-link',
+            type: 'boolean',
+            required: false,
+            default: true,
+            description: 'Prepend a Salesforce package-install link section (test + login URLs for the 04t) to the release body. Defaults to true.',
+        },
+        {
+            name: 'target',
+            type: 'string',
+            required: false,
+            description: 'Commit SHA or branch to tag. Defaults to the repository’s default branch.',
+        },
+        {
+            name: 'repo-url',
+            type: 'string',
+            required: false,
+            description: 'GitHub repository URL. Falls back to config.project.git.repoUrl.',
+        },
+        {
+            name: 'github-alias',
+            type: 'string',
+            required: false,
+            default: 'default',
+            description: 'GitHub token alias.',
+        },
+    ],
+    outputs: [
+        {
+            name: 'tag',
+            type: 'string',
+            description: 'The created tag name.',
+        },
+        {
+            name: 'release-url',
+            type: 'string',
+            description: 'URL of the created GitHub release.',
+        },
+    ],
+    async run({ flow, params, output }) {
+        const tagName = params['tag'];
+        const versionId = params['version-id'];
+        const packageType = params['package-type'] ?? '2GP';
+        const prerelease = params['prerelease'] === true;
+        const releaseName = params['name'] ?? tagName;
+        const customBody = params['body'];
+        const generateReleaseNotes = customBody === undefined;
+        const installInfo = params['install-link'] !== false ? buildInstallInfo(versionId, prerelease) : '';
+        const releaseBody = [installInfo, customBody ?? ''].filter((s) => s.length > 0).join('\n\n');
+        const alias = String(params['github-alias'] ?? 'default');
+        const token = getGithubToken(alias);
+        if (!token) {
+            throw new ExpectedError(`No GitHub token found for alias "${alias}". Run: sf ship service connect github`);
+        }
+        const repoUrl = params['repo-url'] ?? flow.config.project.git?.repoUrl;
+        if (!repoUrl) {
+            throw new ExpectedError('No repo URL. Set config.project.git.repoUrl in ship.yml or pass --param repo-url=<url>.');
+        }
+        const repo = normalizeRepo(repoUrl);
+        const commitSha = await resolveCommitSha(params['target'], token, repo);
+        const depsForAnnotation = [];
+        const deps = flow.config.project.package?.dependencies ?? [];
+        if (deps.length > 0) {
+            flow.log('Resolving dependencies for tag annotation...');
+            const steps = await resolveDependencies(deps);
+            for (const step of steps) {
+                if (step.kind === 'package-id') {
+                    // eslint-disable-next-line camelcase
+                    depsForAnnotation.push({ version_id: step.versionId, package_name: step.name });
+                }
+            }
+        }
+        const tagMessage = [
+            `version_id: ${versionId}`,
+            `package_type: ${packageType}`,
+            `dependencies: ${JSON.stringify(depsForAnnotation)}`,
+        ].join('\n');
+        flow.log(`Creating annotated tag ${tagName} at ${commitSha.slice(0, 7)}...`);
+        const tagObj = await gh(token, `/repos/${repo}/git/tags`, {
+            method: 'POST',
+            body: {
+                tag: tagName,
+                message: tagMessage,
+                object: commitSha,
+                type: 'commit',
+                tagger: { name: 'plugin-ship', email: 'noreply@plugin-ship', date: new Date().toISOString() },
+            },
+        });
+        flow.log(`Creating tag reference refs/tags/${tagName}...`);
+        await gh(token, `/repos/${repo}/git/refs`, {
+            method: 'POST',
+            body: { ref: `refs/tags/${tagName}`, sha: tagObj.sha },
+        });
+        // For production releases, anchor auto-generated notes against the previous
+        // production release. If none exists, anchor against the first commit so notes
+        // span the full history rather than an arbitrary prerelease.
+        let previousTagName;
+        if (!prerelease && generateReleaseNotes) {
+            const releases = await gh(token, `/repos/${repo}/releases?per_page=30`);
+            const previousProd = releases.find((r) => !r.prerelease);
+            if (previousProd) {
+                previousTagName = previousProd.tag_name;
+            }
+            else {
+                const firstSha = await fetchFirstCommitSha(repo, token);
+                if (firstSha)
+                    previousTagName = firstSha;
+            }
+        }
+        flow.log(`Creating GitHub release ${tagName}...`);
+        const release = await gh(token, `/repos/${repo}/releases`, {
+            method: 'POST',
+            body: {
+                tag_name: tagName,
+                name: releaseName,
+                body: releaseBody,
+                prerelease,
+                generate_release_notes: generateReleaseNotes,
+                ...(previousTagName !== undefined ? { previous_tag_name: previousTagName } : {}),
+            },
+        });
+        flow.log(`Released: ${release.html_url}`);
+        output.set('tag', tagName);
+        output.set('release-url', release.html_url);
+    },
+};
+//# sourceMappingURL=create.js.map

package/lib/core/tasks/git/release/create.js.map

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

package/lib/core/tasks/git/release/fetch.d.ts

@@ -0,0 +1,24 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: ({
+        name: string;
+        type: "boolean";
+        required: false;
+        default: false;
+        description: string;
+    } | {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+        default?: undefined;
+    })[];
+    outputs: {
+        name: string;
+        type: "string";
+        description: string;
+    }[];
+    run({ flow, params, output }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/git/release/fetch.js

@@ -0,0 +1,93 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { fetchRelease, fetchGitTag, normalizeRepo } from '../../../service.github.js';
+import { ExpectedError } from '../../../error.js';
+export default {
+    description: 'Resolves a package version ID from the latest GitHub release or pre-release.',
+    params: [
+        {
+            name: 'prerelease',
+            type: 'boolean',
+            required: false,
+            default: false,
+            description: 'When true, resolves from the latest pre-release. When false (default), the latest production release.',
+        },
+        {
+            name: 'tag',
+            type: 'string',
+            required: false,
+            description: 'Specific release tag to resolve. Overrides prerelease.',
+        },
+        {
+            name: 'repo-url',
+            type: 'string',
+            required: false,
+            description: 'GitHub repository URL. Falls back to config.project.git.repoUrl.',
+        },
+    ],
+    outputs: [
+        {
+            name: 'version-id',
+            type: 'string',
+            description: 'The 04t SubscriberPackageVersionId from the release tag annotation.',
+        },
+        {
+            name: 'version-number',
+            type: 'string',
+            description: 'Full version number (e.g. "0.4.0.1"), derived from the tag name.',
+        },
+        {
+            name: 'version-base',
+            type: 'string',
+            description: 'Major.minor.patch portion only (e.g. "0.4.0").',
+        },
+        {
+            name: 'tag',
+            type: 'string',
+            description: 'The release tag name (e.g. "v0.4.0.1").',
+        },
+    ],
+    async run({ flow, params, output }) {
+        const repoUrl = params['repo-url'] ?? flow.config.project.git?.repoUrl;
+        if (!repoUrl) {
+            throw new ExpectedError('No repo URL. Set project.git.repoUrl in ship.yml or pass --param repo-url=<url>.');
+        }
+        const repo = normalizeRepo(repoUrl);
+        const prerelease = params['prerelease'] === true;
+        const tag = params['tag'];
+        const release = await fetchRelease(repo, tag, prerelease);
+        if (!release) {
+            throw new ExpectedError(`No ${prerelease ? 'pre-release' : 'production release'} found for ${repo}.`);
+        }
+        const gitTag = await fetchGitTag(repo, release.tagName);
+        if (!gitTag) {
+            throw new ExpectedError(`No release metadata found in tag ${release.tagName} for ${repo}.`);
+        }
+        const match = /version_id:\s*(\S+)/.exec(gitTag.message);
+        if (!match) {
+            throw new ExpectedError(`No version_id found in tag annotation for ${release.tagName}.`);
+        }
+        const versionId = match[1];
+        const rawVersion = release.tagName.replace(/^v/, '');
+        const parts = rawVersion.split('.');
+        flow.log(`Resolved ${repo} → ${rawVersion} (${versionId}) [${prerelease ? 'pre-release' : 'release'}]`);
+        output.set('version-id', versionId);
+        output.set('tag', release.tagName);
+        if (rawVersion)
+            output.set('version-number', rawVersion);
+        if (parts.length >= 3)
+            output.set('version-base', `${parts[0]}.${parts[1]}.${parts[2]}`);
+    },
+};
+//# sourceMappingURL=fetch.js.map

package/lib/core/tasks/git/release/fetch.js.map

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

package/lib/core/tasks/git/repo/info.d.ts

@@ -0,0 +1,12 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+    }[];
+    run({ flow, params }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/git/repo/info.js

@@ -0,0 +1,47 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { getGithubToken, normalizeRepo, fetchRepoInfo } from '../../../service.github.js';
+import { ExpectedError } from '../../../error.js';
+export default {
+    description: 'Fetches and logs basic repository info from the GitHub API.',
+    params: [
+        {
+            name: 'github-alias',
+            type: 'string',
+            required: false,
+            description: 'GitHub token alias. Defaults to "default".',
+        },
+        {
+            name: 'repo-url',
+            type: 'string',
+            required: false,
+            description: 'GitHub repository URL. Falls back to config.project.git.repoUrl.',
+        },
+    ],
+    async run({ flow, params }) {
+        const alias = String(params['github-alias'] ?? 'default');
+        const token = getGithubToken(alias);
+        if (!token)
+            throw new ExpectedError(`No GitHub token found for alias "${alias}". Run: sf ship service connect github`);
+        const repoUrl = params['repo-url'] ?? flow.config.project.git?.repoUrl;
+        if (!repoUrl)
+            throw new ExpectedError('No repo URL. Set config.project.git.repoUrl in ship.yml or pass --param repo-url=<url>.');
+        const data = await fetchRepoInfo(normalizeRepo(repoUrl), token);
+        flow.log(`Repo:            ${data.full_name}`);
+        flow.log(`Description:     ${data.description ?? '(none)'}`);
+        flow.log(`Default branch:  ${data.default_branch}`);
+        flow.log(`Visibility:      ${data.visibility}`);
+    },
+};
+//# sourceMappingURL=info.js.map

package/lib/core/tasks/git/repo/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../../../src/core/tasks/git/repo/info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAe;IACb,WAAW,EAAE,6DAA6D;IAC1E,MAAM,EAAE;QACN;YACE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,4CAA4C;SAC1D;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,kEAAkE;SAChF;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAe;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,aAAa,CAAC,oCAAoC,KAAK,wCAAwC,CAAC,CAAC;QAE7G,MAAM,OAAO,GAAI,MAAM,CAAC,UAAU,CAAwB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC;QAC/F,IAAI,CAAC,OAAO;YACV,MAAM,IAAI,aAAa,CACrB,yFAAyF,CAC1F,CAAC;QAEJ,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAEhE,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,WAAW,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;CACuB,CAAC"}

package/lib/core/tasks/metadata/deploy.d.ts

@@ -0,0 +1,12 @@
+import type { TaskContext } from '../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+    }[];
+    run({ flow, params }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/metadata/deploy.js

@@ -0,0 +1,39 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { resolve } from 'node:path';
+export default {
+    description: 'Deploys metadata to a target org using the Salesforce source deploy API.',
+    params: [
+        {
+            name: 'source-dir',
+            type: 'string',
+            required: false,
+            description: 'Path to the source directory to deploy. Defaults to "force-app".',
+        },
+        {
+            name: 'target-org',
+            type: 'string',
+            required: false,
+            description: 'Org alias or username to deploy to. Defaults to the SF CLI default target-org.',
+        },
+    ],
+    async run({ flow, params }) {
+        const sourceDir = resolve(process.cwd(), params['source-dir'] ?? 'force-app');
+        const alias = flow.orgs.resolveAlias(params['target-org']);
+        const orgArgs = alias !== undefined ? ['--target-org', alias] : [];
+        await flow.runCommand('project:deploy:start', ['--source-dir', sourceDir, ...orgArgs]);
+        flow.log('Deployed successfully.');
+    },
+};
+//# sourceMappingURL=deploy.js.map

package/lib/core/tasks/metadata/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../../src/core/tasks/metadata/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAe;IACb,WAAW,EAAE,0EAA0E;IACvF,MAAM,EAAE;QACN;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,kEAAkE;SAChF;QACD;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,gFAAgF;SAC9F;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAe;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAG,MAAM,CAAC,YAAY,CAAwB,IAAI,WAAW,CAAC,CAAC;QACtG,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAuB,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnE,MAAM,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACrC,CAAC;CACuB,CAAC"}

package/lib/core/tasks/org/assign/permsets.d.ts

@@ -0,0 +1,12 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+    }[];
+    run({ flow, params }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/org/assign/permsets.js

@@ -0,0 +1,54 @@
+import { ExpectedError } from '../../../error.js';
+import { withSuppressedStdout } from '../../../stdout.js';
+export default {
+    description: 'Assigns permission sets and/or permission set groups to a user. Defaults to the list in ship.yml under project.package.permsets.',
+    params: [
+        {
+            name: 'target-org',
+            type: 'string',
+            required: false,
+            description: 'Org alias or username. Defaults to the SF CLI default target-org.',
+        },
+        {
+            name: 'permsets',
+            type: 'string',
+            required: false,
+            description: 'Comma-separated permission set or permission set group API names. Defaults to project.package.permsets in ship.yml.',
+        },
+        {
+            name: 'username',
+            type: 'string',
+            required: false,
+            description: 'Username to assign to. Defaults to the org running user.',
+        },
+    ],
+    async run({ flow, params }) {
+        const alias = flow.orgs.resolveAlias(params['target-org']);
+        const namesParam = params['permsets'];
+        const names = namesParam
+            ? namesParam
+                .split(',')
+                .map((n) => n.trim())
+                .filter(Boolean)
+            : flow.config.project.package?.permsets ?? [];
+        if (names.length === 0) {
+            flow.log('No permission sets configured, skipping.');
+            return;
+        }
+        const argv = ['--json'];
+        if (alias !== undefined)
+            argv.push('--target-org', alias);
+        for (const name of names)
+            argv.push('--name', name);
+        if (params['username'])
+            argv.push('--on-behalf-of', params['username']);
+        const result = (await withSuppressedStdout(() => flow.runCommand('org:assign:permset', argv)));
+        // Reassigning perm sets reports as a failure, so we filter those out
+        const realFailures = (result.failures ?? []).filter((f) => !f.message.includes('Duplicate PermissionSetAssignment'));
+        if (realFailures.length > 0) {
+            throw new ExpectedError(`Failed to assign permission sets:\n${realFailures.map((f) => `  ${f.name}: ${f.message}`).join('\n')}`);
+        }
+        flow.log(`Assigned ${names.length} permission set(s) to ${alias ?? 'default org'}.`);
+    },
+};
+//# sourceMappingURL=permsets.js.map

package/lib/core/tasks/org/assign/permsets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permsets.js","sourceRoot":"","sources":["../../../../../src/core/tasks/org/assign/permsets.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAO1D,eAAe;IACb,WAAW,EACT,kIAAkI;IACpI,MAAM,EAAE;QACN;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,mEAAmE;SACjF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EACT,qHAAqH;SACxH;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,0DAA0D;SACxE;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAe;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAuB,CAAC,CAAC;QAEjF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAuB,CAAC;QAC5D,MAAM,KAAK,GAAG,UAAU;YACtB,CAAC,CAAC,UAAU;iBACP,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,OAAO,CAAC;YACpB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;QAEhD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAa,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,UAAU,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAW,CAAC,CAAC;QAElF,MAAM,MAAM,GAAG,CAAC,MAAM,oBAAoB,CAAC,GAAG,EAAE,CAC9C,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAC5C,CAAwB,CAAC;QAE1B,qEAAqE;QACrE,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAChE,CAAC;QACF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,aAAa,CACrB,sCAAsC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,yBAAyB,KAAK,IAAI,aAAa,GAAG,CAAC,CAAC;IACvF,CAAC;CACuB,CAAC"}

package/lib/core/tasks/org/create/scratch.d.ts

@@ -0,0 +1,36 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    outputs: ({
+        name: string;
+        type: "string";
+        description: string;
+    } | {
+        name: string;
+        type: "boolean";
+        description: string;
+    })[];
+    params: ({
+        name: string;
+        type: "string";
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+    } | {
+        name: string;
+        type: "number";
+        required: false;
+        description: string;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        description: string;
+    })[];
+    run({ flow, params, output }: TaskContext): Promise<void>;
+};
+export default _default;