@spaceflow/review 0.29.3 → 0.31.0

package/src/review.config.ts

@@ -1,4 +1,6 @@
 import { z } from "@spaceflow/core";
+import type { LLMMode, VerboseLevel } from "@spaceflow/core";
+import type { ReportFormat } from "./review-report";
 
 /** LLM 模式 schema（与 core 中的 LLMMode 保持一致） */
 const llmModeSchema = z.enum(["claude-code", "openai", "gemini", "open-code"]);
@@ -12,6 +14,65 @@ const severitySchema = z.enum(["off", "warn", "error"]);
 /** 变更文件处理策略 schema */
 const invalidateChangedFilesSchema = z.enum(["invalidate", "keep", "off"]);
 
+/**
+ * 删除代码分析模式
+ * - true: 始终启用
+ * - false: 始终禁用
+ * - 'ci': 仅在 CI 环境中启用
+ * - 'pr': 仅在 PR 环境中启用
+ * - 'terminal': 仅在终端环境中启用
+ */
+export type AnalyzeDeletionsMode = z.infer<typeof analyzeDeletionsModeSchema>;
+
+/** 审查规则严重级别 */
+export type Severity = z.infer<typeof severitySchema>;
+
+/**
+ * 变更文件处理策略
+ * - 'invalidate': 将变更文件的历史问题标记为无效（默认）
+ * - 'keep': 保留历史问题，不做处理
+ * - 'off': 关闭此功能
+ */
+export type InvalidateChangedFilesMode = z.infer<typeof invalidateChangedFilesSchema>;
+
+/**
+ * Review 命令选项
+ */
+export interface ReviewOptions {
+  dryRun: boolean;
+  ci: boolean;
+  prNumber?: number;
+  base?: string;
+  head?: string;
+  references?: string[];
+  verbose?: VerboseLevel;
+  includes?: string[];
+  llmMode?: LLMMode;
+  files?: string[];
+  commits?: string[];
+  verifyFixes?: boolean;
+  verifyConcurrency?: number;
+  analyzeDeletions?: AnalyzeDeletionsMode;
+  /** 仅执行删除代码分析，跳过常规代码审查 */
+  deletionOnly?: boolean;
+  /** 删除代码分析模式：openai 使用标准模式，claude-agent 使用 Agent 模式 */
+  deletionAnalysisMode?: LLMMode;
+  /** 输出格式：markdown, terminal, json。不指定则智能选择 */
+  outputFormat?: ReportFormat;
+  /** 是否使用 AI 生成 PR 功能描述 */
+  generateDescription?: boolean;
+  /** 显示所有问题，不过滤非变更行的问题 */
+  showAll?: boolean;
+  /** 仅刷新状态（同步 reactions、resolved 等），不执行 LLM 审查 */
+  flush?: boolean;
+  /** PR 事件类型（opened, synchronize, closed 等） */
+  eventAction?: string;
+  concurrency?: number;
+  timeout?: number;
+  retries?: number;
+  retryDelay?: number;
+}
+
 /** review 命令配置 schema（LLM 敏感配置由系统 llm.config.ts 管理） */
 export const reviewSchema = () =>
   z.object({
@@ -33,26 +94,5 @@ export const reviewSchema = () =>
     invalidateChangedFiles: invalidateChangedFilesSchema.default("invalidate").optional(),
   });
 
-/**
- * 变更文件处理策略
- * - 'invalidate': 将变更文件的历史问题标记为无效（默认）
- * - 'keep': 保留历史问题，不做处理
- * - 'off': 关闭此功能
- */
-export type InvalidateChangedFilesMode = z.infer<typeof invalidateChangedFilesSchema>;
-
 /** review 配置类型（从 schema 推导） */
 export type ReviewConfig = z.infer<ReturnType<typeof reviewSchema>>;
-
-/**
- * 删除代码分析模式
- * - true: 始终启用
- * - false: 始终禁用
- * - 'ci': 仅在 CI 环境中启用
- * - 'pr': 仅在 PR 环境中启用
- * - 'terminal': 仅在终端环境中启用
- */
-export type AnalyzeDeletionsMode = z.infer<typeof analyzeDeletionsModeSchema>;
-
-/** 审查规则严重级别 */
-export type Severity = z.infer<typeof severitySchema>;