grf-cli 1.0.0

package/dist/core/filesystem.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * FileSystem 模块
+ * 封装文件系统操作，提供复制、删除等功能
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyDir = copyDir;
+exports.copyFile = copyFile;
+exports.removeDir = removeDir;
+exports.exists = exists;
+exports.ensureDir = ensureDir;
+exports.updateGitignore = updateGitignore;
+exports.readDir = readDir;
+exports.isDirectory = isDirectory;
+exports.removeFromGitignore = removeFromGitignore;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const index_js_1 = require("../types/index.js");
+/**
+ * 复制目录
+ * @param src 源目录路径
+ * @param dest 目标目录路径
+ * @param options 复制选项
+ */
+async function copyDir(src, dest, options) {
+    try {
+        await fs_extra_1.default.copy(src, dest, {
+            overwrite: options?.overwrite ?? true,
+            filter: (srcPath) => {
+                const basename = path_1.default.basename(srcPath);
+                return !options?.exclude?.includes(basename);
+            },
+        });
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PATH_NOT_FOUND, `源路径不存在: ${src}`, err);
+        }
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝: ${src} -> ${dest}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `复制目录失败: ${src} -> ${dest}`, err);
+    }
+}
+/**
+ * 复制单个文件
+ * @param src 源文件路径
+ * @param dest 目标文件路径
+ */
+async function copyFile(src, dest) {
+    try {
+        // 确保目标目录存在
+        await fs_extra_1.default.ensureDir(path_1.default.dirname(dest));
+        await fs_extra_1.default.copy(src, dest);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PATH_NOT_FOUND, `源文件不存在: ${src}`, err);
+        }
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝: ${src} -> ${dest}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `复制文件失败: ${src} -> ${dest}`, err);
+    }
+}
+/**
+ * 删除目录（递归删除）
+ * @param dirPath 要删除的目录路径
+ */
+async function removeDir(dirPath) {
+    try {
+        await fs_extra_1.default.remove(dirPath);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝，无法删除: ${dirPath}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `删除目录失败: ${dirPath}`, err);
+    }
+}
+/**
+ * 检查路径是否存在
+ * @param filePath 要检查的路径
+ * @returns 路径是否存在
+ */
+async function exists(filePath) {
+    return fs_extra_1.default.pathExists(filePath);
+}
+/**
+ * 确保目录存在（不存在则创建）
+ * @param dirPath 目录路径
+ */
+async function ensureDir(dirPath) {
+    try {
+        await fs_extra_1.default.ensureDir(dirPath);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝，无法创建目录: ${dirPath}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `创建目录失败: ${dirPath}`, err);
+    }
+}
+/**
+ * 更新 .gitignore 文件
+ * 如果指定条目不存在，则追加到文件末尾
+ * 优化：将所有 gitreference 管理的条目放在同一个注释块下
+ * @param dir 目录路径
+ * @param entry 要添加的条目
+ */
+async function updateGitignore(dir, entry) {
+    const GITREFERENCE_COMMENT = "# Added by gitreference";
+    try {
+        const gitignorePath = path_1.default.join(dir, ".gitignore");
+        let content = "";
+        if (await fs_extra_1.default.pathExists(gitignorePath)) {
+            content = await fs_extra_1.default.readFile(gitignorePath, "utf-8");
+        }
+        const lines = content.split("\n");
+        const trimmedEntry = entry.trim();
+        // 检查条目是否已存在（按行检查，避免部分匹配）
+        const trimmedLines = lines.map((line) => line.trim());
+        if (trimmedLines.includes(trimmedEntry)) {
+            return; // 条目已存在，无需添加
+        }
+        // 查找现有的 gitreference 注释块
+        let commentIndex = -1;
+        let lastGitrefEntryIndex = -1;
+        for (let i = 0; i < lines.length; i++) {
+            const trimmedLine = lines[i].trim();
+            if (trimmedLine === GITREFERENCE_COMMENT) {
+                if (commentIndex === -1) {
+                    commentIndex = i;
+                }
+                lastGitrefEntryIndex = i;
+            }
+            else if (commentIndex !== -1 &&
+                trimmedLine !== "" &&
+                !trimmedLine.startsWith("#")) {
+                // 在注释块后找到非空、非注释行，更新最后条目位置
+                lastGitrefEntryIndex = i;
+            }
+            else if (commentIndex !== -1 && trimmedLine === "") {
+                // 遇到空行，检查是否是 gitreference 块的结束
+                // 继续查找，可能有多个 gitreference 块需要合并
+            }
+        }
+        if (commentIndex !== -1) {
+            // 找到现有的 gitreference 块，在最后一个条目后插入新条目
+            // 首先需要找到该块的实际结束位置
+            let insertIndex = lastGitrefEntryIndex + 1;
+            // 在现有块后插入新条目
+            lines.splice(insertIndex, 0, trimmedEntry);
+            // 写回文件
+            await fs_extra_1.default.writeFile(gitignorePath, lines.join("\n"), "utf-8");
+        }
+        else {
+            // 没有找到现有块，追加新块
+            const newEntry = `\n${GITREFERENCE_COMMENT}\n${trimmedEntry}\n`;
+            await fs_extra_1.default.appendFile(gitignorePath, newEntry);
+        }
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝，无法更新 .gitignore: ${dir}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `更新 .gitignore 失败: ${dir}`, err);
+    }
+}
+/**
+ * 读取目录内容
+ * @param dirPath 目录路径
+ * @returns 文件/目录名数组
+ */
+async function readDir(dirPath) {
+    try {
+        return await fs_extra_1.default.readdir(dirPath);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PATH_NOT_FOUND, `目录不存在: ${dirPath}`, err);
+        }
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝，无法读取目录: ${dirPath}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `读取目录失败: ${dirPath}`, err);
+    }
+}
+/**
+ * 检查路径是否为目录
+ * @param filePath 要检查的路径
+ * @returns 是否为目录
+ */
+async function isDirectory(filePath) {
+    try {
+        const stat = await fs_extra_1.default.stat(filePath);
+        return stat.isDirectory();
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PATH_NOT_FOUND, `路径不存在: ${filePath}`, err);
+        }
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝，无法访问: ${filePath}`, err);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_COPY_FAILED, `获取文件信息失败: ${filePath}`, err);
+    }
+}
+/**
+ * 从 .gitignore 文件中移除指定条目
+ * @param dir 目录路径（包含 .gitignore 的目录）
+ * @param entry 要移除的条目
+ * @param options 移除选项
+ * @returns 是否成功移除（条目存在并被移除返回 true）
+ */
+async function removeFromGitignore(dir, entry, options) {
+    const removeComment = options?.removeComment ?? true;
+    const gitignorePath = path_1.default.join(dir, ".gitignore");
+    try {
+        // 检查 .gitignore 文件是否存在
+        if (!(await fs_extra_1.default.pathExists(gitignorePath))) {
+            return false;
+        }
+        // 读取文件内容
+        const content = await fs_extra_1.default.readFile(gitignorePath, "utf-8");
+        const lines = content.split("\n");
+        // 标记要删除的行索引
+        const linesToDelete = new Set();
+        const trimmedEntry = entry.trim();
+        let found = false;
+        // 遍历每一行，查找匹配的条目
+        for (let i = 0; i < lines.length; i++) {
+            const trimmedLine = lines[i].trim();
+            if (trimmedLine === trimmedEntry) {
+                found = true;
+                linesToDelete.add(i);
+                // 如果 removeComment 为 true，检查上一行是否为注释
+                if (removeComment && i > 0) {
+                    const prevLine = lines[i - 1].trim();
+                    if (prevLine === "# Added by gitreference") {
+                        linesToDelete.add(i - 1);
+                    }
+                }
+            }
+        }
+        // 如果没有找到匹配的行，返回 false
+        if (!found) {
+            return false;
+        }
+        // 过滤掉标记为删除的行
+        const filteredLines = lines.filter((_, index) => !linesToDelete.has(index));
+        // 清理多余的空行（连续多个空行合并为一个）
+        const cleanedLines = [];
+        let prevLineEmpty = false;
+        for (const line of filteredLines) {
+            const isEmpty = line.trim() === "";
+            if (isEmpty) {
+                if (!prevLineEmpty) {
+                    cleanedLines.push(line);
+                }
+                prevLineEmpty = true;
+            }
+            else {
+                cleanedLines.push(line);
+                prevLineEmpty = false;
+            }
+        }
+        // 移除开头和结尾的空行
+        while (cleanedLines.length > 0 && cleanedLines[0].trim() === "") {
+            cleanedLines.shift();
+        }
+        while (cleanedLines.length > 0 &&
+            cleanedLines[cleanedLines.length - 1].trim() === "") {
+            cleanedLines.pop();
+        }
+        // 写回文件
+        const newContent = cleanedLines.length > 0 ? cleanedLines.join("\n") + "\n" : "";
+        await fs_extra_1.default.writeFile(gitignorePath, newContent, "utf-8");
+        return true;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "EACCES" || err.code === "EPERM") {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `权限被拒绝，无法更新 .gitignore: ${dir}`, err);
+        }
+        // 其他错误静默处理，返回 false
+        return false;
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/core/filesystem.js.map

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

package/dist/core/git.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Git 模块
+ * 封装所有 Git 命令的执行，提供类型安全的接口
+ */
+/**
+ * Git 克隆选项
+ */
+export interface CloneOptions {
+    /** 指定分支 */
+    branch?: string;
+    /** 浅克隆深度 */
+    depth?: number;
+    /** 是否浅克隆 */
+    shallow?: boolean;
+}
+/**
+ * 克隆 Git 仓库
+ * @param url 仓库 URL
+ * @param dest 目标路径
+ * @param options 克隆选项
+ */
+export declare function clone(url: string, dest: string, options?: CloneOptions): Promise<void>;
+/**
+ * 拉取远程更新
+ * @param repoPath 仓库路径
+ */
+export declare function pull(repoPath: string): Promise<void>;
+/**
+ * 获取当前 commit ID
+ * @param repoPath 仓库路径
+ * @returns 完整的 40 字符 SHA
+ */
+export declare function getCurrentCommit(repoPath: string): Promise<string>;
+/**
+ * 获取远程仓库 URL
+ * @param repoPath 仓库路径
+ * @returns 远程 URL
+ */
+export declare function getRemoteUrl(repoPath: string): Promise<string>;
+/**
+ * 检查是否有远程更新
+ * @param repoPath 仓库路径
+ * @returns 是否有更新
+ */
+export declare function hasUpdates(repoPath: string): Promise<boolean>;
+/**
+ * 获取当前分支名
+ * @param repoPath 仓库路径
+ * @returns 分支名称
+ */
+export declare function getBranch(repoPath: string): Promise<string>;
+/**
+ * 检查路径是否是 Git 仓库
+ * @param path 要检查的路径
+ * @returns 是否是 Git 仓库
+ */
+export declare function isGitRepo(path: string): Promise<boolean>;
+/**
+ * 获取远程更新（不合并）
+ * @param repoPath 仓库路径
+ */
+export declare function fetch(repoPath: string): Promise<void>;
+/**
+ * 切换到指定分支
+ * @param repoPath 仓库路径
+ * @param branch 目标分支名
+ */
+export declare function checkout(repoPath: string, branch: string): Promise<void>;
+/**
+ * 获取所有远程分支列表
+ * @param repoPath 仓库路径
+ * @returns 分支名称数组
+ */
+export declare function listRemoteBranches(repoPath: string): Promise<string[]>;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmCD;;;;;GAKG;AACH,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMxE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BnE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9D;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa5E"}

package/dist/core/git.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Git 模块
+ * 封装所有 Git 命令的执行，提供类型安全的接口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clone = clone;
+exports.pull = pull;
+exports.getCurrentCommit = getCurrentCommit;
+exports.getRemoteUrl = getRemoteUrl;
+exports.hasUpdates = hasUpdates;
+exports.getBranch = getBranch;
+exports.isGitRepo = isGitRepo;
+exports.fetch = fetch;
+exports.checkout = checkout;
+exports.listRemoteBranches = listRemoteBranches;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const index_js_1 = require("../types/index.js");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * 执行 Git 命令的内部函数
+ * @param args Git 命令参数数组
+ * @param options 执行选项
+ * @param errorCode 失败时使用的错误码
+ * @returns 命令输出（已去除首尾空白）
+ */
+async function execGit(args, options, errorCode = index_js_1.ErrorCode.GIT_CLONE_FAILED) {
+    const command = `git ${args.join(" ")}`;
+    try {
+        const { stdout } = await execAsync(command, { cwd: options?.cwd });
+        return stdout.trim();
+    }
+    catch (error) {
+        throw new index_js_1.GrfError(errorCode, `Git command failed: ${command}`, error);
+    }
+}
+/**
+ * 克隆 Git 仓库
+ * @param url 仓库 URL
+ * @param dest 目标路径
+ * @param options 克隆选项
+ */
+async function clone(url, dest, options) {
+    const args = ["clone"];
+    // 处理浅克隆选项
+    if (options?.shallow || options?.depth) {
+        const depth = options.depth ?? 1;
+        args.push("--depth", depth.toString());
+    }
+    // 处理分支选项
+    if (options?.branch) {
+        args.push("--branch", options.branch);
+    }
+    args.push(url, dest);
+    await execGit(args, undefined, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+}
+/**
+ * 拉取远程更新
+ * @param repoPath 仓库路径
+ */
+async function pull(repoPath) {
+    await execGit(["pull"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_PULL_FAILED);
+}
+/**
+ * 获取当前 commit ID
+ * @param repoPath 仓库路径
+ * @returns 完整的 40 字符 SHA
+ */
+async function getCurrentCommit(repoPath) {
+    return execGit(["rev-parse", "HEAD"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+}
+/**
+ * 获取远程仓库 URL
+ * @param repoPath 仓库路径
+ * @returns 远程 URL
+ */
+async function getRemoteUrl(repoPath) {
+    return execGit(["remote", "get-url", "origin"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+}
+/**
+ * 检查是否有远程更新
+ * @param repoPath 仓库路径
+ * @returns 是否有更新
+ */
+async function hasUpdates(repoPath) {
+    // 先获取远程更新
+    await fetch(repoPath);
+    // 获取当前分支
+    const branch = await getBranch(repoPath);
+    // 比较本地和远程的差异
+    try {
+        const count = await execGit(["rev-list", `HEAD..origin/${branch}`, "--count"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+        return parseInt(count, 10) > 0;
+    }
+    catch {
+        // 如果比较失败（例如远程分支不存在），尝试使用 origin/HEAD
+        try {
+            const count = await execGit(["rev-list", "HEAD..origin/HEAD", "--count"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+            return parseInt(count, 10) > 0;
+        }
+        catch {
+            // 如果都失败了，假设没有更新
+            return false;
+        }
+    }
+}
+/**
+ * 获取当前分支名
+ * @param repoPath 仓库路径
+ * @returns 分支名称
+ */
+async function getBranch(repoPath) {
+    return execGit(["rev-parse", "--abbrev-ref", "HEAD"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+}
+/**
+ * 检查路径是否是 Git 仓库
+ * @param path 要检查的路径
+ * @returns 是否是 Git 仓库
+ */
+async function isGitRepo(path) {
+    try {
+        await execGit(["rev-parse", "--git-dir"], { cwd: path }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取远程更新（不合并）
+ * @param repoPath 仓库路径
+ */
+async function fetch(repoPath) {
+    await execGit(["fetch"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+}
+/**
+ * 切换到指定分支
+ * @param repoPath 仓库路径
+ * @param branch 目标分支名
+ */
+async function checkout(repoPath, branch) {
+    try {
+        // 1. 修改 fetch 配置以支持获取所有分支（解决浅克隆问题）
+        await execGit(["config", "remote.origin.fetch", "+refs/heads/*:refs/remotes/origin/*"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CHECKOUT_FAILED);
+        // 2. 获取指定分支
+        await execGit(["fetch", "origin", branch], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CHECKOUT_FAILED);
+        // 3. 切换到指定分支
+        await execGit(["checkout", branch], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CHECKOUT_FAILED);
+    }
+    catch (error) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.GIT_CHECKOUT_FAILED, `Git command failed: git checkout ${branch}\n  Branch "${branch}" may not exist. Use git branch -r to list available branches.`, error);
+    }
+}
+/**
+ * 获取所有远程分支列表
+ * @param repoPath 仓库路径
+ * @returns 分支名称数组
+ */
+async function listRemoteBranches(repoPath) {
+    const output = await execGit(["branch", "-r"], { cwd: repoPath }, index_js_1.ErrorCode.GIT_CLONE_FAILED);
+    // 解析输出，每行一个分支，格式如 "  origin/main" 或 "  origin/HEAD -> origin/main"
+    return output
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line && !line.includes("->")) // 过滤空行和 HEAD 指针
+        .map((line) => line.replace(/^origin\//, "")); // 移除 origin/ 前缀
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

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

package/dist/core/loading.d.ts

@@ -0,0 +1,85 @@
+/**
+ * loading.json 管理模块
+ * 用于追踪已加载的参考代码仓库
+ */
+import type { LoadingEntry, LoadingConfig } from "../types/index.js";
+/**
+ * 获取 loading.json 文件路径
+ * @param projectRoot 项目根目录，默认为当前工作目录
+ * @returns loading.json 的绝对路径
+ */
+export declare function getLoadingFilePath(projectRoot?: string): string;
+/**
+ * 读取 loading.json 配置
+ * @param projectRoot 项目根目录
+ * @returns 加载配置，如果文件不存在则返回空配置
+ */
+export declare function readLoadingConfig(projectRoot?: string): Promise<LoadingConfig>;
+/**
+ * 写入 loading.json 配置
+ * @param config 加载配置
+ * @param projectRoot 项目根目录
+ */
+export declare function writeLoadingConfig(config: LoadingConfig, projectRoot?: string): Promise<void>;
+/**
+ * 添加加载条目
+ * @param entry 加载条目（不含 id 和 loadedAt）
+ * @param projectRoot 项目根目录
+ * @returns 添加的完整条目
+ */
+export declare function addEntry(entry: Omit<LoadingEntry, "id" | "loadedAt">, projectRoot?: string): Promise<LoadingEntry>;
+/**
+ * 获取所有加载条目
+ * @param projectRoot 项目根目录
+ * @returns 加载条目列表
+ */
+export declare function getEntries(projectRoot?: string): Promise<LoadingEntry[]>;
+/**
+ * 根据 ID 获取加载条目
+ * @param id 条目 ID
+ * @param projectRoot 项目根目录
+ * @returns 加载条目，如果不存在则返回 undefined
+ */
+export declare function getEntryById(id: string, projectRoot?: string): Promise<LoadingEntry | undefined>;
+/**
+ * 根据目标路径获取加载条目
+ * @param targetPath 目标路径
+ * @param projectRoot 项目根目录
+ * @returns 加载条目，如果不存在则返回 undefined
+ */
+export declare function getEntryByTargetPath(targetPath: string, projectRoot?: string): Promise<LoadingEntry | undefined>;
+/**
+ * 根据仓库名称获取加载条目
+ * @param repoName 仓库名称
+ * @param projectRoot 项目根目录
+ * @returns 匹配的加载条目列表
+ */
+export declare function getEntriesByRepoName(repoName: string, projectRoot?: string): Promise<LoadingEntry[]>;
+/**
+ * 删除加载条目
+ * @param id 条目 ID
+ * @param projectRoot 项目根目录
+ * @returns 是否成功删除
+ */
+export declare function removeEntry(id: string, projectRoot?: string): Promise<boolean>;
+/**
+ * 根据目标路径删除加载条目
+ * @param targetPath 目标路径
+ * @param projectRoot 项目根目录
+ * @returns 被删除的条目，如果不存在则返回 undefined
+ */
+export declare function removeEntryByTargetPath(targetPath: string, projectRoot?: string): Promise<LoadingEntry | undefined>;
+/**
+ * 清空所有加载条目
+ * @param projectRoot 项目根目录
+ */
+export declare function clearAllEntries(projectRoot?: string): Promise<void>;
+/**
+ * 更新加载条目
+ * @param id 条目 ID
+ * @param updates 要更新的字段
+ * @param projectRoot 项目根目录
+ * @returns 更新后的条目，如果不存在则返回 undefined
+ */
+export declare function updateEntry(id: string, updates: Partial<Omit<LoadingEntry, "id" | "loadedAt">>, projectRoot?: string): Promise<LoadingEntry | undefined>;
+//# sourceMappingURL=loading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../src/core/loading.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWrE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,GAAE,MAAsB,GAClC,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,aAAa,CAAC,CAaxB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,UAAU,CAAC,EAC5C,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,MAAM,EACV,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAGnC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAOnC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,MAAM,EACV,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAenC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,UAAU,CAAC,CAAC,EACvD,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAiBnC"}