@zooique/memora 0.3.0 → 2.0.0

package/dist/memory/projectManager.js

@@ -1,88 +1,34 @@
 /**
- * 项目管理器 — 多项目并发
+ * 项目管理器 — 多项目生命周期编排（瘦身后）
  *
- * 核心职责：
- *   - 管理项目注册表（~/.memora/projects.json）
- *   - 锁文件机制（.memora/.lock）防止同项目并发写入导致数据损坏
+ * 核心职责（聚焦编排）：
+ *   - 项目初始化编排（关闭旧项目 → 加锁 → 加载资源 → 构建上下文）
  *   - Agent 级资源管理（memora.db 全局共享，不随项目切换重建）
  *   - 两层记忆加载：项目级（projectPath/.memora/）→ Agent 级（configDir）
  *   - 项目切换（只更新 projectPath + security + 重新加载项目 rules/skills）
  *
+ * 已拆分至专职模块（1.0 接口稳定化）：
+ *   - ProjectRegistry（src/memory/projectRegistry.ts）：注册表读写 + 条目管理
+ *   - LockManager（src/memory/lockManager.ts）：锁文件获取/释放 + 残留锁检测
+ *
  * 设计原则（单 Agent 模型）：
  *   - memora.db 只有一个（Agent 级），所有项目共享同一记忆数据库
  *   - 项目切换不重建数据库，只更新安全守卫 + 重新扫描项目规则
  *   - 项目级 .memora/ 仅存放 rules/ 和 skills/（无 memora.db）
  *
- * 锁文件策略：
- *   - 打开项目时创建 .lock 文件（含 PID + 时间戳 + 主机名）
- *   - 关闭/切换项目时删除 .lock 文件
- *   - 检测到残留锁时：判断进程是否存活 → 存活则警告 / 已死则清理
- *   - 不强制阻止并发（CLI-first，用户决定）
- *
  * 详见 ADR-008 · 目录结构按"职责分层"
  */
 import { resolve, join } from 'node:path';
-import { hostname } from 'node:os';
-import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
-import { mkdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import { mkdir } from 'node:fs/promises';
 import { FileStore } from '../memory/store.js';
 import { InMemoryStorage } from '../memory/inMemoryStorage.js';
 import { MemoryLoader } from '../memory/loader.js';
 import { logger } from '../logging/logger.js';
-import { toError } from '../utils/toError.js';
 import { expandHome } from '../utils/path.js';
 import { SOURCE_LABELS } from '../memory/types.js';
-import { nowIso } from '../utils/time.js';
-// ─── QC-24 类型守卫 ─────────────────────────────────────
-// 对不可信磁盘文件 JSON.parse 结果进行运行时校验，替代 `as` 类型断言
-/**
- * 判断值是否为非数组对象（排除 null）
- *
- * @param value 待校验的值
- * @returns true 表示是普通对象
- */
-function isPlainObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-/**
- * 判断值是否为 LockInfo（锁文件结构）
- *
- * @param value 待校验的值
- * @returns true 表示符合 LockInfo 结构
- */
-function isLockInfo(value) {
-    if (!isPlainObject(value))
-        return false;
-    return (typeof value['pid'] === 'number' &&
-        typeof value['acquiredAt'] === 'string' &&
-        typeof value['hostname'] === 'string');
-}
-/**
- * 判断值是否为 ProjectEntry（项目注册表条目）
- *
- * @param value 待校验的值
- * @returns true 表示符合 ProjectEntry 结构
- */
-function isProjectEntry(value) {
-    if (!isPlainObject(value))
-        return false;
-    return (typeof value['path'] === 'string' &&
-        typeof value['name'] === 'string' &&
-        typeof value['lastOpened'] === 'string');
-}
-/**
- * 判断值是否为 ProjectEntry 数组
- *
- * 过滤掉不符合结构的条目，仅保留合法条目
- *
- * @param value 待校验的值
- * @returns 解析后的合法条目数组（损坏时返回空数组）
- */
-function asProjectEntryArray(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.filter(isProjectEntry);
-}
+import { ProjectRegistry } from '../memory/projectRegistry.js';
+import { LockManager } from '../memory/lockManager.js';
+// ─── 类 ──────────────────────────────────────────────────
 /**
  * 项目管理器
  *
@@ -90,33 +36,38 @@ function asProjectEntryArray(value) {
  * 1. 初始化当前项目（加锁 + 加载两层配置）
  * 2. /project <name> 切换到新项目（解锁旧项目 + 加锁新项目）
  * 3. 退出时清理锁文件
+ *
+ * 注册表/锁文件实现委托给 ProjectRegistry / LockManager，
+ * 本类聚焦生命周期编排。
  */
 export class ProjectManager {
-    /** 项目注册表路径 */
-    registryPath;
     /** Agent 级数据目录（memora.db 所在目录） */
     agentDataDir;
     /** Agent 级存储实例（全局共享，不随项目切换重建） */
     agentIndex = null;
     /** 当前打开的项目路径 */
     currentProjectPath = null;
-    /** 当前持有的锁文件路径 */
-    currentLockPath = null;
     /** 外部注入的存储实例（可选，不传则内部创建 InMemoryStorage 兜底） */
     externalStorage;
     /** SecurityGuard 工厂函数（由 Agent 层注入） */
     createSecurityGuard;
+    /** 项目注册表（专职管理 projects.json） */
+    registry;
+    /** 锁文件管理器（专职管理 .memora/.lock） */
+    lockManager;
     constructor(options) {
         const { dataDir, storage, registryDir, createSecurityGuard } = options;
         const memoraHome = resolve(expandHome(dataDir));
         this.agentDataDir = memoraHome;
         // 注册表目录：优先使用宿主指定的用户级路径，避免每项目重复存储
         const registryHome = registryDir ? resolve(expandHome(registryDir)) : memoraHome;
-        this.registryPath = join(registryHome, 'projects.json');
         // 保存外部注入的存储实例（宿主项目注入时使用）
         this.externalStorage = storage ?? null;
         // 保存 SecurityGuard 工厂函数
         this.createSecurityGuard = createSecurityGuard;
+        // 委托注册表/锁文件管理给专职模块
+        this.registry = new ProjectRegistry(join(registryHome, 'projects.json'));
+        this.lockManager = new LockManager();
     }
     /**
      * 确保 Agent 级资源已初始化（存储实例）
@@ -164,11 +115,10 @@ export class ProjectManager {
         if (this.currentProjectPath) {
             await this.closeProject();
         }
-        // 2) 解析 memoraDir + 获取项目级锁
+        // 2) 解析 memoraDir + 获取项目级锁（委托给 LockManager）
         const memoraDir = this.resolveMemoraDir(projectPath);
-        await this.acquireLock(memoraDir);
+        await this.lockManager.acquire(memoraDir);
         this.currentProjectPath = projectPath;
-        this.currentLockPath = join(memoraDir, '.lock');
         // 后续步骤失败时释放锁并重置状态，避免锁文件残留导致下次启动检测失败
         try {
             // 3) 确保项目目录 + 加载两层资源
@@ -179,11 +129,10 @@ export class ProjectManager {
         }
         catch (err) {
             // 后续步骤失败时释放锁并重置状态，避免锁文件残留导致下次启动检测失败
-            await this.releaseLock().catch((releaseErr) => {
+            await this.lockManager.release().catch((releaseErr) => {
                 logger.warn({ err: releaseErr }, '释放项目锁失败');
             });
             this.currentProjectPath = null;
-            this.currentLockPath = null;
             throw err;
         }
     }
@@ -242,9 +191,9 @@ export class ProjectManager {
         const security = this.createSecurityGuard
             ? this.createSecurityGuard(projectPath, memoraDir, configDir, this.agentDataDir)
             : null;
-        // 注册到项目表
-        const name = projectName || this.inferProjectName(projectPath);
-        this.registerProject(projectPath, name);
+        // 注册到项目表（委托给 ProjectRegistry）
+        const name = projectName || ProjectRegistry.inferProjectName(projectPath);
+        this.registry.register(projectPath, name);
         logger.info({
             projectPath,
             projectName: name,
@@ -270,9 +219,8 @@ export class ProjectManager {
      */
     async closeProject() {
         // Agent 级 index/sessionStore 不关闭——它们是共享的，在整个 Agent 生命周期内持久存在
-        await this.releaseLock();
+        await this.lockManager.release();
         this.currentProjectPath = null;
-        this.currentLockPath = null;
     }
     /**
      * 完全关闭：释放项目锁 + 关闭 Agent 级数据库
@@ -294,45 +242,41 @@ export class ProjectManager {
     }
     /**
      * 列出已注册的项目（IX-02：统一为 getter 风格，与 persona/skill 一致）
+     *
+     * 委托给 ProjectRegistry。
      */
     get list() {
-        return this.readRegistry();
+        return this.registry.list;
     }
     /**
      * 列出已注册的项目
-     * @deprecated 请使用 `projectManager.list` getter 代替
+     *
+     * v1.0 公共 API（CHANGELOG 迁移路径：`agent.listProjects()` → `agent.projects.listProjects()`）。
+     * 与 `.list` getter 等价，保留方法形式以兼容 0.3 迁移路径。
      */
     listProjects() {
-        return this.readRegistry();
+        return this.registry.list;
     }
     /**
      * 注册项目到注册表
+     *
+     * 委托给 ProjectRegistry。
+     *
+     * @param projectPath 项目根目录
+     * @param name 项目名称
      */
     registerProject(projectPath, name) {
-        const registry = this.readRegistry();
-        // Windows 文件系统不区分大小写，路径大小写不同视为同一项目
-        const existing = registry.findIndex((e) => e.path.toLowerCase() === projectPath.toLowerCase());
-        const entry = {
-            path: projectPath,
-            name,
-            lastOpened: nowIso(),
-        };
-        if (existing >= 0) {
-            registry[existing] = entry;
-        }
-        else {
-            registry.push(entry);
-        }
-        this.writeRegistry(registry);
+        this.registry.register(projectPath, name);
     }
     /**
      * 从注册表移除项目
+     *
+     * 委托给 ProjectRegistry。
+     *
+     * @param projectPath 项目根目录
      */
     unregisterProject(projectPath) {
-        const registry = this.readRegistry();
-        // Windows 文件系统不区分大小写，大小写不同视为同一项目
-        const filtered = registry.filter((e) => e.path.toLowerCase() !== projectPath.toLowerCase());
-        this.writeRegistry(filtered);
+        this.registry.unregister(projectPath);
     }
     /**
      * 获取当前项目路径
@@ -340,86 +284,6 @@ export class ProjectManager {
     get currentProject() {
         return this.currentProjectPath;
     }
-    /**
-     * 获取锁文件
-     * 如果锁文件存在且进程存活，发出警告但不阻止
-     * 如果锁文件存在但进程已死，清理残留锁
-     */
-    async acquireLock(memoraDir) {
-        const lockPath = join(memoraDir, '.lock');
-        try {
-            // 尝试读取锁文件（存在时）
-            const raw = await readFile(lockPath, 'utf-8');
-            // QC-24 使用类型守卫校验 JSON.parse 结果，替代 `as LockInfo` 类型断言
-            const parsed = JSON.parse(raw);
-            if (!isLockInfo(parsed)) {
-                // 锁文件结构损坏，清理后重新获取
-                logger.warn({ path: lockPath }, '锁文件结构损坏，清理残留');
-                await this.safeUnlink(lockPath);
-                return;
-            }
-            const info = parsed;
-            // 检查进程是否存活
-            if (this.isProcessAlive(info.pid)) {
-                logger.warn({ pid: info.pid, acquiredAt: info.acquiredAt, hostname: info.hostname }, '项目已被其他进程打开（锁文件存在），继续操作可能导致数据冲突');
-            }
-            else {
-                // 残留锁，清理
-                logger.info({ pid: info.pid }, '清理残留锁文件（进程已退出）');
-                await this.safeUnlink(lockPath);
-            }
-        }
-        catch (err) {
-            // 锁文件不存在或损坏，清理：记录 debug 日志便于排查（不存在属正常首次启动）
-            logger.debug({ path: lockPath, err: toError(err).message }, '锁文件读取失败，清理残留');
-            await this.safeUnlink(lockPath);
-        }
-        // 写入新锁
-        const lockInfo = {
-            pid: process.pid,
-            acquiredAt: nowIso(),
-            hostname: hostname(),
-        };
-        await mkdir(memoraDir, { recursive: true });
-        await writeFile(lockPath, JSON.stringify(lockInfo, null, 2), 'utf-8');
-    }
-    /**
-     * 释放锁文件
-     */
-    async releaseLock() {
-        if (this.currentLockPath) {
-            await this.safeUnlink(this.currentLockPath);
-        }
-    }
-    /**
-     * 安全删除文件（忽略不存在的错误）
-     */
-    async safeUnlink(filePath) {
-        try {
-            await unlink(filePath);
-        }
-        catch (err) {
-            logger.debug({ path: filePath, err: toError(err).message }, 'safeUnlink 忽略删除失败');
-        }
-    }
-    /**
-     * 检查进程是否存活
-     *
-     * 跨平台统一使用 process.kill(pid, 0) 探测进程存活
-     * （Windows 上 process.kill(pid, 0) 同样有效）
-     */
-    isProcessAlive(pid) {
-        try {
-            // 发送信号 0 检查进程是否存在（POSIX 兼容）
-            // Windows 上 process.kill(pid, 0) 也会抛出错误如果进程不存在
-            process.kill(pid, 0);
-            return true;
-        }
-        catch {
-            logger.debug({ pid }, '进程不存在');
-            return false;
-        }
-    }
     /**
      * 解析项目的 .memora/ 目录路径
      * 每个项目有独立的 .memora/ 目录（在项目根目录下）
@@ -428,50 +292,5 @@ export class ProjectManager {
     resolveMemoraDir(projectPath) {
         return resolve(projectPath, '.memora');
     }
-    /**
-     * 从项目路径推断项目名称
-     * 取路径最后一段目录名
-     */
-    inferProjectName(projectPath) {
-        const parts = projectPath.replace(/[/\\]+$/, '').split(/[/\\]/);
-        return parts[parts.length - 1] || 'unnamed';
-    }
-    /**
-     * 读取项目注册表
-     *
-     * 同步读取：list getter 契约要求同步返回，注册表操作低频，同步 I/O 影响可控
-     * 损坏时返回空数组并记录警告日志，避免静默吞错掩盖磁盘故障
-     */
-    readRegistry() {
-        if (!existsSync(this.registryPath)) {
-            return [];
-        }
-        try {
-            const raw = readFileSync(this.registryPath, 'utf-8');
-            // QC-24 使用类型守卫校验 JSON.parse 结果，替代 `as ProjectEntry[]` 类型断言
-            // 过滤掉不符合结构的条目，仅保留合法条目
-            const parsed = JSON.parse(raw);
-            const entries = asProjectEntryArray(parsed);
-            if (entries.length === 0 && Array.isArray(parsed) && parsed.length > 0) {
-                // 数组存在但所有条目都不合法，记录警告
-                logger.warn({ path: this.registryPath, totalEntries: parsed.length }, '项目注册表所有条目结构不合法，返回空列表');
-            }
-            return entries;
-        }
-        catch (err) {
-            // 注册表损坏：记录警告日志便于排查（不存在属正常首次启动，损坏需排查）
-            logger.warn({ path: this.registryPath, err: toError(err).message }, '项目注册表解析失败，返回空列表');
-            return [];
-        }
-    }
-    /**
-     * 写入项目注册表
-     */
-    writeRegistry(entries) {
-        // 确保目录存在
-        const dir = this.registryPath.replace(/[/\\][^/\\]+$/, '');
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(this.registryPath, JSON.stringify(entries, null, 2), 'utf-8');
-    }
 }
 //# sourceMappingURL=projectManager.js.map

package/dist/memory/projectManager.js.map

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

package/dist/memory/projectRegistry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 项目注册表条目
+ */
+export interface ProjectEntry {
+    /** 项目根目录的绝对路径 */
+    path: string;
+    /** 项目名称（用户自定义或目录名） */
+    name: string;
+    /** 最后打开时间 */
+    lastOpened: string;
+}
+/**
+ * 项目注册表
+ *
+ * 管理 projects.json 文件的读写和条目维护。
+ * Windows 文件系统不区分大小写，路径大小写不同视为同一项目。
+ */
+export declare class ProjectRegistry {
+    private readonly registryPath;
+    /**
+     * @param registryPath - 注册表文件绝对路径（projects.json）
+     */
+    constructor(registryPath: string);
+    /**
+     * 列出已注册的项目（同步读取，契约要求 getter 风格）
+     */
+    get list(): ProjectEntry[];
+    /**
+     * 注册项目到注册表
+     *
+     * Windows 文件系统不区分大小写，路径大小写不同视为同一项目（更新而非新增）。
+     *
+     * @param projectPath - 项目根目录绝对路径
+     * @param name - 项目名称
+     */
+    register(projectPath: string, name: string): void;
+    /**
+     * 从注册表移除项目
+     *
+     * @param projectPath - 项目根目录绝对路径
+     */
+    unregister(projectPath: string): void;
+    /**
+     * 从项目路径推断项目名称（取路径最后一段目录名）
+     *
+     * @param projectPath - 项目根目录绝对路径
+     * @returns 项目名称（目录名，无法推断时返回 'unnamed'）
+     */
+    static inferProjectName(projectPath: string): string;
+    /**
+     * 读取项目注册表
+     *
+     * 同步读取：list getter 契约要求同步返回，注册表操作低频，同步 I/O 影响可控。
+     * 损坏时返回空数组并记录警告日志，避免静默吞错掩盖磁盘故障。
+     */
+    private read;
+    /**
+     * 写入项目注册表
+     */
+    private write;
+}
+//# sourceMappingURL=projectRegistry.d.ts.map

package/dist/memory/projectRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRegistry.d.ts","sourceRoot":"","sources":["../../src/memory/projectRegistry.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAkCD;;;;;GAKG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,YAAY;IAHzC;;OAEG;gBAC0B,YAAY,EAAE,MAAM;IAEjD;;OAEG;IACH,IAAI,IAAI,IAAI,YAAY,EAAE,CAEzB;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAsBjD;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IASrC;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAKpD;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IA6BZ;;OAEG;IACH,OAAO,CAAC,KAAK;CAMd"}

package/dist/memory/projectRegistry.js

@@ -0,0 +1,158 @@
+/**
+ * 项目注册表 — 多项目注册信息持久化
+ *
+ * 从 ProjectManager 拆分出来，专职管理 projects.json 注册表：
+ *   - 读写项目注册表（~/.memora/projects.json 或宿主指定 registryDir）
+ *   - 注册/注销项目条目（Windows 大小写不敏感去重）
+ *   - 从路径推断项目名称
+ *   - 不可信磁盘 JSON 的运行时类型校验（QC-24，替代 `as` 类型断言）
+ *
+ * 设计原则：
+ *   - 纯文件系统操作，无锁机制（锁由 LockManager 负责）
+ *   - 同步 I/O（list getter 契约要求同步返回；注册表操作低频，影响可控）
+ *   - 损坏降级：解析失败返回空列表 + 警告日志，不抛异常
+ *
+ * 与 ProjectManager 的分工（1.0 接口稳定化）：
+ *   - ProjectRegistry：注册表读写 + 条目管理 + 名称推断
+ *   - ProjectManager：项目生命周期编排（加锁 + 资源加载 + 上下文构建）
+ *
+ * 详见 ADR-008 · 目录结构按"职责分层"
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { logger } from '../logging/logger.js';
+import { toError } from '../utils/toError.js';
+import { nowIso } from '../utils/time.js';
+import { isPlainObject } from '../utils/objects.js';
+// ─── 类型守卫（QC-24，对不可信磁盘 JSON 运行时校验） ─────
+/**
+ * 判断值是否为 ProjectEntry（项目注册表条目）
+ *
+ * @param value 待校验的值
+ * @returns true 表示符合 ProjectEntry 结构
+ */
+function isProjectEntry(value) {
+    if (!isPlainObject(value))
+        return false;
+    return (typeof value['path'] === 'string' &&
+        typeof value['name'] === 'string' &&
+        typeof value['lastOpened'] === 'string');
+}
+/**
+ * 判断值是否为 ProjectEntry 数组
+ *
+ * 过滤掉不符合结构的条目，仅保留合法条目
+ *
+ * @param value 待校验的值
+ * @returns 解析后的合法条目数组（损坏时返回空数组）
+ */
+function asProjectEntryArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter(isProjectEntry);
+}
+// ─── 类 ──────────────────────────────────────────────────
+/**
+ * 项目注册表
+ *
+ * 管理 projects.json 文件的读写和条目维护。
+ * Windows 文件系统不区分大小写，路径大小写不同视为同一项目。
+ */
+export class ProjectRegistry {
+    registryPath;
+    /**
+     * @param registryPath - 注册表文件绝对路径（projects.json）
+     */
+    constructor(registryPath) {
+        this.registryPath = registryPath;
+    }
+    /**
+     * 列出已注册的项目（同步读取，契约要求 getter 风格）
+     */
+    get list() {
+        return this.read();
+    }
+    /**
+     * 注册项目到注册表
+     *
+     * Windows 文件系统不区分大小写，路径大小写不同视为同一项目（更新而非新增）。
+     *
+     * @param projectPath - 项目根目录绝对路径
+     * @param name - 项目名称
+     */
+    register(projectPath, name) {
+        const registry = this.read();
+        // Windows 文件系统不区分大小写，路径大小写不同视为同一项目
+        const existing = registry.findIndex((e) => e.path.toLowerCase() === projectPath.toLowerCase());
+        const entry = {
+            path: projectPath,
+            name,
+            lastOpened: nowIso(),
+        };
+        if (existing >= 0) {
+            registry[existing] = entry;
+        }
+        else {
+            registry.push(entry);
+        }
+        this.write(registry);
+    }
+    /**
+     * 从注册表移除项目
+     *
+     * @param projectPath - 项目根目录绝对路径
+     */
+    unregister(projectPath) {
+        const registry = this.read();
+        // Windows 文件系统不区分大小写，大小写不同视为同一项目
+        const filtered = registry.filter((e) => e.path.toLowerCase() !== projectPath.toLowerCase());
+        this.write(filtered);
+    }
+    /**
+     * 从项目路径推断项目名称（取路径最后一段目录名）
+     *
+     * @param projectPath - 项目根目录绝对路径
+     * @returns 项目名称（目录名，无法推断时返回 'unnamed'）
+     */
+    static inferProjectName(projectPath) {
+        const parts = projectPath.replace(/[/\\]+$/, '').split(/[/\\]/);
+        return parts[parts.length - 1] || 'unnamed';
+    }
+    /**
+     * 读取项目注册表
+     *
+     * 同步读取：list getter 契约要求同步返回，注册表操作低频，同步 I/O 影响可控。
+     * 损坏时返回空数组并记录警告日志，避免静默吞错掩盖磁盘故障。
+     */
+    read() {
+        if (!existsSync(this.registryPath)) {
+            return [];
+        }
+        try {
+            const raw = readFileSync(this.registryPath, 'utf-8');
+            // QC-24 使用类型守卫校验 JSON.parse 结果，替代 `as ProjectEntry[]` 类型断言
+            // 过滤掉不符合结构的条目，仅保留合法条目
+            const parsed = JSON.parse(raw);
+            const entries = asProjectEntryArray(parsed);
+            if (entries.length === 0 && Array.isArray(parsed) && parsed.length > 0) {
+                // 数组存在但所有条目都不合法，记录警告
+                logger.warn({ path: this.registryPath, totalEntries: parsed.length }, '项目注册表所有条目结构不合法，返回空列表');
+            }
+            return entries;
+        }
+        catch (err) {
+            // 注册表损坏：记录警告日志便于排查（不存在属正常首次启动，损坏需排查）
+            logger.warn({ path: this.registryPath, err: toError(err).message }, '项目注册表解析失败，返回空列表');
+            return [];
+        }
+    }
+    /**
+     * 写入项目注册表
+     */
+    write(entries) {
+        // 确保目录存在
+        const dir = this.registryPath.replace(/[/\\][^/\\]+$/, '');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(this.registryPath, JSON.stringify(entries, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=projectRegistry.js.map

package/dist/memory/projectRegistry.js.map

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