package-versioner 0.8.6 → 0.9.2

package/README.md

@@ -130,7 +130,7 @@ Customize behaviour by creating a `version.config.json` file in your project roo
   "updateChangelog": true,
   "changelogFormat": "keep-a-changelog",
   "strictReachable": false,
-  "synced": true,
+  "sync": true,
   "skip": [
     "docs",
     "e2e"
@@ -160,7 +160,7 @@ Customize behaviour by creating a `version.config.json` file in your project roo
   - `paths`: Directories to search for Cargo.toml files (optional)
 
 #### Monorepo-Specific Options
-- `synced`: Whether all packages should be versioned together (default: true)
+- `sync`: Whether all packages should be versioned together (default: true)
 - `skip`: Array of package names or patterns to exclude from versioning. Supports exact names, scope wildcards, path patterns, and global wildcards (e.g., ["@scope/package-a", "@scope/*", "packages/**/*"])
 - `packages`: Array of package names or patterns to target for versioning. Supports exact names, scope wildcards, path patterns and global wildcards (e.g., ["@scope/package-a", "@scope/*", "*"])
 - `mainPackage`: Package name whose commit history should drive version determination
@@ -234,7 +234,7 @@ This option works in conjunction with `tagTemplate` to control tag formatting. T
 
 **Examples:**
 
-For single-package repositories or synced monorepos:
+For single-package repositories or sync monorepos:
 ```json
 {
   "packageSpecificTags": true,
@@ -253,8 +253,8 @@ For global versioning:
 Creates tags like `v1.2.3`
 
 **Important Notes:**
-- In **synced mode** with a single package, `packageSpecificTags: true` will use the package name even though all packages are versioned together
-- In **synced mode** with multiple packages, package names are not used regardless of the setting
+- In **sync mode** with a single package, `packageSpecificTags: true` will use the package name even though all packages are versioned together
+- In **sync mode** with multiple packages, package names are not used regardless of the setting
 - In **async mode**, each package gets its own tag when `packageSpecificTags` is enabled
 
 With package-specific tagging enabled, the tool will:
@@ -269,7 +269,7 @@ With package-specific tagging enabled, the tool will:
 1.  **Conventional Commits:** Analyzes commit messages (like `feat:`, `fix:`, `BREAKING CHANGE:`) since the last tag.
 2.  **Branch Pattern:** Determines the bump based on the current or recently merged branch name matching predefined patterns.
 
-For a detailed explanation of these concepts and monorepo modes (Synced vs. Async), see [Versioning Strategies and Concepts](./docs/versioning.md).
+For a detailed explanation of these concepts and monorepo modes (Sync vs. Async), see [Versioning Strategies and Concepts](./docs/versioning.md).
 
 ## Documentation
 

package/dist/baseError-XWEU2UI6.js

@@ -0,0 +1,6 @@
+import {
+  BasePackageVersionerError
+} from "./chunk-IXZZQDKS.js";
+export {
+  BasePackageVersionerError
+};

package/dist/chunk-IXZZQDKS.js

@@ -0,0 +1,122 @@
+// src/utils/logging.ts
+import chalk from "chalk";
+import figlet from "figlet";
+
+// src/utils/jsonOutput.ts
+var _jsonOutputMode = false;
+var _jsonData = {
+  dryRun: false,
+  updates: [],
+  tags: []
+};
+function enableJsonOutput(dryRun = false) {
+  _jsonOutputMode = true;
+  _jsonData.dryRun = dryRun;
+  _jsonData.updates = [];
+  _jsonData.tags = [];
+  _jsonData.commitMessage = void 0;
+}
+function isJsonOutputMode() {
+  return _jsonOutputMode;
+}
+function addPackageUpdate(packageName, newVersion, filePath) {
+  if (!_jsonOutputMode) return;
+  _jsonData.updates.push({
+    packageName,
+    newVersion,
+    filePath
+  });
+}
+function addTag(tag) {
+  if (!_jsonOutputMode) return;
+  _jsonData.tags.push(tag);
+}
+function setCommitMessage(message) {
+  if (!_jsonOutputMode) return;
+  _jsonData.commitMessage = message;
+}
+function printJsonOutput() {
+  if (_jsonOutputMode) {
+    console.log(JSON.stringify(_jsonData, null, 2));
+  }
+}
+
+// src/utils/logging.ts
+function log(message, level = "info") {
+  const showDebug = process.env.DEBUG === "true" || process.env.DEBUG === "1";
+  if (level === "debug" && !showDebug) {
+    return;
+  }
+  let chalkFn;
+  switch (level) {
+    case "success":
+      chalkFn = chalk.green;
+      break;
+    case "warning":
+      chalkFn = chalk.yellow;
+      break;
+    case "error":
+      chalkFn = chalk.red;
+      break;
+    case "debug":
+      chalkFn = chalk.gray;
+      break;
+    default:
+      chalkFn = chalk.blue;
+  }
+  if (isJsonOutputMode()) {
+    if (level === "error") {
+      chalkFn(message);
+      console.error(message);
+    }
+    return;
+  }
+  const formattedMessage = level === "debug" ? `[DEBUG] ${message}` : message;
+  if (level === "error") {
+    console.error(chalkFn(formattedMessage));
+  } else {
+    console.log(chalkFn(formattedMessage));
+  }
+}
+
+// src/errors/baseError.ts
+var BasePackageVersionerError = class _BasePackageVersionerError extends Error {
+  constructor(message, code, suggestions) {
+    super(message);
+    this.code = code;
+    this.suggestions = suggestions;
+    this.name = this.constructor.name;
+  }
+  /**
+   * Log the error with consistent formatting and optional suggestions
+   * This centralizes all error output formatting and behavior
+   */
+  logError() {
+    var _a;
+    log(this.message, "error");
+    if ((_a = this.suggestions) == null ? void 0 : _a.length) {
+      log("\nSuggested solutions:", "info");
+      this.suggestions.forEach((suggestion, i) => {
+        log(`${i + 1}. ${suggestion}`, "info");
+      });
+    }
+  }
+  /**
+   * Type guard to check if an error is a package-versioner error
+   * @param error Error to check
+   * @returns true if error is a BasePackageVersionerError
+   */
+  static isPackageVersionerError(error) {
+    return error instanceof _BasePackageVersionerError;
+  }
+};
+
+export {
+  enableJsonOutput,
+  addPackageUpdate,
+  addTag,
+  setCommitMessage,
+  printJsonOutput,
+  log,
+  BasePackageVersionerError
+};

package/dist/index.cjs

@@ -6,6 +6,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -28,32 +31,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  run: () => run
-});
-module.exports = __toCommonJS(index_exports);
-var fs10 = __toESM(require("fs"), 1);
-var import_node_path8 = __toESM(require("path"), 1);
-var import_commander = require("commander");
-
-// src/changelog/changelogRegenerator.ts
-var import_node_child_process2 = require("child_process");
-var import_node_fs = __toESM(require("fs"), 1);
-var import_node_path = __toESM(require("path"), 1);
-
-// src/utils/logging.ts
-var import_chalk = __toESM(require("chalk"), 1);
-var import_figlet = __toESM(require("figlet"), 1);
-
 // src/utils/jsonOutput.ts
-var _jsonOutputMode = false;
-var _jsonData = {
-  dryRun: false,
-  updates: [],
-  tags: []
-};
 function enableJsonOutput(dryRun = false) {
   _jsonOutputMode = true;
   _jsonData.dryRun = dryRun;
@@ -85,6 +63,18 @@ function printJsonOutput() {
     console.log(JSON.stringify(_jsonData, null, 2));
   }
 }
+var _jsonOutputMode, _jsonData;
+var init_jsonOutput = __esm({
+  "src/utils/jsonOutput.ts"() {
+    "use strict";
+    _jsonOutputMode = false;
+    _jsonData = {
+      dryRun: false,
+      updates: [],
+      tags: []
+    };
+  }
+});
 
 // src/utils/logging.ts
 function log(message, level = "info") {
@@ -123,9 +113,78 @@ function log(message, level = "info") {
     console.log(chalkFn(formattedMessage));
   }
 }
+var import_chalk, import_figlet;
+var init_logging = __esm({
+  "src/utils/logging.ts"() {
+    "use strict";
+    import_chalk = __toESM(require("chalk"), 1);
+    import_figlet = __toESM(require("figlet"), 1);
+    init_jsonOutput();
+  }
+});
+
+// src/errors/baseError.ts
+var baseError_exports = {};
+__export(baseError_exports, {
+  BasePackageVersionerError: () => BasePackageVersionerError
+});
+var BasePackageVersionerError;
+var init_baseError = __esm({
+  "src/errors/baseError.ts"() {
+    "use strict";
+    init_logging();
+    BasePackageVersionerError = class _BasePackageVersionerError extends Error {
+      constructor(message, code, suggestions) {
+        super(message);
+        this.code = code;
+        this.suggestions = suggestions;
+        this.name = this.constructor.name;
+      }
+      /**
+       * Log the error with consistent formatting and optional suggestions
+       * This centralizes all error output formatting and behavior
+       */
+      logError() {
+        var _a;
+        log(this.message, "error");
+        if ((_a = this.suggestions) == null ? void 0 : _a.length) {
+          log("\nSuggested solutions:", "info");
+          this.suggestions.forEach((suggestion, i) => {
+            log(`${i + 1}. ${suggestion}`, "info");
+          });
+        }
+      }
+      /**
+       * Type guard to check if an error is a package-versioner error
+       * @param error Error to check
+       * @returns true if error is a BasePackageVersionerError
+       */
+      static isPackageVersionerError(error) {
+        return error instanceof _BasePackageVersionerError;
+      }
+    };
+  }
+});
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  run: () => run
+});
+module.exports = __toCommonJS(index_exports);
+var fs10 = __toESM(require("fs"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
+var import_commander = require("commander");
+
+// src/changelog/changelogRegenerator.ts
+var import_node_child_process2 = require("child_process");
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+init_logging();
 
 // src/changelog/commitParser.ts
 var import_node_child_process = require("child_process");
+init_logging();
 var CONVENTIONAL_COMMIT_REGEX = /^(\w+)(?:\(([^)]+)\))?(!)?: (.+)(?:\n\n([\s\S]*))?/;
 var BREAKING_CHANGE_REGEX = /BREAKING CHANGE: ([\s\S]+?)(?:\n\n|$)/;
 function extractChangelogEntriesFromCommits(projectDir, revisionRange) {
@@ -640,12 +699,8 @@ var import_node_process5 = require("process");
 var import_get_packages = require("@manypkg/get-packages");
 
 // src/errors/gitError.ts
-var GitError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "GitError";
-  }
+init_baseError();
+var GitError = class extends BasePackageVersionerError {
 };
 function createGitError(code, details) {
   const messages = {
@@ -653,20 +708,32 @@ function createGitError(code, details) {
     ["GIT_PROCESS_ERROR" /* GIT_PROCESS_ERROR */]: "Failed to create new version",
     ["NO_FILES" /* NO_FILES */]: "No files specified for commit",
     ["NO_COMMIT_MESSAGE" /* NO_COMMIT_MESSAGE */]: "Commit message is required",
-    ["GIT_ERROR" /* GIT_ERROR */]: "Git operation failed"
+    ["GIT_ERROR" /* GIT_ERROR */]: "Git operation failed",
+    ["TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */]: "Git tag already exists"
+  };
+  const suggestions = {
+    ["NOT_GIT_REPO" /* NOT_GIT_REPO */]: [
+      "Initialize git repository with: git init",
+      "Ensure you are in the correct directory"
+    ],
+    ["TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */]: [
+      "Delete the existing tag: git tag -d <tag-name>",
+      "Use a different version by incrementing manually",
+      "Check if this version was already released"
+    ],
+    ["GIT_PROCESS_ERROR" /* GIT_PROCESS_ERROR */]: void 0,
+    ["NO_FILES" /* NO_FILES */]: void 0,
+    ["NO_COMMIT_MESSAGE" /* NO_COMMIT_MESSAGE */]: void 0,
+    ["GIT_ERROR" /* GIT_ERROR */]: void 0
   };
   const baseMessage = messages[code];
   const fullMessage = details ? `${baseMessage}: ${details}` : baseMessage;
-  return new GitError(fullMessage, code);
+  return new GitError(fullMessage, code, suggestions[code]);
 }
 
 // src/errors/versionError.ts
-var VersionError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "VersionError";
-  }
+init_baseError();
+var VersionError = class extends BasePackageVersionerError {
 };
 function createVersionError(code, details) {
   const messages = {
@@ -677,14 +744,49 @@ function createVersionError(code, details) {
     ["PACKAGE_NOT_FOUND" /* PACKAGE_NOT_FOUND */]: "Package not found",
     ["VERSION_CALCULATION_ERROR" /* VERSION_CALCULATION_ERROR */]: "Failed to calculate version"
   };
+  const suggestions = {
+    ["CONFIG_REQUIRED" /* CONFIG_REQUIRED */]: [
+      "Create a version.config.json file in your project root",
+      "Check the documentation for configuration examples"
+    ],
+    ["PACKAGES_NOT_FOUND" /* PACKAGES_NOT_FOUND */]: [
+      "Ensure package.json or Cargo.toml files exist in your project",
+      "Check workspace configuration (pnpm-workspace.yaml, etc.)",
+      "Verify file permissions and paths"
+    ],
+    ["WORKSPACE_ERROR" /* WORKSPACE_ERROR */]: [
+      "Verify workspace configuration files are valid",
+      "Check that workspace packages are accessible",
+      "Ensure proper monorepo structure"
+    ],
+    ["INVALID_CONFIG" /* INVALID_CONFIG */]: [
+      "Validate version.config.json syntax",
+      "Check configuration against schema",
+      "Review documentation for valid configuration options"
+    ],
+    ["PACKAGE_NOT_FOUND" /* PACKAGE_NOT_FOUND */]: [
+      "Verify package name spelling and case",
+      "Check if package exists in workspace",
+      "Review packages configuration in version.config.json"
+    ],
+    ["VERSION_CALCULATION_ERROR" /* VERSION_CALCULATION_ERROR */]: [
+      "Ensure git repository has commits",
+      "Check conventional commit message format",
+      "Verify git tags are properly formatted"
+    ]
+  };
   const baseMessage = messages[code];
   const fullMessage = details ? `${baseMessage}: ${details}` : baseMessage;
-  return new VersionError(fullMessage, code);
+  return new VersionError(fullMessage, code, suggestions[code]);
 }
 
+// src/core/versionEngine.ts
+init_logging();
+
 // src/utils/packageFiltering.ts
 var import_node_path2 = __toESM(require("path"), 1);
 var import_micromatch = __toESM(require("micromatch"), 1);
+init_logging();
 function filterPackagesByConfig(packages, configTargets, workspaceRoot) {
   if (configTargets.length === 0) {
     log("No config targets specified, returning all packages", "debug");
@@ -770,6 +872,7 @@ var path8 = __toESM(require("path"), 1);
 // src/changelog/changelogManager.ts
 var fs3 = __toESM(require("fs"), 1);
 var path3 = __toESM(require("path"), 1);
+init_logging();
 function updateChangelog(packagePath, packageName, version, entries, repoUrl, format = "keep-a-changelog") {
   try {
     const changelogPath = path3.join(packagePath, "CHANGELOG.md");
@@ -844,8 +947,13 @@ ${newVersionContent}
   }
 }
 
+// src/core/versionStrategies.ts
+init_baseError();
+
 // src/git/commands.ts
 var import_node_process2 = require("process");
+init_jsonOutput();
+init_logging();
 
 // src/git/commandExecutor.ts
 var import_node_child_process3 = require("child_process");
@@ -916,7 +1024,18 @@ async function gitCommit(options) {
 async function createGitTag(options) {
   const { tag, message = "", args = "" } = options;
   const command = `git tag -a -m "${message}" ${tag} ${args}`;
-  return execAsync(command);
+  try {
+    return await execAsync(command);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (errorMessage.includes("already exists")) {
+      throw createGitError(
+        "TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */,
+        `Tag '${tag}' already exists in the repository. Please use a different version or delete the existing tag first.`
+      );
+    }
+    throw createGitError("GIT_ERROR" /* GIT_ERROR */, errorMessage);
+  }
 }
 async function gitProcess(options) {
   const { files, nextTag, commitMessage, skipHooks, dryRun } = options;
@@ -949,6 +1068,13 @@ async function gitProcess(options) {
     }
   } catch (err) {
     const errorMessage = err instanceof Error ? err.message : String(err);
+    if (errorMessage.includes("already exists") && nextTag) {
+      log(`Tag '${nextTag}' already exists in the repository.`, "error");
+      throw createGitError(
+        "TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */,
+        `Tag '${nextTag}' already exists in the repository. Please use a different version or delete the existing tag first.`
+      );
+    }
     log(`Git process error: ${errorMessage}`, "error");
     if (err instanceof Error && err.stack) {
       console.error("Git process stack trace:");
@@ -980,6 +1106,9 @@ async function createGitCommitAndTag(files, nextTag, commitMessage, skipHooks, d
       log(`Created tag: ${nextTag}`, "success");
     }
   } catch (error) {
+    if (error instanceof GitError) {
+      throw error;
+    }
     const errorMessage = error instanceof Error ? error.message : String(error);
     log(`Failed to create git commit and tag: ${errorMessage}`, "error");
     if (error instanceof Error) {
@@ -1003,6 +1132,7 @@ var import_git_semver_tags = require("git-semver-tags");
 var import_semver = __toESM(require("semver"), 1);
 
 // src/utils/formatting.ts
+init_logging();
 function escapeRegExp(string) {
   return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -1012,7 +1142,7 @@ function formatVersionPrefix(prefix) {
 function formatTag(version, prefix, packageName, template, packageSpecificTags) {
   if ((template == null ? void 0 : template.includes("${packageName}")) && !packageName) {
     log(
-      'Warning: Your tagTemplate contains ${packageName} but no package name is available.\nThis will result in an empty package name in the tag (e.g., "@v1.0.0" instead of "my-package@v1.0.0").\n\nTo fix this:\n\u2022 If using synced mode: Set "packageSpecificTags": true in your config to enable package names in tags\n\u2022 If you want global tags: Remove ${packageName} from your tagTemplate (e.g., use "${prefix}${version}")\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
+      'Warning: Your tagTemplate contains ${packageName} but no package name is available.\nThis will result in an empty package name in the tag (e.g., "@v1.0.0" instead of "my-package@v1.0.0").\n\nTo fix this:\n\u2022 If using sync mode: Set "packageSpecificTags": true in your config to enable package names in tags\n\u2022 If you want global tags: Remove ${packageName} from your tagTemplate (e.g., use "${prefix}${version}")\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
       "warning"
     );
   }
@@ -1027,7 +1157,7 @@ function formatTag(version, prefix, packageName, template, packageSpecificTags)
 function formatCommitMessage(template, version, packageName, additionalContext) {
   if (template.includes("${packageName}") && !packageName) {
     log(
-      'Warning: Your commitMessage template contains ${packageName} but no package name is available.\nThis will result in an empty package name in the commit message (e.g., "Release @v1.0.0").\n\nTo fix this:\n\u2022 If using synced mode: Set "packageSpecificTags": true to enable package names in commits\n\u2022 If you want generic commit messages: Remove ${packageName} from your commitMessage template\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
+      'Warning: Your commitMessage template contains ${packageName} but no package name is available.\nThis will result in an empty package name in the commit message (e.g., "Release @v1.0.0").\n\nTo fix this:\n\u2022 If using sync mode: Set "packageSpecificTags": true to enable package names in commits\n\u2022 If you want generic commit messages: Remove ${packageName} from your commitMessage template\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
       "warning"
     );
   }
@@ -1045,6 +1175,7 @@ function formatCommitMessage(template, version, packageName, additionalContext)
 }
 
 // src/git/tagsAndBranches.ts
+init_logging();
 function getCommitsLength(pkgRoot, sinceTag) {
   try {
     let gitCommand;
@@ -1242,6 +1373,8 @@ var import_node_path5 = __toESM(require("path"), 1);
 var import_node_fs3 = __toESM(require("fs"), 1);
 var import_node_path4 = __toESM(require("path"), 1);
 var TOML = __toESM(require("smol-toml"), 1);
+init_jsonOutput();
+init_logging();
 function getCargoInfo(cargoPath) {
   var _a;
   if (!import_node_fs3.default.existsSync(cargoPath)) {
@@ -1302,6 +1435,8 @@ function updateCargoVersion(cargoPath, version) {
 }
 
 // src/package/packageManagement.ts
+init_jsonOutput();
+init_logging();
 function updatePackageVersion(packagePath, version) {
   if (isCargoToml(packagePath)) {
     updateCargoVersion(packagePath, version);
@@ -1334,10 +1469,12 @@ var import_node_process4 = require("process");
 var import_node_process3 = require("process");
 var import_conventional_recommended_bump = require("conventional-recommended-bump");
 var import_semver3 = __toESM(require("semver"), 1);
+init_logging();
 
 // src/utils/manifestHelpers.ts
 var import_node_fs5 = __toESM(require("fs"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
+init_logging();
 function getVersionFromManifests(packageDir) {
   const packageJsonPath = import_node_path6.default.join(packageDir, "package.json");
   const cargoTomlPath = import_node_path6.default.join(packageDir, "Cargo.toml");
@@ -1419,6 +1556,7 @@ function verifyTag(tagName, cwd5) {
 }
 
 // src/utils/versionUtils.ts
+init_logging();
 var STANDARD_BUMP_TYPES = ["major", "minor", "patch"];
 function normalizePrereleaseIdentifier(prereleaseIdentifier, config) {
   if (prereleaseIdentifier === true) {
@@ -1668,8 +1806,13 @@ async function calculateVersion(config, options) {
   }
 }
 
+// src/package/packageProcessor.ts
+init_jsonOutput();
+init_logging();
+
 // src/utils/packageMatching.ts
 var import_micromatch2 = __toESM(require("micromatch"), 1);
+init_logging();
 function matchesPackageTarget(packageName, target) {
   if (packageName === target) {
     return true;
@@ -1993,11 +2136,12 @@ var PackageProcessor = class {
 };
 
 // src/core/versionStrategies.ts
+init_logging();
 function shouldProcessPackage2(pkg, config) {
   const pkgName = pkg.packageJson.name;
   return shouldProcessPackage(pkgName, config.skip);
 }
-function createSyncedStrategy(config) {
+function createSyncStrategy(config) {
   return async (packages) => {
     try {
       const {
@@ -2124,8 +2268,8 @@ function createSyncedStrategy(config) {
       );
       await createGitCommitAndTag(files, nextTag, formattedCommitMessage, skipHooks, dryRun);
     } catch (error) {
-      if (error instanceof VersionError || error instanceof GitError) {
-        log(`Synced Strategy failed: ${error.message} (${error.code || "UNKNOWN"})`, "error");
+      if (BasePackageVersionerError.isPackageVersionerError(error)) {
+        log(`Synced Strategy failed: ${error.message} (${error.code})`, "error");
       } else {
         const errorMessage = error instanceof Error ? error.message : String(error);
         log(`Synced Strategy failed: ${errorMessage}`, "error");
@@ -2274,8 +2418,8 @@ function createSingleStrategy(config) {
         log(`Would create tag: ${tagName}`, "info");
       }
     } catch (error) {
-      if (error instanceof VersionError || error instanceof GitError) {
-        log(`Single Strategy failed: ${error.message} (${error.code || "UNKNOWN"})`, "error");
+      if (BasePackageVersionerError.isPackageVersionerError(error)) {
+        log(`Single Strategy failed: ${error.message} (${error.code})`, "error");
       } else {
         const errorMessage = error instanceof Error ? error.message : String(error);
         log(`Single Strategy failed: ${errorMessage}`, "error");
@@ -2306,10 +2450,21 @@ function createAsyncStrategy(config) {
     }
   };
   const packageProcessor = new PackageProcessor(processorOptions);
-  return async (packages, _targets = []) => {
+  return async (packages, targets = []) => {
     try {
-      log(`Processing ${packages.packages.length} pre-filtered packages`, "info");
-      const result = await packageProcessor.processPackages(packages.packages);
+      let packagesToProcess = packages.packages;
+      if (targets.length > 0) {
+        const beforeCount = packagesToProcess.length;
+        packagesToProcess = packagesToProcess.filter(
+          (pkg) => targets.includes(pkg.packageJson.name)
+        );
+        log(
+          `Runtime targets filter: ${beforeCount} \u2192 ${packagesToProcess.length} packages (${targets.join(", ")})`,
+          "info"
+        );
+      }
+      log(`Processing ${packagesToProcess.length} packages`, "info");
+      const result = await packageProcessor.processPackages(packagesToProcess);
       if (result.updatedPackages.length === 0) {
         log("No packages required a version update.", "info");
       } else {
@@ -2323,8 +2478,8 @@ function createAsyncStrategy(config) {
         }
       }
     } catch (error) {
-      if (error instanceof VersionError || error instanceof GitError) {
-        log(`Async Strategy failed: ${error.message} (${error.code || "UNKNOWN"})`, "error");
+      if (BasePackageVersionerError.isPackageVersionerError(error)) {
+        log(`Async Strategy failed: ${error.message} (${error.code})`, "error");
       } else {
         const errorMessage = error instanceof Error ? error.message : String(error);
         log(`Async Strategy failed: ${errorMessage}`, "error");
@@ -2334,14 +2489,14 @@ function createAsyncStrategy(config) {
   };
 }
 function createStrategy(config) {
-  if (config.synced) {
-    return createSyncedStrategy(config);
+  if (config.sync) {
+    return createSyncStrategy(config);
   }
   return createAsyncStrategy(config);
 }
 function createStrategyMap(config) {
   return {
-    synced: createSyncedStrategy(config),
+    sync: createSyncStrategy(config),
     single: createSingleStrategy(config),
     async: createAsyncStrategy(config)
   };
@@ -2442,7 +2597,7 @@ var VersionEngine = class {
   }
   /**
    * Change the current strategy
-   * @param strategyType The strategy type to use: 'synced', 'single', or 'async'
+   * @param strategyType The strategy type to use: 'sync', 'single', or 'async'
    */
   setStrategy(strategyType) {
     this.currentStrategy = this.strategies[strategyType];
@@ -2450,6 +2605,8 @@ var VersionEngine = class {
 };
 
 // src/index.ts
+init_jsonOutput();
+init_logging();
 var import_meta = {};
 function getPackageVersion() {
   try {
@@ -2477,7 +2634,7 @@ async function run() {
     program.command("version", { isDefault: true }).description("Version a package or packages based on configuration").option(
       "-c, --config <path>",
       "Path to config file (defaults to version.config.json in current directory)"
-    ).option("-d, --dry-run", "Dry run (no changes made)", false).option("-b, --bump <type>", "Specify bump type (patch|minor|major)").option("-p, --prerelease [identifier]", "Create prerelease version").option("-s, --synced", "Use synchronized versioning across all packages").option("-j, --json", "Output results as JSON", false).option("-t, --target <packages>", "Comma-delimited list of package names to target").option("--project-dir <path>", "Project directory to run commands in", process.cwd()).action(async (options) => {
+    ).option("-d, --dry-run", "Dry run (no changes made)", false).option("-b, --bump <type>", "Specify bump type (patch|minor|major)").option("-p, --prerelease [identifier]", "Create prerelease version").option("-s, --sync", "Use synchronized versioning across all packages").option("-j, --json", "Output results as JSON", false).option("-t, --target <packages>", "Comma-delimited list of package names to target").option("--project-dir <path>", "Project directory to run commands in", process.cwd()).action(async (options) => {
       if (options.json) {
         enableJsonOutput(options.dryRun);
       }
@@ -2496,22 +2653,26 @@ async function run() {
         const config = await loadConfig(options.config);
         log(`Loaded configuration from ${options.config || "version.config.json"}`, "info");
         if (options.dryRun) config.dryRun = true;
-        if (options.synced) config.synced = true;
+        if (options.sync) config.sync = true;
         if (options.bump) config.type = options.bump;
         if (options.prerelease) {
           config.prereleaseIdentifier = options.prerelease === true ? "next" : options.prerelease;
           config.isPrerelease = true;
         }
         const cliTargets = options.target ? options.target.split(",").map((t) => t.trim()) : [];
+        if (cliTargets.length > 0) {
+          config.packages = cliTargets;
+          log(`CLI targets specified: ${cliTargets.join(", ")}`, "info");
+        }
         const engine = new VersionEngine(config, !!options.json);
         const pkgsResult = await engine.getWorkspacePackages();
         const resolvedCount = pkgsResult.packages.length;
         log(`Resolved ${resolvedCount} packages from workspace`, "debug");
         log(`Config packages: ${JSON.stringify(config.packages)}`, "debug");
-        log(`Config synced: ${config.synced}`, "debug");
-        if (config.synced) {
-          log("Using synced versioning strategy.", "info");
-          engine.setStrategy("synced");
+        log(`Config sync: ${config.sync}`, "debug");
+        if (config.sync) {
+          log("Using sync versioning strategy.", "info");
+          engine.setStrategy("sync");
           await engine.run(pkgsResult);
         } else if (resolvedCount === 1) {
           log("Using single package versioning strategy.", "info");
@@ -2533,14 +2694,19 @@ async function run() {
         log("Versioning process completed.", "success");
         printJsonOutput();
       } catch (error) {
-        log(error instanceof Error ? error.message : String(error), "error");
-        if (error instanceof Error) {
-          console.error("Error details:");
-          console.error(error.stack || error.message);
-          if (error.message.includes("Command failed:")) {
-            const cmdOutput = error.message.split("Command failed:")[1];
-            if (cmdOutput) {
-              console.error("Command output:", cmdOutput.trim());
+        const { BasePackageVersionerError: BasePackageVersionerError2 } = await Promise.resolve().then(() => (init_baseError(), baseError_exports));
+        if (BasePackageVersionerError2.isPackageVersionerError(error)) {
+          error.logError();
+        } else {
+          log(error instanceof Error ? error.message : String(error), "error");
+          if (error instanceof Error) {
+            console.error("Error details:");
+            console.error(error.stack || error.message);
+            if (error.message.includes("Command failed:")) {
+              const cmdOutput = error.message.split("Command failed:")[1];
+              if (cmdOutput) {
+                console.error("Command output:", cmdOutput.trim());
+              }
             }
           }
         }

package/dist/index.js

@@ -1,4 +1,13 @@
 #!/usr/bin/env node
+import {
+  BasePackageVersionerError,
+  addPackageUpdate,
+  addTag,
+  enableJsonOutput,
+  log,
+  printJsonOutput,
+  setCommitMessage
+} from "./chunk-IXZZQDKS.js";
 
 // src/index.ts
 import * as fs10 from "fs";
@@ -10,87 +19,6 @@ import { execSync as execSync2 } from "child_process";
 import fs from "fs";
 import path from "path";
 
-// src/utils/logging.ts
-import chalk from "chalk";
-import figlet from "figlet";
-
-// src/utils/jsonOutput.ts
-var _jsonOutputMode = false;
-var _jsonData = {
-  dryRun: false,
-  updates: [],
-  tags: []
-};
-function enableJsonOutput(dryRun = false) {
-  _jsonOutputMode = true;
-  _jsonData.dryRun = dryRun;
-  _jsonData.updates = [];
-  _jsonData.tags = [];
-  _jsonData.commitMessage = void 0;
-}
-function isJsonOutputMode() {
-  return _jsonOutputMode;
-}
-function addPackageUpdate(packageName, newVersion, filePath) {
-  if (!_jsonOutputMode) return;
-  _jsonData.updates.push({
-    packageName,
-    newVersion,
-    filePath
-  });
-}
-function addTag(tag) {
-  if (!_jsonOutputMode) return;
-  _jsonData.tags.push(tag);
-}
-function setCommitMessage(message) {
-  if (!_jsonOutputMode) return;
-  _jsonData.commitMessage = message;
-}
-function printJsonOutput() {
-  if (_jsonOutputMode) {
-    console.log(JSON.stringify(_jsonData, null, 2));
-  }
-}
-
-// src/utils/logging.ts
-function log(message, level = "info") {
-  const showDebug = process.env.DEBUG === "true" || process.env.DEBUG === "1";
-  if (level === "debug" && !showDebug) {
-    return;
-  }
-  let chalkFn;
-  switch (level) {
-    case "success":
-      chalkFn = chalk.green;
-      break;
-    case "warning":
-      chalkFn = chalk.yellow;
-      break;
-    case "error":
-      chalkFn = chalk.red;
-      break;
-    case "debug":
-      chalkFn = chalk.gray;
-      break;
-    default:
-      chalkFn = chalk.blue;
-  }
-  if (isJsonOutputMode()) {
-    if (level === "error") {
-      chalkFn(message);
-      console.error(message);
-    }
-    return;
-  }
-  const formattedMessage = level === "debug" ? `[DEBUG] ${message}` : message;
-  if (level === "error") {
-    console.error(chalkFn(formattedMessage));
-  } else {
-    console.log(chalkFn(formattedMessage));
-  }
-}
-
 // src/changelog/commitParser.ts
 import { execSync } from "child_process";
 var CONVENTIONAL_COMMIT_REGEX = /^(\w+)(?:\(([^)]+)\))?(!)?: (.+)(?:\n\n([\s\S]*))?/;
@@ -607,12 +535,7 @@ import { cwd as cwd4 } from "process";
 import { getPackagesSync } from "@manypkg/get-packages";
 
 // src/errors/gitError.ts
-var GitError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "GitError";
-  }
+var GitError = class extends BasePackageVersionerError {
 };
 function createGitError(code, details) {
   const messages = {
@@ -620,20 +543,31 @@ function createGitError(code, details) {
     ["GIT_PROCESS_ERROR" /* GIT_PROCESS_ERROR */]: "Failed to create new version",
     ["NO_FILES" /* NO_FILES */]: "No files specified for commit",
     ["NO_COMMIT_MESSAGE" /* NO_COMMIT_MESSAGE */]: "Commit message is required",
-    ["GIT_ERROR" /* GIT_ERROR */]: "Git operation failed"
+    ["GIT_ERROR" /* GIT_ERROR */]: "Git operation failed",
+    ["TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */]: "Git tag already exists"
+  };
+  const suggestions = {
+    ["NOT_GIT_REPO" /* NOT_GIT_REPO */]: [
+      "Initialize git repository with: git init",
+      "Ensure you are in the correct directory"
+    ],
+    ["TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */]: [
+      "Delete the existing tag: git tag -d <tag-name>",
+      "Use a different version by incrementing manually",
+      "Check if this version was already released"
+    ],
+    ["GIT_PROCESS_ERROR" /* GIT_PROCESS_ERROR */]: void 0,
+    ["NO_FILES" /* NO_FILES */]: void 0,
+    ["NO_COMMIT_MESSAGE" /* NO_COMMIT_MESSAGE */]: void 0,
+    ["GIT_ERROR" /* GIT_ERROR */]: void 0
   };
   const baseMessage = messages[code];
   const fullMessage = details ? `${baseMessage}: ${details}` : baseMessage;
-  return new GitError(fullMessage, code);
+  return new GitError(fullMessage, code, suggestions[code]);
 }
 
 // src/errors/versionError.ts
-var VersionError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "VersionError";
-  }
+var VersionError = class extends BasePackageVersionerError {
 };
 function createVersionError(code, details) {
   const messages = {
@@ -644,9 +578,40 @@ function createVersionError(code, details) {
     ["PACKAGE_NOT_FOUND" /* PACKAGE_NOT_FOUND */]: "Package not found",
     ["VERSION_CALCULATION_ERROR" /* VERSION_CALCULATION_ERROR */]: "Failed to calculate version"
   };
+  const suggestions = {
+    ["CONFIG_REQUIRED" /* CONFIG_REQUIRED */]: [
+      "Create a version.config.json file in your project root",
+      "Check the documentation for configuration examples"
+    ],
+    ["PACKAGES_NOT_FOUND" /* PACKAGES_NOT_FOUND */]: [
+      "Ensure package.json or Cargo.toml files exist in your project",
+      "Check workspace configuration (pnpm-workspace.yaml, etc.)",
+      "Verify file permissions and paths"
+    ],
+    ["WORKSPACE_ERROR" /* WORKSPACE_ERROR */]: [
+      "Verify workspace configuration files are valid",
+      "Check that workspace packages are accessible",
+      "Ensure proper monorepo structure"
+    ],
+    ["INVALID_CONFIG" /* INVALID_CONFIG */]: [
+      "Validate version.config.json syntax",
+      "Check configuration against schema",
+      "Review documentation for valid configuration options"
+    ],
+    ["PACKAGE_NOT_FOUND" /* PACKAGE_NOT_FOUND */]: [
+      "Verify package name spelling and case",
+      "Check if package exists in workspace",
+      "Review packages configuration in version.config.json"
+    ],
+    ["VERSION_CALCULATION_ERROR" /* VERSION_CALCULATION_ERROR */]: [
+      "Ensure git repository has commits",
+      "Check conventional commit message format",
+      "Verify git tags are properly formatted"
+    ]
+  };
   const baseMessage = messages[code];
   const fullMessage = details ? `${baseMessage}: ${details}` : baseMessage;
-  return new VersionError(fullMessage, code);
+  return new VersionError(fullMessage, code, suggestions[code]);
 }
 
 // src/utils/packageFiltering.ts
@@ -883,7 +848,18 @@ async function gitCommit(options) {
 async function createGitTag(options) {
   const { tag, message = "", args = "" } = options;
   const command = `git tag -a -m "${message}" ${tag} ${args}`;
-  return execAsync(command);
+  try {
+    return await execAsync(command);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (errorMessage.includes("already exists")) {
+      throw createGitError(
+        "TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */,
+        `Tag '${tag}' already exists in the repository. Please use a different version or delete the existing tag first.`
+      );
+    }
+    throw createGitError("GIT_ERROR" /* GIT_ERROR */, errorMessage);
+  }
 }
 async function gitProcess(options) {
   const { files, nextTag, commitMessage, skipHooks, dryRun } = options;
@@ -916,6 +892,13 @@ async function gitProcess(options) {
     }
   } catch (err) {
     const errorMessage = err instanceof Error ? err.message : String(err);
+    if (errorMessage.includes("already exists") && nextTag) {
+      log(`Tag '${nextTag}' already exists in the repository.`, "error");
+      throw createGitError(
+        "TAG_ALREADY_EXISTS" /* TAG_ALREADY_EXISTS */,
+        `Tag '${nextTag}' already exists in the repository. Please use a different version or delete the existing tag first.`
+      );
+    }
     log(`Git process error: ${errorMessage}`, "error");
     if (err instanceof Error && err.stack) {
       console.error("Git process stack trace:");
@@ -947,6 +930,9 @@ async function createGitCommitAndTag(files, nextTag, commitMessage, skipHooks, d
       log(`Created tag: ${nextTag}`, "success");
     }
   } catch (error) {
+    if (error instanceof GitError) {
+      throw error;
+    }
     const errorMessage = error instanceof Error ? error.message : String(error);
     log(`Failed to create git commit and tag: ${errorMessage}`, "error");
     if (error instanceof Error) {
@@ -979,7 +965,7 @@ function formatVersionPrefix(prefix) {
 function formatTag(version, prefix, packageName, template, packageSpecificTags) {
   if ((template == null ? void 0 : template.includes("${packageName}")) && !packageName) {
     log(
-      'Warning: Your tagTemplate contains ${packageName} but no package name is available.\nThis will result in an empty package name in the tag (e.g., "@v1.0.0" instead of "my-package@v1.0.0").\n\nTo fix this:\n\u2022 If using synced mode: Set "packageSpecificTags": true in your config to enable package names in tags\n\u2022 If you want global tags: Remove ${packageName} from your tagTemplate (e.g., use "${prefix}${version}")\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
+      'Warning: Your tagTemplate contains ${packageName} but no package name is available.\nThis will result in an empty package name in the tag (e.g., "@v1.0.0" instead of "my-package@v1.0.0").\n\nTo fix this:\n\u2022 If using sync mode: Set "packageSpecificTags": true in your config to enable package names in tags\n\u2022 If you want global tags: Remove ${packageName} from your tagTemplate (e.g., use "${prefix}${version}")\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
       "warning"
     );
   }
@@ -994,7 +980,7 @@ function formatTag(version, prefix, packageName, template, packageSpecificTags)
 function formatCommitMessage(template, version, packageName, additionalContext) {
   if (template.includes("${packageName}") && !packageName) {
     log(
-      'Warning: Your commitMessage template contains ${packageName} but no package name is available.\nThis will result in an empty package name in the commit message (e.g., "Release @v1.0.0").\n\nTo fix this:\n\u2022 If using synced mode: Set "packageSpecificTags": true to enable package names in commits\n\u2022 If you want generic commit messages: Remove ${packageName} from your commitMessage template\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
+      'Warning: Your commitMessage template contains ${packageName} but no package name is available.\nThis will result in an empty package name in the commit message (e.g., "Release @v1.0.0").\n\nTo fix this:\n\u2022 If using sync mode: Set "packageSpecificTags": true to enable package names in commits\n\u2022 If you want generic commit messages: Remove ${packageName} from your commitMessage template\n\u2022 If using single/async mode: Ensure your package.json has a valid "name" field',
       "warning"
     );
   }
@@ -1964,7 +1950,7 @@ function shouldProcessPackage2(pkg, config) {
   const pkgName = pkg.packageJson.name;
   return shouldProcessPackage(pkgName, config.skip);
 }
-function createSyncedStrategy(config) {
+function createSyncStrategy(config) {
   return async (packages) => {
     try {
       const {
@@ -2091,8 +2077,8 @@ function createSyncedStrategy(config) {
       );
       await createGitCommitAndTag(files, nextTag, formattedCommitMessage, skipHooks, dryRun);
     } catch (error) {
-      if (error instanceof VersionError || error instanceof GitError) {
-        log(`Synced Strategy failed: ${error.message} (${error.code || "UNKNOWN"})`, "error");
+      if (BasePackageVersionerError.isPackageVersionerError(error)) {
+        log(`Synced Strategy failed: ${error.message} (${error.code})`, "error");
       } else {
         const errorMessage = error instanceof Error ? error.message : String(error);
         log(`Synced Strategy failed: ${errorMessage}`, "error");
@@ -2241,8 +2227,8 @@ function createSingleStrategy(config) {
         log(`Would create tag: ${tagName}`, "info");
       }
     } catch (error) {
-      if (error instanceof VersionError || error instanceof GitError) {
-        log(`Single Strategy failed: ${error.message} (${error.code || "UNKNOWN"})`, "error");
+      if (BasePackageVersionerError.isPackageVersionerError(error)) {
+        log(`Single Strategy failed: ${error.message} (${error.code})`, "error");
       } else {
         const errorMessage = error instanceof Error ? error.message : String(error);
         log(`Single Strategy failed: ${errorMessage}`, "error");
@@ -2273,10 +2259,21 @@ function createAsyncStrategy(config) {
     }
   };
   const packageProcessor = new PackageProcessor(processorOptions);
-  return async (packages, _targets = []) => {
+  return async (packages, targets = []) => {
     try {
-      log(`Processing ${packages.packages.length} pre-filtered packages`, "info");
-      const result = await packageProcessor.processPackages(packages.packages);
+      let packagesToProcess = packages.packages;
+      if (targets.length > 0) {
+        const beforeCount = packagesToProcess.length;
+        packagesToProcess = packagesToProcess.filter(
+          (pkg) => targets.includes(pkg.packageJson.name)
+        );
+        log(
+          `Runtime targets filter: ${beforeCount} \u2192 ${packagesToProcess.length} packages (${targets.join(", ")})`,
+          "info"
+        );
+      }
+      log(`Processing ${packagesToProcess.length} packages`, "info");
+      const result = await packageProcessor.processPackages(packagesToProcess);
       if (result.updatedPackages.length === 0) {
         log("No packages required a version update.", "info");
       } else {
@@ -2290,8 +2287,8 @@ function createAsyncStrategy(config) {
         }
       }
     } catch (error) {
-      if (error instanceof VersionError || error instanceof GitError) {
-        log(`Async Strategy failed: ${error.message} (${error.code || "UNKNOWN"})`, "error");
+      if (BasePackageVersionerError.isPackageVersionerError(error)) {
+        log(`Async Strategy failed: ${error.message} (${error.code})`, "error");
       } else {
         const errorMessage = error instanceof Error ? error.message : String(error);
         log(`Async Strategy failed: ${errorMessage}`, "error");
@@ -2301,14 +2298,14 @@ function createAsyncStrategy(config) {
   };
 }
 function createStrategy(config) {
-  if (config.synced) {
-    return createSyncedStrategy(config);
+  if (config.sync) {
+    return createSyncStrategy(config);
   }
   return createAsyncStrategy(config);
 }
 function createStrategyMap(config) {
   return {
-    synced: createSyncedStrategy(config),
+    sync: createSyncStrategy(config),
     single: createSingleStrategy(config),
     async: createAsyncStrategy(config)
   };
@@ -2409,7 +2406,7 @@ var VersionEngine = class {
   }
   /**
    * Change the current strategy
-   * @param strategyType The strategy type to use: 'synced', 'single', or 'async'
+   * @param strategyType The strategy type to use: 'sync', 'single', or 'async'
    */
   setStrategy(strategyType) {
     this.currentStrategy = this.strategies[strategyType];
@@ -2443,7 +2440,7 @@ async function run() {
     program.command("version", { isDefault: true }).description("Version a package or packages based on configuration").option(
       "-c, --config <path>",
       "Path to config file (defaults to version.config.json in current directory)"
-    ).option("-d, --dry-run", "Dry run (no changes made)", false).option("-b, --bump <type>", "Specify bump type (patch|minor|major)").option("-p, --prerelease [identifier]", "Create prerelease version").option("-s, --synced", "Use synchronized versioning across all packages").option("-j, --json", "Output results as JSON", false).option("-t, --target <packages>", "Comma-delimited list of package names to target").option("--project-dir <path>", "Project directory to run commands in", process.cwd()).action(async (options) => {
+    ).option("-d, --dry-run", "Dry run (no changes made)", false).option("-b, --bump <type>", "Specify bump type (patch|minor|major)").option("-p, --prerelease [identifier]", "Create prerelease version").option("-s, --sync", "Use synchronized versioning across all packages").option("-j, --json", "Output results as JSON", false).option("-t, --target <packages>", "Comma-delimited list of package names to target").option("--project-dir <path>", "Project directory to run commands in", process.cwd()).action(async (options) => {
       if (options.json) {
         enableJsonOutput(options.dryRun);
       }
@@ -2462,22 +2459,26 @@ async function run() {
         const config = await loadConfig(options.config);
         log(`Loaded configuration from ${options.config || "version.config.json"}`, "info");
         if (options.dryRun) config.dryRun = true;
-        if (options.synced) config.synced = true;
+        if (options.sync) config.sync = true;
         if (options.bump) config.type = options.bump;
         if (options.prerelease) {
           config.prereleaseIdentifier = options.prerelease === true ? "next" : options.prerelease;
           config.isPrerelease = true;
         }
         const cliTargets = options.target ? options.target.split(",").map((t) => t.trim()) : [];
+        if (cliTargets.length > 0) {
+          config.packages = cliTargets;
+          log(`CLI targets specified: ${cliTargets.join(", ")}`, "info");
+        }
         const engine = new VersionEngine(config, !!options.json);
         const pkgsResult = await engine.getWorkspacePackages();
         const resolvedCount = pkgsResult.packages.length;
         log(`Resolved ${resolvedCount} packages from workspace`, "debug");
         log(`Config packages: ${JSON.stringify(config.packages)}`, "debug");
-        log(`Config synced: ${config.synced}`, "debug");
-        if (config.synced) {
-          log("Using synced versioning strategy.", "info");
-          engine.setStrategy("synced");
+        log(`Config sync: ${config.sync}`, "debug");
+        if (config.sync) {
+          log("Using sync versioning strategy.", "info");
+          engine.setStrategy("sync");
           await engine.run(pkgsResult);
         } else if (resolvedCount === 1) {
           log("Using single package versioning strategy.", "info");
@@ -2499,14 +2500,19 @@ async function run() {
         log("Versioning process completed.", "success");
         printJsonOutput();
       } catch (error) {
-        log(error instanceof Error ? error.message : String(error), "error");
-        if (error instanceof Error) {
-          console.error("Error details:");
-          console.error(error.stack || error.message);
-          if (error.message.includes("Command failed:")) {
-            const cmdOutput = error.message.split("Command failed:")[1];
-            if (cmdOutput) {
-              console.error("Command output:", cmdOutput.trim());
+        const { BasePackageVersionerError: BasePackageVersionerError2 } = await import("./baseError-XWEU2UI6.js");
+        if (BasePackageVersionerError2.isPackageVersionerError(error)) {
+          error.logError();
+        } else {
+          log(error instanceof Error ? error.message : String(error), "error");
+          if (error instanceof Error) {
+            console.error("Error details:");
+            console.error(error.stack || error.message);
+            if (error.message.includes("Command failed:")) {
+              const cmdOutput = error.message.split("Command failed:")[1];
+              if (cmdOutput) {
+                console.error("Command output:", cmdOutput.trim());
+              }
             }
           }
         }

package/docs/versioning.md

@@ -334,7 +334,7 @@ Warning: Your tagTemplate contains ${packageName} but no package name is availab
 This will result in an empty package name in the tag (e.g., "@v1.0.0" instead of "my-package@v1.0.0").
 
 To fix this:
-• If using synced mode: Set "packageSpecificTags": true in your config to enable package names in tags
+• If using sync mode: Set "packageSpecificTags": true in your config to enable package names in tags
 • If you want global tags: Remove ${packageName} from your tagTemplate (e.g., use "${prefix}${version}")
 • If using single/async mode: Ensure your package.json has a valid "name" field
 ```
@@ -344,7 +344,7 @@ To fix this:
 1. **For Synced Mode with Package Names**: Enable package-specific tags
    ```json
    {
-     "synced": true,
+     "sync": true,
      "packageSpecificTags": true,
      "tagTemplate": "${packageName}@${prefix}${version}"
    }
@@ -397,11 +397,11 @@ For global commit messages, use templates without `${packageName}`:
 
 ## Monorepo Versioning Modes
 
-While primarily used for single packages now, `package-versioner` retains options for monorepo workflows, controlled mainly by the `synced` flag in `version.config.json`.
+While primarily used for single packages now, `package-versioner` retains options for monorepo workflows, controlled mainly by the `sync` flag in `version.config.json`.
 
-### Synced Mode (`synced: true`)
+### Sync Mode (`sync: true`)
 
-This is the default if the `synced` flag is present and true.
+This is the default if the `sync` flag is present and true.
 
 -   **Behaviour:** The tool calculates **one** version bump based on the overall history (or branch pattern). This single new version is applied to **all** packages within the repository (or just the root `package.json` if not a structured monorepo). A single Git tag is created.
 -   **Tag Behaviour:** 
@@ -409,7 +409,7 @@ This is the default if the `synced` flag is present and true.
     - In **single-package repositories**: Respects the `packageSpecificTags` setting - can create either `v1.2.3` or `package-name@v1.2.3`
 -   **Use Case:** Suitable for monorepos where all packages are tightly coupled and released together with the same version number. Also the effective mode for single-package repositories.
 
-### Async Mode (`synced: false`)
+### Async Mode (`sync: false`)
 
 *(Note: This mode relies heavily on monorepo tooling and structure, like `pnpm workspaces` and correctly configured package dependencies.)*
 

package/package-versioner.schema.json

@@ -41,7 +41,7 @@
       "description": "The main branch for versioning",
       "default": "main"
     },
-    "synced": {
+    "sync": {
       "type": "boolean",
       "default": false,
       "description": "Whether packages should be versioned together"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "package-versioner",
   "description": "A lightweight yet powerful CLI tool for automated semantic versioning based on Git history and conventional commits.",
-  "version": "0.8.6",
+  "version": "0.9.2",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",