@zooique/memora 4.0.0 → 5.0.0

package/dist/memory/nodeSqliteStorage.js

@@ -0,0 +1,393 @@
+/**
+ * Node 内置 SQLite 存储实现 —— `IMemoryStorage` 的落盘版（`node:sqlite` 内建模块，零第三方运行时依赖）
+ *
+ * ## 边界（勿越）
+ * - **只出工厂、不出实现类**：宿主经 `createNodeSqliteStorage()` 消费；实现类随签名结构可用，但不挂公共面
+ *   （避免宿主绕过工厂校验自建实例——基址/只读/PRAGMA 全在工厂收口）。
+ * - **文件路径语义留在宿主侧**：工厂收 `dbPath` 全长路径，内核不拼 `.memora/`、不定义记忆文件名常量
+ *   （对齐 ADR-002 定位：内核不感知数据目录布局）。
+ * - **不接管 IO 装载与迁移**：JSON 读取与一次性迁移是宿主的组合调用，内核不实现。
+ *
+ * ## 为什么用 `process.getBuiltinModule` 而非 `createRequire(import.meta.url)`
+ * ① `import.meta.url` 在本仓宿主 esbuild bundle 场景**有事故史**（bundle 后路径漂移，见宿主 assemble.ts /
+ *    extension.ts 相关注释）；
+ * ② `process.getBuiltinModule('node:xxx')` 对**不存在的模块返回 `undefined` 而非抛异常**（Node 22.22.2 /
+ *    24.12.0 实测）⇒「环境不支持」是显式判据；若改用 `createRequire` 的 catch-all，bundle 造成的
+ *    `TypeError` 会被吞成「老 Node 环境」= 真故障伪装成环境问题（违背「不带伤」）；
+ * ③ 版本代价 ≥22.3 被 `node:sqlite` 自身的 ≥22.13 门槛完全吸收，不额外抬门槛。
+ *    Node ≤22.2 无 `getBuiltinModule` 方法 → 走同一条「不可用」判据。
+ *
+ * ## 可用性判据唯一来源（禁判据散点）
+ * 「当前环境能否用 SQLite」的**唯一判据** = 调用本工厂的结果（成功 / 抛 `NOT_AVAILABLE` 专属错误）。
+ * 宿主**禁止**自行解析 `process.versions.node` 推断——版本号与实际加载结果可能不一致。
+ *
+ * ## 只读视图
+ * `{ readOnly: true }` 重载返回 `ReadOnlyMemoryStorage`（仅读方法）：连接以 SQLite 只读模式打开，且返回对象
+ * **结构上不含写方法**（不是「约定不乱调」）。供只读宿主（如 memora-mcp）零并列复用本实现，避免各宿主自写
+ * 第二份 SQLite 语义实现（三份并列 = 语义漂移）。**只读模式不建库**：库不存在时抛
+ * `MemoraError{ errorCode: FILE_NOT_FOUND }`，宿主据此区分「未初始化」与「真故障」。
+ *
+ * ## API 子集约束（防「因错误的原因通过」）
+ * 根 `@types/node` 版本高于运行时门槛（22.13）⇒ `tsc` 绿**不等于**运行时有该 API。本文件只使用 ≥22.13
+ * 已存在的 API：`DatabaseSync` / `prepare` / `run` / `get` / `all` / `exec` / `close` + 选项 `readOnly`
+ * （`@since v22.12.0`）。**刻意不使用** `timeout` 选项（`@since v24.0.0`，高于门槛）——忙等待改经
+ * `PRAGMA busy_timeout` 设置（全版本可用）。
+ *
+ * ## 并发
+ * 写锁为整库级，多进程（vscode / mcp / dsh）同写须排队（SQLite 默认 `busy_timeout = 0` = 立即报
+ * `SQLITE_BUSY`）⇒ 构造时设忙等待；写模式另设 `journal_mode = WAL`（读写不互斥，多进程互见）。
+ */
+import { existsSync } from 'node:fs';
+import { parseMemory } from '../memory/types.js';
+import { escapeLike, validateSource } from '../memory/sourceValidation.js';
+import { segmentLower } from '../utils/segmenter.js';
+import { logger } from '../logging/logger.js';
+import { MemoraError, ToolErrorCode, configError } from '../utils/errors.js';
+import { nowIso } from '../utils/time.js';
+/** 忙等待超时（毫秒）：写锁整库级，多进程同写须排队；0（SQLite 默认）会让并发写立即失败 */
+const DEFAULT_BUSY_TIMEOUT_MS = 3000;
+/** 建表语句：列名 snake_case 对齐 SQL 习惯，字段集与 `Memory` 白名单逐一对应 */
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS memories (
+  id                   TEXT PRIMARY KEY,
+  content              TEXT NOT NULL,
+  source               TEXT NOT NULL,
+  name                 TEXT NOT NULL,
+  created_at           TEXT NOT NULL,
+  accessed_at          TEXT NOT NULL,
+  deleted_at           TEXT,
+  metadata             TEXT,
+  summary_type         TEXT,
+  session_name         TEXT,
+  round_id             TEXT,
+  is_modified          INTEGER,
+  superseded_by        TEXT,
+  material_fingerprint TEXT
+)`;
+/** 列清单（显式列出而非 `SELECT *`：列序稳定且与 rowToMemory 对齐，加列时不静默错位） */
+const COLUMNS = [
+    'id',
+    'content',
+    'source',
+    'name',
+    'created_at',
+    'accessed_at',
+    'deleted_at',
+    'metadata',
+    'summary_type',
+    'session_name',
+    'round_id',
+    'is_modified',
+    'superseded_by',
+    'material_fingerprint',
+].join(', ');
+/** upsert 语句：整对象覆盖（契约「无 CAS 乐观锁」；`ON CONFLICT DO UPDATE` 语义等价于 REPLACE） */
+const UPSERT_SQL = `
+INSERT INTO memories (${COLUMNS})
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+ON CONFLICT(id) DO UPDATE SET
+  content              = excluded.content,
+  source               = excluded.source,
+  name                 = excluded.name,
+  created_at           = excluded.created_at,
+  accessed_at          = excluded.accessed_at,
+  deleted_at           = excluded.deleted_at,
+  metadata             = excluded.metadata,
+  summary_type         = excluded.summary_type,
+  session_name         = excluded.session_name,
+  round_id             = excluded.round_id,
+  is_modified          = excluded.is_modified,
+  superseded_by        = excluded.superseded_by,
+  material_fingerprint = excluded.material_fingerprint`;
+/**
+ * 取 Node 内建 sqlite 模块。
+ * 判据显式：模块缺失 → 返回 `undefined`（**不是抛异常**）；Node ≤22.2 无 `getBuiltinModule` 方法，走同一判据。
+ */
+function loadSqliteModule() {
+    if (typeof process.getBuiltinModule !== 'function')
+        return undefined;
+    return process.getBuiltinModule('node:sqlite');
+}
+/**
+ * 专属错误：「当前运行时无 node:sqlite 实现方」。
+ * 复用 `NOT_AVAILABLE`（能力缺席、不可重试）——与「provider 未注入」同语义类，避免为存储另开枚举码
+ * 造成单码单义分裂；宿主判据 = `err instanceof MemoraError && err.errorCode === ToolErrorCode.NOT_AVAILABLE`。
+ */
+function sqliteUnavailableError() {
+    return new MemoraError({
+        title: 'SQLite 存储不可用',
+        detail: '当前 Node 运行时未提供 node:sqlite 内建模块（需 Node ≥22.13）',
+        suggestions: [
+            '升级 Node 至 ≥22.13 后重试',
+            '或改用 JSON / 内存存储（宿主按本工厂的抛出结果降级）',
+        ],
+        category: 'config',
+        errorCode: ToolErrorCode.NOT_AVAILABLE,
+    });
+}
+/**
+ * 专属错误：「只读打开时库文件不存在」。
+ *
+ * 为什么不把驱动的裸 `ERR_SQLITE_ERROR: unable to open database file` 抛出去：只读宿主
+ * （memora-mcp / dsh 等）必须能用**错误码**区分「本工作区还没建库」与「真故障」，
+ * 否则每个宿主都得自己 `existsSync`（判据散点），用户看到的也是不可操作的驱动原文。
+ *
+ * 复用 `FILE_NOT_FOUND`：语义就是「文件不存在」，不为存储另开枚举码。
+ */
+function memoryDbNotFoundError(dbPath) {
+    return new MemoraError({
+        title: '记忆库文件不存在',
+        detail: `${dbPath} 尚未创建（只读模式不建库）`,
+        suggestions: [
+            '先用写宿主（如 Memora VS Code 插件）打开该工作区一次，以创建并迁移记忆库',
+            '确认传入的是工作区根目录，而不是它的子目录',
+        ],
+        category: 'config',
+        errorCode: ToolErrorCode.FILE_NOT_FOUND,
+    });
+}
+/**
+ * 行 → Memory：字段白名单校验**单一来源** = `parseMemory`（禁在本文件复写字段类型/取值校验）。
+ */
+function rowToMemory(row) {
+    return parseMemory({
+        id: row.id,
+        content: row.content,
+        source: row.source,
+        name: row.name,
+        createdAt: row.created_at,
+        accessedAt: row.accessed_at,
+        // SQL NULL 交 parseMemory 归一（其已把 null 视为未软删除）——字符串则为其原始软删除时间
+        deletedAt: row.deleted_at,
+        metadata: row.metadata === null || row.metadata === undefined ? undefined : parseMetadata(row.metadata),
+        // 以下可空列须显式把 null 归一为 undefined：parseMemory 对「非 undefined」做类型校验，null 会被判非法
+        summaryType: row.summary_type ?? undefined,
+        sessionName: row.session_name ?? undefined,
+        roundId: row.round_id ?? undefined,
+        isModified: row.is_modified === null || row.is_modified === undefined
+            ? undefined
+            : Number(row.is_modified) !== 0,
+        supersededBy: row.superseded_by ?? undefined,
+        materialFingerprint: row.material_fingerprint ?? undefined,
+    });
+}
+/** 解析 metadata 列的 JSON 文本；非法 JSON 抛错（响亮失败，不静默丢字段） */
+function parseMetadata(raw) {
+    try {
+        return JSON.parse(String(raw));
+    }
+    catch (err) {
+        throw configError('SQLite 记忆行损坏', `metadata 列不是合法 JSON：${String(raw)}`, ['检查该行是否被外部工具写坏', '或用备份重新迁移'], err instanceof Error ? err : undefined);
+    }
+}
+/** Memory → 绑定参数（顺序严格对齐 COLUMNS） */
+function memoryToParams(m) {
+    return [
+        m.id,
+        m.content,
+        m.source,
+        m.name,
+        m.createdAt,
+        m.accessedAt,
+        m.deletedAt ?? null,
+        m.metadata === undefined ? null : JSON.stringify(m.metadata),
+        m.summaryType ?? null,
+        m.sessionName ?? null,
+        m.roundId ?? null,
+        m.isModified === undefined ? null : m.isModified ? 1 : 0,
+        m.supersededBy ?? null,
+        m.materialFingerprint ?? null,
+    ];
+}
+/** 从行里取计数值（`COUNT(*)` 结果列） */
+function rowCount(row) {
+    return row === undefined ? 0 : Number(row.c);
+}
+/**
+ * 内部实现类（不挂公共面）。所有方法同步，语义逐位对齐 `InMemoryStorage`（契约对拍测试兜底）。
+ */
+class NodeSqliteStorage {
+    db;
+    /** 写模式才建表 + 设 WAL；只读模式连表都不建（宿主只读打开既有库） */
+    stmtUpsert;
+    stmtSoftDelete;
+    stmtRestore;
+    stmtPurge;
+    stmtListDeleted;
+    stmtListDeletedLimit;
+    stmtGetDeletedById;
+    stmtPurgeExpired;
+    stmtGetActiveById;
+    stmtGetActiveBySource;
+    stmtActiveByAccessedDesc;
+    stmtGetDeletedAt;
+    stmtCount;
+    stmtCountBySource;
+    stmtTouch;
+    stmtAllSources;
+    /** search 语句按 token 数缓存（每 token 两个 LIKE 占位），避免每次调用重新 prepare */
+    searchStmtCache = new Map();
+    closed = false;
+    constructor(db, writeMode) {
+        this.db = db;
+        // 忙等待：多进程同写排队，而非立即 SQLITE_BUSY（用 PRAGMA 而非 DatabaseSync 的 timeout 选项——
+        // 后者 @since v24.0.0，高于本实现的 22.13 门槛）
+        this.db.exec(`PRAGMA busy_timeout = ${DEFAULT_BUSY_TIMEOUT_MS}`);
+        if (writeMode) {
+            // WAL：读写不互斥，多进程互见（这是本次换 SQLite 的核心收益）
+            this.db.exec('PRAGMA journal_mode = WAL');
+            this.db.exec(SCHEMA_SQL);
+        }
+        this.stmtUpsert = this.prepare(UPSERT_SQL);
+        this.stmtSoftDelete = this.prepare('UPDATE memories SET deleted_at = ? WHERE id = ? AND deleted_at IS NULL');
+        this.stmtRestore = this.prepare('UPDATE memories SET deleted_at = NULL WHERE id = ? AND deleted_at IS NOT NULL');
+        this.stmtPurge = this.prepare('DELETE FROM memories WHERE id = ?');
+        this.stmtListDeleted = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE deleted_at IS NOT NULL ORDER BY deleted_at DESC`);
+        this.stmtListDeletedLimit = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE deleted_at IS NOT NULL ORDER BY deleted_at DESC LIMIT ?`);
+        this.stmtGetDeletedById = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE id = ? AND deleted_at IS NOT NULL`);
+        this.stmtPurgeExpired = this.prepare('DELETE FROM memories WHERE deleted_at IS NOT NULL AND deleted_at < ?');
+        this.stmtGetActiveById = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE id = ? AND deleted_at IS NULL`);
+        this.stmtGetActiveBySource = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE source = ? AND deleted_at IS NULL ORDER BY accessed_at DESC`);
+        this.stmtActiveByAccessedDesc = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE deleted_at IS NULL ORDER BY accessed_at DESC LIMIT ?`);
+        this.stmtGetDeletedAt = this.prepare('SELECT deleted_at FROM memories WHERE id = ?');
+        this.stmtCount = this.prepare('SELECT COUNT(*) AS c FROM memories WHERE deleted_at IS NULL');
+        this.stmtCountBySource = this.prepare('SELECT COUNT(*) AS c FROM memories WHERE source = ? AND deleted_at IS NULL');
+        this.stmtTouch = this.prepare('UPDATE memories SET accessed_at = ? WHERE id = ? AND deleted_at IS NULL');
+        this.stmtAllSources = this.prepare('SELECT source AS s, COUNT(*) AS c FROM memories WHERE deleted_at IS NULL GROUP BY source');
+    }
+    /** prepare 包装（集中类型收口点，免每处重复断言） */
+    prepare(sql) {
+        return this.db.prepare(sql);
+    }
+    upsert(memory) {
+        const result = validateSource(memory.source);
+        if (result.severity === 'block') {
+            throw configError('source 校验失败，拒绝写入', result.warning, [
+                '请检查 source 字段是否拼写正确',
+                '参考 source 开放字符串规范',
+            ]);
+        }
+        if (result.severity === 'warn' && result.warning) {
+            logger.warn({ id: memory.id, source: memory.source, warning: result.warning }, 'source 校验警告');
+        }
+        // 软删除复活拦截：与 InMemoryStorage 同判据（须先显式 restore，或新对象自带 deletedAt）
+        const existing = this.stmtGetDeletedAt.get(memory.id);
+        if (existing && existing.deleted_at !== null && memory.deletedAt === undefined) {
+            throw configError('不允许通过 upsert 复活软删除记忆', `id=${memory.id} 已被软删除（deletedAt=${String(existing.deleted_at)}）`, [
+                '若需恢复：先调用 restore(id)，再 upsert',
+                '若需覆盖软删除态：在 newMemory 中显式传入 deletedAt 字段',
+                '参考软删除机制设计',
+            ]);
+        }
+        this.stmtUpsert.run(...memoryToParams(memory));
+    }
+    delete(id) {
+        this.stmtSoftDelete.run(nowIso(), id);
+    }
+    restore(id) {
+        this.stmtRestore.run(id);
+    }
+    purge(id) {
+        this.stmtPurge.run(id);
+    }
+    listDeleted(limit) {
+        const rows = limit !== undefined && limit > 0
+            ? this.stmtListDeletedLimit.all(limit)
+            : this.stmtListDeleted.all();
+        return rows.map(rowToMemory);
+    }
+    getDeletedById(id) {
+        const row = this.stmtGetDeletedById.get(id);
+        return row === undefined ? null : rowToMemory(row);
+    }
+    purgeExpired(before) {
+        const result = this.stmtPurgeExpired.run(before.toISOString());
+        return Number(result.changes);
+    }
+    getById(id) {
+        const row = this.stmtGetActiveById.get(id);
+        return row === undefined ? null : rowToMemory(row);
+    }
+    getBySource(source) {
+        return this.stmtGetActiveBySource.all(source).map(rowToMemory);
+    }
+    search(query, limit = 10) {
+        // 空查询 / 分词零 token：退化为「按 accessedAt 降序取前 N」（与 InMemoryStorage 同语义）
+        const tokens = query.trim() ? segmentLower(query) : [];
+        if (tokens.length === 0) {
+            return this.stmtActiveByAccessedDesc.all(limit).map(rowToMemory);
+        }
+        const stmt = this.searchStatement(tokens.length);
+        // 每 token 两个 LIKE（content / name）；转义后必须配 ESCAPE '\'，否则含 % / _ 的字面值零召回
+        const params = [];
+        for (const token of tokens) {
+            const pattern = `%${escapeLike(token)}%`;
+            params.push(pattern, pattern);
+        }
+        params.push(limit);
+        return stmt.all(...params).map(rowToMemory);
+    }
+    /** 按 token 数取（必要时建）search 语句：任一 token 命中 content/name 即入选 */
+    searchStatement(tokenCount) {
+        const cached = this.searchStmtCache.get(tokenCount);
+        if (cached)
+            return cached;
+        const clauses = Array.from({ length: tokenCount }, () => `(content LIKE ? ESCAPE '\\' OR name LIKE ? ESCAPE '\\')`).join(' OR ');
+        const stmt = this.prepare(`SELECT ${COLUMNS} FROM memories WHERE deleted_at IS NULL AND (${clauses}) ORDER BY accessed_at DESC LIMIT ?`);
+        this.searchStmtCache.set(tokenCount, stmt);
+        return stmt;
+    }
+    count() {
+        return rowCount(this.stmtCount.get());
+    }
+    countBySource(source) {
+        return rowCount(this.stmtCountBySource.get(source));
+    }
+    touch(id, now) {
+        return Number(this.stmtTouch.run(now, id).changes) > 0;
+    }
+    getAllSources() {
+        const out = new Map();
+        for (const row of this.stmtAllSources.all()) {
+            out.set(String(row.s), Number(row.c));
+        }
+        return out;
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.db.close();
+    }
+}
+/** 构建只读视图：仅含读方法 + close（结构上拿不到写方法），供只读宿主复用 */
+function toReadOnlyView(impl) {
+    return Object.freeze({
+        getById: (id) => impl.getById(id),
+        getBySource: (source) => impl.getBySource(source),
+        search: (query, limit) => impl.search(query, limit),
+        count: () => impl.count(),
+        countBySource: (source) => impl.countBySource(source),
+        getAllSources: () => impl.getAllSources(),
+        listDeleted: (limit) => impl.listDeleted(limit),
+        getDeletedById: (id) => impl.getDeletedById(id),
+        close: () => impl.close?.(),
+    });
+}
+export function createNodeSqliteStorage(dbPath, options) {
+    const mod = loadSqliteModule();
+    if (!mod)
+        throw sqliteUnavailableError();
+    const readOnly = options?.readOnly === true;
+    // 只读模式不建库：先判存在，把「未初始化」收成专属错误码（见 memoryDbNotFoundError）。
+    // 判存在与打开之间存在 TOCTOU 窗口，但文件被删时 DatabaseSync 会抛裸错——真故障原样暴露，不吞。
+    if (readOnly && !existsSync(dbPath))
+        throw memoryDbNotFoundError(dbPath);
+    // 注意：不能写 `new DatabaseSync(path, undefined)`——第二个实参一旦出现，Node 参数校验即要求它是对象
+    const db = readOnly
+        ? new mod.DatabaseSync(dbPath, { readOnly: true })
+        : new mod.DatabaseSync(dbPath);
+    const impl = new NodeSqliteStorage(db, !readOnly);
+    return readOnly ? toReadOnlyView(impl) : impl;
+}
+//# sourceMappingURL=nodeSqliteStorage.js.map

package/dist/memory/nodeSqliteStorage.js.map

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

package/dist/memory/projectManager.d.ts

@@ -1,12 +1,11 @@
 import type { IMemoryStorage } from '../memory/storageInterface.js';
 import type { SecurityGuard } from '../security/pathGuard.js';
 import { type Memory } from '../memory/types.js';
-import { type ProjectEntry } from '../memory/projectRegistry.js';
 /** 项目上下文：打开一个项目后产出的一组组件（含项目级信息） */
 export interface ProjectContext {
     /** 项目根目录的绝对路径 */
     projectPath: string;
-    /** 项目名称（注册表读取或取目录名） */
+    /** 项目名称（显式传入优先，否则取目录名；内核不读任何注册表） */
     projectName: string;
     /** .memora/ 目录的绝对路径 */
     memoraDir: string;
@@ -23,22 +22,21 @@ export interface ProjectManagerOptions {
     dataDir: string;
     /** 外部注入存储实例（可选，不传则内部 InMemoryStorage 兜底） */
     storage?: IMemoryStorage;
-    /** 注册表目录（可选，缺省同 dataDir；跨项目按名解析需要多项目共用一份注册表） */
-    registryDir?: string;
     /**
      * SecurityGuard 工厂函数（Agent 层注入，解除 memory→security 反向依赖）。
-     * 项目切换时调用；不提供则 ProjectContext.security 为 null。
+     * 在 initProject 时调用一次；不提供则 ProjectContext.security 为 null。
      */
     createSecurityGuard?: (projectPath: string, memoraDir: string, configDir?: string, agentDataDir?: string) => SecurityGuard;
 }
 /**
- * 项目管理器：管理多项目生命周期——初始化当前项目（加锁+加载两层配置）、
- * 切换到新项目（解锁旧+锁新）、退出清理锁文件。注册表/锁文件委托专职模块，本类聚焦编排。
+ * 项目管理器：**单个**项目的生命周期编排——初始化（加锁 → 确保存储 → 构建上下文）、
+ * 关闭与锁释放。一个 Agent 绑定一个项目（2026-10-18 形态定案），因此本类**不持跨项目状态**：
+ * 无切换入口、无注册表、无项目名单。多项目由宿主各建一个 Agent 实例。
  */
 export declare class ProjectManager {
     /** Agent 级数据目录（宿主传入；内核不假设其下的文件形态） */
     private readonly agentDataDir;
-    /** Agent 级存储实例（全局共享，不随项目切换重建） */
+    /** Agent 级存储实例（实例内唯一，init 后不再重建） */
     private agentIndex;
     /** 当前打开的项目路径 */
     private currentProjectPath;
@@ -46,35 +44,27 @@ export declare class ProjectManager {
     private externalStorage;
     /** SecurityGuard 工厂函数（Agent 层注入） */
     private readonly createSecurityGuard?;
-    /** 项目注册表（专职 projects.json） */
-    private readonly registry;
     /** 锁文件管理器（专职 .memora/.lock） */
     private readonly lockManager;
     constructor(options: ProjectManagerOptions);
     /**
-     * 确保 Agent 级资源（存储实例）已初始化，生命周期内共享不随项目切换重建。
+     * 确保 Agent 级资源（存储实例）已初始化，Agent 实例生命周期内保持同一实例。
      * 构造注入的外部实例直接用，否则内部 InMemoryStorage（非持久化，仅开发/测试）。
      */
     private ensureAgentResources;
     /**
-     * 初始化项目：关闭旧项目→取项目级锁→确保共享存储→构建上下文。
+     * 初始化项目：防重入释放旧锁→取项目级锁→确保存储→构建上下文。
      * 任一步失败释放锁并重置状态，防锁文件残留导致下次启动检测失败。
      */
     initProject(projectPath: string, projectName?: string, configDir?: string): Promise<ProjectContext>;
     /**
-     * 构建项目上下文：bootstrap 过滤（恒为空，设定记忆归角色包层）+ 安全守卫创建 + 项目注册 + 日志。
+     * 构建项目上下文：bootstrap 过滤（恒为空，设定记忆归角色包层）+ 安全守卫创建 + 名称推断 + 日志。
      */
     private buildProjectContext;
     /** 关闭当前项目：释放锁/清状态，但不关 Agent 级 DB（共享，Agent 生命周期内持久存在） */
     closeProject(): Promise<void>;
-    /** 完全关闭：释放项目锁 + 关闭 Agent 级数据库（应在 Agent 整体关闭而非项目切换时调用） */
+    /** 完全关闭：释放项目锁 + 关闭 Agent 级数据库（由 `Agent.close()` 调用） */
     shutdown(): Promise<void>;
-    /** 列出已注册项目（委托 ProjectRegistry） */
-    get list(): ProjectEntry[];
-    /** 注册项目（委托 ProjectRegistry） */
-    registerProject(projectPath: string, name: string): void;
-    /** 移除项目（委托 ProjectRegistry） */
-    unregisterProject(projectPath: string): void;
     /** 当前项目路径 */
     get currentProject(): string | null;
     /** 解析项目 .memora/ 目录（项目根目录下，区别于用户级 dataDir） */

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

@@ -1 +1 @@
-{"version":3,"file":"projectManager.d.ts","sourceRoot":"","sources":["../../src/memory/projectManager.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAKjF,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,0BAA0B;AAC1B,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,KAClB,aAAa,CAAC;CACpB;AAID;;;GAGG;AACH,qBAAa,cAAc;IACzB,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,iCAAiC;IACjC,OAAO,CAAC,UAAU,CAA+B;IACjD,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAuB;IACjD,yCAAyC;IACzC,OAAO,CAAC,eAAe,CAAwB;IAC/C,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAKlB;IACnB,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,OAAO,EAAE,qBAAqB;IAe1C;;;OAGG;YACW,oBAAoB;IAiBlC;;;OAGG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IA0B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuC3B,wDAAwD;IAClD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,yDAAyD;IACnD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B,kCAAkC;IAClC,IAAI,IAAI,IAAI,YAAY,EAAE,CAEzB;IAED,+BAA+B;IAC/B,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxD,+BAA+B;IAC/B,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI5C,aAAa;IACb,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,8CAA8C;IAC9C,OAAO,CAAC,gBAAgB;CAGzB"}
+{"version":3,"file":"projectManager.d.ts","sourceRoot":"","sources":["../../src/memory/projectManager.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAehD,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,0BAA0B;AAC1B,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,KAClB,aAAa,CAAC;CACpB;AAID;;;;GAIG;AACH,qBAAa,cAAc;IACzB,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,oCAAoC;IACpC,OAAO,CAAC,UAAU,CAA+B;IACjD,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAAuB;IACjD,yCAAyC;IACzC,OAAO,CAAC,eAAe,CAAwB;IAC/C,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAKlB;IACnB,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,OAAO,EAAE,qBAAqB;IAQ1C;;;OAGG;YACW,oBAAoB;IAiBlC;;;OAGG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IA0B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B,wDAAwD;IAClD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,uDAAuD;IACjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B,aAAa;IACb,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,8CAA8C;IAC9C,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/memory/projectManager.js

@@ -1,26 +1,35 @@
 /**
- * 项目管理器 — 多项目生命周期编排（单 Agent 模型）。
- * 职责：项目初始化编排（关旧项目→加锁→加载资源→构建上下文）、Agent 级资源管理
- * （memora.db 全局共享不随切换重建）、两层记忆加载。注册表/锁文件委托专职模块 ProjectRegistry / LockManager。
- * 原则：memora.db 只有一个（Agent 级）；项目切换不重建库，只更新安全守卫+重扫项目规则；
- * 项目级 .memora/ 仅存放 rules 与 skills（无 memora.db）。
+ * 项目管理器 — 单个项目的生命周期编排（单 Agent 模型）。
+ * 职责：项目初始化编排（加锁 → 确保 Agent 级存储 → 构建上下文）、关闭与锁释放。
+ * 边界（2026-10-18 定案）：一个 Agent 绑定一个项目；**多项目由宿主创建多个 Agent 实例**，
+ * 内核既不提供单实例内切换、也不维护跨项目名单（历史 `switchProject` / `projects.json`
+ * 注册表整链已随 PR-SWITCH-1 删除）。项目名只从路径推断，内核不落任何跨项目状态。
  */
-import { resolve, join } from 'node:path';
+import { resolve } from 'node:path';
 import { mkdir } from 'node:fs/promises';
 import { InMemoryStorage } from '../memory/inMemoryStorage.js';
 import { logger } from '../logging/logger.js';
 import { expandHome } from '../utils/path.js';
-import { ProjectRegistry } from '../memory/projectRegistry.js';
 import { LockManager } from '../memory/lockManager.js';
+/**
+ * 从路径推断项目名称（取最后一段目录名，无法推断返回 'unnamed'）。
+ * 原为 ProjectRegistry 静态方法，注册表整链删除后摘为本模块级纯函数——项目名是
+ * `ProjectContext.projectName` 的唯一来源，推断逻辑不该随注册表一起消失。
+ */
+function inferProjectName(projectPath) {
+    const parts = projectPath.replace(/[/\\]+$/, '').split(/[/\\]/);
+    return parts[parts.length - 1] || 'unnamed';
+}
 // ─── 类 ──────────────────────────────────────────────────
 /**
- * 项目管理器：管理多项目生命周期——初始化当前项目（加锁+加载两层配置）、
- * 切换到新项目（解锁旧+锁新）、退出清理锁文件。注册表/锁文件委托专职模块，本类聚焦编排。
+ * 项目管理器：**单个**项目的生命周期编排——初始化（加锁 → 确保存储 → 构建上下文）、
+ * 关闭与锁释放。一个 Agent 绑定一个项目（2026-10-18 形态定案），因此本类**不持跨项目状态**：
+ * 无切换入口、无注册表、无项目名单。多项目由宿主各建一个 Agent 实例。
  */
 export class ProjectManager {
     /** Agent 级数据目录（宿主传入；内核不假设其下的文件形态） */
     agentDataDir;
-    /** Agent 级存储实例（全局共享，不随项目切换重建） */
+    /** Agent 级存储实例（实例内唯一，init 后不再重建） */
     agentIndex = null;
     /** 当前打开的项目路径 */
     currentProjectPath = null;
@@ -28,26 +37,17 @@ export class ProjectManager {
     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;
-        // 注册表目录：显式指定时用之（典型为用户级路径，使注册表跨项目共享）；
-        // 缺省随 dataDir——此时注册表能否跨项目取决于调用方传的 dataDir 是共享还是项目级，
-        // 内核不做假设：项目级 dataDir 下每个项目只注册自身，按名切换不成立（switchProject 已加守卫）。
-        const registryHome = registryDir ? resolve(expandHome(registryDir)) : memoraHome;
+        const { dataDir, storage, createSecurityGuard } = options;
+        this.agentDataDir = resolve(expandHome(dataDir));
         this.externalStorage = storage ?? null;
         this.createSecurityGuard = createSecurityGuard;
-        // 注册表/锁文件委托专职模块
-        this.registry = new ProjectRegistry(join(registryHome, 'projects.json'));
         this.lockManager = new LockManager();
     }
     /**
-     * 确保 Agent 级资源（存储实例）已初始化，生命周期内共享不随项目切换重建。
+     * 确保 Agent 级资源（存储实例）已初始化，Agent 实例生命周期内保持同一实例。
      * 构造注入的外部实例直接用，否则内部 InMemoryStorage（非持久化，仅开发/测试）。
      */
     async ensureAgentResources() {
@@ -64,11 +64,11 @@ export class ProjectManager {
         return { index: this.agentIndex };
     }
     /**
-     * 初始化项目：关闭旧项目→取项目级锁→确保共享存储→构建上下文。
+     * 初始化项目：防重入释放旧锁→取项目级锁→确保存储→构建上下文。
      * 任一步失败释放锁并重置状态，防锁文件残留导致下次启动检测失败。
      */
     async initProject(projectPath, projectName, configDir) {
-        // 1) 关闭旧项目（释放旧锁，不关 Agent 级 DB）
+        // 1) 防重入：本实例已打开过项目则先释放旧锁（不关 Agent 级 DB）
         if (this.currentProjectPath) {
             await this.closeProject();
         }
@@ -93,7 +93,7 @@ export class ProjectManager {
         }
     }
     /**
-     * 构建项目上下文：bootstrap 过滤（恒为空，设定记忆归角色包层）+ 安全守卫创建 + 项目注册 + 日志。
+     * 构建项目上下文：bootstrap 过滤（恒为空，设定记忆归角色包层）+ 安全守卫创建 + 名称推断 + 日志。
      */
     buildProjectContext(projectPath, projectName, memoraDir, index, configDir) {
         // 设定记忆唯一归角色包内容层，由 assembler 角色包路径接管，恒为空数组
@@ -102,9 +102,7 @@ export class ProjectManager {
         const security = this.createSecurityGuard
             ? this.createSecurityGuard(projectPath, memoraDir, configDir, this.agentDataDir)
             : null;
-        // 注册到项目表（委托 ProjectRegistry）
-        const name = projectName || ProjectRegistry.inferProjectName(projectPath);
-        this.registry.register(projectPath, name);
+        const name = projectName || inferProjectName(projectPath);
         logger.info({
             projectPath,
             projectName: name,
@@ -125,7 +123,7 @@ export class ProjectManager {
         await this.lockManager.release();
         this.currentProjectPath = null;
     }
-    /** 完全关闭：释放项目锁 + 关闭 Agent 级数据库（应在 Agent 整体关闭而非项目切换时调用） */
+    /** 完全关闭：释放项目锁 + 关闭 Agent 级数据库（由 `Agent.close()` 调用） */
     async shutdown() {
         if (this.currentProjectPath) {
             await this.closeProject();
@@ -140,18 +138,6 @@ export class ProjectManager {
             this.agentIndex = null;
         }
     }
-    /** 列出已注册项目（委托 ProjectRegistry） */
-    get list() {
-        return this.registry.list;
-    }
-    /** 注册项目（委托 ProjectRegistry） */
-    registerProject(projectPath, name) {
-        this.registry.register(projectPath, name);
-    }
-    /** 移除项目（委托 ProjectRegistry） */
-    unregisterProject(projectPath) {
-        this.registry.unregister(projectPath);
-    }
     /** 当前项目路径 */
     get currentProject() {
         return this.currentProjectPath;