dependfix 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,672 +0,0 @@
-import * as citty from "citty";
-import { AppError, FixAction, NormalizedSecurityAlert, RunResult, SeverityThreshold } from "@dependfix/core";
-import { Octokit } from "@octokit/rest";
-export * from "@dependfix/core";
-
-//#region src/config/index.d.ts
-declare const RUNTIME_MODES: readonly ["report-only", "fix", "fix-and-pr", "cleanup-branches"];
-declare const SEVERITY_THRESHOLDS: readonly ["critical", "high", "medium", "all"];
-type RuntimeMode = typeof RUNTIME_MODES[number];
-interface RuntimeConfig {
-  mode: RuntimeMode;
-  severityThreshold: SeverityThreshold;
-  repositories: string[];
-  dryRun: boolean;
-  createPullRequest: boolean;
-  /** 修复完成后是否在本地当前分支直接提交（不推送、不创建 PR） */
-  commit: boolean;
-  /** fix-and-pr 模式下结束后是否列出已合并的 dependfix 分支到报告（不自动删除） */
-  cleanupBranches: boolean;
-  githubToken: string;
-  maxAlertsPerRepository: number;
-}
-interface CliConfigOverrides {
-  mode?: RuntimeMode;
-  severityThreshold?: SeverityThreshold;
-  repositories?: string[];
-  reposFilePath?: string;
-  dryRun?: boolean;
-  createPullRequest?: boolean;
-  /** 修复完成后是否在本地当前分支直接提交 */
-  commit?: boolean;
-  /** fix-and-pr 模式下结束后是否列出已合并的 dependfix 分支到报告 */
-  cleanupBranches?: boolean;
-  githubToken?: string;
-  maxAlertsPerRepository?: number;
-  /** 是否输出详细日志 */
-  verbose?: boolean;
-  /** 自定义验证命令（覆盖默认的 `pnpm install --frozen-lockfile` / `pnpm lint` / `pnpm build`） */
-  commands?: string[];
-}
-interface ResolveRuntimeConfigOptions {
-  env?: NodeJS.ProcessEnv;
-  cliOverrides?: CliConfigOverrides;
-  /** 工作目录，用于从 git remote 推断仓库名（默认 `process.cwd()`） */
-  workDir?: string;
-}
-declare const DEFAULT_RUNTIME_CONFIG: Omit<RuntimeConfig, 'githubToken' | 'repositories' | 'dryRun' | 'createPullRequest' | 'commit' | 'cleanupBranches'>;
-declare function readEnvConfig(env?: NodeJS.ProcessEnv): CliConfigOverrides;
-declare function resolveRuntimeConfig(options?: ResolveRuntimeConfigOptions): RuntimeConfig;
-/**
- * 从 git remote origin 推断 owner/repo。
- *
- * 支持格式：
- * - `https://github.com/owner/repo.git`
- * - `git@github.com:owner/repo.git`
- * - `ssh://git@github.com/owner/repo.git`
- *
- * @returns `owner/repo` 或 `null`（非 GitHub / 无 origin）
- */
-declare function inferRepoFromGitRemote(workDir: string): string | null;
-//#endregion
-//#region src/cli/index.d.ts
-interface CliInvocation {
-  mode?: RuntimeMode;
-  configOverrides: CliConfigOverrides;
-  rawArgs: string[];
-}
-interface CliRunResult {
-  ok: true;
-  invocation: CliInvocation;
-  config: ReturnType<typeof resolveRuntimeConfig>;
-}
-declare function parseCliArgs(rawArgs: string[]): CliInvocation;
-declare function runCli(rawArgs: string[]): CliRunResult;
-declare const dependfixCommand: citty.CommandDef<{
-  mode: {
-    type: "positional";
-    description: string;
-    required: false;
-    default: "report-only";
-  };
-  repo: {
-    type: "string";
-    description: string;
-    alias: string[];
-  };
-  'repos-file': {
-    type: "string";
-    description: string;
-  };
-  'severity-threshold': {
-    type: "string";
-    description: string;
-    default: "high";
-  };
-  'dry-run': {
-    type: "boolean";
-    description: string;
-    negativeDescription: string;
-  };
-  'create-pr': {
-    type: "boolean";
-    description: string;
-    negativeDescription: string;
-  };
-  commit: {
-    type: "boolean";
-    description: string;
-    negativeDescription: string;
-  };
-  'cleanup-branches': {
-    type: "boolean";
-    description: string;
-    negativeDescription: string;
-  };
-  'github-token': {
-    type: "string";
-    description: string;
-  };
-  'max-alerts-per-repository': {
-    type: "string";
-    description: string;
-    default: "10";
-  };
-  commands: {
-    type: "string";
-    description: string;
-  };
-  verbose: {
-    type: "boolean";
-    description: string;
-  };
-}>;
-//#endregion
-//#region src/app.d.ts
-interface DependfixAppOptions {
-  /** 已解析的运行时配置 */
-  config: RuntimeConfig;
-  /** 工作目录（默认 `process.cwd()`） */
-  workDir?: string;
-  /** 是否输出详细日志 */
-  verbose?: boolean;
-  /** 自定义验证命令（覆盖默认命令链） */
-  commands?: string[];
-}
-interface DependfixRunResult {
-  /** 结构化运行结果（用于报告生成） */
-  result: RunResult;
-  /** 进程退出码：0=全部成功, 1=部分失败, 2=全部失败 */
-  exitCode: number;
-}
-declare class DependfixApp {
-  private readonly config;
-  private readonly workDir;
-  private readonly logger;
-  private readonly verbose;
-  private readonly customCommands?;
-  private readonly runId;
-  private readonly allAlerts;
-  private readonly allActions;
-  private readonly allErrors;
-  private readonly repoResults;
-  private readonly summary;
-  private startedAt;
-  private finishedAt;
-  constructor(options: DependfixAppOptions);
-  /** 供辅助方法使用的状态切片。 */
-  private get ctx();
-  /** 执行完整的编排流程，返回结构化结果和退出码。 */
-  run(): Promise<DependfixRunResult>;
-  private executeMode;
-  private executeReportMode;
-  private processRepoForReport;
-  private executeFixMode;
-  private processRepoForFix;
-  /**
-   * 修复 → 计算内容指纹 → 查重 →（同指纹跳过 / 异指纹关旧开新）。
-   *
-   * 去重语义（T210）：
-   * - 同告警集 → 同修复结果 → 同指纹 → 跳过，不重复提交相同 PR
-   * - 内容变化 → 先创建新 PR（body 注明 Supersedes），成功后关闭旧 PR；
-   *   新 PR 创建失败时保留旧 PR，避免出现"无 PR 窗口"
-   */
-  private executeFixAndPrMode;
-  /**
-   * 清理已合并（或已关闭）的 dependfix 分支。
-   *
-   * - 分类：已合并（安全清理）/ 已关闭未合并（supersede 孤儿）/ open（跳过）
-   * - 删除前必须交互式确认（y/N）；非 TTY 环境（CI）默认拒绝
-   * - 只删 `dependfix/` 前缀分支，绝不触碰 open PR 对应分支
-   * - dry-run 模式仅列清单并打印 "would delete"，不执行删除
-   */
-  private executeCleanupBranchesMode;
-  private createClient;
-  /**
-   * 获取仓库的默认分支。
-   * 失败时返回 `'unknown'`（不阻塞主流程）。
-   */
-  private fetchDefaultBranch;
-}
-//#endregion
-//#region src/fixers/dependency/index.d.ts
-interface UpgradeDependencyParams {
-  /** 包名（如 `'lodash'`, `'@babel/traverse'`） */
-  packageName: string;
-  /** 目标精确版本（如 `'4.17.21'`） */
-  targetVersion: string;
-  /** 工作目录（包含 `package.json` 和 `pnpm-lock.yaml`） */
-  workDir: string;
-}
-interface DependencyFixResult {
-  packageName: string;
-  /** 升级前版本声明（保留原始 range 格式，如 `^4.17.20`） */
-  fromVersion: string;
-  /** 升级后版本声明（保留原始前缀，如 `^4.17.21`） */
-  toVersion: string;
-  /** 是否为 major 版本升级 */
-  isMajor: boolean;
-  /** 升级是否成功 */
-  success: boolean;
-  /** 失败原因（仅 `success=false` 时有值） */
-  error?: string;
-}
-interface PackageJson {
-  name?: string;
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-  optionalDependencies?: Record<string, string>;
-  peerDependencies?: Record<string, string>;
-  pnpm?: {
-    overrides?: Record<string, string>;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-interface DependencyInfo {
-  group: 'dependencies' | 'devDependencies' | 'optionalDependencies';
-  version: string;
-}
-/**
- * 升级单个依赖到指定版本。
- *
- * - 在 `workDir` 中查找 `package.json` 并修改目标包的版本声明（保留原始前缀）
- * - 执行 `pnpm install --no-frozen-lockfile` 更新 lockfile
- * - 失败时自动回滚 `package.json` 和 `pnpm-lock.yaml`
- * - 不执行验证（由 T107 负责）
- *
- * @param params - 包名、目标版本、工作目录
- * @returns 修复结果
- */
-declare function upgradeDependency(params: UpgradeDependencyParams): Promise<DependencyFixResult>;
-/**
- * 通过 pnpm `overrides` 升级间接（transitive）依赖。
- *
- * 间接依赖不在 `package.json` 的 `dependencies` / `devDependencies` 中列出，
- * 因此无法通过常规 `upgradeDependency` 处理。本函数根据项目类型选择覆盖写入位置：
- *
- * - **有 `pnpm-workspace.yaml`**（monorepo / workspace）→ 写入其中的 `overrides` 字段（pnpm v10+ 推荐）
- * - **无 `pnpm-workspace.yaml`**（单包项目）→ 写入 `package.json` 的 `pnpm.overrides`
- *
- * 失败时自动回滚被修改的文件和 `pnpm-lock.yaml`。不执行验证（由 T107 负责）。
- *
- * @param params - 包名、目标版本、工作目录
- * @returns 修复结果
- */
-declare function overrideTransitiveDependency(params: UpgradeDependencyParams): Promise<DependencyFixResult>;
-/**
- * 从版本声明中提取前缀（^ / ~ / 空）。
- *
- * @example
- * extractPrefix('^4.17.20')  // '^'
- * extractPrefix('~4.17.0')   // '~'
- * extractPrefix('4.17.20')   // ''
- * extractPrefix('*')         // '^'  (默认)
- */
-declare function extractPrefix(version: string): string;
-/**
- * 从版本声明中提取主版本号（major）。
- * 去除前缀后匹配第一个 semver 段。
- *
- * @example
- * parseMajorVersion('^4.17.20')   // 4
- * parseMajorVersion('~2.0.0')     // 2
- * parseMajorVersion('1.2.3')      // 1
- * parseMajorVersion('*')          // -1
- */
-declare function parseMajorVersion(version: string): number;
-/**
- * 在 `package.json` 的 `dependencies` / `devDependencies` / `optionalDependencies` 中按顺序查找包。
- */
-declare function findDependencyVersion(pkg: PackageJson, packageName: string): DependencyInfo | null;
-/**
- * 确保 `package.json` 中存在 `pnpm.overrides` 对象，若不存在则创建。
- * 返回 `overrides` 对象的引用，调用方可直接写入。
- */
-declare function ensurePnpmOverrides(pkg: PackageJson): Record<string, string>;
-/**
- * 从 `pnpm-lock.yaml` 中读取指定包的当前锁定版本。
- * 通过简单的正则匹配查找，不解析完整 YAML（性能优先）。
- *
- * pnpm v9+ lockfile 格式（v9.0 起）:
- *   /package-name/version:
- *   /@scope/package-name/version:
- *
- * @returns 锁定版本字符串（如 `'5.0.0'`），未找到返回 `null`
- */
-declare function readLockfileVersion(lockfilePath: string, packageName: string): string | null;
-//#endregion
-//#region src/fixers/pnpm/index.d.ts
-type LockfileFailureCategory = 'LOCKFILE_NOT_FOUND' | 'MANIFEST_MISMATCH' | 'LOCKFILE_VERSION_MISMATCH' | 'CORRUPTED_LOCKFILE' | 'CREDENTIAL_ERROR' | 'RESOLVE_ERROR' | 'UNKNOWN';
-type RepairStrategy = 'REGENERATE' | 'FIX_ENTRIES' | 'PIN_TOOLCHAIN' | 'REINSTALL' | 'SKIP';
-interface RepairLockfileParams {
-  /** 工作目录（必须包含 package.json 和 pnpm-lock.yaml） */
-  workDir: string;
-  /** 可选：期望的 pnpm 版本（优先于 packageManager 字段） */
-  toolchain?: {
-    pnpmVersion?: string;
-  };
-}
-interface LockfileDiff {
-  /** lockfile 行数变化（正=增加） */
-  linesChanged: number;
-  /** packages 条数变化（正=增加） */
-  packagesChanged: number;
-  /** 简要文字摘要 */
-  summary: string;
-}
-interface RepairAttempt {
-  strategy: RepairStrategy;
-  command: string;
-  success: boolean;
-  error?: string;
-  durationMs: number;
-}
-interface LockfileRepairResult {
-  success: boolean;
-  failureCategory?: LockfileFailureCategory;
-  failureDetail?: string;
-  strategy?: RepairStrategy;
-  diff?: LockfileDiff | null;
-  attemptHistory: RepairAttempt[];
-}
-interface ClassificationResult {
-  ok: boolean;
-  category?: LockfileFailureCategory;
-  stderr?: string;
-}
-/**
- * 执行 `pnpm i --frozen-lockfile` 并解析失败分类。
- * 成功时返回 { ok: true }。
- */
-declare function classifyLockfileFailure(workDir: string): ClassificationResult;
-/**
- * 比较修复前后 lockfile，返回行数与包数量变化摘要。
- */
-declare function computeLockfileDiff(beforePath: string, afterPath: string): LockfileDiff;
-/**
- * 从 package.json 的 `packageManager` 字段解析 pnpm 版本。
- * 优先级: toolchain.pnpmVersion > packageManager > null
- */
-declare function resolvePnpmVersion(workDir: string, toolchain?: {
-  pnpmVersion?: string;
-}): string | null;
-/**
- * 检测并修复 pnpm frozen-lockfile 漂移。
- *
- * 流程：
- * 1. 先跑 `pnpm i --frozen-lockfile` 诊断
- * 2. 若已合规 → 直接返回 success
- * 3. 若为 CREDENTIAL_ERROR → SKIP
- * 4. 按分类选取策略链，逐级尝试修复：
- *    - 每个策略执行后立即用 `pnpm i --frozen-lockfile` 验证
- *    - 验证通过 → 记录 diff、返回 success
- *    - 验证失败 → 继续下一个策略
- * 5. 所有策略失败 → 回滚 lockfile、返回失败结果
- */
-declare function repairLockfile(params: RepairLockfileParams): LockfileRepairResult;
-//#endregion
-//#region src/github/client.d.ts
-interface OctokitClientOptions {
-  /** GitHub Personal Access Token */
-  token: string;
-  /**
-   * API 基地址。
-   * 默认 `https://api.github.com`。
-   * 测试时指向 nock 拦截的同一地址。
-   */
-  baseUrl?: string;
-}
-/**
- * 创建已认证的 Octokit 实例。
- *
- * 调用方直接使用 `octokit.rest.*` 访问所有已类型化的 GitHub REST API。
- * 分页使用 `octokit.paginate()` 自动合并多页结果。
- *
- * @example
- * ```typescript
- * const octokit = createGitHubClient({ token: 'ghp_xxxx' })
- *
- * // 仓库信息
- * const { data: repo } = await octokit.rest.repos.get({ owner: 'foo', repo: 'bar' })
- *
- * // Dependabot 告警（自动分页）
- * const alerts = await octokit.paginate(
- *     octokit.rest.dependabot.listAlertsForRepo,
- *     { owner: 'foo', repo: 'bar', state: 'open', per_page: 100 },
- * )
- * ```
- */
-declare function createGitHubClient(options: OctokitClientOptions): Octokit;
-//#endregion
-//#region src/github/dependabot-fetcher.d.ts
-interface FetchDependabotAlertsParams {
-  /** 仓库所属组织或用户 */
-  owner: string;
-  /** 仓库名称 */
-  repo: string;
-  /**
-   * 告警状态过滤。
-   * M1 只拉 `open`（默认）。
-   */
-  state?: 'open' | 'fixed' | 'dismissed' | 'auto_dismissed';
-  /** 每页数量，默认 100（GitHub API 最大值） */
-  perPage?: number;
-}
-/**
- * 拉取指定仓库的 Dependabot 告警并映射为标准化模型。
- *
- * - 自动分页（`octokit.paginate()`），返回所有匹配的告警
- * - 仅处理 `state=open` 的告警（可通过 `params.state` 覆盖）
- * - 异常通过 `mapGitHubError` 转为 `AppError`
- * - 空仓库返回 `[]`，不抛异常
- *
- * @param client - 已认证的 Octokit 实例（来自 `createGitHubClient`）
- * @param params - 仓库标识与过滤参数
- * @returns 标准化告警列表
- *
- * @example
- * ```typescript
- * const octokit = createGitHubClient({ token: 'ghp_xxxx' })
- * const alerts = await fetchDependabotAlerts(octokit, { owner: 'foo', repo: 'bar' })
- * ```
- */
-declare function fetchDependabotAlerts(client: Octokit, params: FetchDependabotAlertsParams): Promise<NormalizedSecurityAlert[]>;
-//#endregion
-//#region src/github/errors.d.ts
-/**
- * 将 Octokit 请求错误映射为 `AppError`。
- *
- * @param error   - 原始错误（`RequestError` 或网络异常）
- * @param context - 调用上下文描述（如 `'fetch repo info for foo/bar'`），会附加到错误消息中
- */
-declare function mapGitHubError(error: unknown, context: string): AppError;
-//#endregion
-//#region src/github/pr-creator.d.ts
-interface CreatePullRequestParams {
-  /** 已认证的 Octokit 实例 */
-  octokit: Octokit;
-  /** 仓库 owner */
-  owner: string;
-  /** 仓库名 */
-  repo: string;
-  /** 修复分支名 */
-  headBranch: string;
-  /** 目标分支（默认 master/main，从 API 获取） */
-  baseBranch: string;
-  /** PR 标题 */
-  title: string;
-  /** PR 内容（Markdown） */
-  body: string;
-}
-interface PullRequestResult {
-  /** PR 编号 */
-  number: number;
-  /** PR HTML URL */
-  htmlUrl: string;
-}
-interface FixBranchResult {
-  /** 分支名 */
-  branchName: string;
-  /** 是否为新创建 */
-  created: boolean;
-}
-/** dependfix 自动修复 PR 的公开信息（用于查重/取代判定） */
-interface DependfixOpenPR {
-  /** PR 编号 */
-  number: number;
-  /** PR HTML URL */
-  htmlUrl: string;
-  /** PR head 分支名 */
-  headRef: string;
-}
-/**
- * 计算修复内容指纹（sha256 前 8 位）。
- *
- * 指纹基于**结构化修复结果**而非 git diff：
- * - 成功升级集：`pkg@toVersion`（排序拼接）
- * - 修复失败集：失败包名（排序拼接）
- * - lockfile 修复状态（成功/失败）
- *
- * 同告警集 → 同修复结果 → 同指纹 → 幂等跳过；
- * 内容变化（升级集/失败集/锁文件修复变化）→ 指纹变化 → 关旧开新。
- * 不用 diff hash 是因为 pnpm 版本等非确定性因素会使锁文件内容漂移，
- * 导致"告警没变但指纹变"。
- */
-declare function computeFixFingerprint(actions: FixAction[]): string;
-/**
- * 从分支名提取内容指纹（`dependfix/auto-fix-{fp8}` → `{fp8}`）。
- * 指纹格式为 8 位 hex；分支名不含 `-` 后的内容、前缀不匹配或格式不合法时返回 null
- * （如旧版 runId 分支，会被 supersede）。
- */
-declare function extractFingerprintFromBranch(branchName: string): string | null;
-/** fix-and-pr 去重决策结果 */
-interface FixAndPrPlan {
-  /** skip = 已有同内容 PR，不重复提交；create = 需要新建 PR */
-  action: 'skip' | 'create';
-  /** action=skip 时命中的同内容 PR */
-  sameContentPR?: DependfixOpenPR;
-  /** 内容不同、需要关闭（supersede）的旧 PR 列表 */
-  supersedePRs: DependfixOpenPR[];
-}
-/**
- * 计算 fix-and-pr 去重决策：
- * - 存在同指纹 open PR → skip（仅需关闭其余异指纹 PR）
- * - 否则 → create（关闭全部旧 PR，先建新后关旧由调用方保证）
- */
-declare function computeFixAndPrPlan(existingPRs: DependfixOpenPR[], fingerprint: string): FixAndPrPlan;
-/**
- * 在工作目录创建修复分支。
- *
- * - 分支名由调用方传入（T210 起为 `dependfix/auto-fix-{内容指纹}`，不再依赖 runId）
- * - 如果分支已存在（如重跑），切换到该分支
- *
- * @returns 分支名和是否为新创建
- */
-declare function createFixBranch(branchName: string, workDir: string): FixBranchResult;
-/**
- * 暂存所有变更并提交。
- * 自动设置 git user.name / user.email（如未设置）。
- */
-declare function stageAndCommit(message: string, workDir: string): void;
-/**
- * 推送分支到远程 origin。
- */
-declare function pushBranch(branchName: string, workDir: string): void;
-/**
- * 查找目标仓库中所有 open 状态的 dependfix 自动修复 PR。
- *
- * GitHub 的 `pulls.list` 的 `head` 参数不支持通配符，因此拉取 open PR 列表后
- * 按 head 分支前缀 `dependfix/auto-fix-` 过滤。假设 PR 数量不多（单页 100 足够），
- * 未来 PR 数量增大时可引入 label 索引（见 backlog B1）。
- */
-declare function findDependfixOpenPR(octokit: Octokit, owner: string, repo: string): Promise<DependfixOpenPR[]>;
-/**
- * 关闭 Pull Request（用于 supersede 旧 PR）。
- */
-declare function closePullRequest(octokit: Octokit, owner: string, repo: string, pullNumber: number): Promise<void>;
-/**
- * 通过 GitHub API 创建 Pull Request。
- */
-declare function createPullRequest(params: CreatePullRequestParams): Promise<PullRequestResult>;
-/** 分支清理状态（用于 cleanup-branches 清单分类） */
-interface DependfixBranchStatus {
-  /** 分支名 */
-  branch: string;
-  /** 关联 PR 编号（无 PR 记录时为 null） */
-  prNumber: number | null;
-  /** PR 是否已合并 */
-  merged: boolean;
-  /** PR 是否已关闭（含合并） */
-  closed: boolean;
-}
-/**
- * 列出远端所有 `dependfix/` 前缀分支（git.listMatchingRefs 精确前缀匹配）。
- */
-declare function listDependfixBranches(octokit: Octokit, owner: string, repo: string): Promise<string[]>;
-/**
- * 查询分支对应的最近 PR 状态（pulls.list head 精确匹配，按最近更新取 1 条）。
- */
-declare function getBranchPrStatus(octokit: Octokit, owner: string, repo: string, branch: string): Promise<DependfixBranchStatus>;
-/**
- * 删除远端分支（git ref delete）。失败（分支保护、不存在）由调用方捕获处理。
- */
-declare function deleteRemoteBranch(octokit: Octokit, owner: string, repo: string, branch: string): Promise<void>;
-/**
- * 判定交互确认回答是否为"是"（y/yes，大小写不敏感；空输入默认拒绝）。
- */
-declare function isConfirmAnswer(answer: string): boolean;
-/**
- * 从 RunResult 生成 PR body（Markdown）。
- *
- * @param supersededNumbers 被本 PR 取代并已关闭的旧 PR 编号列表（用于 Supersedes 声明）
- */
-declare function generatePRBody(result: RunResult, supersededNumbers?: number[]): string;
-//#endregion
-//#region src/github/repo-selector.d.ts
-/**
- * 从文件读取仓库列表（每行一个 `owner/repo`）。
- * 空行和 `#` 开头的注释行会被跳过。
- */
-declare function readReposFile(filePath: string): string[];
-/**
- * 合并 CLI 传入仓库列表与文件中的仓库列表，去重并校验。
- */
-declare function resolveRepoList(cliRepos: string[], reposFilePath?: string): string[];
-//#endregion
-//#region src/runners/verification-runner.d.ts
-/**
- * 单条命令的执行结果
- */
-interface CommandResult {
-  /** 执行的命令文本 */
-  command: string;
-  /** 退出码（0 = 成功） */
-  exitCode: number;
-  /** 执行耗时（毫秒） */
-  durationMs: number;
-  /** stdout 摘要（截断到 200 行，已脱敏） */
-  stdout: string;
-  /** stderr 摘要（截断到 200 行，已脱敏） */
-  stderr: string;
-}
-/**
- * 验证执行参数
- */
-interface VerificationParams {
-  /** 工作目录 */
-  workDir: string;
-  /**
-   * 要执行的命令序列。
-   * 默认: `pnpm install --frozen-lockfile` → `pnpm lint` → `pnpm build`
-   */
-  commands?: string[];
-}
-/**
- * 验证执行结果
- */
-interface VerificationResult {
-  /** 所有命令是否全部成功 */
-  success: boolean;
-  /** 每条命令的详细结果 */
-  commandResults: CommandResult[];
-  /** 失败的命令（仅 success=false 时填充） */
-  failedCommand?: string;
-  /** 失败详情（仅 success=false 时填充） */
-  failure?: string;
-}
-/**
- * 按顺序在工作目录执行命令序列，任一命令失败则停止。
- *
- * @example
- * ```ts
- * const result = await runVerification({ workDir: '/repo' })
- * if (!result.success) {
- *     console.error(result.failure)
- * }
- * ```
- */
-declare function runVerification(params: VerificationParams): Promise<VerificationResult>;
-/**
- * 对外暴露以支持单独测试
- */
-declare function sanitizeOutput(output: string): string;
-//#endregion
-//#region src/index.d.ts
-/**
- * 简化调用的入口（内部数据处理，非 CLI 使用）。
- */
-declare function main(args?: string[]): CliRunResult;
-//#endregion
-export { CliConfigOverrides, CliInvocation, CliRunResult, CommandResult, CreatePullRequestParams, DEFAULT_RUNTIME_CONFIG, DependencyFixResult, DependfixApp, DependfixAppOptions, DependfixBranchStatus, DependfixOpenPR, DependfixRunResult, FetchDependabotAlertsParams, FixAndPrPlan, FixBranchResult, LockfileDiff, LockfileFailureCategory, LockfileRepairResult, OctokitClientOptions, PullRequestResult, RUNTIME_MODES, RepairAttempt, RepairLockfileParams, RepairStrategy, ResolveRuntimeConfigOptions, RuntimeConfig, RuntimeMode, SEVERITY_THRESHOLDS, type SeverityThreshold, UpgradeDependencyParams, VerificationParams, VerificationResult, classifyLockfileFailure, closePullRequest, computeFixAndPrPlan, computeFixFingerprint, computeLockfileDiff, createFixBranch, createGitHubClient, createPullRequest, deleteRemoteBranch, dependfixCommand, ensurePnpmOverrides, extractFingerprintFromBranch, extractPrefix, fetchDependabotAlerts, findDependencyVersion, findDependfixOpenPR, generatePRBody, getBranchPrStatus, inferRepoFromGitRemote, isConfirmAnswer, listDependfixBranches, main, mapGitHubError, overrideTransitiveDependency, parseCliArgs, parseMajorVersion, pushBranch, readEnvConfig, readLockfileVersion, readReposFile, repairLockfile, resolvePnpmVersion, resolveRepoList, resolveRuntimeConfig, runCli, runVerification, sanitizeOutput, stageAndCommit, upgradeDependency };
-//# sourceMappingURL=index.d.cts.map