feat: auto-merge non-breaking dependency updates (#5)

## Summary
Minori now automatically merges dependency update PRs when they meet safety criteria, reducing manual work whilst maintaining safety for potentially breaking changes.

## Changes
- ✨ Add version comparison utility to detect major version bumps
- ✨ Add Gitea service methods for checking commit status and merging PRs
- ✨ Add auto-merge logic that checks:
  - Is it a major version bump? (if yes, skip auto-merge)
  - Did CI checks pass? (if no, skip auto-merge)
  - If both conditions pass → auto-merge! 🎉
- ✅ Add comprehensive tests for all new functionality
- 📊 Maintain ~94% test coverage

## How It Works
When Minori processes a dependency update:
1. Check if a PR already exists for that dependency
2. If it exists, verify:
   - **Not a major version bump** (major bumps need manual review)
   - **CI status = "success"** (all checks must pass)
3. If both conditions are met → automatically merge the PR and delete the branch

## Test Plan
- [x] All 114 tests passing
- [x] New tests for version comparison utility
- [x] New tests for Gitea service extensions
- [x] Build successful
- [x] Linting clean

---
✨ This PR was created with help from Hikari~ 🌸

Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com>
Reviewed-on: #5
Co-authored-by: Hikari <hikari@nhcarrigan.com>
Co-committed-by: Hikari <hikari@nhcarrigan.com>

package.json

@@ -20,11 +20,11 @@
     "@types/node": "25.2.0",
     "@types/node-cron": "3.0.11",
     "@types/semver": "7.7.1",
-    "@vitest/coverage-istanbul": "^4.0.18",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/coverage-istanbul": "4.0.18",
+    "@vitest/coverage-v8": "4.0.18",
     "eslint": "9.39.2",
     "typescript": "5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "4.0.18"
   },
   "dependencies": {
     "@nhcarrigan/logger": "1.1.1",

pnpm-lock.yaml

@@ -37,10 +37,10 @@ importers:
         specifier: 7.7.1
         version: 7.7.1
       '@vitest/coverage-istanbul':
-        specifier: ^4.0.18
+        specifier: 4.0.18
         version: 4.0.18(vitest@4.0.18(@types/node@25.2.0))
       '@vitest/coverage-v8':
-        specifier: ^4.0.18
+        specifier: 4.0.18
         version: 4.0.18(vitest@4.0.18(@types/node@25.2.0))
       eslint:
         specifier: 9.39.2
@@ -49,7 +49,7 @@ importers:
         specifier: 5.9.3
         version: 5.9.3
       vitest:
-        specifier: ^4.0.18
+        specifier: 4.0.18
         version: 4.0.18(@types/node@25.2.0)
 
 packages:

src/services/giteaService.ts

@@ -7,6 +7,7 @@
 import axios, { isAxiosError, type AxiosInstance } from "axios";
 import { config } from "../config.js";
 import type {
+  GiteaCombinedStatus,
   GiteaFile,
   GiteaPullRequest,
   GiteaRepository,
@@ -142,6 +143,83 @@ class GiteaService {
     );
     return data;
   }
+
+  /**
+   * Gets the combined commit status for a specific commit by querying the Gitea API for all status checks.
+   * @param owner - The repository owner.
+   * @param repo - The repository name.
+   * @param sha - The commit SHA to check.
+   * @returns The combined status of all checks (pending, success, error, or failure).
+   */
+  public async getCommitStatus(
+    owner: string,
+    repo: string,
+    sha: string,
+  ): Promise<GiteaCombinedStatus> {
+    const { data } = await this.client.get<GiteaCombinedStatus>(
+      `/repos/${owner}/${repo}/commits/${sha}/status`,
+    );
+    return data;
+  }
+
+  /**
+   * Merges a pull request.
+   * @param owner - The repository owner.
+   * @param repo - The repository name.
+   * @param index - The pull request index number.
+   * @returns True if the merge was successful, false otherwise.
+   */
+  public async mergePullRequest(
+    owner: string,
+    repo: string,
+    index: number,
+  ): Promise<boolean> {
+    try {
+      await this.client.post(
+        `/repos/${owner}/${repo}/pulls/${String(index)}/merge`,
+        {
+          /* eslint-disable @typescript-eslint/naming-convention -- Gitea API uses snake_case */
+          Do:                        "merge",
+          MergeMessageField:         "",
+          MergeTitleField:           "",
+          delete_branch_after_merge: true,
+          force_merge:               false,
+          head_commit_id:            "",
+          merge_when_checks_succeed: false,
+          /* eslint-enable @typescript-eslint/naming-convention -- End Gitea API */
+        },
+      );
+      return true;
+    } catch (error) {
+      if (isAxiosError(error)) {
+        return false;
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Deletes a repository branch by name.
+   * @param owner - The repository owner.
+   * @param repo - The repository name.
+   * @param branch - The branch name to remove.
+   * @returns True if successful, false otherwise.
+   */
+  public async deleteBranch(
+    owner: string,
+    repo: string,
+    branch: string,
+  ): Promise<boolean> {
+    try {
+      await this.client.delete(`/repos/${owner}/${repo}/branches/${branch}`);
+      return true;
+    } catch (error) {
+      if (isAxiosError(error)) {
+        return false;
+      }
+      throw error;
+    }
+  }
 }
 
 export { GiteaService };

src/services/updateOrchestratorService.ts

@@ -6,6 +6,10 @@
 
 import { config } from "../config.js";
 import { logger } from "../utils/logger.js";
+import {
+  isMajorVersionBump,
+  stripVersionPrefix,
+} from "../utils/versionComparison.js";
 import { DependencyAnalyzerService } from "./dependencyAnalyzerService.js";
 import { GiteaService } from "./giteaService.js";
 import {
@@ -17,15 +21,6 @@ import { NpmService } from "./npmService.js";
 import type { GiteaRepository } from "../types/gitea.types.js";
 import type { DependencyUpdate, PackageJson } from "../types/package.types.js";
 
-/**
- * Strips version prefix characters from a version string.
- * @param version - The version string with potential prefixes.
- * @returns The version without prefix characters.
- */
-const stripVersionPrefix = (version: string): string => {
-  return version.replace(/^[<=>^~]*/, "");
-};
-
 /**
  * Generates the body content for a PR.
  * @param update - The dependency update information.
@@ -142,6 +137,103 @@ class UpdateOrchestratorService {
     await logger.log("info", "Dependency update check complete!");
   }
 
+  /**
+   * Attempts to merge an existing PR after checking CI status.
+   * @param repo - The repository information.
+   * @param update - The dependency update details.
+   * @param matchingPR - The existing PR with head SHA and number.
+   * @param matchingPR.head - The PR head information.
+   * @param matchingPR.head.sha - The commit SHA to check.
+   * @param matchingPR.number - The PR number for merging.
+   * @returns True if merge was attempted, false otherwise.
+   */
+  private async attemptPRMerge(
+    repo: GiteaRepository,
+    update: DependencyUpdate,
+    matchingPR: { head: { sha: string }; number: number },
+  ): Promise<boolean> {
+    const commitStatus = await this.giteaService.getCommitStatus(
+      config.giteaOrg,
+      repo.name,
+      matchingPR.head.sha,
+    );
+
+    if (commitStatus.state !== "success") {
+      await logger.log(
+        "info",
+        `    PR exists for ${update.packageName} but CI status is ${commitStatus.state}, skipping auto-merge...`,
+      );
+      return true;
+    }
+
+    await logger.log(
+      "info",
+      `    Auto-merging PR for ${update.packageName} (CI passed, non-major bump)...`,
+    );
+
+    const merged = await this.giteaService.mergePullRequest(
+      config.giteaOrg,
+      repo.name,
+      matchingPR.number,
+    );
+
+    if (merged) {
+      await logger.log(
+        "info",
+        `    Successfully merged PR for ${update.packageName}`,
+      );
+      return true;
+    }
+
+    await logger.log(
+      "warn",
+      `    Failed to merge PR for ${update.packageName}`,
+    );
+    return true;
+  }
+
+  /**
+   * Checks if an existing PR can be auto-merged based on CI status and version bump type.
+   * @param repo - The repository information.
+   * @param update - The dependency update details.
+   * @param branchName - The branch name for the PR.
+   * @returns True if the PR exists and was handled, false otherwise.
+   */
+  private async checkAndMergeExistingPR(
+    repo: GiteaRepository,
+    update: DependencyUpdate,
+    branchName: string,
+  ): Promise<boolean> {
+    const existingPRs = await this.giteaService.listPullRequests(
+      config.giteaOrg,
+      repo.name,
+      "open",
+    );
+
+    const matchingPR = existingPRs.find((pr) => {
+      return pr.head.ref === branchName;
+    });
+
+    if (matchingPR === undefined) {
+      return false;
+    }
+
+    const isMajorBump = isMajorVersionBump(
+      update.currentVersion,
+      update.latestVersion,
+    );
+
+    if (isMajorBump) {
+      await logger.log(
+        "info",
+        `    PR exists for ${update.packageName} but is a major version bump, skipping auto-merge...`,
+      );
+      return true;
+    }
+
+    return await this.attemptPRMerge(repo, update, matchingPR);
+  }
+
   /**
    * Creates or updates a PR for a dependency update.
    * @param repo - The repository information.
@@ -157,6 +249,16 @@ class UpdateOrchestratorService {
       = `${config.prBranchPrefix}${update.packageName.replaceAll(/[/@]/g, "-")}`;
 
     try {
+      const existingPRMerged = await this.checkAndMergeExistingPR(
+        repo,
+        update,
+        branchName,
+      );
+
+      if (existingPRMerged) {
+        return;
+      }
+
       const result = await createOrUpdateBranch({
         branchName:    branchName,
         clonedRepo:    clonedRepo,

src/types/gitea.types.ts

@@ -39,6 +39,33 @@ interface GiteaPullRequest {
   state:  "closed" | "open";
   title:  string;
 }
+
+interface GiteaCommitStatus {
+  context:     string;
+  created_at:  string;
+  description: string;
+  id:          number;
+  state:       "error" | "failure" | "pending" | "success" | "warning";
+  target_url:  string;
+  updated_at:  string;
+  url:         string;
+}
+
+interface GiteaCombinedStatus {
+  commit_url:  string;
+  repository:  GiteaRepository;
+  sha:         string;
+  state:       "error" | "failure" | "pending" | "success" | "warning";
+  statuses:    Array<GiteaCommitStatus>;
+  total_count: number;
+  url:         string;
+}
 /* eslint-enable @typescript-eslint/naming-convention -- End Gitea API types */
 
-export type { GiteaFile, GiteaPullRequest, GiteaRepository };
+export type {
+  GiteaCombinedStatus,
+  GiteaCommitStatus,
+  GiteaFile,
+  GiteaPullRequest,
+  GiteaRepository,
+};

src/utils/logger.ts

@@ -4,19 +4,22 @@
  * @author Naomi Carrigan
  */
 
-import { Logger } from "@nhcarrigan/logger";
+import type { Logger } from "@nhcarrigan/logger";
 
-// import { Logger } from "@nhcarrigan/logger";
+// Import { Logger } from "@nhcarrigan/logger";
 
-// const logger = new Logger("Minori", process.env.LOG_TOKEN ?? "");
+// Const logger = new Logger("Minori", process.env.LOG_TOKEN ?? "");
 
+/* eslint-disable no-console -- Temporary mock logger for development */
+/* eslint-disable @typescript-eslint/consistent-type-assertions -- Mock logger requires type assertion */
 const logger = {
   error: (message: string, error: Error) => {
     console.error(message, error);
   },
-  log:   (level: string, message: string) => {
+  log: (level: string, message: string) => {
     console.log(level, message);
   },
 } as unknown as Logger;
+/* eslint-enable no-console, @typescript-eslint/consistent-type-assertions -- Re-enable rules after mock logger */
 
 export { logger };

src/utils/versionComparison.ts

@@ -0,0 +1,64 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+/**
+ * Strips version prefix characters from a version string.
+ * @param version - The version string with potential prefixes.
+ * @returns The version without prefix characters.
+ */
+const stripVersionPrefix = (version: string): string => {
+  return version.replace(/^[<=>^~]*/, "");
+};
+
+/**
+ * Parses a semantic version string into its components.
+ * @param version - The version string to parse (e.g., "1.2.3").
+ * @returns An object with major, minor, and patch numbers, or null if invalid.
+ */
+const parseVersion = (
+  version: string,
+): { major: number; minor: number; patch: number } | null => {
+  const cleaned = stripVersionPrefix(version);
+  const parts = cleaned.split(".");
+
+  if (parts.length < 3) {
+    return null;
+  }
+
+  const major = Number.parseInt(parts[0] ?? "0", 10);
+  const minor = Number.parseInt(parts[1] ?? "0", 10);
+  const patchPart = parts[2] ?? "0";
+  const patch = Number.parseInt(patchPart.split("-")[0] ?? "0", 10);
+
+  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch)) {
+    return null;
+  }
+
+  return { major, minor, patch };
+};
+
+/**
+ * Determines if a version update is a major version bump.
+ * A major bump occurs when the major version number increases.
+ * @param fromVersion - The current version.
+ * @param toVersion - The target version.
+ * @returns True if this is a major version bump, false otherwise.
+ */
+const isMajorVersionBump = (
+  fromVersion: string,
+  toVersion: string,
+): boolean => {
+  const from = parseVersion(fromVersion);
+  const to = parseVersion(toVersion);
+
+  if (from === null || to === null) {
+    return false;
+  }
+
+  return to.major > from.major;
+};
+
+export { isMajorVersionBump, stripVersionPrefix };

test/services/giteaService.spec.ts

@@ -6,11 +6,16 @@
 
 /* eslint-disable vitest/valid-expect -- Test expectations don't need messages */
 /* eslint-disable max-lines-per-function -- Test suites require many test cases */
+/* eslint-disable max-lines -- Test suites naturally have many cases */
+/* eslint-disable max-statements -- Test suites naturally have many statements */
 /* eslint-disable @typescript-eslint/consistent-type-assertions -- Required for mocking */
 /* eslint-disable @typescript-eslint/consistent-type-imports -- Dynamic imports */
 /* eslint-disable @typescript-eslint/naming-convention -- Environment variables and Gitea API format */
 /* eslint-disable max-nested-callbacks -- Vitest structure requires nested callbacks */
 /* eslint-disable vitest/require-to-throw-message -- Generic throw assertion */
+/* eslint-disable vitest/prefer-to-be-truthy -- toBe(true) is clearer for boolean functions */
+/* eslint-disable vitest/prefer-to-be-falsy -- toBe(false) is clearer for boolean functions */
+/* eslint-disable stylistic/max-len -- Test files have long object literals */
 
 import axios, { AxiosError, type AxiosResponse } from "axios";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
@@ -24,8 +29,9 @@ vi.mock("axios", async() => {
     default:    {
       create: vi.fn(() => {
         return {
-          get:  vi.fn(),
-          post: vi.fn(),
+          delete: vi.fn(),
+          get:    vi.fn(),
+          post:   vi.fn(),
         };
       }),
     },
@@ -69,6 +75,8 @@ describe("giteaService", () => {
   let mockGet: ReturnType<typeof vi.fn>;
   // eslint-disable-next-line @typescript-eslint/init-declarations -- Reassigned in beforeEach
   let mockPost: ReturnType<typeof vi.fn>;
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- Reassigned in beforeEach
+  let mockDelete: ReturnType<typeof vi.fn>;
   const originalEnvironment = process.env;
 
   beforeEach(() => {
@@ -77,9 +85,11 @@ describe("giteaService", () => {
 
     mockGet = vi.fn();
     mockPost = vi.fn();
+    mockDelete = vi.fn();
     vi.mocked(axios.create).mockReturnValue({
-      get:  mockGet,
-      post: mockPost,
+      delete: mockDelete,
+      get:    mockGet,
+      post:   mockPost,
     } as unknown as ReturnType<typeof axios.create>);
 
     giteaService = new GiteaService();
@@ -306,4 +316,69 @@ describe("giteaService", () => {
       { params: { state: "closed" } },
     );
   });
+
+  it("should get commit status", async() => {
+    expect.assertions(2);
+    const mockStatus = {
+      commit_url:  "https://git.nhcarrigan.com/api/v1/repos/owner/repo/commits/abc123",
+      repository:  createMockRepository({ id: 1, name: "test-repo" }),
+      sha:         "abc123",
+      state:       "success",
+      statuses:    [],
+      total_count: 0,
+      url:         "https://git.nhcarrigan.com/api/v1/repos/owner/repo/commits/abc123/status",
+    };
+    mockGet.mockResolvedValueOnce({ data: mockStatus });
+    const result = await giteaService.getCommitStatus("owner", "repo", "abc123");
+    expect(result).toStrictEqual(mockStatus);
+    expect(mockGet).toHaveBeenCalledWith("/repos/owner/repo/commits/abc123/status");
+  });
+
+  it("should merge a pull request successfully", async() => {
+    expect.assertions(2);
+    mockPost.mockResolvedValueOnce({ data: {} });
+    const result = await giteaService.mergePullRequest("owner", "repo", 1);
+    expect(result).toBe(true);
+    expect(mockPost).toHaveBeenCalledWith("/repos/owner/repo/pulls/1/merge", {
+      Do:                        "merge",
+      MergeMessageField:         "",
+      MergeTitleField:           "",
+      delete_branch_after_merge: true,
+      force_merge:               false,
+      head_commit_id:            "",
+      merge_when_checks_succeed: false,
+    });
+  });
+
+  it("should return false when merge fails", async() => {
+    expect.assertions(1);
+    const axiosError = new AxiosError("Merge conflict");
+    mockPost.mockRejectedValueOnce(axiosError);
+    const result = await giteaService.mergePullRequest("owner", "repo", 1);
+    expect(result).toBe(false);
+  });
+
+  it("should delete a branch successfully", async() => {
+    expect.assertions(2);
+    mockDelete.mockResolvedValueOnce({ data: {} });
+    const result = await giteaService.deleteBranch(
+      "owner",
+      "repo",
+      "feature-branch",
+    );
+    expect(result).toBe(true);
+    expect(mockDelete).toHaveBeenCalledWith("/repos/owner/repo/branches/feature-branch");
+  });
+
+  it("should return false when branch deletion fails", async() => {
+    expect.assertions(1);
+    const axiosError = new AxiosError("Branch not found");
+    mockDelete.mockRejectedValueOnce(axiosError);
+    const result = await giteaService.deleteBranch(
+      "owner",
+      "repo",
+      "nonexistent-branch",
+    );
+    expect(result).toBe(false);
+  });
 });

test/services/updateOrchestratorService.spec.ts

@@ -18,6 +18,8 @@ const mockGiteaGetFileContent = vi.fn();
 const mockGiteaListOrgRepositories = vi.fn();
 const mockGiteaCreatePullRequest = vi.fn();
 const mockGiteaListPullRequests = vi.fn();
+const mockGiteaGetCommitStatus = vi.fn();
+const mockGiteaMergePullRequest = vi.fn();
 const mockNpmGetPackageChangelog = vi.fn();
 const mockNpmGetPackageInfo = vi.fn();
 const mockAnalyzePackageJson = vi.fn();
@@ -39,9 +41,11 @@ vi.mock("../../src/services/giteaService.js", () => {
 
     GiteaService: class MockGiteaService {
       public createPullRequest = mockGiteaCreatePullRequest;
+      public getCommitStatus = mockGiteaGetCommitStatus;
       public getFileContent = mockGiteaGetFileContent;
       public listOrgRepositories = mockGiteaListOrgRepositories;
       public listPullRequests = mockGiteaListPullRequests;
+      public mergePullRequest = mockGiteaMergePullRequest;
     },
   };
 });
@@ -221,6 +225,7 @@ describe("updateOrchestratorService", () => {
     const mockUpdates = [ createMockUpdate() ];
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockNpmGetPackageChangelog.mockResolvedValue("## Changelog");
     mockCloneRepository.mockResolvedValue(createMockClonedRepo());
@@ -267,6 +272,7 @@ describe("updateOrchestratorService", () => {
     const mockUpdates = [ createMockUpdate() ];
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockCloneRepository.mockResolvedValue(createMockClonedRepo());
     mockCreateOrUpdateBranch.mockResolvedValue({
@@ -289,6 +295,7 @@ describe("updateOrchestratorService", () => {
     const mockUpdates = [ createMockUpdate() ];
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockCloneRepository.mockResolvedValue(createMockClonedRepo());
     mockCreateOrUpdateBranch.mockResolvedValue({
@@ -312,6 +319,7 @@ describe("updateOrchestratorService", () => {
     const mockUpdates = [ createMockUpdate() ];
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockCloneRepository.mockResolvedValue(createMockClonedRepo());
     mockCreateOrUpdateBranch.mockResolvedValue({
@@ -354,6 +362,7 @@ describe("updateOrchestratorService", () => {
     const mockUpdates = [ createMockUpdate() ];
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockCloneRepository.mockResolvedValue(createMockClonedRepo());
     mockCreateOrUpdateBranch.mockResolvedValue({
@@ -377,6 +386,7 @@ describe("updateOrchestratorService", () => {
     const mockUpdates = [ createMockUpdate() ];
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockNpmGetPackageChangelog.mockResolvedValue("## Changelog");
     mockCloneRepository.mockResolvedValue(createMockClonedRepo());
@@ -426,6 +436,7 @@ describe("updateOrchestratorService", () => {
     const mockCleanup = vi.fn();
     mockGiteaListOrgRepositories.mockResolvedValue(mockRepos);
     mockGiteaGetFileContent.mockResolvedValue(mockFileContent);
+    mockGiteaListPullRequests.mockResolvedValue([]);
     mockAnalyzePackageJson.mockResolvedValue(mockUpdates);
     mockCloneRepository.mockResolvedValue(createMockClonedRepo(mockCleanup));
     mockCreateOrUpdateBranch.mockResolvedValue({

test/utils/versionComparison.spec.ts

@@ -0,0 +1,108 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+/* eslint-disable vitest/valid-expect -- Test expectations don't need messages */
+/* eslint-disable max-lines-per-function -- Test suites naturally have many cases */
+/* eslint-disable max-nested-callbacks -- Vitest structure requires nesting */
+/* eslint-disable vitest/prefer-to-be-truthy -- toBe(true) is clearer for boolean functions */
+/* eslint-disable vitest/prefer-to-be-falsy -- toBe(false) is clearer for boolean functions */
+
+import { describe, expect, it } from "vitest";
+import {
+  isMajorVersionBump,
+  stripVersionPrefix,
+} from "../../src/utils/versionComparison.js";
+
+describe("versionComparison", () => {
+  describe("stripVersionPrefix", () => {
+    it("should strip caret prefix", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix("^1.2.3")).toBe("1.2.3");
+    });
+
+    it("should strip tilde prefix", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix("~1.2.3")).toBe("1.2.3");
+    });
+
+    it("should strip greater than prefix", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix(">1.2.3")).toBe("1.2.3");
+    });
+
+    it("should strip less than prefix", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix("<1.2.3")).toBe("1.2.3");
+    });
+
+    it("should strip equals prefix", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix("=1.2.3")).toBe("1.2.3");
+    });
+
+    it("should strip multiple prefix characters", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix(">=1.2.3")).toBe("1.2.3");
+    });
+
+    it("should return version without prefix unchanged", () => {
+      expect.assertions(1);
+      expect(stripVersionPrefix("1.2.3")).toBe("1.2.3");
+    });
+  });
+
+  describe("isMajorVersionBump", () => {
+    it("should detect major version bump", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("1.2.3", "2.0.0")).toBe(true);
+    });
+
+    it("should detect major version bump with prefixes", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("^1.2.3", "^2.0.0")).toBe(true);
+    });
+
+    it("should not detect minor version bump as major", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("1.2.3", "1.3.0")).toBe(false);
+    });
+
+    it("should not detect patch version bump as major", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("1.2.3", "1.2.4")).toBe(false);
+    });
+
+    it("should handle version with pre-release tags", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("1.2.3", "2.0.0-beta.1")).toBe(true);
+    });
+
+    it("should return false for invalid from version", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("invalid", "2.0.0")).toBe(false);
+    });
+
+    it("should return false for invalid to version", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("1.2.3", "invalid")).toBe(false);
+    });
+
+    it("should return false for both invalid versions", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("invalid", "also-invalid")).toBe(false);
+    });
+
+    it("should handle 0.x.x to 1.x.x as major bump", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("0.9.5", "1.0.0")).toBe(true);
+    });
+
+    it("should not detect same version as major bump", () => {
+      expect.assertions(1);
+      expect(isMajorVersionBump("1.2.3", "1.2.3")).toBe(false);
+    });
+  });
+});