npm - @simplysf/simply-project - Versions diffs - 1.3.1 → 1.4.0 - Mend

@simplysf/simply-project 1.3.1 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +94 -2
package/lib/commands/simply/project/release/create.d.ts +30 -0
package/lib/commands/simply/project/release/create.js +133 -0
package/lib/commands/simply/project/release/create.js.map +1 -0
package/messages/simply.project.release.create.md +134 -0
package/oclif.manifest.json +183 -1
package/package.json +6 -4

package/README.md CHANGED Viewed

@@ -20,9 +20,101 @@ This package is part of the [`@simplysf/simply`](https://github.com/SimplySF/sim
 <!-- commands -->
+- [`sf simply project release create`](#sf-simply-project-release-create)
 - [`sf simply project release roll-forward`](#sf-simply-project-release-roll-forward)
 - [`sf simply project update api-version`](#sf-simply-project-update-api-version)
+## `sf simply project release create`
+Cut the next release branch, with its version bumped in sfdx-project.json.
+```
+USAGE
+  $ sf simply project release create [--json] [--flags-dir <value>] [-t major|minor|patch] [--source <value>]
+    [--package-release-branch-prefix <value>] [--remote <value>] [--message <value>] [--create-release] [--release-tag
+    <value>] [-s] [--vcs-provider gitlab|github] [--vcs-host <value>] [--vcs-project-id <value>] [--vcs-token <value>]
+    [--dry-run] [--no-prompt]
+FLAGS
+  -s, --set-default                            Make the new branch the project's default branch after pushing.
+  -t, --type=<option>                          Version to bump: major, minor, or patch. Asked for when omitted in a
+                                               terminal.
+                                               <options: major|minor|patch>
+      --create-release                         Publish a GitLab or GitHub release for the source's version before
+                                               cutting.
+      --dry-run                                Print the plan, including the tag a release would use, without changing
+                                               anything.
+      --message=<value>                        Commit message template, with an optional {VERSION} placeholder. Defaults
+                                               to "chore: bump version to {VERSION}".
+      --no-prompt                              Don't ask for confirmation, or for --type.
+      --package-release-branch-prefix=<value>  [default: release/] Prefix identifying release branches. Branch names
+                                               must then be `[v]MAJOR.MINOR[.PATCH]`.
+      --release-tag=<value>                    Tag to publish the release from, instead of the latest build tag. Implies
+                                               --create-release.
+      --remote=<value>                         [default: origin] Remote holding the release branches.
+      --source=<value>                         Release branch to cut from. Defaults to the current branch.
+      --vcs-host=<value>                       VCS hostname, for a self-hosted instance. Defaults to SIMPLY_VCS_HOST,
+                                               then vcs.host in .sfdevrc.json.
+      --vcs-project-id=<value>                 GitLab project ID or GitHub owner/repo. Defaults to
+                                               SIMPLY_VCS_PROJECT_ID, then vcs.projectId in .sfdevrc.json.
+      --vcs-provider=<option>                  VCS platform. Defaults to SIMPLY_VCS_PROVIDER, then vcs.provider in
+                                               .sfdevrc.json, then gitlab.
+                                               <options: gitlab|github>
+      --vcs-token=<value>                      [env: SIMPLY_VCS_TOKEN] VCS API token, needed only with --create-release,
+                                               --release-tag, or --set-default.
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+DESCRIPTION
+  Cut the next release branch, with its version bumped in sfdx-project.json.
+  Run this from a local clone, on the release branch to cut from, or pass `--source`. The new branch, such as
+  `release/v1.3.0` from `release/v1.2.0`, starts from the remote's copy of the source, never from local commits, and
+  gets one commit that bumps `sfdx-project.json`: `versionNumber` becomes `1.3.0.NEXT` in every package directory on the
+  source's version, and the version inside `versionName` is replaced in place. Then the branch is pushed. A version that
+  already has a branch is refused. A patch on an older line is allowed while newer releases exist, for hotfixes.
+  With `--create-release`, a GitLab or GitHub release for the version being closed out is published first, from the
+  highest `v<version>.<build>` tag that is reachable from the source and on the remote. Fallback tags are skipped. A
+  release that already exists is reported, not recreated. With `--set-default`, the new branch becomes the project's
+  default after the push. Both need a token, from `--vcs-token` or `SIMPLY_VCS_TOKEN`, and a project ID, from
+  `--vcs-project-id`, `SIMPLY_VCS_PROJECT_ID`, or `vcs.projectId` in `.sfdevrc.json`. These are checked before anything
+  changes.
+  Your repository's commit hooks always run. The default commit message is `chore: bump version to {VERSION}`; use
+  `--message` if your rules need something else, such as a ticket number. If a hook rejects the commit, nothing is
+  pushed, and the bump stays staged on the new local branch. Run `git commit` with an accepted message, then run this
+  command again from that branch.
+  The command never force-pushes or pushes tags. Pushing the new branch triggers a normal release-branch build, which
+  creates the new release's first package version.
+EXAMPLES
+  Cut the next minor release from the current release branch:
+    $ sf simply project release create --type minor
+  See what would happen, without changing anything:
+    $ sf simply project release create --type minor --dry-run
+  Cut a hotfix from an older release:
+    $ sf simply project release create --type patch --source release/v1.2.0
+  Also publish a release for the current version and make the new branch the default:
+    $ sf simply project release create --type minor --create-release --set-default
+  Use a commit message your repository's rules accept:
+    $ sf simply project release create --type minor --message "chore: PROJ-123 bump version to {VERSION}"
+```
+_See code: [lib/commands/simply/project/release/create.js](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-project@1.4.0/packages/simply-project/lib/commands/simply/project/release/create.js)_
 ## `sf simply project release roll-forward`
 Merge each release branch into the next higher one, keeping version tags in the target's history.
@@ -97,7 +189,7 @@ EXAMPLES
     $ sf simply project release roll-forward --no-push
 ```
-_See code: [lib/commands/simply/project/release/roll-forward.js](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-project@1.3.1/packages/simply-project/lib/commands/simply/project/release/roll-forward.js)_
+_See code: [lib/commands/simply/project/release/roll-forward.js](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-project@1.4.0/packages/simply-project/lib/commands/simply/project/release/roll-forward.js)_
 ## `sf simply project update api-version`
@@ -136,7 +228,7 @@ FLAG DESCRIPTIONS
     The path to the Salesforce project directory to scan for metadata files.
 ```
-_See code: [lib/commands/simply/project/update/api-version.js](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-project@1.3.1/packages/simply-project/lib/commands/simply/project/update/api-version.js)_
+_See code: [lib/commands/simply/project/update/api-version.js](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-project@1.4.0/packages/simply-project/lib/commands/simply/project/update/api-version.js)_
 <!-- commandsstop -->
 ## License

package/lib/commands/simply/project/release/create.d.ts ADDED Viewed

@@ -0,0 +1,30 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type CreateReleaseResult, type ReleaseType } from '@simplysf/simply-project-core';
+export type ProjectReleaseCreateResult = CreateReleaseResult;
+/** Cuts the next release branch, and optionally publishes a release and sets the default branch. */
+export default class ProjectReleaseCreate extends SfCommand<ProjectReleaseCreateResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly enableJsonFlag = true;
+    static readonly flags: {
+        type: import("@oclif/core/interfaces").OptionFlag<ReleaseType | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'package-release-branch-prefix': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        remote: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'create-release': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'release-tag': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'set-default': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'vcs-provider': import("@oclif/core/interfaces").OptionFlag<"gitlab" | "github" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'vcs-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'vcs-project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'vcs-token': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-prompt': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'flags-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ProjectReleaseCreateResult>;
+    protected promptForType(): Promise<ReleaseType>;
+    private confirmPlan;
+}

package/lib/commands/simply/project/release/create.js ADDED Viewed

@@ -0,0 +1,133 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * 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 { select } from '@inquirer/prompts';
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { VCS_PROVIDER_KINDS } from '@simplysf/simply-core';
+import { createRelease, RELEASE_TYPES, resolveReleaseVcs, } from '@simplysf/simply-project-core';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@simplysf/simply-project', 'simply.project.release.create');
+/** Cuts the next release branch, and optionally publishes a release and sets the default branch. */
+export default class ProjectReleaseCreate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static enableJsonFlag = true;
+    static flags = {
+        ...SfCommand.baseFlags,
+        type: Flags.custom({ options: [...RELEASE_TYPES] })({
+            char: 't',
+            summary: messages.getMessage('flags.type.summary'),
+        }),
+        source: Flags.string({ summary: messages.getMessage('flags.source.summary') }),
+        'package-release-branch-prefix': Flags.string({
+            summary: messages.getMessage('flags.package-release-branch-prefix.summary'),
+            default: 'release/',
+        }),
+        remote: Flags.string({ summary: messages.getMessage('flags.remote.summary'), default: 'origin' }),
+        message: Flags.string({ summary: messages.getMessage('flags.message.summary') }),
+        'create-release': Flags.boolean({ summary: messages.getMessage('flags.create-release.summary'), default: false }),
+        'release-tag': Flags.string({ summary: messages.getMessage('flags.release-tag.summary') }),
+        'set-default': Flags.boolean({
+            char: 's',
+            summary: messages.getMessage('flags.set-default.summary'),
+            default: false,
+        }),
+        'vcs-provider': Flags.custom({ options: [...VCS_PROVIDER_KINDS] })({
+            summary: messages.getMessage('flags.vcs-provider.summary'),
+        }),
+        'vcs-host': Flags.string({ summary: messages.getMessage('flags.vcs-host.summary') }),
+        'vcs-project-id': Flags.string({ summary: messages.getMessage('flags.vcs-project-id.summary') }),
+        'vcs-token': Flags.string({ summary: messages.getMessage('flags.vcs-token.summary'), env: 'SIMPLY_VCS_TOKEN' }),
+        'dry-run': Flags.boolean({ summary: messages.getMessage('flags.dry-run.summary'), default: false }),
+        'no-prompt': Flags.boolean({ summary: messages.getMessage('flags.no-prompt.summary'), default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProjectReleaseCreate);
+        const interactive = !flags['no-prompt'] && !flags['dry-run'] && !this.jsonEnabled();
+        const type = flags.type ?? (interactive ? await this.promptForType() : undefined);
+        if (!type) {
+            this.error(messages.getMessage('error.typeRequired'));
+        }
+        const wantsVcs = flags['create-release'] || flags['release-tag'] !== undefined || flags['set-default'];
+        const vcs = wantsVcs
+            ? resolveReleaseVcs({
+                provider: flags['vcs-provider'],
+                host: flags['vcs-host'],
+                projectId: flags['vcs-project-id'],
+                token: flags['vcs-token'],
+                warn: (message) => this.warn(message),
+            })
+            : undefined;
+        const result = await createRelease({
+            type,
+            source: flags.source,
+            packageReleaseBranchPrefix: flags['package-release-branch-prefix'],
+            remote: flags.remote,
+            message: flags.message,
+            createRelease: flags['create-release'],
+            releaseTag: flags['release-tag'],
+            setDefault: flags['set-default'],
+            vcs,
+            dryRun: flags['dry-run'],
+            confirm: interactive ? (plan) => this.confirmPlan(plan) : undefined,
+        });
+        this.table({
+            title: messages.getMessage('tableTitle'),
+            data: [
+                { field: 'Source', value: result.source },
+                { field: 'Branch', value: result.branch },
+                { field: 'Status', value: result.status },
+                { field: 'Commit', value: result.commit ?? '' },
+                ...(result.release
+                    ? [
+                        {
+                            field: 'Release',
+                            value: `${result.release.name} (${result.release.tagName}): ${result.release.status}`,
+                        },
+                    ]
+                    : []),
+                ...(result.release?.webUrl ? [{ field: 'Release URL', value: result.release.webUrl }] : []),
+                ...(result.defaultBranch ? [{ field: 'Default branch', value: result.defaultBranch.status }] : []),
+            ],
+        });
+        if (result.status === 'Commit rejected') {
+            process.exitCode = 1;
+        }
+        return result;
+    }
+    // eslint-disable-next-line class-methods-use-this -- kept as a method so tests can stub the prompt
+    async promptForType() {
+        return select({
+            message: messages.getMessage('prompt.type'),
+            choices: RELEASE_TYPES.map((value) => ({
+                value,
+                name: value,
+                description: messages.getMessage(`type.${value}`),
+            })),
+            default: 'minor',
+        });
+    }
+    async confirmPlan(plan) {
+        const steps = [
+            ...(plan.release ? [messages.getMessage('confirm.release', [plan.release.name, plan.release.tagName])] : []),
+            messages.getMessage('confirm.branch', [plan.branch, plan.source, plan.version]),
+            ...(plan.defaultBranch ? [messages.getMessage('confirm.default', [plan.branch])] : []),
+        ];
+        return this.confirm({ message: messages.getMessage('confirm', [steps.map((step) => `- ${step}`).join('\n')]) });
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/simply/project/release/create.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../../src/commands/simply/project/release/create.ts"],"names":[],"mappings":"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"}

package/messages/simply.project.release.create.md ADDED Viewed

@@ -0,0 +1,134 @@
+# summary
+Cut the next release branch, with its version bumped in sfdx-project.json.
+# description
+Run this from a local clone, on the release branch to cut from, or pass `--source`. The new branch, such as `release/v1.3.0` from `release/v1.2.0`, starts from the remote's copy of the source, never from local commits, and gets one commit that bumps `sfdx-project.json`: `versionNumber` becomes `1.3.0.NEXT` in every package directory on the source's version, and the version inside `versionName` is replaced in place. Then the branch is pushed. A version that already has a branch is refused. A patch on an older line is allowed while newer releases exist, for hotfixes.
+With `--create-release`, a GitLab or GitHub release for the version being closed out is published first, from the highest `v<version>.<build>` tag that is reachable from the source and on the remote. Fallback tags are skipped. A release that already exists is reported, not recreated. With `--set-default`, the new branch becomes the project's default after the push. Both need a token, from `--vcs-token` or `SIMPLY_VCS_TOKEN`, and a project ID, from `--vcs-project-id`, `SIMPLY_VCS_PROJECT_ID`, or `vcs.projectId` in `.sfdevrc.json`. These are checked before anything changes.
+Your repository's commit hooks always run. The default commit message is `chore: bump version to {VERSION}`; use `--message` if your rules need something else, such as a ticket number. If a hook rejects the commit, nothing is pushed, and the bump stays staged on the new local branch. Run `git commit` with an accepted message, then run this command again from that branch.
+The command never force-pushes or pushes tags. Pushing the new branch triggers a normal release-branch build, which creates the new release's first package version.
+# flags.type.summary
+Version to bump: major, minor, or patch. Asked for when omitted in a terminal.
+# flags.source.summary
+Release branch to cut from. Defaults to the current branch.
+# flags.package-release-branch-prefix.summary
+Prefix identifying release branches. Branch names must then be `[v]MAJOR.MINOR[.PATCH]`.
+# flags.remote.summary
+Remote holding the release branches.
+# flags.message.summary
+Commit message template, with an optional {VERSION} placeholder. Defaults to "chore: bump version to {VERSION}".
+# flags.create-release.summary
+Publish a GitLab or GitHub release for the source's version before cutting.
+# flags.release-tag.summary
+Tag to publish the release from, instead of the latest build tag. Implies --create-release.
+# flags.set-default.summary
+Make the new branch the project's default branch after pushing.
+# flags.vcs-provider.summary
+VCS platform. Defaults to SIMPLY_VCS_PROVIDER, then vcs.provider in .sfdevrc.json, then gitlab.
+# flags.vcs-host.summary
+VCS hostname, for a self-hosted instance. Defaults to SIMPLY_VCS_HOST, then vcs.host in .sfdevrc.json.
+# flags.vcs-project-id.summary
+GitLab project ID or GitHub owner/repo. Defaults to SIMPLY_VCS_PROJECT_ID, then vcs.projectId in .sfdevrc.json.
+# flags.vcs-token.summary
+VCS API token, needed only with --create-release, --release-tag, or --set-default.
+# flags.dry-run.summary
+Print the plan, including the tag a release would use, without changing anything.
+# flags.no-prompt.summary
+Don't ask for confirmation, or for --type.
+# error.typeRequired
+Pass --type with major, minor, or patch.
+# prompt.type
+Which version do you want to bump?
+# type.major
+Breaking changes
+# type.minor
+New features
+# type.patch
+Fixes for the current release
+# confirm.release
+Publish release %s from tag %s.
+# confirm.branch
+Create %s from %s, with version %s, and push it. The push starts a build that creates a package version.
+# confirm.default
+Make %s the project's default branch.
+# confirm
+This will:
+%s
+Continue?
+# tableTitle
+Release branch
+# examples
+- Cut the next minor release from the current release branch:
+  <%= config.bin %> <%= command.id %> --type minor
+- See what would happen, without changing anything:
+  <%= config.bin %> <%= command.id %> --type minor --dry-run
+- Cut a hotfix from an older release:
+  <%= config.bin %> <%= command.id %> --type patch --source release/v1.2.0
+- Also publish a release for the current version and make the new branch the default:
+  <%= config.bin %> <%= command.id %> --type minor --create-release --set-default
+- Use a commit message your repository's rules accept:
+  <%= config.bin %> <%= command.id %> --type minor --message "chore: PROJ-123 bump version to {VERSION}"

package/oclif.manifest.json CHANGED Viewed

@@ -1,5 +1,187 @@
 {
   "commands": {
+    "simply:project:release:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Run this from a local clone, on the release branch to cut from, or pass `--source`. The new branch, such as `release/v1.3.0` from `release/v1.2.0`, starts from the remote's copy of the source, never from local commits, and gets one commit that bumps `sfdx-project.json`: `versionNumber` becomes `1.3.0.NEXT` in every package directory on the source's version, and the version inside `versionName` is replaced in place. Then the branch is pushed. A version that already has a branch is refused. A patch on an older line is allowed while newer releases exist, for hotfixes.\n\nWith `--create-release`, a GitLab or GitHub release for the version being closed out is published first, from the highest `v<version>.<build>` tag that is reachable from the source and on the remote. Fallback tags are skipped. A release that already exists is reported, not recreated. With `--set-default`, the new branch becomes the project's default after the push. Both need a token, from `--vcs-token` or `SIMPLY_VCS_TOKEN`, and a project ID, from `--vcs-project-id`, `SIMPLY_VCS_PROJECT_ID`, or `vcs.projectId` in `.sfdevrc.json`. These are checked before anything changes.\n\nYour repository's commit hooks always run. The default commit message is `chore: bump version to {VERSION}`; use `--message` if your rules need something else, such as a ticket number. If a hook rejects the commit, nothing is pushed, and the bump stays staged on the new local branch. Run `git commit` with an accepted message, then run this command again from that branch.\n\nThe command never force-pushes or pushes tags. Pushing the new branch triggers a normal release-branch build, which creates the new release's first package version.",
+      "examples": [
+        "Cut the next minor release from the current release branch:\n<%= config.bin %> <%= command.id %> --type minor",
+        "See what would happen, without changing anything:\n<%= config.bin %> <%= command.id %> --type minor --dry-run",
+        "Cut a hotfix from an older release:\n<%= config.bin %> <%= command.id %> --type patch --source release/v1.2.0",
+        "Also publish a release for the current version and make the new branch the default:\n<%= config.bin %> <%= command.id %> --type minor --create-release --set-default",
+        "Use a commit message your repository's rules accept:\n<%= config.bin %> <%= command.id %> --type minor --message \"chore: PROJ-123 bump version to {VERSION}\""
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "name": "type",
+          "summary": "Version to bump: major, minor, or patch. Asked for when omitted in a terminal.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "major",
+            "minor",
+            "patch"
+          ],
+          "type": "option"
+        },
+        "source": {
+          "name": "source",
+          "summary": "Release branch to cut from. Defaults to the current branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "package-release-branch-prefix": {
+          "name": "package-release-branch-prefix",
+          "summary": "Prefix identifying release branches. Branch names must then be `[v]MAJOR.MINOR[.PATCH]`.",
+          "default": "release/",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "name": "remote",
+          "summary": "Remote holding the release branches.",
+          "default": "origin",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "name": "message",
+          "summary": "Commit message template, with an optional {VERSION} placeholder. Defaults to \"chore: bump version to {VERSION}\".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "create-release": {
+          "name": "create-release",
+          "summary": "Publish a GitLab or GitHub release for the source's version before cutting.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "release-tag": {
+          "name": "release-tag",
+          "summary": "Tag to publish the release from, instead of the latest build tag. Implies --create-release.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "set-default": {
+          "char": "s",
+          "name": "set-default",
+          "summary": "Make the new branch the project's default branch after pushing.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "vcs-provider": {
+          "name": "vcs-provider",
+          "summary": "VCS platform. Defaults to SIMPLY_VCS_PROVIDER, then vcs.provider in .sfdevrc.json, then gitlab.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gitlab",
+            "github"
+          ],
+          "type": "option"
+        },
+        "vcs-host": {
+          "name": "vcs-host",
+          "summary": "VCS hostname, for a self-hosted instance. Defaults to SIMPLY_VCS_HOST, then vcs.host in .sfdevrc.json.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "vcs-project-id": {
+          "name": "vcs-project-id",
+          "summary": "GitLab project ID or GitHub owner/repo. Defaults to SIMPLY_VCS_PROJECT_ID, then vcs.projectId in .sfdevrc.json.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "vcs-token": {
+          "env": "SIMPLY_VCS_TOKEN",
+          "name": "vcs-token",
+          "summary": "VCS API token, needed only with --create-release, --release-tag, or --set-default.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Print the plan, including the tag a release would use, without changing anything.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-prompt": {
+          "name": "no-prompt",
+          "summary": "Don't ask for confirmation, or for --type.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "simply:project:release:create",
+      "pluginAlias": "@simplysf/simply-project",
+      "pluginName": "@simplysf/simply-project",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Cut the next release branch, with its version bumped in sfdx-project.json.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "simply",
+        "project",
+        "release",
+        "create.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "simply:project:release:create",
+        "project:simply:release:create",
+        "project:release:simply:create",
+        "project:release:create:simply",
+        "simply:release:project:create",
+        "release:simply:project:create",
+        "release:project:simply:create",
+        "release:project:create:simply",
+        "simply:release:create:project",
+        "release:simply:create:project",
+        "release:create:simply:project",
+        "release:create:project:simply",
+        "simply:project:create:release",
+        "project:simply:create:release",
+        "project:create:simply:release",
+        "project:create:release:simply",
+        "simply:create:project:release",
+        "create:simply:project:release",
+        "create:project:simply:release",
+        "create:project:release:simply",
+        "simply:create:release:project",
+        "create:simply:release:project",
+        "create:release:simply:project",
+        "create:release:project:simply"
+      ]
+    },
     "simply:project:release:roll-forward": {
       "aliases": [],
       "args": {},
@@ -221,5 +403,5 @@
       ]
     }
   },
-  "version": "1.3.1"
+  "version": "1.4.0"
 }

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@simplysf/simply-project",
   "description": "Utilities for working with Salesforce projects",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "author": "@ClayChipps",
   "homepage": "https://github.com/SimplySF/simply-plugins",
   "bugs": "https://github.com/SimplySF/simply-plugins/issues",
@@ -51,7 +51,7 @@
             "description": "Commands for working with Salesforce projects",
             "subtopics": {
               "release": {
-                "description": "Commands for maintaining release branches"
+                "description": "Commands for cutting release branches and rolling them forward"
               },
               "update": {
                 "description": "Commands for updating Salesforce project settings"
@@ -64,11 +64,13 @@
     "topicSeparator": " "
   },
   "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
     "@oclif/core": "^4.11.2",
     "@salesforce/core": "^8.30.0",
     "@salesforce/kit": "^3.2.6",
     "@salesforce/sf-plugins-core": "^12.2.16",
-    "@simplysf/simply-project-core": "^0.2.0",
+    "@simplysf/simply-core": "^1.8.0",
+    "@simplysf/simply-project-core": "^0.3.0",
     "glob": "^13.0.6"
   },
   "devDependencies": {
@@ -207,5 +209,5 @@
       "output": []
     }
   },
-  "gitHead": "37a20f64434ed8a208f43503c6bbc6e68d25ca0d"
+  "gitHead": "743cad9ae6581a38925a6fac023c5820c99e6eab"
 }