grf-cli 1.0.0

package/dist/core/repository.js

@@ -0,0 +1,374 @@
+"use strict";
+/**
+ * Repository 模块
+ * 负责仓库的增删改查操作，整合配置、Git 和文件系统模块
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRepoUrl = parseRepoUrl;
+exports.getRepoStoragePath = getRepoStoragePath;
+exports.add = add;
+exports.get = get;
+exports.list = list;
+exports.remove = remove;
+exports.exists = exists;
+exports.resolvePath = resolvePath;
+exports.switchBranch = switchBranch;
+const path_1 = __importDefault(require("path"));
+const index_js_1 = require("../types/index.js");
+const config_js_1 = require("./config.js");
+const git = __importStar(require("./git.js"));
+const fs = __importStar(require("./filesystem.js"));
+/**
+ * 解析 Git URL
+ * 支持 HTTPS 和 SSH 格式
+ * @param url Git 仓库 URL
+ * @returns 解析后的 URL 信息
+ * @throws GrfError 如果 URL 格式无效
+ *
+ * @example
+ * // HTTPS 格式
+ * parseRepoUrl('https://github.com/facebook/react.git')
+ * // -> { host: 'github.com', owner: 'facebook', repo: 'react' }
+ *
+ * // SSH 格式
+ * parseRepoUrl('git@github.com:facebook/react.git')
+ * // -> { host: 'github.com', owner: 'facebook', repo: 'react' }
+ */
+function parseRepoUrl(url) {
+    // 去除首尾空白
+    url = url.trim();
+    // HTTPS 格式: https://github.com/user/repo.git
+    const httpsRegex = /^https?:\/\/([^/]+)\/([^/]+)\/([^/]+?)(?:\.git)?$/;
+    const httpsMatch = url.match(httpsRegex);
+    if (httpsMatch) {
+        return {
+            host: httpsMatch[1],
+            owner: httpsMatch[2],
+            repo: httpsMatch[3].replace(/\.git$/, ""),
+        };
+    }
+    // SSH 格式: git@github.com:user/repo.git
+    const sshRegex = /^git@([^:]+):([^/]+)\/([^/]+?)(?:\.git)?$/;
+    const sshMatch = url.match(sshRegex);
+    if (sshMatch) {
+        return {
+            host: sshMatch[1],
+            owner: sshMatch[2],
+            repo: sshMatch[3].replace(/\.git$/, ""),
+        };
+    }
+    throw new index_js_1.GrfError(index_js_1.ErrorCode.REPO_INVALID_URL, `无效的 Git URL: ${url}。支持的格式: https://github.com/user/repo.git 或 git@github.com:user/repo.git`);
+}
+/**
+ * 根据 URL 生成本地存储路径
+ * @param url Git 仓库 URL
+ * @returns 本地存储路径
+ *
+ * @example
+ * getRepoStoragePath('https://github.com/facebook/react.git')
+ * // -> ~/.gitreference/repos/github.com/facebook/react
+ */
+function getRepoStoragePath(url) {
+    const { host, owner, repo } = parseRepoUrl(url);
+    return path_1.default.join((0, config_js_1.getReposRoot)(), host, owner, repo);
+}
+/**
+ * 根据解析后的 URL 信息生成仓库名称
+ * @param parsed 解析后的 URL 信息
+ * @returns 仓库名称（格式: host/owner/repo）
+ */
+function getRepoName(parsed) {
+    return `${parsed.host}/${parsed.owner}/${parsed.repo}`;
+}
+/**
+ * 添加仓库
+ * @param url Git 仓库 URL
+ * @param options 添加选项
+ * @returns 仓库信息
+ */
+async function add(url, options) {
+    // 解析 URL
+    const parsed = parseRepoUrl(url);
+    const repoPath = getRepoStoragePath(url);
+    const repoName = options?.name ?? getRepoName(parsed);
+    // 检查仓库是否已存在
+    if (await exists(repoName)) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.REPO_ALREADY_EXISTS, `仓库已存在: ${repoName}`);
+    }
+    // 确保配置目录存在
+    await (0, config_js_1.ensureConfigDir)();
+    // 确保父目录存在
+    await fs.ensureDir(path_1.default.dirname(repoPath));
+    // 克隆仓库
+    await git.clone(url, repoPath, {
+        branch: options?.branch,
+        shallow: options?.shallow,
+        depth: options?.depth,
+    });
+    // 获取 commit ID 和分支信息
+    const commitId = await git.getCurrentCommit(repoPath);
+    const branch = await git.getBranch(repoPath);
+    // 创建元信息
+    const now = new Date().toISOString();
+    const meta = {
+        url,
+        name: repoName,
+        addedAt: now,
+        updatedAt: now,
+        commitId,
+        branch,
+    };
+    // 保存元信息
+    await (0, config_js_1.writeRepoMeta)(repoPath, meta);
+    // 更新全局配置
+    const config = await (0, config_js_1.readGlobalConfig)();
+    config.repos[repoName] = {
+        url,
+        path: repoPath,
+        addedAt: now,
+    };
+    await (0, config_js_1.writeGlobalConfig)(config);
+    return {
+        name: repoName,
+        url,
+        path: repoPath,
+        commitId,
+        branch,
+        addedAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * 检查仓库名称是否匹配
+ * 支持以下匹配方式：
+ * - 完整名称：github.com/owner/repo
+ * - owner/repo 格式：owner/repo
+ * - 仅 repo 名称：repo
+ *
+ * @param repoName 仓库完整名称（如 github.com/owner/repo）
+ * @param searchName 搜索名称
+ * @returns 是否匹配
+ */
+function matchRepoName(repoName, searchName) {
+    // 标准化：将反斜杠转换为正斜杠
+    const normalizedRepoName = repoName.replace(/\\/g, "/");
+    const normalizedSearchName = searchName.replace(/\\/g, "/");
+    // 完整名称匹配
+    if (normalizedRepoName === normalizedSearchName) {
+        return true;
+    }
+    // 分割仓库名称为各个部分
+    const repoParts = normalizedRepoName.split("/");
+    const searchParts = normalizedSearchName.split("/");
+    // 如果搜索名称有多个部分，从末尾开始匹配
+    if (searchParts.length > 1) {
+        // 检查是否匹配末尾的 N 个部分
+        if (repoParts.length >= searchParts.length) {
+            const repoSuffix = repoParts.slice(-searchParts.length).join("/");
+            return repoSuffix === normalizedSearchName;
+        }
+        return false;
+    }
+    // 单个名称：只匹配最后一个部分（repo 名称）
+    const repoBaseName = repoParts[repoParts.length - 1];
+    return repoBaseName === normalizedSearchName;
+}
+/**
+ * 根据名称获取仓库信息
+ * @param name 仓库名称（完整路径或简短名称）
+ * @returns 仓库信息，不存在返回 null
+ */
+async function get(name) {
+    const config = await (0, config_js_1.readGlobalConfig)();
+    // 首先尝试完整名称匹配
+    if (config.repos[name]) {
+        const entry = config.repos[name];
+        const meta = await (0, config_js_1.readRepoMeta)(entry.path);
+        if (!meta) {
+            return null;
+        }
+        return {
+            name,
+            url: entry.url,
+            path: entry.path,
+            commitId: meta.commitId,
+            branch: meta.branch,
+            addedAt: meta.addedAt,
+            updatedAt: meta.updatedAt,
+        };
+    }
+    // 尝试简短名称匹配（支持 repo 或 owner/repo 格式）
+    for (const [repoName, entry] of Object.entries(config.repos)) {
+        if (matchRepoName(repoName, name)) {
+            const meta = await (0, config_js_1.readRepoMeta)(entry.path);
+            if (!meta) {
+                continue;
+            }
+            return {
+                name: repoName,
+                url: entry.url,
+                path: entry.path,
+                commitId: meta.commitId,
+                branch: meta.branch,
+                addedAt: meta.addedAt,
+                updatedAt: meta.updatedAt,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * 列出所有仓库
+ * @returns 仓库信息数组
+ */
+async function list() {
+    const config = await (0, config_js_1.readGlobalConfig)();
+    const repos = [];
+    for (const [name, entry] of Object.entries(config.repos)) {
+        const meta = await (0, config_js_1.readRepoMeta)(entry.path);
+        if (meta) {
+            repos.push({
+                name,
+                url: entry.url,
+                path: entry.path,
+                commitId: meta.commitId,
+                branch: meta.branch,
+                addedAt: meta.addedAt,
+                updatedAt: meta.updatedAt,
+            });
+        }
+    }
+    return repos;
+}
+/**
+ * 删除仓库
+ * @param name 仓库名称
+ * @throws GrfError 如果仓库不存在
+ */
+async function remove(name) {
+    const repoInfo = await get(name);
+    if (!repoInfo) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.REPO_NOT_FOUND, `仓库不存在: ${name}`);
+    }
+    // 删除仓库目录
+    await fs.removeDir(repoInfo.path);
+    // 更新全局配置
+    const config = await (0, config_js_1.readGlobalConfig)();
+    delete config.repos[repoInfo.name];
+    await (0, config_js_1.writeGlobalConfig)(config);
+}
+/**
+ * 检查仓库是否存在
+ * @param name 仓库名称
+ * @returns 是否存在
+ */
+async function exists(name) {
+    const config = await (0, config_js_1.readGlobalConfig)();
+    // 首先尝试完整名称匹配
+    if (config.repos[name]) {
+        const entry = config.repos[name];
+        // 检查目录和元信息是否都存在
+        const dirExists = await fs.exists(entry.path);
+        const meta = await (0, config_js_1.readRepoMeta)(entry.path);
+        return dirExists && meta !== null;
+    }
+    // 尝试简短名称匹配（使用统一的匹配函数）
+    for (const [repoName, entry] of Object.entries(config.repos)) {
+        if (matchRepoName(repoName, name)) {
+            const dirExists = await fs.exists(entry.path);
+            const meta = await (0, config_js_1.readRepoMeta)(entry.path);
+            return dirExists && meta !== null;
+        }
+    }
+    return false;
+}
+/**
+ * 将仓库名称解析为本地路径
+ * @param name 仓库名称（完整名称或简短名称）
+ * @returns 本地路径
+ * @throws GrfError 如果仓库不存在
+ */
+async function resolvePath(name) {
+    const repoInfo = await get(name);
+    if (!repoInfo) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.REPO_NOT_FOUND, `仓库不存在: ${name}`);
+    }
+    return repoInfo.path;
+}
+/**
+ * 切换仓库分支
+ * @param name 仓库名称
+ * @param branch 目标分支
+ * @returns 更新后的仓库信息
+ * @throws GrfError 如果仓库不存在或切换失败
+ */
+async function switchBranch(name, branch) {
+    // 获取仓库信息
+    const repoInfo = await get(name);
+    if (!repoInfo) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.REPO_NOT_FOUND, `仓库不存在: ${name}`);
+    }
+    // 调用 git.checkout() 切换分支
+    await git.checkout(repoInfo.path, branch);
+    // 获取新的 commit ID
+    const commitId = await git.getCurrentCommit(repoInfo.path);
+    const currentBranch = await git.getBranch(repoInfo.path);
+    // 更新 meta.json 中的 branch 字段
+    const now = new Date().toISOString();
+    const meta = {
+        url: repoInfo.url,
+        name: repoInfo.name,
+        addedAt: repoInfo.addedAt,
+        updatedAt: now,
+        commitId,
+        branch: currentBranch,
+    };
+    await (0, config_js_1.writeRepoMeta)(repoInfo.path, meta);
+    // 返回更新后的仓库信息
+    return {
+        name: repoInfo.name,
+        url: repoInfo.url,
+        path: repoInfo.path,
+        commitId,
+        branch: currentBranch,
+        addedAt: repoInfo.addedAt,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=repository.js.map

package/dist/core/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/core/repository.ts"],"names":[],"mappings":"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"}

package/dist/core/sync.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 同步模块
+ * 负责工作目录与全局缓存之间的同步操作
+ */
+import type { LoadingEntry } from "../types/index.js";
+/**
+ * 同步状态
+ */
+export interface SyncStatus {
+    /** 条目 ID */
+    entryId: string;
+    /** 仓库名称 */
+    repoName: string;
+    /** 目标路径 */
+    targetPath: string;
+    /** loading.json 中记录的 commitId */
+    loadedCommitId: string;
+    /** 缓存仓库当前的 commitId */
+    cacheCommitId: string;
+    /** 是否需要同步 */
+    needsSync: boolean;
+    /** 缓存仓库是否存在 */
+    cacheExists: boolean;
+    /** 目标目录是否存在 */
+    targetExists: boolean;
+}
+/**
+ * 同步结果
+ */
+export interface SyncResult {
+    /** 条目 ID */
+    entryId: string;
+    /** 仓库名称 */
+    repoName: string;
+    /** 是否成功 */
+    success: boolean;
+    /** 结果消息 */
+    message: string;
+    /** 旧的 commitId */
+    oldCommitId?: string;
+    /** 新的 commitId */
+    newCommitId?: string;
+}
+/**
+ * 获取单个加载条目的同步状态
+ * @param entry 加载条目
+ * @param projectRoot 项目根目录
+ * @returns 同步状态
+ */
+export declare function getSyncStatus(entry: LoadingEntry, projectRoot?: string): Promise<SyncStatus>;
+/**
+ * 获取所有已加载条目的同步状态
+ * @param projectRoot 项目根目录
+ * @returns 同步状态列表
+ */
+export declare function getAllSyncStatus(projectRoot?: string): Promise<SyncStatus[]>;
+/**
+ * 同步单个条目到工作目录
+ * @param entry 加载条目
+ * @param force 是否强制同步（忽略本地修改）
+ * @param projectRoot 项目根目录
+ * @returns 同步结果
+ */
+export declare function syncEntry(entry: LoadingEntry, force?: boolean, projectRoot?: string): Promise<SyncResult>;
+/**
+ * 同步所有需要更新的条目
+ * @param force 是否强制同步
+ * @param projectRoot 项目根目录
+ * @returns 同步结果列表
+ */
+export declare function syncAll(force?: boolean, projectRoot?: string): Promise<SyncResult[]>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/core/sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe;IACf,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAUvB;AAID;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,OAAe,EACtB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,UAAU,CAAC,CA2ErB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,KAAK,GAAE,OAAe,EACtB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAsCvB"}

package/dist/core/sync.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * 同步模块
+ * 负责工作目录与全局缓存之间的同步操作
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSyncStatus = getSyncStatus;
+exports.getAllSyncStatus = getAllSyncStatus;
+exports.syncEntry = syncEntry;
+exports.syncAll = syncAll;
+const path = __importStar(require("path"));
+const loading = __importStar(require("./loading.js"));
+const repository = __importStar(require("./repository.js"));
+const filesystem = __importStar(require("./filesystem.js"));
+const git = __importStar(require("./git.js"));
+// ============ 状态检测 ============
+/**
+ * 获取单个加载条目的同步状态
+ * @param entry 加载条目
+ * @param projectRoot 项目根目录
+ * @returns 同步状态
+ */
+async function getSyncStatus(entry, projectRoot = process.cwd()) {
+    const status = {
+        entryId: entry.id,
+        repoName: entry.repoName,
+        targetPath: entry.targetPath,
+        loadedCommitId: entry.commitId,
+        cacheCommitId: "",
+        needsSync: false,
+        cacheExists: false,
+        targetExists: false,
+    };
+    // 检查目标目录是否存在
+    const targetAbsPath = path.join(projectRoot, entry.targetPath);
+    status.targetExists = await filesystem.exists(targetAbsPath);
+    // 获取缓存仓库信息
+    try {
+        const repoInfo = await repository.get(entry.repoName);
+        if (repoInfo) {
+            status.cacheExists = true;
+            // 获取缓存仓库当前的 commitId
+            status.cacheCommitId = await git.getCurrentCommit(repoInfo.path);
+            // 判断是否需要同步
+            // 需要同步的情况：
+            // 1. 目标目录不存在
+            // 2. commitId 不一致
+            if (!status.targetExists) {
+                status.needsSync = true;
+            }
+            else if (status.loadedCommitId !== status.cacheCommitId) {
+                status.needsSync = true;
+            }
+        }
+        else {
+            status.cacheExists = false;
+            status.needsSync = false; // 缓存不存在，无法同步
+        }
+    }
+    catch {
+        // 获取仓库信息失败，标记缓存不存在
+        status.cacheExists = false;
+        status.needsSync = false;
+    }
+    return status;
+}
+/**
+ * 获取所有已加载条目的同步状态
+ * @param projectRoot 项目根目录
+ * @returns 同步状态列表
+ */
+async function getAllSyncStatus(projectRoot = process.cwd()) {
+    const entries = await loading.getEntries(projectRoot);
+    const statusList = [];
+    for (const entry of entries) {
+        const status = await getSyncStatus(entry, projectRoot);
+        statusList.push(status);
+    }
+    return statusList;
+}
+// ============ 同步操作 ============
+/**
+ * 同步单个条目到工作目录
+ * @param entry 加载条目
+ * @param force 是否强制同步（忽略本地修改）
+ * @param projectRoot 项目根目录
+ * @returns 同步结果
+ */
+async function syncEntry(entry, force = false, projectRoot = process.cwd()) {
+    const result = {
+        entryId: entry.id,
+        repoName: entry.repoName,
+        success: false,
+        message: "",
+        oldCommitId: entry.commitId,
+    };
+    try {
+        // 获取缓存仓库信息
+        const repoInfo = await repository.get(entry.repoName);
+        if (!repoInfo) {
+            result.message = `缓存仓库不存在: ${entry.repoName}`;
+            return result;
+        }
+        // 获取缓存仓库当前的 commitId
+        const cacheCommitId = await git.getCurrentCommit(repoInfo.path);
+        result.newCommitId = cacheCommitId;
+        // 检查是否需要同步
+        const targetAbsPath = path.join(projectRoot, entry.targetPath);
+        const targetExists = await filesystem.exists(targetAbsPath);
+        if (targetExists && entry.commitId === cacheCommitId && !force) {
+            result.success = true;
+            result.message = "已是最新版本，无需同步";
+            return result;
+        }
+        // 确定源路径（考虑 subdir）
+        let sourcePath = repoInfo.path;
+        if (entry.subdir) {
+            sourcePath = path.join(repoInfo.path, entry.subdir);
+            // 检查子目录是否存在
+            if (!(await filesystem.exists(sourcePath))) {
+                result.message = `子目录不存在: ${entry.subdir}`;
+                return result;
+            }
+        }
+        // 删除旧目录（如果存在）
+        if (targetExists) {
+            await filesystem.removeDir(targetAbsPath);
+        }
+        // 确保目标父目录存在
+        const targetParentDir = path.dirname(targetAbsPath);
+        await filesystem.ensureDir(targetParentDir);
+        // 复制新内容（排除 .git 目录）
+        await filesystem.copyDir(sourcePath, targetAbsPath, {
+            exclude: [".git", ".gitreference-meta.json"],
+            overwrite: true,
+        });
+        // 更新 loading.json 中的 commitId 和 updatedAt
+        await loading.updateEntry(entry.id, {
+            commitId: cacheCommitId,
+        }, projectRoot);
+        result.success = true;
+        result.message = `同步成功: ${entry.commitId.substring(0, 7)} → ${cacheCommitId.substring(0, 7)}`;
+        return result;
+    }
+    catch (error) {
+        const err = error;
+        result.message = `同步失败: ${err.message}`;
+        return result;
+    }
+}
+/**
+ * 同步所有需要更新的条目
+ * @param force 是否强制同步
+ * @param projectRoot 项目根目录
+ * @returns 同步结果列表
+ */
+async function syncAll(force = false, projectRoot = process.cwd()) {
+    const entries = await loading.getEntries(projectRoot);
+    const results = [];
+    for (const entry of entries) {
+        // 获取同步状态
+        const status = await getSyncStatus(entry, projectRoot);
+        // 只同步需要同步的条目，或者强制同步所有
+        if (status.needsSync || force) {
+            if (!status.cacheExists) {
+                // 缓存不存在，跳过
+                results.push({
+                    entryId: entry.id,
+                    repoName: entry.repoName,
+                    success: false,
+                    message: `缓存仓库不存在: ${entry.repoName}`,
+                    oldCommitId: entry.commitId,
+                });
+                continue;
+            }
+            const result = await syncEntry(entry, force, projectRoot);
+            results.push(result);
+        }
+        else {
+            // 不需要同步
+            results.push({
+                entryId: entry.id,
+                repoName: entry.repoName,
+                success: true,
+                message: "已是最新版本",
+                oldCommitId: entry.commitId,
+                newCommitId: entry.commitId,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=sync.js.map