/** lib.mjs 的类型声明,供 index.ts 导入时获得类型信息 */
export interface WorktreeInfo {
  /** worktree 编号或描述名(gittree-<name>-task 或 gittree-<name> 中的 name) */
  name: string;
  /** 完整分支名 */
  branch: string;
  path: string;
  hash: string;
  prunable: boolean;
  /** worktree 被 `git worktree lock` 锁定 */
  locked: boolean;
  /** 是否有进程占用(不可安全删除) */
  inUse: boolean;
}

/** 转义字符串,使其可安全用于双引号包裹的 bash 字符串内。 */
export function shEscape(s: string): string;

/** 解析 `git worktree list --porcelain` 输出为结构化 worktree 列表。 */
export function parseWorktreePorcelain(out: string): WorktreeInfo[];

/** lsof spawnSync 结果。 */
export interface LsofSpawnResult {
  error?: unknown;
  stdout?: string | Buffer;
}

/** 从 `lsof -Fn` 输出中提取进程的 cwd 路径。 */
export function parseLsofCwds(out: string): string[];

/** 判断 lsof 调用结果是否「可用」（不依赖退出码）。 */
export function classifyLsofResult(res: LsofSpawnResult | null): boolean;