feat: 添加Agent审查引擎核心类型和Schema定义

定义ReviewRun、Finding、ReviewContext等核心数据结构，以及基于Zod的finding响应校验Schema

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

src/review/schema/finding-schema.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+
+const findingItemSchema = z.object({
+  category: z.enum(['correctness', 'security', 'reliability', 'maintainability']).optional(),
+  severity: z.enum(['high', 'medium', 'low']),
+  confidence: z.number().min(0).max(1),
+  path: z.string().min(1),
+  line: z.number().int().positive(),
+  title: z.string().min(1),
+  detail: z.string().min(1),
+  evidence: z.string().min(1),
+  suggestion: z.string().min(1),
+  fingerprint: z.string().min(1).optional(),
+});
+
+export const findingResponseSchema = z.object({
+  findings: z.array(findingItemSchema).default([]),
+});
+
+export type FindingResponse = z.infer<typeof findingResponseSchema>;

src/review/types.ts

@@ -0,0 +1,146 @@
+export type ReviewEngineMode = 'legacy' | 'agent';
+
+export type ReviewEventType = 'pull_request' | 'commit_status';
+
+export type ReviewRunStatus =
+  | 'queued'
+  | 'in_progress'
+  | 'succeeded'
+  | 'failed'
+  | 'ignored';
+
+export type FindingSeverity = 'high' | 'medium' | 'low';
+
+export type FindingCategory =
+  | 'correctness'
+  | 'security'
+  | 'reliability'
+  | 'maintainability';
+
+export interface ReviewRun {
+  id: string;
+  idempotencyKey: string;
+  eventType: ReviewEventType;
+  status: ReviewRunStatus;
+  owner: string;
+  repo: string;
+  cloneUrl: string;
+  headCloneUrl?: string; // Fork PR场景：head commit的源仓库URL，用于fetch head SHA
+  prNumber?: number;
+  relatedPrNumber?: number;
+  baseSha?: string;
+  headSha?: string;
+  commitSha?: string;
+  commitMessage?: string;
+  attempts: number;
+  maxAttempts: number;
+  createdAt: string;
+  updatedAt: string;
+  startedAt?: string;
+  finishedAt?: string;
+  error?: string;
+}
+
+export interface ReviewStep {
+  id: string;
+  runId: string;
+  stepName: string;
+  agentName?: string;
+  status: 'started' | 'succeeded' | 'failed';
+  startedAt: string;
+  finishedAt?: string;
+  latencyMs?: number;
+  inputRef?: string;
+  outputRef?: string;
+  error?: string;
+}
+
+export interface Finding {
+  id: string;
+  runId: string;
+  fingerprint: string;
+  category: FindingCategory;
+  severity: FindingSeverity;
+  confidence: number;
+  path: string;
+  line: number;
+  title: string;
+  detail: string;
+  evidence: string;
+  suggestion: string;
+  published: boolean;
+}
+
+export interface ReviewCommentRecord {
+  id: string;
+  runId: string;
+  path?: string;
+  line?: number;
+  body: string;
+  giteaCommentId?: number;
+  status: 'pending' | 'published' | 'failed';
+  createdAt: string;
+  fingerprint?: string; // Finding fingerprint for matching feedback to specific findings
+}
+
+export interface ReviewPayloadBase {
+  idempotencyKey: string;
+  owner: string;
+  repo: string;
+  cloneUrl: string;
+  headCloneUrl?: string; // Fork PR场景：head commit的源仓库URL
+  maxAttempts?: number;
+}
+
+export interface PullRequestReviewPayload extends ReviewPayloadBase {
+  eventType: 'pull_request';
+  prNumber: number;
+  baseSha: string;
+  headSha: string;
+}
+
+export interface CommitReviewPayload extends ReviewPayloadBase {
+  eventType: 'commit_status';
+  commitSha: string;
+  commitMessage?: string;
+  relatedPrNumber?: number;
+}
+
+export type ReviewPayload = PullRequestReviewPayload | CommitReviewPayload;
+
+export interface ChangedFile {
+  path: string;
+  status: 'A' | 'M' | 'D' | 'R' | 'C' | 'T' | 'U' | 'X' | 'B';
+  additions: number;
+  deletions: number;
+}
+
+export interface DiffLine {
+  lineNumber: number;
+  content: string;
+  type: 'add' | 'context';
+}
+
+export interface DiffFile {
+  path: string;
+  changes: DiffLine[];
+}
+
+export interface ReviewContext {
+  workspacePath: string;
+  mirrorPath: string;
+  diff: string;
+  changedFiles: ChangedFile[];
+  parsedDiff: DiffFile[];
+  fileContents: Record<string, string>;
+}
+
+export interface AgentResult {
+  agentName: string;
+  findings: Omit<Finding, 'id' | 'runId' | 'published'>[];
+}
+
+export interface ReviewDecision {
+  summaryMarkdown: string;
+  findings: Omit<Finding, 'id' | 'runId' | 'published'>[];
+}