@releasekit/version 0.3.0 → 0.4.0

package/README.md

@@ -133,10 +133,19 @@ Configure via `releasekit.config.json`:
 | `cargo.enabled` | Update Cargo.toml files | `true` |
 | `cargo.paths` | Directories containing Cargo.toml | auto-detect |
 
+## Using in CI
+
+A few things to keep in mind when running `releasekit-version` in a pipeline:
+
+- **Always pass `fetch-depth: 0`** on checkout — the tool reads git history to determine the version bump and will produce incorrect results on a shallow clone.
+- **Use `--json`** for reliable downstream parsing. Text output format can change; the JSON schema is stable.
+- **`NO_COLOR=1`** disables ANSI colour codes in log output. Most CI environments set `CI=true` automatically, which the tool detects and adjusts for.
+
+If you are running the full release pipeline (version + changelog + publish), use `@releasekit/release` instead of invoking `releasekit-version` directly. See the [CI setup guide](../release/docs/ci-setup.md).
+
 ## Documentation
 
 - [Versioning Strategies and Concepts](./docs/versioning.md)
-- [CI/CD Integration](./docs/CI_CD_INTEGRATION.md)
 
 ## Acknowledgements
 

package/dist/baseError-FARJUY5U.js

@@ -0,0 +1,6 @@
+import {
+  BaseVersionError
+} from "./chunk-2MN2VLZF.js";
+export {
+  BaseVersionError
+};

package/dist/chunk-2MN2VLZF.js

@@ -0,0 +1,85 @@
+// ../core/dist/index.js
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import chalk from "chalk";
+function readPackageVersion(importMetaUrl) {
+  try {
+    const dir = path.dirname(fileURLToPath(importMetaUrl));
+    const packageJsonPath = path.resolve(dir, "../package.json");
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+    return packageJson.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var LOG_LEVELS = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3,
+  trace: 4
+};
+var PREFIXES = {
+  error: "[ERROR]",
+  warn: "[WARN]",
+  info: "[INFO]",
+  debug: "[DEBUG]",
+  trace: "[TRACE]"
+};
+var COLORS = {
+  error: chalk.red,
+  warn: chalk.yellow,
+  info: chalk.blue,
+  debug: chalk.gray,
+  trace: chalk.dim
+};
+var currentLevel = "info";
+var quietMode = false;
+function shouldLog(level) {
+  if (quietMode && level !== "error") return false;
+  return LOG_LEVELS[level] <= LOG_LEVELS[currentLevel];
+}
+function log(message, level = "info") {
+  if (!shouldLog(level)) return;
+  const formatted = COLORS[level](`${PREFIXES[level]} ${message}`);
+  console.error(formatted);
+}
+var ReleaseKitError = class _ReleaseKitError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+  }
+  logError() {
+    log(this.message, "error");
+    if (this.suggestions.length > 0) {
+      log("\nSuggested solutions:", "info");
+      for (const [i, suggestion] of this.suggestions.entries()) {
+        log(`${i + 1}. ${suggestion}`, "info");
+      }
+    }
+  }
+  static isReleaseKitError(error2) {
+    return error2 instanceof _ReleaseKitError;
+  }
+};
+
+// src/errors/baseError.ts
+var BaseVersionError = class _BaseVersionError extends ReleaseKitError {
+  code;
+  suggestions;
+  constructor(message, code, suggestions) {
+    super(message);
+    this.code = code;
+    this.suggestions = suggestions ?? [];
+  }
+  static isVersionError(error) {
+    return error instanceof _BaseVersionError;
+  }
+};
+
+export {
+  readPackageVersion,
+  ReleaseKitError,
+  BaseVersionError
+};

package/dist/chunk-LMPZV35Z.js

@@ -0,0 +1,20 @@
+// src/git/commandExecutor.ts
+import { execFile, execFileSync } from "child_process";
+var execAsync = (file, args, options) => {
+  const defaultOptions = { maxBuffer: 1024 * 1024 * 10, ...options };
+  return new Promise((resolve, reject) => {
+    execFile(file, args, defaultOptions, (error, stdout, stderr) => {
+      if (error) {
+        reject(error);
+      } else {
+        resolve({ stdout: stdout.toString(), stderr: stderr.toString() });
+      }
+    });
+  });
+};
+var execSync = (file, args, options) => execFileSync(file, args, { maxBuffer: 1024 * 1024 * 10, ...options });
+
+export {
+  execAsync,
+  execSync
+};