@spaceflow/review 0.76.0 → 0.77.0

package/src/review-context.ts

@@ -0,0 +1,409 @@
+import {
+  GitProviderService,
+  PullRequestCommit,
+  type CiConfig,
+  type LLMMode,
+  type VerboseLevel,
+  shouldLog,
+  normalizeVerbose,
+  GitSdkService,
+} from "@spaceflow/core";
+import type { IConfigReader, LocalReviewMode } from "@spaceflow/core";
+import { type AnalyzeDeletionsMode, type ReviewConfig } from "./review.config";
+import { ReviewOptions } from "./review.config";
+import { parseTitleOptions } from "./parse-title-options";
+import { type ReviewIssue, type UserInfo } from "./review-spec";
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { isAbsolute, relative } from "path";
+import { homedir } from "os";
+import type { ReportFormat } from "./review-report";
+
+export interface ReviewContext extends ReviewOptions {
+  owner: string;
+  repo: string;
+  prNumber?: number;
+  baseRef?: string;
+  headRef?: string;
+  specSources: string[];
+  verbose?: VerboseLevel;
+  includes?: string[];
+  files?: string[];
+  commits?: string[];
+  concurrency?: number;
+  timeout?: number;
+  retries?: number;
+  retryDelay?: number;
+  /** 仅执行删除代码分析，跳过常规代码审查 */
+  deletionOnly?: boolean;
+  /** 删除代码分析模式：openai 使用标准模式，claude-agent 使用 Agent 模式 */
+  deletionAnalysisMode?: LLMMode;
+  /** 输出格式：markdown, terminal, json。不指定则智能选择 */
+  outputFormat?: ReportFormat;
+  /** 是否使用 AI 生成 PR 功能描述 */
+  generateDescription?: boolean;
+  /** 显示所有问题，不过滤非变更行的问题 */
+  showAll?: boolean;
+  /** PR 事件类型（opened, synchronize, closed 等） */
+  eventAction?: string;
+  /**
+   * 本地代码审查模式（已解析）
+   * - 'uncommitted': 审查所有未提交的代码（暂存区 + 工作区）
+   * - 'staged': 仅审查暂存区的代码
+   * - false: 禁用本地模式
+   */
+  localMode?: LocalReviewMode;
+}
+
+export class ReviewContextBuilder {
+  constructor(
+    protected readonly gitProvider: GitProviderService,
+    protected readonly config: IConfigReader,
+    protected readonly gitSdk: GitSdkService,
+  ) {}
+
+  async getContextFromEnv(options: ReviewOptions): Promise<ReviewContext> {
+    const reviewConf = this.config.getPluginConfig<ReviewConfig>("review");
+    const ciConf = this.config.get<CiConfig>("ci");
+    const repository = ciConf?.repository;
+
+    if (options.ci) {
+      this.gitProvider.validateConfig();
+    }
+
+    let repoPath = repository;
+    if (!repoPath) {
+      // 非 CI 模式下，从 git remote 获取仓库信息
+      const remoteUrl = this.gitSdk.getRemoteUrl();
+      if (remoteUrl) {
+        const parsed = this.gitSdk.parseRepositoryFromRemoteUrl(remoteUrl);
+        if (parsed) {
+          repoPath = `${parsed.owner}/${parsed.repo}`;
+          if (shouldLog(options.verbose, 1)) {
+            console.log(`📦 从 git remote 获取仓库: ${repoPath}`);
+          }
+        }
+      }
+    }
+
+    if (!repoPath) {
+      throw new Error("缺少配置 ci.repository");
+    }
+
+    const parts = repoPath.split("/");
+    if (parts.length < 2) {
+      throw new Error("ci.repository 格式不正确");
+    }
+
+    const owner = parts[0];
+    const repo = parts[1];
+
+    let prNumber = options.prNumber;
+
+    if (!prNumber && options.ci) {
+      prNumber = await this.getPrNumberFromEvent();
+    }
+
+    // 从 PR 标题解析命令参数（命令行参数优先，标题参数作为补充）
+    let titleOptions: ReturnType<typeof parseTitleOptions> = {};
+    if (prNumber && options.ci) {
+      try {
+        const pr = await this.gitProvider.getPullRequest(owner, repo, prNumber);
+        if (pr?.title) {
+          titleOptions = parseTitleOptions(pr.title);
+          if (Object.keys(titleOptions).length > 0 && shouldLog(options.verbose, 1)) {
+            console.log(`📋 从 PR 标题解析到参数:`, titleOptions);
+          }
+        }
+      } catch (error) {
+        if (shouldLog(options.verbose, 1)) {
+          console.warn(`⚠️ 获取 PR 标题失败:`, error);
+        }
+      }
+    }
+
+    const specSources = [
+      join(homedir(), ".spaceflow", "deps"),
+      join(process.cwd(), ".spaceflow", "deps"),
+    ];
+    if (options.references?.length) {
+      specSources.push(...options.references);
+    }
+    if (reviewConf.references?.length) {
+      specSources.push(...reviewConf.references);
+    }
+
+    // 解析本地模式：非 CI、非 PR、无 base/head 时默认启用 uncommitted 模式
+    const localMode = this.resolveLocalMode(options, {
+      ci: options.ci,
+      hasPrNumber: !!prNumber,
+      hasBaseHead: !!(options.base || options.head),
+    });
+
+    // 当没有 PR 且没有指定 base/head 且不是本地模式时，自动获取默认值
+    let baseRef = options.base;
+    let headRef = options.head;
+    if (!prNumber && !baseRef && !headRef && !localMode) {
+      headRef = this.gitSdk.getCurrentBranch() ?? "HEAD";
+      baseRef = this.gitSdk.getDefaultBranch();
+      if (shouldLog(options.verbose, 1)) {
+        console.log(`📌 自动检测分支: base=${baseRef}, head=${headRef}`);
+      }
+    }
+
+    // 合并参数优先级：命令行 > PR 标题 > 配置文件 > 默认值
+    return {
+      owner,
+      repo,
+      prNumber,
+      baseRef,
+      headRef,
+      specSources,
+      dryRun: options.dryRun || titleOptions.dryRun || false,
+      ci: options.ci ?? false,
+      verbose: normalizeVerbose(options.verbose ?? titleOptions.verbose),
+      includes: options.includes ?? titleOptions.includes ?? reviewConf.includes,
+      llmMode: options.llmMode ?? titleOptions.llmMode ?? reviewConf.llmMode,
+      files: this.normalizeFilePaths(options.files),
+      commits: options.commits,
+      verifyFixes:
+        options.verifyFixes ?? titleOptions.verifyFixes ?? reviewConf.verifyFixes ?? true,
+      verifyConcurrency: options.verifyConcurrency ?? reviewConf.verifyFixesConcurrency ?? 10,
+      analyzeDeletions: this.resolveAnalyzeDeletions(
+        options.analyzeDeletions ??
+          options.deletionOnly ??
+          titleOptions.analyzeDeletions ??
+          titleOptions.deletionOnly ??
+          reviewConf.analyzeDeletions ??
+          false,
+        { ci: options.ci, hasPrNumber: !!prNumber },
+      ),
+      deletionOnly: options.deletionOnly || titleOptions.deletionOnly || false,
+      deletionAnalysisMode:
+        options.deletionAnalysisMode ??
+        titleOptions.deletionAnalysisMode ??
+        reviewConf.deletionAnalysisMode ??
+        "openai",
+      concurrency: options.concurrency ?? reviewConf.concurrency ?? 5,
+      timeout: options.timeout ?? reviewConf.timeout,
+      retries: options.retries ?? reviewConf.retries ?? 0,
+      retryDelay: options.retryDelay ?? reviewConf.retryDelay ?? 1000,
+      generateDescription: options.generateDescription ?? reviewConf.generateDescription ?? false,
+      showAll: options.showAll ?? false,
+      flush: options.flush ?? false,
+      eventAction: options.eventAction,
+      localMode,
+      skipDuplicateWorkflow:
+        options.skipDuplicateWorkflow ?? reviewConf.skipDuplicateWorkflow ?? false,
+      autoApprove: options.autoApprove ?? reviewConf.autoApprove ?? false,
+    };
+  }
+
+  /**
+   * 解析本地代码审查模式
+   * - 显式指定 --local [mode] 时使用指定值
+   * - 显式指定 --no-local 时禁用
+   * - 非 CI、非 PR、无 base/head 时默认启用 uncommitted 模式
+   */
+  resolveLocalMode(
+    options: ReviewOptions,
+    env: { ci: boolean; hasPrNumber: boolean; hasBaseHead: boolean },
+  ): "uncommitted" | "staged" | false {
+    // 显式指定了 --no-local
+    if (options.local === false) {
+      return false;
+    }
+    // 显式指定了 --local [mode]
+    if (options.local === "staged" || options.local === "uncommitted") {
+      return options.local;
+    }
+    // CI 或 PR 模式下不启用本地模式
+    if (env.ci || env.hasPrNumber) {
+      return false;
+    }
+    // 指定了 base/head 时不启用本地模式
+    if (env.hasBaseHead) {
+      return false;
+    }
+    // 默认启用 uncommitted 模式
+    return "uncommitted";
+  }
+
+  /**
+   * 将文件路径规范化为相对于仓库根目录的路径
+   * 支持绝对路径和相对路径输入
+   */
+  normalizeFilePaths(files?: string[]): string[] | undefined {
+    if (!files || files.length === 0) return files;
+
+    const cwd = process.cwd();
+    return files.map((file) => {
+      if (isAbsolute(file)) {
+        // 绝对路径转换为相对路径
+        return relative(cwd, file);
+      }
+      return file;
+    });
+  }
+
+  /**
+   * 根据 AnalyzeDeletionsMode 和当前环境解析是否启用删除代码分析
+   * @param mode 配置的模式值
+   * @param env 当前环境信息
+   * @returns 是否启用删除代码分析
+   */
+  resolveAnalyzeDeletions(
+    mode: AnalyzeDeletionsMode,
+    env: { ci: boolean; hasPrNumber: boolean },
+  ): boolean {
+    if (typeof mode === "boolean") {
+      return mode;
+    }
+    switch (mode) {
+      case "ci":
+        return env.ci;
+      case "pr":
+        return env.hasPrNumber;
+      case "terminal":
+        return !env.ci;
+      default:
+        return false;
+    }
+  }
+
+  /**
+   * 从 CI 事件文件中解析 PR 编号
+   * 在 CI 环境中，GitHub/Gitea Actions 会将事件信息写入 GITHUB_EVENT_PATH / GITEA_EVENT_PATH 指向的文件
+   * @returns PR 编号，如果无法解析则返回 undefined
+   */
+  async getPrNumberFromEvent(): Promise<number | undefined> {
+    const eventPath = process.env.GITHUB_EVENT_PATH || process.env.GITEA_EVENT_PATH;
+    if (!eventPath) {
+      return undefined;
+    }
+
+    try {
+      const eventContent = await readFile(eventPath, "utf-8");
+      const event = JSON.parse(eventContent);
+      // 支持多种事件类型：
+      // - pull_request 事件: event.pull_request.number 或 event.number
+      // - issue_comment 事件: event.issue.number
+      return event.pull_request?.number || event.issue?.number || event.number;
+    } catch {
+      return undefined;
+    }
+  }
+
+  /**
+   * 根据 commit 填充 issue 的 author 信息
+   * 如果没有找到对应的 author，使用最后一次提交的人作为默认值
+   */
+  async fillIssueAuthors(
+    issues: ReviewIssue[],
+    commits: PullRequestCommit[],
+    _owner: string,
+    _repo: string,
+    verbose?: VerboseLevel,
+  ): Promise<ReviewIssue[]> {
+    if (shouldLog(verbose, 2)) {
+      console.log(`[fillIssueAuthors] issues=${issues.length}, commits=${commits.length}`);
+    }
+
+    // 收集需要查找的 Git 作者信息（email 或 name）
+    const gitAuthorsToSearch = new Set<string>();
+    for (const commit of commits) {
+      const platformUser = commit.author || commit.committer;
+      if (!platformUser?.login) {
+        const gitAuthor = commit.commit?.author;
+        if (gitAuthor?.email) gitAuthorsToSearch.add(gitAuthor.email);
+        if (gitAuthor?.name) gitAuthorsToSearch.add(gitAuthor.name);
+      }
+    }
+
+    // 通过 Git Provider API 查找用户，建立 email/name -> UserInfo 的映射
+    const gitAuthorToUserMap = new Map<string, UserInfo>();
+    for (const query of gitAuthorsToSearch) {
+      try {
+        const users = await this.gitProvider.searchUsers(query, 1);
+        if (users.length > 0 && users[0].login) {
+          const user: UserInfo = { id: String(users[0].id), login: users[0].login };
+          gitAuthorToUserMap.set(query, user);
+          if (shouldLog(verbose, 2)) {
+            console.log(`[fillIssueAuthors] found user: ${query} -> ${user.login}`);
+          }
+        }
+      } catch {
+        // 忽略搜索失败
+      }
+    }
+
+    // 构建 commit hash 到 author 的映射
+    const commitAuthorMap = new Map<string, UserInfo>();
+    for (const commit of commits) {
+      const platformUser = commit.author || commit.committer;
+      const gitAuthor = commit.commit?.author;
+      if (shouldLog(verbose, 2)) {
+        console.log(
+          `[fillIssueAuthors] commit: sha=${commit.sha?.slice(0, 7)}, platformUser=${platformUser?.login}, gitAuthor=${gitAuthor?.name}`,
+        );
+      }
+      if (commit.sha) {
+        const shortHash = commit.sha.slice(0, 7);
+        if (platformUser?.login) {
+          commitAuthorMap.set(shortHash, {
+            id: String(platformUser.id),
+            login: platformUser.login,
+          });
+        } else if (gitAuthor) {
+          const foundUser =
+            (gitAuthor.email && gitAuthorToUserMap.get(gitAuthor.email)) ||
+            (gitAuthor.name && gitAuthorToUserMap.get(gitAuthor.name));
+          if (foundUser) {
+            commitAuthorMap.set(shortHash, foundUser);
+          } else if (gitAuthor.name) {
+            commitAuthorMap.set(shortHash, { id: "0", login: gitAuthor.name });
+          }
+        }
+      }
+    }
+    if (shouldLog(verbose, 2)) {
+      console.log(`[fillIssueAuthors] commitAuthorMap size: ${commitAuthorMap.size}`);
+    }
+
+    // 获取最后一次提交的 author 作为默认值
+    const lastCommit = commits[commits.length - 1];
+    const lastPlatformUser = lastCommit?.author || lastCommit?.committer;
+    const lastGitAuthor = lastCommit?.commit?.author;
+    let defaultAuthor: UserInfo | undefined;
+    if (lastPlatformUser?.login) {
+      defaultAuthor = { id: String(lastPlatformUser.id), login: lastPlatformUser.login };
+    } else if (lastGitAuthor) {
+      const foundUser =
+        (lastGitAuthor.email && gitAuthorToUserMap.get(lastGitAuthor.email)) ||
+        (lastGitAuthor.name && gitAuthorToUserMap.get(lastGitAuthor.name));
+      defaultAuthor =
+        foundUser || (lastGitAuthor.name ? { id: "0", login: lastGitAuthor.name } : undefined);
+    }
+    if (shouldLog(verbose, 2)) {
+      console.log(`[fillIssueAuthors] defaultAuthor: ${JSON.stringify(defaultAuthor)}`);
+    }
+    // 为每个 issue 填充 author
+    return issues.map((issue) => {
+      if (issue.author) {
+        if (shouldLog(verbose, 2)) {
+          console.log(`[fillIssueAuthors] issue already has author: ${issue.author.login}`);
+        }
+        return issue;
+      }
+      const shortHash = issue.commit?.slice(0, 7);
+      const author =
+        shortHash && !shortHash.includes("---") ? commitAuthorMap.get(shortHash) : undefined;
+      if (shouldLog(verbose, 2)) {
+        console.log(
+          `[fillIssueAuthors] issue: file=${issue.file}, commit=${issue.commit}, shortHash=${shortHash}, foundAuthor=${author?.login}, finalAuthor=${(author || defaultAuthor)?.login}`,
+        );
+      }
+      return { ...issue, author: author || defaultAuthor };
+    });
+  }
+}

package/src/review-includes-filter.spec.ts

@@ -0,0 +1,248 @@
+import { describe, it, expect } from "vitest";
+import {
+  parseIncludePattern,
+  filterFilesByIncludes,
+  extractGlobsFromIncludes,
+} from "./review-includes-filter";
+
+describe("review-includes-filter", () => {
+  describe("parseIncludePattern", () => {
+    it("无分隔符时返回原始 glob，status 为 undefined", () => {
+      expect(parseIncludePattern("*/**/*.ts")).toEqual({ status: undefined, glob: "*/**/*.ts" });
+    });
+
+    it("! 开头的排除模式直接返回，不解析前缀", () => {
+      expect(parseIncludePattern("!*/**/*.spec.ts")).toEqual({
+        status: undefined,
+        glob: "!*/**/*.spec.ts",
+      });
+    });
+
+    it("added| 前缀解析为 status=added", () => {
+      expect(parseIncludePattern("added|*/**/*.ts")).toEqual({
+        status: "added",
+        glob: "*/**/*.ts",
+      });
+    });
+
+    it("modified| 前缀解析为 status=modified", () => {
+      expect(parseIncludePattern("modified|*/**/*.ts")).toEqual({
+        status: "modified",
+        glob: "*/**/*.ts",
+      });
+    });
+
+    it("deleted| 前缀解析为 status=deleted", () => {
+      expect(parseIncludePattern("deleted|*/**/*.ts")).toEqual({
+        status: "deleted",
+        glob: "*/**/*.ts",
+      });
+    });
+
+    it("glob 部分可以带 ! 前缀（status 内排除语法）", () => {
+      expect(parseIncludePattern("added|!*/**/*.spec.ts")).toEqual({
+        status: "added",
+        glob: "!*/**/*.spec.ts",
+      });
+    });
+
+    it("无法识别的前缀当作普通 glob 处理（容错）", () => {
+      expect(parseIncludePattern("unknown|*/**/*.ts")).toEqual({
+        status: undefined,
+        glob: "unknown|*/**/*.ts",
+      });
+    });
+
+    it("extglob 中含 | 不被误识别为前缀分隔符", () => {
+      expect(parseIncludePattern("+(*.ts|*.js)")).toEqual({
+        status: undefined,
+        glob: "+(*.ts|*.js)",
+      });
+    });
+
+    it("前缀大小写不敏感", () => {
+      expect(parseIncludePattern("Added|*/**/*.ts")).toEqual({
+        status: "added",
+        glob: "*/**/*.ts",
+      });
+      expect(parseIncludePattern("MODIFIED|*/**/*.ts")).toEqual({
+        status: "modified",
+        glob: "*/**/*.ts",
+      });
+    });
+
+    it("平台别名：created 映射为 added", () => {
+      expect(parseIncludePattern("created|*/**/*.ts")).toEqual({
+        status: "added",
+        glob: "*/**/*.ts",
+      });
+    });
+
+    it("平台别名：removed 映射为 deleted", () => {
+      expect(parseIncludePattern("removed|*/**/*.ts")).toEqual({
+        status: "deleted",
+        glob: "*/**/*.ts",
+      });
+    });
+
+    it("平台别名：renamed 映射为 modified", () => {
+      expect(parseIncludePattern("renamed|*/**/*.ts")).toEqual({
+        status: "modified",
+        glob: "*/**/*.ts",
+      });
+    });
+  });
+
+  describe("filterFilesByIncludes", () => {
+    const files = [
+      { filename: "src/foo.ts", status: "added" },
+      { filename: "src/foo.spec.ts", status: "added" },
+      { filename: "src/bar.ts", status: "modified" },
+      { filename: "src/bar.spec.ts", status: "modified" },
+      { filename: "src/old.ts", status: "removed" },
+      { filename: "src/old.spec.ts", status: "removed" },
+    ];
+    const glob = "**/*.ts";
+    const specGlob = "**/*.spec.ts";
+
+    it("includes 为空时返回全部文件", () => {
+      expect(filterFilesByIncludes(files, [])).toEqual(files);
+    });
+
+    it("无前缀 glob 不限 status，匹配所有 .ts 文件", () => {
+      const result = filterFilesByIncludes(files, [glob]);
+      expect(result.map((f) => f.filename)).toEqual([
+        "src/foo.ts",
+        "src/foo.spec.ts",
+        "src/bar.ts",
+        "src/bar.spec.ts",
+        "src/old.ts",
+        "src/old.spec.ts",
+      ]);
+    });
+
+    it("排除模式过滤掉 spec 文件", () => {
+      const result = filterFilesByIncludes(files, [glob, `!${specGlob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/foo.ts", "src/bar.ts", "src/old.ts"]);
+    });
+
+    it("排除模式优先于所有正向匹配", () => {
+      const result = filterFilesByIncludes(files, [`added|${glob}`, `!${specGlob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/foo.ts"]);
+    });
+
+    it("added| 前缀只匹配 added 状态文件", () => {
+      const result = filterFilesByIncludes(files, [`added|${glob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/foo.ts", "src/foo.spec.ts"]);
+    });
+
+    it("modified| 前缀只匹配 modified 状态文件", () => {
+      const result = filterFilesByIncludes(files, [`modified|${glob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/bar.ts", "src/bar.spec.ts"]);
+    });
+
+    it("deleted| 前缀匹配 removed 状态文件（平台别名）", () => {
+      const result = filterFilesByIncludes(files, [`deleted|${glob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/old.ts", "src/old.spec.ts"]);
+    });
+
+    it("多个 status 前缀之间是 OR 关系", () => {
+      const result = filterFilesByIncludes(files, [`added|${glob}`, `modified|${glob}`]);
+      expect(result.map((f) => f.filename)).toEqual([
+        "src/foo.ts",
+        "src/foo.spec.ts",
+        "src/bar.ts",
+        "src/bar.spec.ts",
+      ]);
+    });
+
+    it("status 前缀内排除语法 added|!**/*.spec.ts", () => {
+      const result = filterFilesByIncludes(files, [`added|${glob}`, `added|!${specGlob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/foo.ts"]);
+    });
+
+    it("status 内排除只影响对应 status，不影响其他 status 的匹配", () => {
+      const result = filterFilesByIncludes(files, [
+        `added|${glob}`,
+        `added|!${specGlob}`,
+        `modified|${glob}`,
+      ]);
+      expect(result.map((f) => f.filename)).toEqual([
+        "src/foo.ts",
+        "src/bar.ts",
+        "src/bar.spec.ts",
+      ]);
+    });
+
+    it("无前缀 glob 与 status 前缀混用时任一命中即保留", () => {
+      const result = filterFilesByIncludes(files, [glob, "added|**/*.vue"]);
+      expect(result.map((f) => f.filename)).toEqual([
+        "src/foo.ts",
+        "src/foo.spec.ts",
+        "src/bar.ts",
+        "src/bar.spec.ts",
+        "src/old.ts",
+        "src/old.spec.ts",
+      ]);
+    });
+
+    it("status 未知的文件 fallback 为 modified", () => {
+      const unknownFiles = [{ filename: "src/foo.ts", status: undefined }];
+      const result = filterFilesByIncludes(unknownFiles, [`modified|${glob}`]);
+      expect(result.map((f) => f.filename)).toEqual(["src/foo.ts"]);
+    });
+
+    it("status 未知的文件不被 added| 匹配", () => {
+      const unknownFiles = [{ filename: "src/foo.ts", status: undefined }];
+      const result = filterFilesByIncludes(unknownFiles, [`added|${glob}`]);
+      expect(result).toEqual([]);
+    });
+
+    it("filename 为空的文件被过滤掉", () => {
+      const withEmpty = [
+        { filename: "", status: "added" },
+        { filename: "src/foo.ts", status: "added" },
+      ];
+      const result = filterFilesByIncludes(withEmpty, [glob]);
+      expect(result.map((f) => f.filename)).toEqual(["src/foo.ts"]);
+    });
+
+    it("GitHub 平台 status=removed 被 deleted| 前缀匹配", () => {
+      const ghFiles = [{ filename: "src/old.ts", status: "removed" }];
+      expect(filterFilesByIncludes(ghFiles, [`deleted|${glob}`])).toHaveLength(1);
+    });
+
+    it("GitLab 平台 status=deleted 被 deleted| 前缀匹配", () => {
+      const glFiles = [{ filename: "src/old.ts", status: "deleted" }];
+      expect(filterFilesByIncludes(glFiles, [`deleted|${glob}`])).toHaveLength(1);
+    });
+  });
+
+  describe("extractGlobsFromIncludes", () => {
+    it("无前缀的 glob 原样返回", () => {
+      expect(extractGlobsFromIncludes(["**/*.ts", "!**/*.spec.ts"])).toEqual([
+        "**/*.ts",
+        "!**/*.spec.ts",
+      ]);
+    });
+
+    it("有 status 前缀的 pattern 去掉前缀只返回 glob 部分", () => {
+      expect(extractGlobsFromIncludes(["added|**/*.ts", "modified|**/*.vue"])).toEqual([
+        "**/*.ts",
+        "**/*.vue",
+      ]);
+    });
+
+    it("混合模式只提取 glob 部分", () => {
+      expect(extractGlobsFromIncludes(["**/*.ts", "added|**/*.vue", "!**/*.spec.ts"])).toEqual([
+        "**/*.ts",
+        "**/*.vue",
+        "!**/*.spec.ts",
+      ]);
+    });
+
+    it("空数组返回空数组", () => {
+      expect(extractGlobsFromIncludes([])).toEqual([]);
+    });
+  });
+});