Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

7.0 KB
Raw Blame
/**
 * worktree 路径 → base repo 折叠:桌面与手机共享的唯一事实源。
 *
 * 会话跑在 worktree 里时,它的 workingDir 是 `<base repo>/<容器目录>/<worktree 名>`。
 * worktree 名是随机生成的(见 desktop `worktree/nameGenerator.ts`,docker 风格
 * `形容词-名人`),所以**按 workingDir 原值分组会把每个 worktree 变成一个独立「项目」,
 * 标题显示成 `serene-lovelace` 这类随机名**。项目分组与项目归属判断必须先折叠到 base
 * repo(`groupingWorktreeBaseRepo`,认全部四种容器目录);项目设置读写只对 Cindy 托管
 * worktree 折叠(`managedWorktreeBaseRepo`)——用户自建的 `.worktrees` /
 * `.claude/worktrees` 可能刻意带独立的 `.claude/settings.json`,继承 base repo 会覆盖
 * 掉它的意图。需要真正读写文件的路径一律用会话 workingDir 原值。
 *
 * 本模块只做纯字符串折叠(不碰文件系统),同时接受 `/` 与 `\` 分隔符,并保留输入的
 * 分隔符风格 —— 手机端的项目标题 / 副标题直接展示折叠结果,不能被改写成另一种风格。
 */

/** Cindy 新建托管 worktree 使用的目录名。 */
export const MANAGED_WORKTREE_DIR_NAME = '.cindy-worktrees';

/** 品牌迁移前使用的目录名;只用于识别和恢复既有 worktree。 */
export const LEGACY_MANAGED_WORKTREE_DIR_NAME = '.xdt-worktrees';

/** 所有受 Cindy 生命周期管理的 worktree 目录名,新目录必须排在第一位。 */
export const MANAGED_WORKTREE_DIR_NAMES = [
  MANAGED_WORKTREE_DIR_NAME,
  LEGACY_MANAGED_WORKTREE_DIR_NAME,
] as const;

/** 判断一个目录 basename 是否属于 Cindy 托管的 worktree 根目录。 */
export function isManagedWorktreeDirectoryName(name: string): boolean {
  return MANAGED_WORKTREE_DIR_NAMES.some((candidate) => candidate === name);
}

/** Cindy 托管的 worktree 容器目录(生命周期由 Cindy 管理,项目设置继承 base repo)。 */
const MANAGED_WORKTREE_CONTAINERS: readonly (readonly string[])[] = MANAGED_WORKTREE_DIR_NAMES.map(
  (name) => [name] as const,
);

/**
 * 用户 / 其它工具自己建的 worktree 约定目录。它们可能刻意带独立的
 * `.claude/settings.json`,所以只用于**分组**,不参与项目设置继承。
 */
const CONVENTIONAL_WORKTREE_CONTAINERS: readonly (readonly string[])[] = [
  ['.worktrees'],
  ['.claude', 'worktrees'],
];

const GROUPING_WORKTREE_CONTAINERS: readonly (readonly string[])[] = [
  ...MANAGED_WORKTREE_CONTAINERS,
  ...CONVENTIONAL_WORKTREE_CONTAINERS,
];

interface PathSegment {
  readonly start: number;
  readonly text: string;
}

/**
 * 反斜杠是否算分隔符 —— 只有盘符路径(`C:\`)与反斜杠 UNC(`\\server\share`)才算。
 * POSIX 路径里的反斜杠是**文件名的合法字符**(桌面侧 storage 归一化刻意保留它),
 * 把它当分隔符会让 `/repo/weird\.worktrees/name` 被误折叠成 `/repo/weird`。
 */
function usesBackslashSeparator(value: string): boolean {
  return /^[A-Za-z]:[\\/]/.test(value) || value.startsWith('\\\\');
}

/** 拆出非空路径段并记录每段在原串中的起始下标(折叠时按下标切片,保留原分隔符风格)。 */
function splitPathSegments(value: string, allowBackslash: boolean): PathSegment[] {
  const segments: PathSegment[] = [];
  let start = -1;
  for (let i = 0; i <= value.length; i += 1) {
    if (i < value.length) {
      const code = value.charCodeAt(i);
      const isSeparator = code === 47 /* / */ || (allowBackslash && code === 92 /* \ */);
      if (!isSeparator) {
        if (start < 0) start = i;
        continue;
      }
    }
    if (start >= 0) {
      segments.push({ start, text: value.slice(start, i) });
      start = -1;
    }
  }
  return segments;
}

function isDriveRoot(value: string): boolean {
  return value.length === 2 && value[1] === ':' && /^[A-Za-z]$/.test(value[0]);
}

/**
 * 去掉 base 末尾的分隔符。只去当前路径风格认可的分隔符 —— POSIX 下目录名可以以反斜杠
 * 结尾(`/repo/weird\`),不能顺手削掉。
 */
function stripTrailingSeparators(value: string, allowBackslash: boolean): string {
  let end = value.length;
  while (end > 0) {
    const code = value.charCodeAt(end - 1);
    if (code !== 47 /* / */ && !(allowBackslash && code === 92 /* \ */)) break;
    end -= 1;
  }
  return end === value.length ? value : value.slice(0, end);
}

function resolveWorktreeBase(
  value: string,
  containers: readonly (readonly string[])[],
  comparison: 'exact' | 'windows-insensitive',
): string | null {
  const allowBackslash = usesBackslashSeparator(value);
  // 分组可兼容 Windows 路径的容器大小写;托管识别必须保持精确匹配,
  // 否则会改变项目设置继承和 worktree 恢复的判定。正斜杠 UNC 也按 Windows 比较。
  const ignoreCase = comparison === 'windows-insensitive'
    && (allowBackslash || value.startsWith('//'));
  const segments = splitPathSegments(value, allowBackslash);
  for (let i = 0; i < segments.length; i += 1) {
    for (const container of containers) {
      // 容器目录后面必须还有一段 worktree 名,否则这只是容器目录本身(或它的父级)。
      if (i + container.length >= segments.length) continue;
      let matched = true;
      for (let k = 0; k < container.length; k += 1) {
        const segment = segments[i + k].text;
        if ((ignoreCase ? segment.toLowerCase() : segment) !== container[k]) {
          matched = false;
          break;
        }
      }
      if (!matched) continue;

      const markerStart = segments[i].start;
      // 路径以容器目录开头(相对路径)时定不出 base repo,按不折叠处理。
      if (markerStart === 0) continue;
      const base = stripTrailingSeparators(value.slice(0, markerStart), allowBackslash);
      // base 只剩分隔符 → POSIX 根;盘符根(`C:`)要补回一个分隔符,否则 `C:` 会退化成
      // drive-relative 语义。分隔符字符都取自原串,不改写风格。
      if (base === '') return value.slice(0, 1);
      if (isDriveRoot(base)) return `${base}${value[markerStart - 1]}`;
      return base;
    }
  }
  return null;
}

/**
 * 解析 Cindy 托管 worktree 的 base repo(只认 `.cindy-worktrees` / `.xdt-worktrees`)。
 * 容器名始终精确匹配;不是托管 worktree 路径时返回 null。
 */
export function managedWorktreeBaseRepo(value: string): string | null {
  return resolveWorktreeBase(value, MANAGED_WORKTREE_CONTAINERS, 'exact');
}

/**
 * 解析用于**项目分组**的 base repo:托管 worktree 加上 `.worktrees/<name>` 与
 * `.claude/worktrees/<name>` 这两种社区约定形态。不是 worktree 路径时返回 null。
 * Windows 盘符 / UNC 路径的容器名忽略大小写,POSIX 保持精确匹配。
 */
export function groupingWorktreeBaseRepo(value: string): string | null {
  return resolveWorktreeBase(value, GROUPING_WORKTREE_CONTAINERS, 'windows-insensitive');
}

/** 项目分组用:是 worktree 路径就折叠到 base repo,否则原样返回。 */
export function collapseWorktreeDirForGrouping(value: string): string {
  return groupingWorktreeBaseRepo(value) ?? value;
}