@storm-software/git-tools 2.101.3 → 2.102.0

package/README.md

@@ -3,7 +3,7 @@
 <!-- markdownlint-disable -->
 
 
-<div align="center"><img src="https://pub-761b436209f44a4d886487c917806c08.r2.dev/storm-banner.gif" width="100%" alt="Storm Software" /></div>
+<div align="center"><img src="https://public.storm-cdn.com/storm-banner.gif" width="100%" alt="Storm Software" /></div>
 <br />
 
 <div align="center">
@@ -21,7 +21,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-2.101.3-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-2.102.0-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->
@@ -33,7 +33,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 <!-- prettier-ignore-end -->
 
 <div align="center">
-<b>Be sure to ⭐ this repository on <a href="https://github.com/storm-software/storm-ops" target="_blank">GitHub</a> so you can keep up to date on any daily progress!</b>
+<b>Be sure to ⭐ this <a href="https://github.com/storm-software/storm-ops" target="_blank">repository on GitHub</a> so you can keep up to date on any daily progress!</b>
 </div>
 
 <br />
@@ -234,7 +234,7 @@ specification. Contributions of any kind welcome!
 <br />
 
 <div align="center">
-<img src="https://pub-761b436209f44a4d886487c917806c08.r2.dev/logo-banner.png" width="100%" alt="Storm Software" />
+<img src="https://public.storm-cdn.com/brand-banner.png" width="100%" alt="Storm Software" />
 </div>
 <br />
 
@@ -243,7 +243,7 @@ specification. Contributions of any kind welcome!
 </div>
 
 <div align="center">
-<b>Fingerprint:</b> 1BD2 7192 7770 2549 F4C9 F238 E6AD C420 DA5C 4C2D
+<b>Fingerprint:</b> F47F 1853 BCAD DE9B 42C8  6316 9FDE EC95 47FE D106
 </div>
 <br />
 
@@ -266,9 +266,9 @@ channel!
 
 <br />
 
-<div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://pub-761b436209f44a4d886487c917806c08.r2.dev/icon-fill.png" alt="Storm Software" width="200px"/></a></div>
+<div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://public.storm-cdn.com/icon-fill.png" alt="Storm Software" width="200px"/></a></div>
 <br />
-<div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://pub-761b436209f44a4d886487c917806c08.r2.dev/visit-us-text.svg" alt="Visit us at stormsoftware.com" height="90px"/></a></div>
+<div align="center"><a href="https://stormsoftware.com" target="_blank"><img src="https://public.storm-cdn.com/visit-us-text.svg" alt="Visit us at stormsoftware.com" height="90px"/></a></div>
 
 <br />
 

package/bin/git.cjs

@@ -80983,6 +80983,44 @@ function parseChangelogMarkdown(contents) {
 }
 _chunkKK4YC43Scjs.__name.call(void 0, parseChangelogMarkdown, "parseChangelogMarkdown");
 
+// src/utilities/git-utils.ts
+_chunkKK4YC43Scjs.init_cjs_shims.call(void 0, );
+var _execcommandjs = require('nx/src/command-line/release/utils/exec-command.js');
+async function gitTag({ tag, message: message2, additionalArgs, dryRun, verbose, logFn }) {
+  logFn = logFn || console.log;
+  const commandArgs = [
+    "tag",
+    // Create an annotated tag (recommended for releases here: https://git-scm.com/docs/git-tag)
+    "--annotate",
+    "--sign",
+    tag,
+    "--message",
+    message2 || tag
+  ];
+  if (additionalArgs) {
+    if (Array.isArray(additionalArgs)) {
+      commandArgs.push(...additionalArgs);
+    } else {
+      commandArgs.push(...additionalArgs.split(" "));
+    }
+  }
+  if (verbose) {
+    logFn(dryRun ? `Would tag the current commit in git with the following command, but --dry-run was set:` : `Tagging the current commit in git with the following command:`);
+    logFn(`git ${commandArgs.join(" ")}`);
+  }
+  if (dryRun) {
+    return "";
+  }
+  try {
+    return await _execcommandjs.execCommand.call(void 0, "git", commandArgs);
+  } catch (err) {
+    throw new Error(`Unexpected error when creating tag ${tag}:
+
+${err}`);
+  }
+}
+_chunkKK4YC43Scjs.__name.call(void 0, gitTag, "gitTag");
+
 // src/release/changelog-renderer.ts
 _chunkKK4YC43Scjs.init_cjs_shims.call(void 0, );
 
@@ -85155,7 +85193,7 @@ async function applyChangesAndExit(args, nxReleaseConfig, tree, toSHA, postGitTa
   if (_nullishCoalesce(args.gitTag, () => ( nxReleaseConfig.changelog.git.tag))) {
     _output.output.logSingleLine(`Tagging commit with git`);
     for (const tag of gitTagValues) {
-      await _git.gitTag.call(void 0, {
+      await gitTag({
         tag,
         message: args.gitTagMessage || nxReleaseConfig.changelog.git.tagMessage,
         additionalArgs: args.gitTagArgs || nxReleaseConfig.changelog.git.tagArgs,
@@ -85471,7 +85509,7 @@ function formatGithubReleaseNotes(releaseVersion2, content, projectName, workspa
   if (!workspaceConfig) {
     return content;
   }
-  return `![${titleCase(workspaceConfig.organization)}](${workspaceConfig.release.banner})
+  return `![${_optionalChain([titleCase, 'call', _236 => _236(workspaceConfig.organization), 'optionalAccess', _237 => _237.replaceAll, 'call', _238 => _238(" ", "-")])}](${workspaceConfig.release.banner})
 ${workspaceConfig.release.header || ""}
 
 # ${projectName ? `${titleCase(projectName)} ` : ""}v${releaseVersion2.rawVersion}
@@ -85480,7 +85518,7 @@ We at [${titleCase(workspaceConfig.organization)}](${workspaceConfig.homepage})
 
 These changes are released under the ${workspaceConfig.license.includes("license") ? workspaceConfig.license : `${workspaceConfig.license} license`}. You can find more details on [our licensing page](${workspaceConfig.licensing}). You can find guides, API references, and other documentation around this release (and much more) on [our documentation site](${workspaceConfig.docs}).
 
-If you have any questions or comments, feel free to reach out to the team on [Discord](${workspaceConfig.account.discord}) or [our contact page](${workspaceConfig.contact}). Please help us spread the word by giving [this repository](https://github.com/${workspaceConfig.organization}/${workspaceConfig.name}) a star \u2B50 on GitHub or [posting on X (Twitter)](https://x.com/intent/tweet?text=Check%20out%20the%20latest%20@${workspaceConfig.account.twitter}%20release%20${projectName ? `${_optionalChain([titleCase, 'call', _236 => _236(projectName), 'optionalAccess', _237 => _237.replaceAll, 'call', _238 => _238(" ", "%20")])}%20` : ""}v${releaseVersion2.rawVersion}%20%F0%9F%9A%80%0D%0A%0D%0Ahttps://github.com/${workspaceConfig.organization}/${workspaceConfig.name}/releases/tag/${releaseVersion2.gitTag}) about this release!
+If you have any questions or comments, feel free to reach out to the team on [Discord](${workspaceConfig.account.discord}) or [our contact page](${workspaceConfig.contact}). Please help us spread the word by giving [this repository](https://github.com/${workspaceConfig.organization}/${workspaceConfig.name}) a star \u2B50 on GitHub or [posting on X (Twitter)](https://x.com/intent/tweet?text=Check%20out%20the%20latest%20@${workspaceConfig.account.twitter}%20release%20${projectName ? `${_optionalChain([titleCase, 'call', _239 => _239(projectName), 'optionalAccess', _240 => _240.replaceAll, 'call', _241 => _241(" ", "%20")])}%20` : ""}v${releaseVersion2.rawVersion}%20%F0%9F%9A%80%0D%0A%0D%0Ahttps://github.com/${workspaceConfig.organization}/${workspaceConfig.name}/releases/tag/${releaseVersion2.gitTag}) about this release!
 
 ## Release Notes
 
@@ -85503,6 +85541,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
   projectsRelationship: "independent",
   releaseTagPattern: "{projectName}@{version}",
   changelog: {
+    git: {
+      tag: true
+    },
     createRelease: "github",
     entryWhenNoChanges: false,
     file: "{projectRoot}/CHANGELOG.md",
@@ -85524,6 +85565,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
 var DEFAULT_RELEASE_CONFIG = {
   conventionalCommits: DEFAULT_CONVENTIONAL_COMMITS_CONFIG2,
   changelog: {
+    git: {
+      tag: true
+    },
     automaticFromRef: true,
     workspaceChangelog: false,
     projectChangelogs: {
@@ -85575,7 +85619,7 @@ async function releaseVersion(config, args) {
     });
     const { projects } = _projectgraphjs.readProjectsConfigurationFromProjectGraph.call(void 0, projectGraph);
     const nxJson = _nxjsonjs.readNxJson.call(void 0, );
-    const workspaceRoot3 = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _239 => _239.workspaceRoot]), () => ( _chunkKX7Y62QYcjs.findWorkspaceRoot.call(void 0, )));
+    const workspaceRoot3 = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _242 => _242.workspaceRoot]), () => ( _chunkKX7Y62QYcjs.findWorkspaceRoot.call(void 0, )));
     if (args.verbose) {
       process.env.NX_VERBOSE_LOGGING = "true";
     }
@@ -85583,7 +85627,7 @@ async function releaseVersion(config, args) {
     if (configError) {
       return await _configjs.handleNxReleaseConfigError.call(void 0, configError);
     }
-    if ((args.gitCommit === void 0 || args.gitTag === void 0 || args.stageChanges === void 0) && _optionalChain([nxJson, 'access', _240 => _240.release, 'optionalAccess', _241 => _241.git])) {
+    if ((args.gitCommit === void 0 || args.gitTag === void 0 || args.stageChanges === void 0) && _optionalChain([nxJson, 'access', _243 => _243.release, 'optionalAccess', _244 => _244.git])) {
       await _resolvenxjsonerrormessagejs.resolveNxJsonConfigErrorMessage.call(void 0, [
         "release",
         "git"
@@ -85598,10 +85642,10 @@ async function releaseVersion(config, args) {
     }
     const tree = new (0, _treejs.FsTree)(workspaceRoot3, true);
     const versionData = {};
-    const commitMessage = args.gitCommitMessage || _optionalChain([nxReleaseConfig, 'optionalAccess', _242 => _242.version, 'access', _243 => _243.git, 'access', _244 => _244.commitMessage]);
+    const commitMessage = args.gitCommitMessage || _optionalChain([nxReleaseConfig, 'optionalAccess', _245 => _245.version, 'access', _246 => _246.git, 'access', _247 => _247.commitMessage]);
     const additionalChangedFiles = /* @__PURE__ */ new Set();
     const generatorCallbacks = [];
-    if (_optionalChain([args, 'access', _245 => _245.projects, 'optionalAccess', _246 => _246.length])) {
+    if (_optionalChain([args, 'access', _248 => _248.projects, 'optionalAccess', _249 => _249.length])) {
       _chunkKX7Y62QYcjs.writeInfo.call(void 0, "Run versioning for all remaining release groups and filtered projects within them", config);
       for (const releaseGroup of releaseGroups) {
         const releaseGroupName = releaseGroup.name;
@@ -85641,7 +85685,7 @@ async function releaseVersion(config, args) {
           });
         }
       }
-      const gitTagValues2 = _nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _247 => _247.version, 'access', _248 => _248.git, 'access', _249 => _249.tag]))) ? _sharedjs.createGitTagValues.call(void 0, releaseGroups, releaseGroupToFilteredProjects, versionData) : [];
+      const gitTagValues2 = _nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _250 => _250.version, 'access', _251 => _251.git, 'access', _252 => _252.tag]))) ? _sharedjs.createGitTagValues.call(void 0, releaseGroups, releaseGroupToFilteredProjects, versionData) : [];
       _sharedjs.handleDuplicateGitTags.call(void 0, gitTagValues2);
       printAndFlushChanges2(config, tree, !!args.dryRun);
       for (const generatorCallback of generatorCallbacks) {
@@ -85658,15 +85702,15 @@ async function releaseVersion(config, args) {
           projectsVersionData: versionData
         };
       }
-      if (_nullishCoalesce(args.gitCommit, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _250 => _250.version, 'access', _251 => _251.git, 'access', _252 => _252.commit])))) {
+      if (_nullishCoalesce(args.gitCommit, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _253 => _253.version, 'access', _254 => _254.git, 'access', _255 => _255.commit])))) {
         await _sharedjs.commitChanges.call(void 0, {
           changedFiles: changedFiles2,
           isDryRun: !!args.dryRun,
           isVerbose: !!args.verbose,
           gitCommitMessages: _sharedjs.createCommitMessageValues.call(void 0, releaseGroups, releaseGroupToFilteredProjects, versionData, commitMessage),
-          gitCommitArgs: args.gitCommitArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _253 => _253.version, 'access', _254 => _254.git, 'access', _255 => _255.commitArgs])
+          gitCommitArgs: args.gitCommitArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _256 => _256.version, 'access', _257 => _257.git, 'access', _258 => _258.commitArgs])
         });
-      } else if (_nullishCoalesce(args.stageChanges, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _256 => _256.version, 'access', _257 => _257.git, 'access', _258 => _258.stageChanges])))) {
+      } else if (_nullishCoalesce(args.stageChanges, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _259 => _259.version, 'access', _260 => _260.git, 'access', _261 => _261.stageChanges])))) {
         _chunkKX7Y62QYcjs.writeInfo.call(void 0, "Staging changed files with git", config);
         await _gitjs.gitAdd.call(void 0, {
           changedFiles: changedFiles2,
@@ -85674,13 +85718,13 @@ async function releaseVersion(config, args) {
           verbose: args.verbose
         });
       }
-      if (_nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _259 => _259.version, 'access', _260 => _260.git, 'access', _261 => _261.tag])))) {
+      if (_nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _262 => _262.version, 'access', _263 => _263.git, 'access', _264 => _264.tag])))) {
         _chunkKX7Y62QYcjs.writeInfo.call(void 0, "Tagging commit with git", config);
         for (const tag of gitTagValues2) {
-          await _gitjs.gitTag.call(void 0, {
+          await gitTag({
             tag,
-            message: args.gitTagMessage || _optionalChain([nxReleaseConfig, 'optionalAccess', _262 => _262.version, 'access', _263 => _263.git, 'access', _264 => _264.tagMessage]),
-            additionalArgs: args.gitTagArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _265 => _265.version, 'access', _266 => _266.git, 'access', _267 => _267.tagArgs]),
+            message: args.gitTagMessage || _optionalChain([nxReleaseConfig, 'optionalAccess', _265 => _265.version, 'access', _266 => _266.git, 'access', _267 => _267.tagMessage]),
+            additionalArgs: args.gitTagArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _268 => _268.version, 'access', _269 => _269.git, 'access', _270 => _270.tagArgs]),
             dryRun: args.dryRun,
             verbose: args.verbose
           });
@@ -85727,7 +85771,7 @@ async function releaseVersion(config, args) {
         });
       }
     }
-    const gitTagValues = _nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _268 => _268.version, 'access', _269 => _269.git, 'access', _270 => _270.tag]))) ? _sharedjs.createGitTagValues.call(void 0, releaseGroups, releaseGroupToFilteredProjects, versionData) : [];
+    const gitTagValues = _nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _271 => _271.version, 'access', _272 => _272.git, 'access', _273 => _273.tag]))) ? _sharedjs.createGitTagValues.call(void 0, releaseGroups, releaseGroupToFilteredProjects, versionData) : [];
     _sharedjs.handleDuplicateGitTags.call(void 0, gitTagValues);
     printAndFlushChanges2(config, tree, !!args.dryRun);
     for (const generatorCallback of generatorCallbacks) {
@@ -85736,10 +85780,10 @@ async function releaseVersion(config, args) {
     let workspaceVersion = void 0;
     if (releaseGroups.length === 1) {
       const releaseGroup = releaseGroups[0];
-      if (_optionalChain([releaseGroup, 'optionalAccess', _271 => _271.projectsRelationship]) === "fixed") {
+      if (_optionalChain([releaseGroup, 'optionalAccess', _274 => _274.projectsRelationship]) === "fixed") {
         const releaseGroupProjectNames = Array.from(_nullishCoalesce(releaseGroupToFilteredProjects.get(releaseGroup), () => ( [])));
         if (releaseGroupProjectNames.length > 0 && releaseGroupProjectNames[0]) {
-          workspaceVersion = _optionalChain([versionData, 'access', _272 => _272[releaseGroupProjectNames[0]], 'optionalAccess', _273 => _273.newVersion]);
+          workspaceVersion = _optionalChain([versionData, 'access', _275 => _275[releaseGroupProjectNames[0]], 'optionalAccess', _276 => _276.newVersion]);
         }
       }
     }
@@ -85753,15 +85797,15 @@ async function releaseVersion(config, args) {
         projectsVersionData: versionData
       };
     }
-    if (_nullishCoalesce(args.gitCommit, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _274 => _274.version, 'access', _275 => _275.git, 'access', _276 => _276.commit])))) {
+    if (_nullishCoalesce(args.gitCommit, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _277 => _277.version, 'access', _278 => _278.git, 'access', _279 => _279.commit])))) {
       await _sharedjs.commitChanges.call(void 0, {
         changedFiles,
         isDryRun: !!args.dryRun,
         isVerbose: !!args.verbose,
         gitCommitMessages: _sharedjs.createCommitMessageValues.call(void 0, releaseGroups, releaseGroupToFilteredProjects, versionData, commitMessage),
-        gitCommitArgs: args.gitCommitArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _277 => _277.version, 'access', _278 => _278.git, 'access', _279 => _279.commitArgs])
+        gitCommitArgs: args.gitCommitArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _280 => _280.version, 'access', _281 => _281.git, 'access', _282 => _282.commitArgs])
       });
-    } else if (_nullishCoalesce(args.stageChanges, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _280 => _280.version, 'access', _281 => _281.git, 'access', _282 => _282.stageChanges])))) {
+    } else if (_nullishCoalesce(args.stageChanges, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _283 => _283.version, 'access', _284 => _284.git, 'access', _285 => _285.stageChanges])))) {
       _chunkKX7Y62QYcjs.writeInfo.call(void 0, "Staging changed files with git", config);
       await _gitjs.gitAdd.call(void 0, {
         changedFiles,
@@ -85769,13 +85813,13 @@ async function releaseVersion(config, args) {
         verbose: args.verbose
       });
     }
-    if (_nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _283 => _283.version, 'access', _284 => _284.git, 'access', _285 => _285.tag])))) {
+    if (_nullishCoalesce(args.gitTag, () => ( _optionalChain([nxReleaseConfig, 'optionalAccess', _286 => _286.version, 'access', _287 => _287.git, 'access', _288 => _288.tag])))) {
       _chunkKX7Y62QYcjs.writeInfo.call(void 0, "Tagging commit with git", config);
       for (const tag of gitTagValues) {
-        await _gitjs.gitTag.call(void 0, {
+        await gitTag({
           tag,
-          message: args.gitTagMessage || _optionalChain([nxReleaseConfig, 'optionalAccess', _286 => _286.version, 'access', _287 => _287.git, 'access', _288 => _288.tagMessage]),
-          additionalArgs: args.gitTagArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _289 => _289.version, 'access', _290 => _290.git, 'access', _291 => _291.tagArgs]),
+          message: args.gitTagMessage || _optionalChain([nxReleaseConfig, 'optionalAccess', _289 => _289.version, 'access', _290 => _290.git, 'access', _291 => _291.tagMessage]),
+          additionalArgs: args.gitTagArgs || _optionalChain([nxReleaseConfig, 'optionalAccess', _292 => _292.version, 'access', _293 => _293.git, 'access', _294 => _294.tagArgs]),
           dryRun: args.dryRun,
           verbose: args.verbose
         });
@@ -85798,7 +85842,7 @@ async function releaseVersion(config, args) {
 }
 _chunkKK4YC43Scjs.__name.call(void 0, releaseVersion, "releaseVersion");
 async function runVersionOnProjects(config, projectGraph, nxJson, args, tree, generatorData, projectNames, releaseGroup, versionData) {
-  const workspaceRoot3 = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _292 => _292.workspaceRoot]), () => ( _chunkKX7Y62QYcjs.findWorkspaceRoot.call(void 0, )));
+  const workspaceRoot3 = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _295 => _295.workspaceRoot]), () => ( _chunkKX7Y62QYcjs.findWorkspaceRoot.call(void 0, )));
   const generatorOptions = {
     // Always ensure a string to avoid generator schema validation errors
     specifier: _nullishCoalesce(args.specifier, () => ( "")),
@@ -85826,11 +85870,11 @@ function printAndFlushChanges2(config, tree, isDryRun) {
   for (const f of changes) {
     if (f.type === "CREATE") {
       _chunkKX7Y62QYcjs.writeInfo.call(void 0, `CREATE ${f.path}${isDryRun ? " [dry-run]" : ""}`, config);
-      _printchangesjs.printDiff.call(void 0, "", _optionalChain([f, 'access', _293 => _293.content, 'optionalAccess', _294 => _294.toString, 'call', _295 => _295()]) || "");
+      _printchangesjs.printDiff.call(void 0, "", _optionalChain([f, 'access', _296 => _296.content, 'optionalAccess', _297 => _297.toString, 'call', _298 => _298()]) || "");
     } else if (f.type === "UPDATE") {
       _chunkKX7Y62QYcjs.writeInfo.call(void 0, `UPDATE ${f.path}${isDryRun ? " [dry-run]" : ""}`, config);
       const currentContentsOnDisk = _fs.readFileSync.call(void 0, (0, import_devkit.joinPathFragments)(tree.root, f.path)).toString();
-      _printchangesjs.printDiff.call(void 0, currentContentsOnDisk, _optionalChain([f, 'access', _296 => _296.content, 'optionalAccess', _297 => _297.toString, 'call', _298 => _298()]) || "");
+      _printchangesjs.printDiff.call(void 0, currentContentsOnDisk, _optionalChain([f, 'access', _299 => _299.content, 'optionalAccess', _300 => _300.toString, 'call', _301 => _301()]) || "");
     } else if (f.type === "DELETE") {
       throw new Error("Unexpected DELETE change, please report this as an issue");
     }
@@ -85909,9 +85953,9 @@ var runRelease = /* @__PURE__ */ _chunkKK4YC43Scjs.__name.call(void 0, async (co
  - From: ${from}
  - To: ${to}
 `, config);
-  if (_optionalChain([nxJson, 'access', _299 => _299.release, 'optionalAccess', _300 => _300.groups])) {
+  if (_optionalChain([nxJson, 'access', _302 => _302.release, 'optionalAccess', _303 => _303.groups])) {
     nxJson.release.groups = Object.keys(nxJson.release.groups).reduce((ret, groupName) => {
-      const groupConfig = _optionalChain([nxJson, 'access', _301 => _301.release, 'optionalAccess', _302 => _302.groups, 'optionalAccess', _303 => _303[groupName]]);
+      const groupConfig = _optionalChain([nxJson, 'access', _304 => _304.release, 'optionalAccess', _305 => _305.groups, 'optionalAccess', _306 => _306[groupName]]);
       ret[groupName] = _chunkP2CHIYIKcjs.defu.call(void 0, groupConfig, DEFAULT_RELEASE_GROUP_CONFIG);
       return ret;
     }, {});
@@ -85929,12 +85973,11 @@ var runRelease = /* @__PURE__ */ _chunkKK4YC43Scjs.__name.call(void 0, async (co
     deleteVersionPlans: false,
     stageChanges: true,
     gitCommit: false,
-    gitTag: false,
     nxReleaseConfig
   });
   await releaseChangelog({
     ...options,
-    version: _optionalChain([nxReleaseConfig, 'optionalAccess', _304 => _304.projectsRelationship]) !== "fixed" ? void 0 : workspaceVersion,
+    version: _optionalChain([nxReleaseConfig, 'optionalAccess', _307 => _307.projectsRelationship]) !== "fixed" ? void 0 : workspaceVersion,
     versionData: projectsVersionData,
     dryRun: false,
     verbose: _chunkKX7Y62QYcjs.isVerbose.call(void 0, config.logLevel),
@@ -85947,7 +85990,7 @@ var runRelease = /* @__PURE__ */ _chunkKK4YC43Scjs.__name.call(void 0, async (co
   if (options.skipPublish) {
     _chunkKX7Y62QYcjs.writeWarning.call(void 0, "Skipping publishing packages since `skipPublish` was provided as `true` in the release options.", config);
   } else {
-    const changedProjects = Object.keys(projectsVersionData).filter((key) => _optionalChain([projectsVersionData, 'access', _305 => _305[key], 'optionalAccess', _306 => _306.newVersion]));
+    const changedProjects = Object.keys(projectsVersionData).filter((key) => _optionalChain([projectsVersionData, 'access', _308 => _308[key], 'optionalAccess', _309 => _309.newVersion]));
     if (changedProjects.length > 0) {
       _chunkKX7Y62QYcjs.writeInfo.call(void 0, `Publishing release for ${changedProjects.length} ${changedProjects.length === 1 ? "project" : "projects"}:
 ${changedProjects.map((changedProject) => `  - ${changedProject}`).join("\n")}
@@ -85957,12 +86000,12 @@ ${changedProjects.map((changedProject) => `  - ${changedProject}`).join("\n")}
         dryRun: !!options.dryRun,
         verbose: _chunkKX7Y62QYcjs.isVerbose.call(void 0, config.logLevel)
       });
-      const failedProjects = Object.keys(result2).filter((key) => _optionalChain([result2, 'access', _307 => _307[key], 'optionalAccess', _308 => _308.code]) && _optionalChain([result2, 'access', _309 => _309[key], 'optionalAccess', _310 => _310.code]) > 0);
+      const failedProjects = Object.keys(result2).filter((key) => _optionalChain([result2, 'access', _310 => _310[key], 'optionalAccess', _311 => _311.code]) && _optionalChain([result2, 'access', _312 => _312[key], 'optionalAccess', _313 => _313.code]) > 0);
       if (failedProjects.length > 0) {
         throw new Error(`The Storm release process was not completed successfully! One or more errors occured while running the \`nx-release-publish\` executor tasks.
 
 Please review the workflow details for the following project(s):
-${failedProjects.map((failedProject) => `  - ${failedProject} (Error Code: ${_optionalChain([result2, 'access', _311 => _311[failedProject], 'optionalAccess', _312 => _312.code])})`).join("\n")}
+${failedProjects.map((failedProject) => `  - ${failedProject} (Error Code: ${_optionalChain([result2, 'access', _314 => _314[failedProject], 'optionalAccess', _315 => _315.code])})`).join("\n")}
 `);
       }
     } else {

package/bin/git.js

@@ -80893,7 +80893,7 @@ import { createNxReleaseConfig, defaultCreateReleaseProvider, handleNxReleaseCon
 import { deepMergeJson } from "nx/src/command-line/release/config/deep-merge-json";
 import { filterReleaseGroups } from "nx/src/command-line/release/config/filter-release-groups";
 import { readRawVersionPlans, setResolvedVersionPlansOnGroups } from "nx/src/command-line/release/config/version-plans";
-import { getCommitHash, getFirstGitCommit, getGitDiff, getLatestGitTagForPattern, gitAdd, gitPush, gitTag, parseCommits, parseGitCommit } from "nx/src/command-line/release/utils/git";
+import { getCommitHash, getFirstGitCommit, getGitDiff, getLatestGitTagForPattern, gitAdd, gitPush, parseCommits, parseGitCommit } from "nx/src/command-line/release/utils/git";
 import { createOrUpdateGithubRelease, getGitHubRepoData } from "nx/src/command-line/release/utils/github";
 import { launchEditor } from "nx/src/command-line/release/utils/launch-editor";
 import { printAndFlushChanges } from "nx/src/command-line/release/utils/print-changes";
@@ -80982,6 +80982,44 @@ function parseChangelogMarkdown(contents) {
 }
 __name(parseChangelogMarkdown, "parseChangelogMarkdown");
 
+// src/utilities/git-utils.ts
+init_esm_shims();
+import { execCommand } from "nx/src/command-line/release/utils/exec-command.js";
+async function gitTag({ tag, message: message2, additionalArgs, dryRun, verbose, logFn }) {
+  logFn = logFn || console.log;
+  const commandArgs = [
+    "tag",
+    // Create an annotated tag (recommended for releases here: https://git-scm.com/docs/git-tag)
+    "--annotate",
+    "--sign",
+    tag,
+    "--message",
+    message2 || tag
+  ];
+  if (additionalArgs) {
+    if (Array.isArray(additionalArgs)) {
+      commandArgs.push(...additionalArgs);
+    } else {
+      commandArgs.push(...additionalArgs.split(" "));
+    }
+  }
+  if (verbose) {
+    logFn(dryRun ? `Would tag the current commit in git with the following command, but --dry-run was set:` : `Tagging the current commit in git with the following command:`);
+    logFn(`git ${commandArgs.join(" ")}`);
+  }
+  if (dryRun) {
+    return "";
+  }
+  try {
+    return await execCommand("git", commandArgs);
+  } catch (err) {
+    throw new Error(`Unexpected error when creating tag ${tag}:
+
+${err}`);
+  }
+}
+__name(gitTag, "gitTag");
+
 // src/release/changelog-renderer.ts
 init_esm_shims();
 
@@ -85470,7 +85508,7 @@ function formatGithubReleaseNotes(releaseVersion2, content, projectName, workspa
   if (!workspaceConfig) {
     return content;
   }
-  return `![${titleCase(workspaceConfig.organization)}](${workspaceConfig.release.banner})
+  return `![${titleCase(workspaceConfig.organization)?.replaceAll(" ", "-")}](${workspaceConfig.release.banner})
 ${workspaceConfig.release.header || ""}
 
 # ${projectName ? `${titleCase(projectName)} ` : ""}v${releaseVersion2.rawVersion}
@@ -85502,6 +85540,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
   projectsRelationship: "independent",
   releaseTagPattern: "{projectName}@{version}",
   changelog: {
+    git: {
+      tag: true
+    },
     createRelease: "github",
     entryWhenNoChanges: false,
     file: "{projectRoot}/CHANGELOG.md",
@@ -85523,6 +85564,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
 var DEFAULT_RELEASE_CONFIG = {
   conventionalCommits: DEFAULT_CONVENTIONAL_COMMITS_CONFIG2,
   changelog: {
+    git: {
+      tag: true
+    },
     automaticFromRef: true,
     workspaceChangelog: false,
     projectChangelogs: {
@@ -85557,7 +85601,7 @@ import { getGeneratorInformation } from "nx/src/command-line/generate/generator-
 import { createNxReleaseConfig as createNxReleaseConfig2, handleNxReleaseConfigError as handleNxReleaseConfigError2 } from "nx/src/command-line/release/config/config.js";
 import { filterReleaseGroups as filterReleaseGroups2 } from "nx/src/command-line/release/config/filter-release-groups.js";
 import { batchProjectsByGeneratorConfig } from "nx/src/command-line/release/utils/batch-projects-by-generator-config.js";
-import { gitAdd as gitAdd2, gitTag as gitTag2 } from "nx/src/command-line/release/utils/git.js";
+import { gitAdd as gitAdd2 } from "nx/src/command-line/release/utils/git.js";
 import { printDiff } from "nx/src/command-line/release/utils/print-changes.js";
 import { resolveNxJsonConfigErrorMessage as resolveNxJsonConfigErrorMessage2 } from "nx/src/command-line/release/utils/resolve-nx-json-error-message.js";
 import { commitChanges as commitChanges2, createCommitMessageValues as createCommitMessageValues2, createGitTagValues as createGitTagValues2, handleDuplicateGitTags as handleDuplicateGitTags2 } from "nx/src/command-line/release/utils/shared.js";
@@ -85676,7 +85720,7 @@ async function releaseVersion(config, args) {
       if (args.gitTag ?? nxReleaseConfig?.version.git.tag) {
         writeInfo("Tagging commit with git", config);
         for (const tag of gitTagValues2) {
-          await gitTag2({
+          await gitTag({
             tag,
             message: args.gitTagMessage || nxReleaseConfig?.version.git.tagMessage,
             additionalArgs: args.gitTagArgs || nxReleaseConfig?.version.git.tagArgs,
@@ -85771,7 +85815,7 @@ async function releaseVersion(config, args) {
     if (args.gitTag ?? nxReleaseConfig?.version.git.tag) {
       writeInfo("Tagging commit with git", config);
       for (const tag of gitTagValues) {
-        await gitTag2({
+        await gitTag({
           tag,
           message: args.gitTagMessage || nxReleaseConfig?.version.git.tagMessage,
           additionalArgs: args.gitTagArgs || nxReleaseConfig?.version.git.tagArgs,
@@ -85928,7 +85972,6 @@ var runRelease = /* @__PURE__ */ __name(async (config, options) => {
     deleteVersionPlans: false,
     stageChanges: true,
     gitCommit: false,
-    gitTag: false,
     nxReleaseConfig
   });
   await releaseChangelog({

package/dist/{chunk-AZCYMACD.cjs → chunk-PDBBNGUQ.cjs}

@@ -12,6 +12,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
   projectsRelationship: "independent",
   releaseTagPattern: "{projectName}@{version}",
   changelog: {
+    git: {
+      tag: true
+    },
     createRelease: "github",
     entryWhenNoChanges: false,
     file: "{projectRoot}/CHANGELOG.md",
@@ -33,6 +36,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
 var DEFAULT_RELEASE_CONFIG = {
   conventionalCommits: DEFAULT_CONVENTIONAL_COMMITS_CONFIG,
   changelog: {
+    git: {
+      tag: true
+    },
     automaticFromRef: true,
     workspaceChangelog: false,
     projectChangelogs: {

package/dist/{chunk-QRP3KP65.js → chunk-WAYANCDV.js}

@@ -12,6 +12,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
   projectsRelationship: "independent",
   releaseTagPattern: "{projectName}@{version}",
   changelog: {
+    git: {
+      tag: true
+    },
     createRelease: "github",
     entryWhenNoChanges: false,
     file: "{projectRoot}/CHANGELOG.md",
@@ -33,6 +36,9 @@ var DEFAULT_RELEASE_GROUP_CONFIG = {
 var DEFAULT_RELEASE_CONFIG = {
   conventionalCommits: DEFAULT_CONVENTIONAL_COMMITS_CONFIG,
   changelog: {
+    git: {
+      tag: true
+    },
     automaticFromRef: true,
     workspaceChangelog: false,
     projectChangelogs: {

package/dist/index.cjs

@@ -5,7 +5,7 @@ var _chunkYCY2PJXXcjs = require('./chunk-YCY2PJXX.cjs');
 
 
 
-var _chunkAZCYMACDcjs = require('./chunk-AZCYMACD.cjs');
+var _chunkPDBBNGUQcjs = require('./chunk-PDBBNGUQ.cjs');
 
 
 
@@ -25,4 +25,4 @@ var _chunkWZADZNEIcjs = require('./chunk-WZADZNEI.cjs');
 
 
 
-exports.DEFAULT_COMMIT_CONFIG = _chunkYCY2PJXXcjs.DEFAULT_COMMIT_CONFIG; exports.DEFAULT_COMMIT_MESSAGE_FORMAT = _chunkWZADZNEIcjs.DEFAULT_COMMIT_MESSAGE_FORMAT; exports.DEFAULT_COMMIT_PROMPT_MESSAGES = _chunkWZADZNEIcjs.DEFAULT_COMMIT_PROMPT_MESSAGES; exports.DEFAULT_COMMIT_QUESTIONS = _chunkWZADZNEIcjs.DEFAULT_COMMIT_QUESTIONS; exports.DEFAULT_COMMIT_SETTINGS = _chunkWZADZNEIcjs.DEFAULT_COMMIT_SETTINGS; exports.DEFAULT_COMMIT_TYPES = _chunkWZADZNEIcjs.DEFAULT_COMMIT_TYPES; exports.DEFAULT_CONVENTIONAL_COMMITS_CONFIG = _chunkAZCYMACDcjs.DEFAULT_CONVENTIONAL_COMMITS_CONFIG; exports.DEFAULT_RELEASE_CONFIG = _chunkAZCYMACDcjs.DEFAULT_RELEASE_CONFIG; exports.DEFAULT_RELEASE_GROUP_CONFIG = _chunkAZCYMACDcjs.DEFAULT_RELEASE_GROUP_CONFIG; exports.RuleConfigSeverity = _chunkWZADZNEIcjs.RuleConfigSeverity;
+exports.DEFAULT_COMMIT_CONFIG = _chunkYCY2PJXXcjs.DEFAULT_COMMIT_CONFIG; exports.DEFAULT_COMMIT_MESSAGE_FORMAT = _chunkWZADZNEIcjs.DEFAULT_COMMIT_MESSAGE_FORMAT; exports.DEFAULT_COMMIT_PROMPT_MESSAGES = _chunkWZADZNEIcjs.DEFAULT_COMMIT_PROMPT_MESSAGES; exports.DEFAULT_COMMIT_QUESTIONS = _chunkWZADZNEIcjs.DEFAULT_COMMIT_QUESTIONS; exports.DEFAULT_COMMIT_SETTINGS = _chunkWZADZNEIcjs.DEFAULT_COMMIT_SETTINGS; exports.DEFAULT_COMMIT_TYPES = _chunkWZADZNEIcjs.DEFAULT_COMMIT_TYPES; exports.DEFAULT_CONVENTIONAL_COMMITS_CONFIG = _chunkPDBBNGUQcjs.DEFAULT_CONVENTIONAL_COMMITS_CONFIG; exports.DEFAULT_RELEASE_CONFIG = _chunkPDBBNGUQcjs.DEFAULT_RELEASE_CONFIG; exports.DEFAULT_RELEASE_GROUP_CONFIG = _chunkPDBBNGUQcjs.DEFAULT_RELEASE_GROUP_CONFIG; exports.RuleConfigSeverity = _chunkWZADZNEIcjs.RuleConfigSeverity;

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   DEFAULT_CONVENTIONAL_COMMITS_CONFIG,
   DEFAULT_RELEASE_CONFIG,
   DEFAULT_RELEASE_GROUP_CONFIG
-} from "./chunk-QRP3KP65.js";
+} from "./chunk-WAYANCDV.js";
 import {
   DEFAULT_COMMIT_MESSAGE_FORMAT,
   DEFAULT_COMMIT_PROMPT_MESSAGES,

package/dist/readme/templates/README.footer.md

@@ -127,7 +127,7 @@ specification. Contributions of any kind welcome!
 </div>
 
 <div align="center">
-<b>Fingerprint:</b> 1BD2 7192 7770 2549 F4C9 F238 E6AD C420 DA5C 4C2D
+<b>Fingerprint:</b> F47F 1853 BCAD DE9B 42C8  6316 9FDE EC95 47FE D106
 </div>
 <br />
 

package/dist/release/config.cjs

@@ -2,10 +2,10 @@
 
 
 
-var _chunkAZCYMACDcjs = require('../chunk-AZCYMACD.cjs');
+var _chunkPDBBNGUQcjs = require('../chunk-PDBBNGUQ.cjs');
 require('../chunk-WZADZNEI.cjs');
 
 
 
 
-exports.DEFAULT_CONVENTIONAL_COMMITS_CONFIG = _chunkAZCYMACDcjs.DEFAULT_CONVENTIONAL_COMMITS_CONFIG; exports.DEFAULT_RELEASE_CONFIG = _chunkAZCYMACDcjs.DEFAULT_RELEASE_CONFIG; exports.DEFAULT_RELEASE_GROUP_CONFIG = _chunkAZCYMACDcjs.DEFAULT_RELEASE_GROUP_CONFIG;
+exports.DEFAULT_CONVENTIONAL_COMMITS_CONFIG = _chunkPDBBNGUQcjs.DEFAULT_CONVENTIONAL_COMMITS_CONFIG; exports.DEFAULT_RELEASE_CONFIG = _chunkPDBBNGUQcjs.DEFAULT_RELEASE_CONFIG; exports.DEFAULT_RELEASE_GROUP_CONFIG = _chunkPDBBNGUQcjs.DEFAULT_RELEASE_GROUP_CONFIG;

package/dist/release/config.d.cts

@@ -334,6 +334,9 @@ declare const DEFAULT_RELEASE_GROUP_CONFIG: {
     projectsRelationship: string;
     releaseTagPattern: string;
     changelog: {
+        git: {
+            tag: boolean;
+        };
         createRelease: string;
         entryWhenNoChanges: boolean;
         file: string;
@@ -682,6 +685,9 @@ declare const DEFAULT_RELEASE_CONFIG: {
         };
     };
     changelog: {
+        git: {
+            tag: boolean;
+        };
         automaticFromRef: boolean;
         workspaceChangelog: boolean;
         projectChangelogs: {

package/dist/release/config.d.ts

@@ -334,6 +334,9 @@ declare const DEFAULT_RELEASE_GROUP_CONFIG: {
     projectsRelationship: string;
     releaseTagPattern: string;
     changelog: {
+        git: {
+            tag: boolean;
+        };
         createRelease: string;
         entryWhenNoChanges: boolean;
         file: string;
@@ -682,6 +685,9 @@ declare const DEFAULT_RELEASE_CONFIG: {
         };
     };
     changelog: {
+        git: {
+            tag: boolean;
+        };
         automaticFromRef: boolean;
         workspaceChangelog: boolean;
         projectChangelogs: {

package/dist/release/config.js

@@ -2,7 +2,7 @@ import {
   DEFAULT_CONVENTIONAL_COMMITS_CONFIG,
   DEFAULT_RELEASE_CONFIG,
   DEFAULT_RELEASE_GROUP_CONFIG
-} from "../chunk-QRP3KP65.js";
+} from "../chunk-WAYANCDV.js";
 import "../chunk-WEKKNQBE.js";
 export {
   DEFAULT_CONVENTIONAL_COMMITS_CONFIG,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storm-software/git-tools",
-  "version": "2.101.3",
+  "version": "2.102.0",
   "type": "module",
   "description": "Tools for managing Git repositories within a Nx workspace.",
   "repository": {