grf-cli 1.0.0 → 1.0.3

package/dist/core/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/core/config-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAe;AACf,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAeX;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,KAAK,CAAkB;IAE/B;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAK7C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IA6BvB;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAclC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAW7B;;;OAGG;IACH,UAAU,IAAI,IAAI;CAGnB;AAMD,cAAc;AACd,eAAO,MAAM,aAAa,uBAGzB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,uBAG/B,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,kBAAkB,wBAG9B,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,kBAAkB,uBAG9B,CAAC;AAMF,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAezD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/core/config-manager.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * grf 单配置文件管理器
+ * 实现"一个参数一个配置文件"的设计
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shallowDepthConfig = exports.shallowCloneConfig = exports.defaultBranchConfig = exports.versionConfig = exports.ConfigManager = exports.CONFIG_DEFAULTS = void 0;
+exports.getAllConfigs = getAllConfigs;
+exports.setAllConfigs = setAllConfigs;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const paths_1 = require("./paths");
+// ============================================================================
+// 配置默认值常量
+// ============================================================================
+/** 各配置项的默认值 */
+exports.CONFIG_DEFAULTS = {
+    VERSION: "1.0.0",
+    DEFAULT_BRANCH: "main",
+    SHALLOW_CLONE: true,
+    SHALLOW_DEPTH: 1,
+};
+// ============================================================================
+// 泛型配置管理类
+// ============================================================================
+/**
+ * 通用的单配置文件管理器
+ * @template T 配置值的类型
+ */
+class ConfigManager {
+    /**
+     * 创建配置管理器实例
+     * @param filePath 配置文件的绝对路径
+     * @param defaultValue 配置的默认值
+     */
+    constructor(filePath, defaultValue) {
+        this.cache = null;
+        this.filePath = filePath;
+        this.defaultValue = defaultValue;
+    }
+    /**
+     * 读取配置值
+     * 如果配置文件不存在，返回默认值
+     * @returns 配置值
+     */
+    async get() {
+        // 如果有缓存，直接返回
+        if (this.cache !== null) {
+            return this.cache;
+        }
+        try {
+            // 检查文件是否存在
+            const fileExists = await fs_extra_1.default.pathExists(this.filePath);
+            if (!fileExists) {
+                return this.defaultValue;
+            }
+            // 读取并解析配置文件
+            const content = (await fs_extra_1.default.readJson(this.filePath));
+            const value = content.value;
+            // 更新缓存
+            this.cache = value;
+            return value;
+        }
+        catch {
+            // 文件读取或解析失败，返回默认值
+            return this.defaultValue;
+        }
+    }
+    /**
+     * 写入配置值
+     * @param value 要写入的配置值
+     */
+    async set(value) {
+        // 确保目录存在
+        await (0, paths_1.ensureGrfDirs)();
+        // 构建配置文件内容
+        const content = { value };
+        // 写入文件
+        await fs_extra_1.default.writeJson(this.filePath, content, { spaces: 2 });
+        // 更新缓存
+        this.cache = value;
+    }
+    /**
+     * 重置为默认值
+     */
+    async reset() {
+        await this.set(this.defaultValue);
+    }
+    /**
+     * 检查配置文件是否存在
+     * @returns 文件是否存在
+     */
+    async exists() {
+        return fs_extra_1.default.pathExists(this.filePath);
+    }
+    /**
+     * 删除配置文件
+     */
+    async delete() {
+        // 清除缓存
+        this.cache = null;
+        // 检查文件是否存在
+        const fileExists = await fs_extra_1.default.pathExists(this.filePath);
+        if (fileExists) {
+            await fs_extra_1.default.remove(this.filePath);
+        }
+    }
+    /**
+     * 清除缓存
+     * 下次调用 get() 时会重新从文件读取
+     */
+    clearCache() {
+        this.cache = null;
+    }
+}
+exports.ConfigManager = ConfigManager;
+// ============================================================================
+// 预定义的配置管理器实例
+// ============================================================================
+/** 版本配置管理器 */
+exports.versionConfig = new ConfigManager((0, paths_1.getConfigFilePath)(paths_1.CONFIG_FILES.VERSION), exports.CONFIG_DEFAULTS.VERSION);
+/** 默认分支配置管理器 */
+exports.defaultBranchConfig = new ConfigManager((0, paths_1.getConfigFilePath)(paths_1.CONFIG_FILES.DEFAULT_BRANCH), exports.CONFIG_DEFAULTS.DEFAULT_BRANCH);
+/** 浅克隆开关配置管理器 */
+exports.shallowCloneConfig = new ConfigManager((0, paths_1.getConfigFilePath)(paths_1.CONFIG_FILES.SHALLOW_CLONE), exports.CONFIG_DEFAULTS.SHALLOW_CLONE);
+/** 浅克隆深度配置管理器 */
+exports.shallowDepthConfig = new ConfigManager((0, paths_1.getConfigFilePath)(paths_1.CONFIG_FILES.SHALLOW_DEPTH), exports.CONFIG_DEFAULTS.SHALLOW_DEPTH);
+/**
+ * 获取所有配置的聚合对象
+ * 用于兼容旧接口或需要一次性获取所有配置的场景
+ * @returns 包含所有配置值的对象
+ */
+async function getAllConfigs() {
+    const [version, defaultBranch, shallowClone, shallowDepth] = await Promise.all([
+        exports.versionConfig.get(),
+        exports.defaultBranchConfig.get(),
+        exports.shallowCloneConfig.get(),
+        exports.shallowDepthConfig.get(),
+    ]);
+    return {
+        version,
+        defaultBranch,
+        shallowClone,
+        shallowDepth,
+    };
+}
+/**
+ * 批量设置配置
+ * 只设置提供的配置项，未提供的保持不变
+ * @param configs 要设置的配置项（部分或全部）
+ */
+async function setAllConfigs(configs) {
+    const promises = [];
+    if (configs.version !== undefined) {
+        promises.push(exports.versionConfig.set(configs.version));
+    }
+    if (configs.defaultBranch !== undefined) {
+        promises.push(exports.defaultBranchConfig.set(configs.defaultBranch));
+    }
+    if (configs.shallowClone !== undefined) {
+        promises.push(exports.shallowCloneConfig.set(configs.shallowClone));
+    }
+    if (configs.shallowDepth !== undefined) {
+        promises.push(exports.shallowDepthConfig.set(configs.shallowDepth));
+    }
+    await Promise.all(promises);
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/core/config-manager.js.map

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

package/dist/core/config.d.ts

@@ -1,6 +1,13 @@
 /**
- * grf 配置模块
- * 负责管理全局配置和仓库元信息的读写
+ * grf 配置模块 - 兼容层
+ *
+ * 此模块是一个兼容层，保持原有 API 不变，内部使用新的模块化架构：
+ * - paths.ts: 路径管理
+ * - config-manager.ts: 单配置文件管理
+ * - repos-index.ts: 仓库索引管理
+ * - migration.ts: 配置迁移工具
+ *
+ * 现有代码无需修改即可正常工作。
  */
 import { GlobalConfig, RepoMeta } from "../types/index.js";
 /**
@@ -16,6 +23,7 @@ export declare function getReposRoot(): string;
 /**
  * 获取配置文件路径
  * @returns 配置文件的绝对路径 (~/.gitreference/config.json)
+ * @deprecated 新架构使用多个配置文件，此函数仅用于兼容
  */
 export declare function getConfigPath(): string;
 /**
@@ -31,12 +39,24 @@ export declare function ensureConfigDir(): Promise<void>;
 /**
  * 读取全局配置
  * 如果配置文件不存在，返回默认配置
+ *
+ * 内部实现：
+ * 1. 调用 ensureMigrated() 确保旧配置已迁移
+ * 2. 使用 getAllConfigs() 获取配置参数
+ * 3. 使用 reposIndex.getAll() 获取仓库列表
+ * 4. 组装成 GlobalConfig 对象返回
+ *
  * @returns 全局配置对象
  */
 export declare function readGlobalConfig(): Promise<GlobalConfig>;
 /**
  * 写入全局配置
  * 自动创建配置目录（如果不存在）
+ *
+ * 内部实现：
+ * 1. 使用 setAllConfigs() 保存配置参数
+ * 2. 使用 reposIndex.setAll() 保存仓库列表
+ *
  * @param config 要写入的配置对象
  */
 export declare function writeGlobalConfig(config: GlobalConfig): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAuB,MAAM,mBAAmB,CAAC;AAahF;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAQ/C;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAoC9D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB3E;AAWD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8B7E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAaf"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAuB,MAAM,mBAAmB,CAAC;AA6BhF;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAQ/C;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAerD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CA4B9D;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B3E;AAeD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8B7E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/core/config.js

@@ -1,7 +1,14 @@
 "use strict";
 /**
- * grf 配置模块
- * 负责管理全局配置和仓库元信息的读写
+ * grf 配置模块 - 兼容层
+ *
+ * 此模块是一个兼容层，保持原有 API 不变，内部使用新的模块化架构：
+ * - paths.ts: 路径管理
+ * - config-manager.ts: 单配置文件管理
+ * - repos-index.ts: 仓库索引管理
+ * - migration.ts: 配置迁移工具
+ *
+ * 现有代码无需修改即可正常工作。
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -17,25 +24,29 @@ exports.writeGlobalConfig = writeGlobalConfig;
 exports.readRepoMeta = readRepoMeta;
 exports.writeRepoMeta = writeRepoMeta;
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../types/index.js");
-/** grf 根目录名称 */
-const GRF_DIR_NAME = ".gitreference";
-/** 全局配置文件名 */
-const CONFIG_FILE_NAME = "config.json";
+// 导入新的模块化组件
+const paths_js_1 = require("./paths.js");
+const config_manager_js_1 = require("./config-manager.js");
+const repos_index_js_1 = require("./repos-index.js");
+const migration_js_1 = require("./migration.js");
+// ============================================================================
+// 常量定义（保持向后兼容）
+// ============================================================================
 /** 仓库存储目录名 */
 const REPOS_DIR_NAME = "repos";
 /** 仓库元信息文件名 */
 const REPO_META_FILE_NAME = ".gitreference-meta.json";
-/** 当前配置版本 */
-const CONFIG_VERSION = "1.0.0";
+// ============================================================================
+// 路径相关函数（保持向后兼容）
+// ============================================================================
 /**
  * 获取 grf 根目录路径
  * @returns grf 根目录的绝对路径 (~/.gitreference/)
  */
 function getGrfRoot() {
-    return path_1.default.join(os_1.default.homedir(), GRF_DIR_NAME);
+    return (0, paths_js_1.getGrfRoot)();
 }
 /**
  * 获取仓库存储根目录
@@ -47,9 +58,10 @@ function getReposRoot() {
 /**
  * 获取配置文件路径
  * @returns 配置文件的绝对路径 (~/.gitreference/config.json)
+ * @deprecated 新架构使用多个配置文件，此函数仅用于兼容
  */
 function getConfigPath() {
-    return path_1.default.join(getGrfRoot(), CONFIG_FILE_NAME);
+    return (0, paths_js_1.getLegacyConfigPath)();
 }
 /**
  * 获取默认配置
@@ -57,10 +69,10 @@ function getConfigPath() {
  */
 function getDefaultConfig() {
     return {
-        version: CONFIG_VERSION,
-        defaultBranch: "main",
-        shallowClone: true,
-        shallowDepth: 1,
+        version: config_manager_js_1.CONFIG_DEFAULTS.VERSION,
+        defaultBranch: config_manager_js_1.CONFIG_DEFAULTS.DEFAULT_BRANCH,
+        shallowClone: config_manager_js_1.CONFIG_DEFAULTS.SHALLOW_CLONE,
+        shallowDepth: config_manager_js_1.CONFIG_DEFAULTS.SHALLOW_DEPTH,
         repos: {},
     };
 }
@@ -70,41 +82,50 @@ function getDefaultConfig() {
  */
 async function ensureConfigDir() {
     try {
-        const grfRoot = getGrfRoot();
+        // 使用新的目录确保函数
+        await (0, paths_js_1.ensureGrfDirs)();
+        // 同时确保 repos 目录存在
         const reposRoot = getReposRoot();
-        await fs_extra_1.default.ensureDir(grfRoot);
         await fs_extra_1.default.ensureDir(reposRoot);
     }
     catch (error) {
         throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `无法创建配置目录: ${error.message}`, error);
     }
 }
+// ============================================================================
+// 全局配置读写函数（使用新模块化架构）
+// ============================================================================
 /**
  * 读取全局配置
  * 如果配置文件不存在，返回默认配置
+ *
+ * 内部实现：
+ * 1. 调用 ensureMigrated() 确保旧配置已迁移
+ * 2. 使用 getAllConfigs() 获取配置参数
+ * 3. 使用 reposIndex.getAll() 获取仓库列表
+ * 4. 组装成 GlobalConfig 对象返回
+ *
  * @returns 全局配置对象
  */
 async function readGlobalConfig() {
-    const configPath = getConfigPath();
     try {
-        const exists = await fs_extra_1.default.pathExists(configPath);
-        if (!exists) {
-            return getDefaultConfig();
-        }
-        const content = await fs_extra_1.default.readFile(configPath, "utf-8");
-        const config = JSON.parse(content);
-        // 确保配置对象包含所有必要字段
+        // 确保配置已迁移（静默执行，不影响用户体验）
+        await (0, migration_js_1.ensureMigrated)();
+        // 使用新模块获取配置
+        const configs = await (0, config_manager_js_1.getAllConfigs)();
+        const repos = await repos_index_js_1.reposIndex.getAll();
+        // 组装成 GlobalConfig 对象
         return {
-            ...getDefaultConfig(),
-            ...config,
+            version: configs.version,
+            defaultBranch: configs.defaultBranch,
+            shallowClone: configs.shallowClone,
+            shallowDepth: configs.shallowDepth,
+            repos,
         };
     }
     catch (error) {
-        if (error.code === "ENOENT") {
-            return getDefaultConfig();
-        }
-        if (error instanceof SyntaxError) {
-            throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_PARSE_ERROR, `配置文件解析失败: ${error.message}`, error);
+        if (error instanceof index_js_1.GrfError) {
+            throw error;
         }
         throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_NOT_FOUND, `读取配置文件失败: ${error.message}`, error);
     }
@@ -112,14 +133,26 @@ async function readGlobalConfig() {
 /**
  * 写入全局配置
  * 自动创建配置目录（如果不存在）
+ *
+ * 内部实现：
+ * 1. 使用 setAllConfigs() 保存配置参数
+ * 2. 使用 reposIndex.setAll() 保存仓库列表
+ *
  * @param config 要写入的配置对象
  */
 async function writeGlobalConfig(config) {
     try {
+        // 确保目录存在
         await ensureConfigDir();
-        const configPath = getConfigPath();
-        const content = JSON.stringify(config, null, 2);
-        await fs_extra_1.default.writeFile(configPath, content, "utf-8");
+        // 使用新模块保存配置参数
+        await (0, config_manager_js_1.setAllConfigs)({
+            version: config.version,
+            defaultBranch: config.defaultBranch,
+            shallowClone: config.shallowClone,
+            shallowDepth: config.shallowDepth,
+        });
+        // 使用新模块保存仓库列表
+        await repos_index_js_1.reposIndex.setAll(config.repos);
     }
     catch (error) {
         if (error instanceof index_js_1.GrfError) {
@@ -128,6 +161,9 @@ async function writeGlobalConfig(config) {
         throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_WRITE_ERROR, `写入配置文件失败: ${error.message}`, error);
     }
 }
+// ============================================================================
+// 仓库元信息相关函数（保持原有实现）
+// ============================================================================
 /**
  * 获取仓库元信息文件路径
  * @param repoPath 仓库目录路径

package/dist/core/config.js.map

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

package/dist/core/loading-state.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 加载状态管理模块
+ * 管理仓库的加载状态，存储到独立的 loading.json 文件中
+ */
+/**
+ * 单个仓库的加载状态
+ */
+export interface RepoLoadingState {
+    /** 加载到的目标路径 */
+    targetPath: string;
+    /** 加载时间 (ISO 8601) */
+    loadedAt: string;
+    /** 加载的分支 */
+    branch?: string;
+}
+/**
+ * 加载状态文件结构
+ */
+export interface LoadingStateIndex {
+    loadedRepos: Record<string, RepoLoadingState>;
+}
+/**
+ * 加载状态管理器
+ * 提供对仓库加载状态的 CRUD 操作
+ */
+export declare class LoadingStateManager {
+    private cache;
+    /**
+     * 读取加载状态文件
+     * @returns 加载状态索引
+     */
+    private read;
+    /**
+     * 写入加载状态文件
+     * @param data 加载状态索引
+     */
+    private write;
+    /**
+     * 获取所有加载状态
+     * @returns 所有仓库的加载状态记录
+     */
+    getAll(): Promise<Record<string, RepoLoadingState>>;
+    /**
+     * 获取单个仓库的加载状态
+     * @param repoName 仓库名称
+     * @returns 仓库的加载状态，如果不存在则返回 undefined
+     */
+    get(repoName: string): Promise<RepoLoadingState | undefined>;
+    /**
+     * 设置仓库的加载状态
+     * @param repoName 仓库名称
+     * @param state 加载状态
+     */
+    set(repoName: string, state: RepoLoadingState): Promise<void>;
+    /**
+     * 移除仓库的加载状态
+     * @param repoName 仓库名称
+     * @returns 是否成功移除（如果仓库不存在则返回 false）
+     */
+    remove(repoName: string): Promise<boolean>;
+    /**
+     * 检查仓库是否已加载
+     * @param repoName 仓库名称
+     * @returns 是否已加载
+     */
+    isLoaded(repoName: string): Promise<boolean>;
+    /**
+     * 获取已加载的仓库数量
+     * @returns 已加载的仓库数量
+     */
+    count(): Promise<number>;
+    /**
+     * 获取所有已加载的仓库名称
+     * @returns 已加载的仓库名称列表
+     */
+    names(): Promise<string[]>;
+    /**
+     * 清空所有加载状态
+     */
+    clear(): Promise<void>;
+    /**
+     * 批量设置加载状态（用于迁移）
+     * @param states 加载状态记录
+     */
+    setAll(states: Record<string, RepoLoadingState>): Promise<void>;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+}
+/**
+ * 加载状态管理器单例实例
+ */
+export declare const loadingState: LoadingStateManager;
+/**
+ * 获取所有加载状态
+ * @returns 所有仓库的加载状态记录
+ */
+export declare function getAllLoadingStates(): Promise<Record<string, RepoLoadingState>>;
+/**
+ * 获取单个仓库的加载状态
+ * @param repoName 仓库名称
+ * @returns 仓库的加载状态，如果不存在则返回 undefined
+ */
+export declare function getLoadingState(repoName: string): Promise<RepoLoadingState | undefined>;
+/**
+ * 标记仓库为已加载
+ * @param repoName 仓库名称
+ * @param targetPath 加载到的目标路径
+ * @param branch 加载的分支（可选）
+ */
+export declare function markAsLoaded(repoName: string, targetPath: string, branch?: string): Promise<void>;
+/**
+ * 标记仓库为已卸载
+ * @param repoName 仓库名称
+ * @returns 是否成功移除（如果仓库不存在则返回 false）
+ */
+export declare function markAsUnloaded(repoName: string): Promise<boolean>;
+/**
+ * 检查仓库是否已加载
+ * @param repoName 仓库名称
+ * @returns 是否已加载
+ */
+export declare function isRepoLoaded(repoName: string): Promise<boolean>;
+//# sourceMappingURL=loading-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loading-state.d.ts","sourceRoot":"","sources":["../../src/core/loading-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC/C;AAMD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAkC;IAE/C;;;OAGG;YACW,IAAI;IA2BlB;;;OAGG;YACW,KAAK;IAOnB;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAKzD;;;;OAIG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAKlE;;;;OAIG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhD;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAMD;;GAEG;AACH,eAAO,MAAM,YAAY,qBAA4B,CAAC;AAMtD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAClD,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CACjC,CAEA;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAEvC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE"}