@zooique/memora 4.0.0 → 5.0.0

package/dist/memory/projectRegistry.js

@@ -1,151 +0,0 @@
-/**
- * 项目注册表 — 多项目注册信息持久化（从 ProjectManager 拆出）。
- * 专职读写 projects.json：注册/注销条目（Windows 大小写不敏感去重）、从路径推断名称、
- * 不可信磁盘 JSON 运行时类型校验（替代 as 断言）。无锁（锁归 LockManager）；同步 I/O（list getter 契约）。
- * 损坏语义：文件不存在=首次启动返回空；文件损坏抛 ProjectRegistryCorruptError 让调用方决策（防空数据覆盖）。
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { logger } from '../logging/logger.js';
-import { MemoraError } from '../utils/errors.js';
-import { nowIso } from '../utils/time.js';
-import { isPlainObject } from '../utils/objects.js';
-/**
- * 注册表损坏错误：projects.json 存在但无法解析（JSON 语法/结构不符）时抛出。
- * 与"文件不存在"（首次正常）区分；register/unregister 必须向上传播防空覆盖，
- * list getter 可捕获降级返回空数组（只读不破坏数据）。保留 registryPath 供备份/排查。
- */
-export class ProjectRegistryCorruptError extends MemoraError {
-    /** 损坏文件的绝对路径，便于备份/排查 */
-    registryPath;
-    constructor(registryPath, cause) {
-        // cause 归一化为 Error 类型，符合 MemoraError.cause 契约
-        const causeError = cause instanceof Error ? cause : cause !== undefined ? new Error(String(cause)) : undefined;
-        super({
-            title: `项目注册表损坏：${registryPath}`,
-            detail: causeError?.message,
-            suggestions: [
-                '检查文件是否被外部程序修改',
-                '从备份恢复 projects.json',
-                '或删除该文件让精灵重建（会丢失历史项目记录）',
-            ],
-            category: 'config',
-            cause: causeError,
-        });
-        this.name = 'ProjectRegistryCorruptError';
-        this.registryPath = registryPath;
-    }
-}
-// ─── 类型守卫（对不可信磁盘 JSON 运行时校验） ───────────
-/** 判断值是否为 ProjectEntry */
-function isProjectEntry(value) {
-    if (!isPlainObject(value))
-        return false;
-    return (typeof value['path'] === 'string' &&
-        typeof value['name'] === 'string' &&
-        typeof value['lastOpened'] === 'string');
-}
-/** 顶层必须为数组否则视为损坏（抛错防空数据覆盖）；数组内单条不合法仅过滤保留（容错） */
-function asProjectEntryArray(value, registryPath) {
-    if (!Array.isArray(value)) {
-        throw new ProjectRegistryCorruptError(registryPath, new Error(`注册表顶层应为数组，实际类型：${typeof value}`));
-    }
-    return value.filter(isProjectEntry);
-}
-// ─── 类 ──────────────────────────────────────────────────
-/**
- * 项目注册表：管理 projects.json 读写与条目维护；Windows 不区分大小写，路径不同大小写视为同一项目。
- */
-export class ProjectRegistry {
-    registryPath;
-    /** @param registryPath 注册表文件绝对路径（projects.json） */
-    constructor(registryPath) {
-        this.registryPath = registryPath;
-    }
-    /**
-     * 列出已注册项目（同步 getter 契约）。只读：损坏时降级返回空数组（不破坏数据），
-     * 与 register/unregister 写入路径须抛错不同。
-     */
-    get list() {
-        try {
-            return this.read();
-        }
-        catch (err) {
-            if (err instanceof ProjectRegistryCorruptError) {
-                logger.warn({ path: err.registryPath, cause: err.cause }, '项目注册表损坏，list getter 降级返回空列表（只读，不破坏数据）');
-                return [];
-            }
-            // 非注册表损坏的意外错误仍向上抛出
-            throw err;
-        }
-    }
-    /** 注册项目：路径大小写不敏感，视为同一项目（更新而非新增） */
-    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);
-    }
-    /** 移除项目（路径大小写不敏感匹配） */
-    unregister(projectPath) {
-        const registry = this.read();
-        const filtered = registry.filter((e) => e.path.toLowerCase() !== projectPath.toLowerCase());
-        this.write(filtered);
-    }
-    /** 从路径推断项目名称（取最后一段目录名，无法推断返回 'unnamed'） */
-    static inferProjectName(projectPath) {
-        const parts = projectPath.replace(/[/\\]+$/, '').split(/[/\\]/);
-        return parts[parts.length - 1] || 'unnamed';
-    }
-    /**
-     * 同步读取注册表（list getter 契约）。语义：文件不存在=空数组（首次启动）；
-     * 解析失败或顶层非数组=抛 ProjectRegistryCorruptError；单条不合法仅过滤。
-     */
-    read() {
-        // 文件不存在=首次启动，返回空数组
-        if (!existsSync(this.registryPath)) {
-            return [];
-        }
-        let raw;
-        try {
-            raw = readFileSync(this.registryPath, 'utf-8');
-        }
-        catch (err) {
-            // 读取失败（权限/磁盘故障）视为损坏
-            throw new ProjectRegistryCorruptError(this.registryPath, err);
-        }
-        let parsed;
-        try {
-            // 类型守卫校验 JSON.parse 结果，替代 as 断言
-            parsed = JSON.parse(raw);
-        }
-        catch (err) {
-            // JSON 语法错误=整体损坏，抛错让调用方决策
-            throw new ProjectRegistryCorruptError(this.registryPath, err);
-        }
-        // 顶层非数组视为损坏；单条不合法仅过滤保留合法条目
-        const entries = asProjectEntryArray(parsed, this.registryPath);
-        if (entries.length === 0 && Array.isArray(parsed) && parsed.length > 0) {
-            logger.warn({ path: this.registryPath, totalEntries: parsed.length }, '项目注册表所有条目结构不合法，返回空列表');
-        }
-        return entries;
-    }
-    /** 写入注册表 */
-    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

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

package/dist/utils/recallDefaults.d.ts

@@ -1,16 +0,0 @@
-/**
- * 召回默认值——单一真理源（记忆层与 agent 层共享）。
- *
- * 召回不设保底下限（无 `DEFAULT_MIN_FALLBACK`）——保底仅在「检查点恢复的温记忆召回」
- * 场景有意义，该链路不在实现内。
- */
-/**
- * 召回排除 source 默认值（空数组）——设定记忆（persona/rule/skill）归角色包、
- * 记忆库不写入，不参与召回排除（memory-role-pack-boundary），此处为空默认。
- *
- * **唯一活性消费者 = `MemoryAdvisor.suggest()`**（关联推荐的 `excludeSources` 本地参数缺省值）；
- * 不存在同名配置管道 `config.recallExcludeSources`（ContextPreparer 侧）——`assembleContext`
- * 从不读取该配置（死配置），勿因「两处同名」而误以为是一根链。
- */
-export declare const DEFAULT_RECALL_EXCLUDE_SOURCES: readonly string[];
-//# sourceMappingURL=recallDefaults.d.ts.map

package/dist/utils/recallDefaults.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recallDefaults.d.ts","sourceRoot":"","sources":["../../src/utils/recallDefaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAAO,CAAC"}

package/dist/utils/recallDefaults.js

@@ -1,16 +0,0 @@
-/**
- * 召回默认值——单一真理源（记忆层与 agent 层共享）。
- *
- * 召回不设保底下限（无 `DEFAULT_MIN_FALLBACK`）——保底仅在「检查点恢复的温记忆召回」
- * 场景有意义，该链路不在实现内。
- */
-/**
- * 召回排除 source 默认值（空数组）——设定记忆（persona/rule/skill）归角色包、
- * 记忆库不写入，不参与召回排除（memory-role-pack-boundary），此处为空默认。
- *
- * **唯一活性消费者 = `MemoryAdvisor.suggest()`**（关联推荐的 `excludeSources` 本地参数缺省值）；
- * 不存在同名配置管道 `config.recallExcludeSources`（ContextPreparer 侧）——`assembleContext`
- * 从不读取该配置（死配置），勿因「两处同名」而误以为是一根链。
- */
-export const DEFAULT_RECALL_EXCLUDE_SOURCES = [];
-//# sourceMappingURL=recallDefaults.js.map

package/dist/utils/recallDefaults.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recallDefaults.js","sourceRoot":"","sources":["../../src/utils/recallDefaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAsB,EAAE,CAAC"}