@ai-agent-forge/agent-forge 0.88.1 → 0.88.2

package/dist/core/session-index.js

@@ -0,0 +1,455 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative } from "node:path";
+import { getAgentDir, getSessionsDir } from "../config.js";
+import { AGENT_SESSIONS_DIR_NAME } from "./agent-session-paths.js";
+/**
+ * 会话元数据索引（session-index.json），设计契约见 docs/design/会话索引.md。
+ *
+ * 索引是文件系统的投影、永远不是事实源；条目内部分两层：关系（file/dir/id/cwd）
+ * 由 readdir 对账保证，内容缓存由 file_mtime_ms 令牌保证（mtime 未变才可信，
+ * 变了就重读刷新）。写钩子是预热优化、不承担正确性（设计 §4）；读路径
+ * （listSessionsViaIndex）负责对账自愈与全量重建。不加跨进程锁——丢失的更新
+ * 会被令牌机制限定为无害，下次读取对账时按文件系统纠正（设计 §6）。
+ */
+const SESSION_INDEX_VERSION = 1;
+const SESSION_INDEX_FILE_NAME = "session-index.json";
+/** 节流落盘窗口（设计 §4：每轮消息追加标脏，10s 落盘一次）。 */
+const FLUSH_THROTTLE_MS = 10_000;
+/** 索引文件路径（与 plugin-state.json 同级；getAgentDir() 尊重 AGENT_FORGE_DIR）。 */
+export function getSessionIndexPath() {
+    return join(getAgentDir(), SESSION_INDEX_FILE_NAME);
+}
+let pendingFlush;
+let flushTimer;
+let exitHookRegistered = false;
+function clearPending() {
+    pendingFlush = undefined;
+    if (flushTimer !== undefined) {
+        clearTimeout(flushTimer);
+        flushTimer = undefined;
+    }
+}
+function ensureExitFlushHook() {
+    if (exitHookRegistered)
+        return;
+    exitHookRegistered = true;
+    process.once("exit", () => {
+        flushSessionIndexNow();
+    });
+}
+function armDirty(indexPath, state) {
+    pendingFlush = { indexPath, state };
+    ensureExitFlushHook();
+    if (flushTimer === undefined) {
+        flushTimer = setTimeout(() => {
+            flushTimer = undefined;
+            flushSessionIndexNow();
+        }, FLUSH_THROTTLE_MS);
+        flushTimer.unref();
+    }
+}
+/** 立即落盘脏状态（测试与 exit 钩子共用）；无脏状态时为 no-op。 */
+export function flushSessionIndexNow() {
+    const pending = pendingFlush;
+    if (!pending)
+        return;
+    clearPending();
+    try {
+        writeStateSync(pending.indexPath, pending.state);
+    }
+    catch {
+        // 失败留给对账自愈（设计 §6），不向会话写入路径传播。
+    }
+}
+// ---------------------------------------------------------------------------
+// 读写原语
+// ---------------------------------------------------------------------------
+function emptyState() {
+    return { version: SESSION_INDEX_VERSION, updated_at_ms: 0, projects: [], sessions: [] };
+}
+function safeMs(value) {
+    return Number.isFinite(value) ? value : 0;
+}
+function isSessionFileName(file) {
+    return file.endsWith(".jsonl") && !file.endsWith(".trace.jsonl");
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+/**
+ * 条目级最小形状校验：必填字段类型/finite 不符的条目直接丢弃（视同缺失，交给
+ * 对账/重建自愈，覆盖设计 §2 目标 3 的字段级损坏）；可选字段仅在为 string 时
+ * 保留，否则按键缺席处理。
+ */
+function coerceSessionEntry(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const raw = value;
+    if (typeof raw.file !== "string" || typeof raw.dir !== "string" || typeof raw.id !== "string")
+        return null;
+    if (typeof raw.cwd !== "string")
+        return null;
+    if (!isFiniteNumber(raw.created_ms) || !isFiniteNumber(raw.modified_ms) || !isFiniteNumber(raw.message_count)) {
+        return null;
+    }
+    if (typeof raw.first_message !== "string")
+        return null;
+    return {
+        file: raw.file,
+        dir: raw.dir,
+        id: raw.id,
+        cwd: raw.cwd,
+        ...(isFiniteNumber(raw.file_mtime_ms) ? { file_mtime_ms: raw.file_mtime_ms } : {}),
+        ...(typeof raw.name === "string" ? { name: raw.name } : {}),
+        ...(typeof raw.parent_session_path === "string" ? { parent_session_path: raw.parent_session_path } : {}),
+        ...(typeof raw.profile_id === "string" ? { profile_id: raw.profile_id } : {}),
+        ...(typeof raw.profile_version === "string" ? { profile_version: raw.profile_version } : {}),
+        created_ms: raw.created_ms,
+        modified_ms: raw.modified_ms,
+        message_count: raw.message_count,
+        first_message: raw.first_message,
+    };
+}
+function coerceProjectEntry(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const raw = value;
+    // 项目条目只有 dir/cwd 关系；last_active 由成员条目 modified_ms 服务时派生
+    // （设计 §3），入库时的任何附加键一律忽略。
+    if (typeof raw.dir !== "string" || typeof raw.cwd !== "string")
+        return null;
+    return { dir: raw.dir, cwd: raw.cwd };
+}
+/** 读取并校验索引文件；不存在/JSON 损坏/版本不符返回 null（由调用方重建或忽略）。 */
+function readIndexFile(indexPath) {
+    let content;
+    try {
+        content = readFileSync(indexPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(content);
+        if (parsed.version !== SESSION_INDEX_VERSION)
+            return null;
+        if (!Array.isArray(parsed.projects) || !Array.isArray(parsed.sessions))
+            return null;
+        const projects = parsed.projects.map(coerceProjectEntry).filter((entry) => {
+            return entry !== null;
+        });
+        const sessions = parsed.sessions.map(coerceSessionEntry).filter((entry) => {
+            return entry !== null;
+        });
+        return { version: SESSION_INDEX_VERSION, updated_at_ms: 0, projects, sessions };
+    }
+    catch {
+        return null;
+    }
+}
+/** 原子写（temp + rename，同 ecosystem/state.ts 模式）；同步 API 供 exit 钩子共用。 */
+function writeStateSync(indexPath, state) {
+    const parent = dirname(indexPath);
+    mkdirSync(parent, { recursive: true });
+    const temporaryPath = join(parent, `.${basename(indexPath)}.${randomUUID()}.tmp`);
+    try {
+        state.updated_at_ms = Date.now();
+        writeFileSync(temporaryPath, `${JSON.stringify(state)}\n`, "utf8");
+        renameSync(temporaryPath, indexPath);
+    }
+    finally {
+        try {
+            unlinkSync(temporaryPath);
+        }
+        catch {
+            // rename 成功后 tmp 已不存在；清理失败不掩盖写入结果。
+        }
+    }
+}
+/** 可变状态：优先续用未落盘的脏快照，避免节流窗口内的读-改-写互相覆盖。 */
+function loadMutableState(indexPath) {
+    if (pendingFlush?.indexPath === indexPath)
+        return pendingFlush.state;
+    return readIndexFile(indexPath) ?? emptyState();
+}
+/**
+ * 解析会话路径在索引中的位置：dir = 相对 sessions 根的父目录名（不从 cwd 重推导，
+ * 规避 Windows 盘符大小写陷阱，设计 §3），file = basename。
+ * sessions 根之外、根一级散落文件、非 `*.jsonl` 与 `*.trace.jsonl` 一律返回 null。
+ */
+function locationInRoot(sessionsRoot, sessionPath) {
+    const rel = relative(sessionsRoot, sessionPath);
+    if (rel === "" || rel.startsWith("..") || isAbsolute(rel))
+        return null;
+    const dir = dirname(rel);
+    if (dir === "." || dir === "..")
+        return null;
+    const file = basename(rel);
+    if (!isSessionFileName(file))
+        return null;
+    return { dir, file };
+}
+function findSessionEntry(state, dir, file) {
+    return state.sessions.find((entry) => entry.dir === dir && entry.file === file);
+}
+function touchProject(state, dir, cwd) {
+    if (state.projects.some((project) => project.dir === dir))
+        return;
+    state.projects.push({ dir, cwd });
+}
+function addSessionFromInfo(state, dir, file, info, mtimeMs) {
+    state.sessions = state.sessions.filter((entry) => !(entry.dir === dir && entry.file === file));
+    state.sessions.push({
+        file,
+        dir,
+        id: info.id,
+        cwd: info.cwd,
+        ...(info.name === undefined ? {} : { name: info.name }),
+        ...(info.parentSessionPath === undefined ? {} : { parent_session_path: info.parentSessionPath }),
+        ...(info.profileId === undefined ? {} : { profile_id: info.profileId }),
+        ...(info.profileVersion === undefined ? {} : { profile_version: info.profileVersion }),
+        ...(mtimeMs === undefined ? {} : { file_mtime_ms: mtimeMs }),
+        created_ms: safeMs(info.created.getTime()),
+        modified_ms: safeMs(info.modified.getTime()),
+        message_count: info.messageCount,
+        first_message: info.firstMessage,
+    });
+    touchProject(state, dir, info.cwd);
+}
+// ---------------------------------------------------------------------------
+// 写路径（设计 §4）
+// ---------------------------------------------------------------------------
+/**
+ * upsert 单会话条目并按 immediate 决定落盘时机。预热优化（设计 §4）：条目缺失
+ * 或过期由读路径的 mtime 令牌对账刷新，不承担正确性。内部错误一律吞掉
+ * （fail-open）：索引是投影，写入失败由下次读取对账自愈，绝不影响会话持久化。
+ */
+export function recordSessionUpdate(input) {
+    try {
+        const sessionsRoot = getSessionsDir();
+        const location = locationInRoot(sessionsRoot, input.sessionPath);
+        if (!location)
+            return;
+        // 缓存有效期令牌 = 当前文件 mtime；stat 失败则条目不带令牌（视为过期，无害）。
+        let mtimeMs;
+        try {
+            mtimeMs = statSync(input.sessionPath).mtimeMs;
+        }
+        catch {
+            mtimeMs = undefined;
+        }
+        const indexPath = getSessionIndexPath();
+        const state = loadMutableState(indexPath);
+        state.sessions = state.sessions.filter((entry) => !(entry.dir === location.dir && entry.file === location.file));
+        const modifiedMs = safeMs(input.modifiedMs);
+        state.sessions.push({
+            file: location.file,
+            dir: location.dir,
+            id: input.sessionId,
+            cwd: input.cwd,
+            ...(input.name === undefined ? {} : { name: input.name }),
+            ...(input.parentSessionPath === undefined ? {} : { parent_session_path: input.parentSessionPath }),
+            ...(input.profileId === undefined ? {} : { profile_id: input.profileId }),
+            ...(input.profileVersion === undefined ? {} : { profile_version: input.profileVersion }),
+            ...(mtimeMs === undefined ? {} : { file_mtime_ms: mtimeMs }),
+            created_ms: safeMs(input.createdMs),
+            modified_ms: modifiedMs,
+            message_count: input.messageCount,
+            first_message: input.firstMessage,
+        });
+        touchProject(state, location.dir, input.cwd);
+        if (input.immediate) {
+            clearPending();
+            writeStateSync(indexPath, state);
+        }
+        else {
+            armDirty(indexPath, state);
+        }
+    }
+    catch {
+        // 索引维护绝不影响会话写入（设计 §4/§6）。
+    }
+}
+/**
+ * 按路径移除条目并立即原子落盘；索引不存在/损坏/路径不在 sessions 根时静默 no-op
+ * （不抛错、不重建，设计 §6）。
+ */
+export function removeSessionFromIndex(sessionPath) {
+    try {
+        const location = locationInRoot(getSessionsDir(), sessionPath);
+        if (!location)
+            return;
+        const indexPath = getSessionIndexPath();
+        const state = loadMutableState(indexPath);
+        const before = state.sessions.length;
+        state.sessions = state.sessions.filter((entry) => !(entry.dir === location.dir && entry.file === location.file));
+        if (state.sessions.length === before)
+            return;
+        clearPending();
+        writeStateSync(indexPath, state);
+    }
+    catch {
+        // 对账会在下次读取自愈（设计 §6）。
+    }
+}
+// ---------------------------------------------------------------------------
+// 读路径与对账（设计 §5）
+// ---------------------------------------------------------------------------
+function sessionInfoFromEntry(sessionsRoot, entry) {
+    return {
+        path: join(sessionsRoot, entry.dir, entry.file),
+        id: entry.id,
+        cwd: entry.cwd,
+        ...(entry.name === undefined ? {} : { name: entry.name }),
+        ...(entry.parent_session_path === undefined ? {} : { parentSessionPath: entry.parent_session_path }),
+        ...(entry.profile_id === undefined ? {} : { profileId: entry.profile_id }),
+        ...(entry.profile_version === undefined ? {} : { profileVersion: entry.profile_version }),
+        created: new Date(entry.created_ms),
+        modified: new Date(entry.modified_ms),
+        messageCount: entry.message_count,
+        firstMessage: entry.first_message,
+        allMessagesText: "",
+    };
+}
+function sortedSessions(sessionsRoot, state) {
+    const ordered = [...state.sessions].sort((a, b) => b.modified_ms - a.modified_ms || b.file.localeCompare(a.file));
+    return ordered.map((entry) => sessionInfoFromEntry(sessionsRoot, entry));
+}
+/** 重建路径：由全量扫描结果构建索引状态，逐文件 stat 写入 mtime 令牌。 */
+async function stateFromSessions(sessionsRoot, sessions) {
+    const state = emptyState();
+    for (const info of sessions) {
+        const location = locationInRoot(sessionsRoot, info.path);
+        if (!location)
+            continue;
+        let mtimeMs;
+        try {
+            mtimeMs = (await stat(info.path)).mtimeMs;
+        }
+        catch {
+            mtimeMs = undefined;
+        }
+        addSessionFromInfo(state, location.dir, location.file, info, mtimeMs);
+    }
+    return state;
+}
+/**
+ * 对账：目录名集合 diff + 目录内文件名集合 diff，逐文件 stat 与条目的
+ * file_mtime_ms 令牌比对（设计 §5）——条目缺失 → buildInfo 补；mtime 与令牌
+ * 一致 → 缓存可信直接沿用；不一致或令牌缺失 → buildInfo 重读刷新缓存与新令牌
+ * （重读失败 = 文件已不再是会话 → 剔除陈旧条目）；索引有、磁盘无 → 剔除；
+ * 消失目录连同其 project 行剔除。返回是否有变更。
+ */
+async function reconcileIndex(sessionsRoot, state, buildInfo, signal) {
+    // 磁盘清单：目录名 → (文件名 → stat mtime)。stat 失败（readdir 与 stat 之间
+    // 被删/不可读）视同本轮缺席，下轮对账收敛。
+    const diskDirs = new Map();
+    let rootEntries;
+    try {
+        rootEntries = await readdir(sessionsRoot, { withFileTypes: true });
+    }
+    catch {
+        // sessions 根不可读视同空盘：剔除全部条目（索引是投影，根恢复后重建）。
+        rootEntries = [];
+    }
+    for (const entry of rootEntries) {
+        if (entry.name === AGENT_SESSIONS_DIR_NAME)
+            continue;
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        let fileNames;
+        try {
+            fileNames = await readdir(join(sessionsRoot, entry.name));
+        }
+        catch {
+            // 目录不可读视同已清空，其索引条目被剔除（悬挂容忍，设计 §6）。
+            fileNames = [];
+        }
+        const files = new Map();
+        for (const file of fileNames) {
+            if (!isSessionFileName(file))
+                continue;
+            signal?.throwIfAborted();
+            try {
+                files.set(file, (await stat(join(sessionsRoot, entry.name, file))).mtimeMs);
+            }
+            catch {
+                // 本轮视同缺席。
+            }
+        }
+        diskDirs.set(entry.name, files);
+    }
+    let changed = false;
+    for (const [dir, files] of diskDirs) {
+        for (const [file, mtimeMs] of files) {
+            const existing = findSessionEntry(state, dir, file);
+            if (existing && existing.file_mtime_ms !== undefined && existing.file_mtime_ms === mtimeMs)
+                continue;
+            signal?.throwIfAborted();
+            const info = await buildInfo(join(sessionsRoot, dir, file));
+            if (!info) {
+                if (existing) {
+                    // 文件已不再解析为会话（损坏/改写）：剔除陈旧条目。
+                    state.sessions = state.sessions.filter((candidate) => candidate !== existing);
+                    changed = true;
+                }
+                continue;
+            }
+            addSessionFromInfo(state, dir, file, info, mtimeMs);
+            changed = true;
+        }
+    }
+    const keptSessions = state.sessions.filter((entry) => diskDirs.get(entry.dir)?.has(entry.file));
+    if (keptSessions.length !== state.sessions.length) {
+        state.sessions = keptSessions;
+        changed = true;
+    }
+    const keptProjects = state.projects.filter((project) => diskDirs.has(project.dir));
+    if (keptProjects.length !== state.projects.length) {
+        state.projects = keptProjects;
+        changed = true;
+    }
+    return changed;
+}
+/**
+ * listAll 默认布局分支的索引读路径。返回 undefined 表示索引层意外失败（IO 等），
+ * 调用方应回退到旧全量扫描（fail-open，设计 §5）；中止按惯例抛 AbortError。
+ */
+export async function listSessionsViaIndex(input) {
+    const { sessionsRoot, buildInfo, scanAll, onHit, signal } = input;
+    try {
+        signal?.throwIfAborted();
+        const indexPath = getSessionIndexPath();
+        let state;
+        if (pendingFlush?.indexPath === indexPath) {
+            // 节流窗口内已积累的更新是对账基准：对账落盘不得把窗口内更新回退覆盖。
+            state = pendingFlush.state;
+        }
+        else {
+            const fromDisk = readIndexFile(indexPath);
+            if (fromDisk === null) {
+                // 缺失/损坏/版本不符 → 旧扫描全量重建并落盘（与旧行为同价，设计 §5.1）。
+                const sessions = await scanAll();
+                writeStateSync(indexPath, await stateFromSessions(sessionsRoot, sessions));
+                return sessions;
+            }
+            state = fromDisk;
+        }
+        const changed = await reconcileIndex(sessionsRoot, state, buildInfo, signal);
+        if (changed) {
+            if (pendingFlush?.indexPath === indexPath)
+                clearPending();
+            writeStateSync(indexPath, state);
+        }
+        const sessions = sortedSessions(sessionsRoot, state);
+        onHit?.(sessions);
+        return sessions;
+    }
+    catch {
+        signal?.throwIfAborted();
+        return undefined;
+    }
+}
+//# sourceMappingURL=session-index.js.map

package/dist/core/session-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-index.js","sourceRoot":"","sources":["../../src/core/session-index.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { type Dirent, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { readdir, stat } from \"node:fs/promises\";\nimport { basename, dirname, isAbsolute, join, relative } from \"node:path\";\nimport { getAgentDir, getSessionsDir } from \"../config.ts\";\nimport { AGENT_SESSIONS_DIR_NAME } from \"./agent-session-paths.ts\";\nimport type { SessionInfo } from \"./session-manager.ts\";\n\n/**\n * 会话元数据索引（session-index.json），设计契约见 docs/design/会话索引.md。\n *\n * 索引是文件系统的投影、永远不是事实源；条目内部分两层：关系（file/dir/id/cwd）\n * 由 readdir 对账保证，内容缓存由 file_mtime_ms 令牌保证（mtime 未变才可信，\n * 变了就重读刷新）。写钩子是预热优化、不承担正确性（设计 §4）；读路径\n * （listSessionsViaIndex）负责对账自愈与全量重建。不加跨进程锁——丢失的更新\n * 会被令牌机制限定为无害，下次读取对账时按文件系统纠正（设计 §6）。\n */\n\nconst SESSION_INDEX_VERSION = 1;\nconst SESSION_INDEX_FILE_NAME = \"session-index.json\";\n/** 节流落盘窗口（设计 §4：每轮消息追加标脏，10s 落盘一次）。 */\nconst FLUSH_THROTTLE_MS = 10_000;\n\nexport interface SessionIndexProjectEntry {\n\t/** 项目目录名（getDefaultSessionDirPath(cwd) 的编码目录名，不从 cwd 重推导）。 */\n\tdir: string;\n\tcwd: string;\n}\n\nexport interface SessionIndexSessionEntry {\n\t/** 会话文件 basename；键 = (dir, file)。 */\n\tfile: string;\n\tdir: string;\n\tid: string;\n\tcwd: string;\n\t/**\n\t * 缓存有效期令牌：条目写入时该会话文件的 stat mtime。缺失或与磁盘不一致 =\n\t * 缓存过期，对账时重读刷新（设计 §3/§5）。\n\t */\n\tfile_mtime_ms?: number;\n\tname?: string;\n\tparent_session_path?: string;\n\t/** 创建时锁定的 profile（可选字段，向后可读；与 SessionHeader 对应）。 */\n\tprofile_id?: string;\n\tprofile_version?: string;\n\tcreated_ms: number;\n\tmodified_ms: number;\n\tmessage_count: number;\n\tfirst_message: string;\n}\n\ninterface SessionIndexFile {\n\tversion: number;\n\tupdated_at_ms: number;\n\tprojects: SessionIndexProjectEntry[];\n\tsessions: SessionIndexSessionEntry[];\n}\n\nexport interface SessionIndexUpdateInput {\n\t/** 绝对会话文件路径（默认布局下位于 sessions 根之内）。 */\n\tsessionPath: string;\n\tsessionId: string;\n\tcwd: string;\n\tname?: string;\n\tparentSessionPath?: string;\n\tprofileId?: string;\n\tprofileVersion?: string;\n\tcreatedMs: number;\n\tmodifiedMs: number;\n\tmessageCount: number;\n\tfirstMessage: string;\n\t/** true = 同步原子落盘；false = 标脏，节流窗口内落盘。 */\n\timmediate: boolean;\n}\n\nexport interface ListSessionsViaIndexInput {\n\t/** sessions 根目录（…/sessions）绝对路径。 */\n\tsessionsRoot: string;\n\t/** 完整 SessionInfo 构建器（session-manager 的 buildSessionInfo）；返回 null = 非会话文件。 */\n\tbuildInfo: (path: string) => Promise<SessionInfo | null>;\n\t/** 旧全量扫描委托：索引缺失/损坏/版本不符时用于重建索引（与旧 listAll 同价）。 */\n\tscanAll: () => Promise<SessionInfo[]>;\n\t/** 索引命中时的单次完整已排序快照回调（重建路径的进度由 scanAll 按旧语义发布）。 */\n\tonHit?: (sessions: SessionInfo[]) => void;\n\tsignal?: AbortSignal;\n}\n\n/** 索引文件路径（与 plugin-state.json 同级；getAgentDir() 尊重 AGENT_FORGE_DIR）。 */\nexport function getSessionIndexPath(): string {\n\treturn join(getAgentDir(), SESSION_INDEX_FILE_NAME);\n}\n\n// ---------------------------------------------------------------------------\n// 模块级脏状态：pendingFlush 捕获写入目标与快照，进程 exit 时同步落盘。\n// 按路径比较，测试间 ENV_AGENT_DIR 切换不会串写。\n// ---------------------------------------------------------------------------\n\ninterface PendingFlush {\n\tindexPath: string;\n\tstate: SessionIndexFile;\n}\n\nlet pendingFlush: PendingFlush | undefined;\nlet flushTimer: ReturnType<typeof setTimeout> | undefined;\nlet exitHookRegistered = false;\n\nfunction clearPending(): void {\n\tpendingFlush = undefined;\n\tif (flushTimer !== undefined) {\n\t\tclearTimeout(flushTimer);\n\t\tflushTimer = undefined;\n\t}\n}\n\nfunction ensureExitFlushHook(): void {\n\tif (exitHookRegistered) return;\n\texitHookRegistered = true;\n\tprocess.once(\"exit\", () => {\n\t\tflushSessionIndexNow();\n\t});\n}\n\nfunction armDirty(indexPath: string, state: SessionIndexFile): void {\n\tpendingFlush = { indexPath, state };\n\tensureExitFlushHook();\n\tif (flushTimer === undefined) {\n\t\tflushTimer = setTimeout(() => {\n\t\t\tflushTimer = undefined;\n\t\t\tflushSessionIndexNow();\n\t\t}, FLUSH_THROTTLE_MS);\n\t\tflushTimer.unref();\n\t}\n}\n\n/** 立即落盘脏状态（测试与 exit 钩子共用）；无脏状态时为 no-op。 */\nexport function flushSessionIndexNow(): void {\n\tconst pending = pendingFlush;\n\tif (!pending) return;\n\tclearPending();\n\ttry {\n\t\twriteStateSync(pending.indexPath, pending.state);\n\t} catch {\n\t\t// 失败留给对账自愈（设计 §6），不向会话写入路径传播。\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// 读写原语\n// ---------------------------------------------------------------------------\n\nfunction emptyState(): SessionIndexFile {\n\treturn { version: SESSION_INDEX_VERSION, updated_at_ms: 0, projects: [], sessions: [] };\n}\n\nfunction safeMs(value: number): number {\n\treturn Number.isFinite(value) ? value : 0;\n}\n\nfunction isSessionFileName(file: string): boolean {\n\treturn file.endsWith(\".jsonl\") && !file.endsWith(\".trace.jsonl\");\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n\treturn typeof value === \"number\" && Number.isFinite(value);\n}\n\n/**\n * 条目级最小形状校验：必填字段类型/finite 不符的条目直接丢弃（视同缺失，交给\n * 对账/重建自愈，覆盖设计 §2 目标 3 的字段级损坏）；可选字段仅在为 string 时\n * 保留，否则按键缺席处理。\n */\nfunction coerceSessionEntry(value: unknown): SessionIndexSessionEntry | null {\n\tif (typeof value !== \"object\" || value === null) return null;\n\tconst raw = value as Record<string, unknown>;\n\tif (typeof raw.file !== \"string\" || typeof raw.dir !== \"string\" || typeof raw.id !== \"string\") return null;\n\tif (typeof raw.cwd !== \"string\") return null;\n\tif (!isFiniteNumber(raw.created_ms) || !isFiniteNumber(raw.modified_ms) || !isFiniteNumber(raw.message_count)) {\n\t\treturn null;\n\t}\n\tif (typeof raw.first_message !== \"string\") return null;\n\treturn {\n\t\tfile: raw.file,\n\t\tdir: raw.dir,\n\t\tid: raw.id,\n\t\tcwd: raw.cwd,\n\t\t...(isFiniteNumber(raw.file_mtime_ms) ? { file_mtime_ms: raw.file_mtime_ms } : {}),\n\t\t...(typeof raw.name === \"string\" ? { name: raw.name } : {}),\n\t\t...(typeof raw.parent_session_path === \"string\" ? { parent_session_path: raw.parent_session_path } : {}),\n\t\t...(typeof raw.profile_id === \"string\" ? { profile_id: raw.profile_id } : {}),\n\t\t...(typeof raw.profile_version === \"string\" ? { profile_version: raw.profile_version } : {}),\n\t\tcreated_ms: raw.created_ms,\n\t\tmodified_ms: raw.modified_ms,\n\t\tmessage_count: raw.message_count,\n\t\tfirst_message: raw.first_message,\n\t};\n}\n\nfunction coerceProjectEntry(value: unknown): SessionIndexProjectEntry | null {\n\tif (typeof value !== \"object\" || value === null) return null;\n\tconst raw = value as Record<string, unknown>;\n\t// 项目条目只有 dir/cwd 关系；last_active 由成员条目 modified_ms 服务时派生\n\t// （设计 §3），入库时的任何附加键一律忽略。\n\tif (typeof raw.dir !== \"string\" || typeof raw.cwd !== \"string\") return null;\n\treturn { dir: raw.dir, cwd: raw.cwd };\n}\n\n/** 读取并校验索引文件；不存在/JSON 损坏/版本不符返回 null（由调用方重建或忽略）。 */\nfunction readIndexFile(indexPath: string): SessionIndexFile | null {\n\tlet content: string;\n\ttry {\n\t\tcontent = readFileSync(indexPath, \"utf8\");\n\t} catch {\n\t\treturn null;\n\t}\n\ttry {\n\t\tconst parsed = JSON.parse(content) as { version?: unknown; projects?: unknown; sessions?: unknown };\n\t\tif (parsed.version !== SESSION_INDEX_VERSION) return null;\n\t\tif (!Array.isArray(parsed.projects) || !Array.isArray(parsed.sessions)) return null;\n\t\tconst projects = parsed.projects.map(coerceProjectEntry).filter((entry): entry is SessionIndexProjectEntry => {\n\t\t\treturn entry !== null;\n\t\t});\n\t\tconst sessions = parsed.sessions.map(coerceSessionEntry).filter((entry): entry is SessionIndexSessionEntry => {\n\t\t\treturn entry !== null;\n\t\t});\n\t\treturn { version: SESSION_INDEX_VERSION, updated_at_ms: 0, projects, sessions };\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/** 原子写（temp + rename，同 ecosystem/state.ts 模式）；同步 API 供 exit 钩子共用。 */\nfunction writeStateSync(indexPath: string, state: SessionIndexFile): void {\n\tconst parent = dirname(indexPath);\n\tmkdirSync(parent, { recursive: true });\n\tconst temporaryPath = join(parent, `.${basename(indexPath)}.${randomUUID()}.tmp`);\n\ttry {\n\t\tstate.updated_at_ms = Date.now();\n\t\twriteFileSync(temporaryPath, `${JSON.stringify(state)}\\n`, \"utf8\");\n\t\trenameSync(temporaryPath, indexPath);\n\t} finally {\n\t\ttry {\n\t\t\tunlinkSync(temporaryPath);\n\t\t} catch {\n\t\t\t// rename 成功后 tmp 已不存在；清理失败不掩盖写入结果。\n\t\t}\n\t}\n}\n\n/** 可变状态：优先续用未落盘的脏快照，避免节流窗口内的读-改-写互相覆盖。 */\nfunction loadMutableState(indexPath: string): SessionIndexFile {\n\tif (pendingFlush?.indexPath === indexPath) return pendingFlush.state;\n\treturn readIndexFile(indexPath) ?? emptyState();\n}\n\n/**\n * 解析会话路径在索引中的位置：dir = 相对 sessions 根的父目录名（不从 cwd 重推导，\n * 规避 Windows 盘符大小写陷阱，设计 §3），file = basename。\n * sessions 根之外、根一级散落文件、非 `*.jsonl` 与 `*.trace.jsonl` 一律返回 null。\n */\nfunction locationInRoot(sessionsRoot: string, sessionPath: string): { dir: string; file: string } | null {\n\tconst rel = relative(sessionsRoot, sessionPath);\n\tif (rel === \"\" || rel.startsWith(\"..\") || isAbsolute(rel)) return null;\n\tconst dir = dirname(rel);\n\tif (dir === \".\" || dir === \"..\") return null;\n\tconst file = basename(rel);\n\tif (!isSessionFileName(file)) return null;\n\treturn { dir, file };\n}\n\nfunction findSessionEntry(state: SessionIndexFile, dir: string, file: string): SessionIndexSessionEntry | undefined {\n\treturn state.sessions.find((entry) => entry.dir === dir && entry.file === file);\n}\n\nfunction touchProject(state: SessionIndexFile, dir: string, cwd: string): void {\n\tif (state.projects.some((project) => project.dir === dir)) return;\n\tstate.projects.push({ dir, cwd });\n}\n\nfunction addSessionFromInfo(\n\tstate: SessionIndexFile,\n\tdir: string,\n\tfile: string,\n\tinfo: SessionInfo,\n\tmtimeMs?: number,\n): void {\n\tstate.sessions = state.sessions.filter((entry) => !(entry.dir === dir && entry.file === file));\n\tstate.sessions.push({\n\t\tfile,\n\t\tdir,\n\t\tid: info.id,\n\t\tcwd: info.cwd,\n\t\t...(info.name === undefined ? {} : { name: info.name }),\n\t\t...(info.parentSessionPath === undefined ? {} : { parent_session_path: info.parentSessionPath }),\n\t\t...(info.profileId === undefined ? {} : { profile_id: info.profileId }),\n\t\t...(info.profileVersion === undefined ? {} : { profile_version: info.profileVersion }),\n\t\t...(mtimeMs === undefined ? {} : { file_mtime_ms: mtimeMs }),\n\t\tcreated_ms: safeMs(info.created.getTime()),\n\t\tmodified_ms: safeMs(info.modified.getTime()),\n\t\tmessage_count: info.messageCount,\n\t\tfirst_message: info.firstMessage,\n\t});\n\ttouchProject(state, dir, info.cwd);\n}\n\n// ---------------------------------------------------------------------------\n// 写路径（设计 §4）\n// ---------------------------------------------------------------------------\n\n/**\n * upsert 单会话条目并按 immediate 决定落盘时机。预热优化（设计 §4）：条目缺失\n * 或过期由读路径的 mtime 令牌对账刷新，不承担正确性。内部错误一律吞掉\n * （fail-open）：索引是投影，写入失败由下次读取对账自愈，绝不影响会话持久化。\n */\nexport function recordSessionUpdate(input: SessionIndexUpdateInput): void {\n\ttry {\n\t\tconst sessionsRoot = getSessionsDir();\n\t\tconst location = locationInRoot(sessionsRoot, input.sessionPath);\n\t\tif (!location) return;\n\t\t// 缓存有效期令牌 = 当前文件 mtime；stat 失败则条目不带令牌（视为过期，无害）。\n\t\tlet mtimeMs: number | undefined;\n\t\ttry {\n\t\t\tmtimeMs = statSync(input.sessionPath).mtimeMs;\n\t\t} catch {\n\t\t\tmtimeMs = undefined;\n\t\t}\n\t\tconst indexPath = getSessionIndexPath();\n\t\tconst state = loadMutableState(indexPath);\n\t\tstate.sessions = state.sessions.filter((entry) => !(entry.dir === location.dir && entry.file === location.file));\n\t\tconst modifiedMs = safeMs(input.modifiedMs);\n\t\tstate.sessions.push({\n\t\t\tfile: location.file,\n\t\t\tdir: location.dir,\n\t\t\tid: input.sessionId,\n\t\t\tcwd: input.cwd,\n\t\t\t...(input.name === undefined ? {} : { name: input.name }),\n\t\t\t...(input.parentSessionPath === undefined ? {} : { parent_session_path: input.parentSessionPath }),\n\t\t\t...(input.profileId === undefined ? {} : { profile_id: input.profileId }),\n\t\t\t...(input.profileVersion === undefined ? {} : { profile_version: input.profileVersion }),\n\t\t\t...(mtimeMs === undefined ? {} : { file_mtime_ms: mtimeMs }),\n\t\t\tcreated_ms: safeMs(input.createdMs),\n\t\t\tmodified_ms: modifiedMs,\n\t\t\tmessage_count: input.messageCount,\n\t\t\tfirst_message: input.firstMessage,\n\t\t});\n\t\ttouchProject(state, location.dir, input.cwd);\n\t\tif (input.immediate) {\n\t\t\tclearPending();\n\t\t\twriteStateSync(indexPath, state);\n\t\t} else {\n\t\t\tarmDirty(indexPath, state);\n\t\t}\n\t} catch {\n\t\t// 索引维护绝不影响会话写入（设计 §4/§6）。\n\t}\n}\n\n/**\n * 按路径移除条目并立即原子落盘；索引不存在/损坏/路径不在 sessions 根时静默 no-op\n * （不抛错、不重建，设计 §6）。\n */\nexport function removeSessionFromIndex(sessionPath: string): void {\n\ttry {\n\t\tconst location = locationInRoot(getSessionsDir(), sessionPath);\n\t\tif (!location) return;\n\t\tconst indexPath = getSessionIndexPath();\n\t\tconst state = loadMutableState(indexPath);\n\t\tconst before = state.sessions.length;\n\t\tstate.sessions = state.sessions.filter((entry) => !(entry.dir === location.dir && entry.file === location.file));\n\t\tif (state.sessions.length === before) return;\n\t\tclearPending();\n\t\twriteStateSync(indexPath, state);\n\t} catch {\n\t\t// 对账会在下次读取自愈（设计 §6）。\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// 读路径与对账（设计 §5）\n// ---------------------------------------------------------------------------\n\nfunction sessionInfoFromEntry(sessionsRoot: string, entry: SessionIndexSessionEntry): SessionInfo {\n\treturn {\n\t\tpath: join(sessionsRoot, entry.dir, entry.file),\n\t\tid: entry.id,\n\t\tcwd: entry.cwd,\n\t\t...(entry.name === undefined ? {} : { name: entry.name }),\n\t\t...(entry.parent_session_path === undefined ? {} : { parentSessionPath: entry.parent_session_path }),\n\t\t...(entry.profile_id === undefined ? {} : { profileId: entry.profile_id }),\n\t\t...(entry.profile_version === undefined ? {} : { profileVersion: entry.profile_version }),\n\t\tcreated: new Date(entry.created_ms),\n\t\tmodified: new Date(entry.modified_ms),\n\t\tmessageCount: entry.message_count,\n\t\tfirstMessage: entry.first_message,\n\t\tallMessagesText: \"\",\n\t};\n}\n\nfunction sortedSessions(sessionsRoot: string, state: SessionIndexFile): SessionInfo[] {\n\tconst ordered = [...state.sessions].sort((a, b) => b.modified_ms - a.modified_ms || b.file.localeCompare(a.file));\n\treturn ordered.map((entry) => sessionInfoFromEntry(sessionsRoot, entry));\n}\n\n/** 重建路径：由全量扫描结果构建索引状态，逐文件 stat 写入 mtime 令牌。 */\nasync function stateFromSessions(sessionsRoot: string, sessions: SessionInfo[]): Promise<SessionIndexFile> {\n\tconst state = emptyState();\n\tfor (const info of sessions) {\n\t\tconst location = locationInRoot(sessionsRoot, info.path);\n\t\tif (!location) continue;\n\t\tlet mtimeMs: number | undefined;\n\t\ttry {\n\t\t\tmtimeMs = (await stat(info.path)).mtimeMs;\n\t\t} catch {\n\t\t\tmtimeMs = undefined;\n\t\t}\n\t\taddSessionFromInfo(state, location.dir, location.file, info, mtimeMs);\n\t}\n\treturn state;\n}\n\n/**\n * 对账：目录名集合 diff + 目录内文件名集合 diff，逐文件 stat 与条目的\n * file_mtime_ms 令牌比对（设计 §5）——条目缺失 → buildInfo 补；mtime 与令牌\n * 一致 → 缓存可信直接沿用；不一致或令牌缺失 → buildInfo 重读刷新缓存与新令牌\n * （重读失败 = 文件已不再是会话 → 剔除陈旧条目）；索引有、磁盘无 → 剔除；\n * 消失目录连同其 project 行剔除。返回是否有变更。\n */\nasync function reconcileIndex(\n\tsessionsRoot: string,\n\tstate: SessionIndexFile,\n\tbuildInfo: (path: string) => Promise<SessionInfo | null>,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\t// 磁盘清单：目录名 → (文件名 → stat mtime)。stat 失败（readdir 与 stat 之间\n\t// 被删/不可读）视同本轮缺席，下轮对账收敛。\n\tconst diskDirs = new Map<string, Map<string, number>>();\n\tlet rootEntries: Dirent[];\n\ttry {\n\t\trootEntries = await readdir(sessionsRoot, { withFileTypes: true });\n\t} catch {\n\t\t// sessions 根不可读视同空盘：剔除全部条目（索引是投影，根恢复后重建）。\n\t\trootEntries = [];\n\t}\n\tfor (const entry of rootEntries) {\n\t\tif (entry.name === AGENT_SESSIONS_DIR_NAME) continue;\n\t\tif (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n\t\tlet fileNames: string[];\n\t\ttry {\n\t\t\tfileNames = await readdir(join(sessionsRoot, entry.name));\n\t\t} catch {\n\t\t\t// 目录不可读视同已清空，其索引条目被剔除（悬挂容忍，设计 §6）。\n\t\t\tfileNames = [];\n\t\t}\n\t\tconst files = new Map<string, number>();\n\t\tfor (const file of fileNames) {\n\t\t\tif (!isSessionFileName(file)) continue;\n\t\t\tsignal?.throwIfAborted();\n\t\t\ttry {\n\t\t\t\tfiles.set(file, (await stat(join(sessionsRoot, entry.name, file))).mtimeMs);\n\t\t\t} catch {\n\t\t\t\t// 本轮视同缺席。\n\t\t\t}\n\t\t}\n\t\tdiskDirs.set(entry.name, files);\n\t}\n\n\tlet changed = false;\n\n\tfor (const [dir, files] of diskDirs) {\n\t\tfor (const [file, mtimeMs] of files) {\n\t\t\tconst existing = findSessionEntry(state, dir, file);\n\t\t\tif (existing && existing.file_mtime_ms !== undefined && existing.file_mtime_ms === mtimeMs) continue;\n\t\t\tsignal?.throwIfAborted();\n\t\t\tconst info = await buildInfo(join(sessionsRoot, dir, file));\n\t\t\tif (!info) {\n\t\t\t\tif (existing) {\n\t\t\t\t\t// 文件已不再解析为会话（损坏/改写）：剔除陈旧条目。\n\t\t\t\t\tstate.sessions = state.sessions.filter((candidate) => candidate !== existing);\n\t\t\t\t\tchanged = true;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\taddSessionFromInfo(state, dir, file, info, mtimeMs);\n\t\t\tchanged = true;\n\t\t}\n\t}\n\n\tconst keptSessions = state.sessions.filter((entry) => diskDirs.get(entry.dir)?.has(entry.file));\n\tif (keptSessions.length !== state.sessions.length) {\n\t\tstate.sessions = keptSessions;\n\t\tchanged = true;\n\t}\n\n\tconst keptProjects = state.projects.filter((project) => diskDirs.has(project.dir));\n\tif (keptProjects.length !== state.projects.length) {\n\t\tstate.projects = keptProjects;\n\t\tchanged = true;\n\t}\n\n\treturn changed;\n}\n\n/**\n * listAll 默认布局分支的索引读路径。返回 undefined 表示索引层意外失败（IO 等），\n * 调用方应回退到旧全量扫描（fail-open，设计 §5）；中止按惯例抛 AbortError。\n */\nexport async function listSessionsViaIndex(input: ListSessionsViaIndexInput): Promise<SessionInfo[] | undefined> {\n\tconst { sessionsRoot, buildInfo, scanAll, onHit, signal } = input;\n\ttry {\n\t\tsignal?.throwIfAborted();\n\t\tconst indexPath = getSessionIndexPath();\n\t\tlet state: SessionIndexFile;\n\t\tif (pendingFlush?.indexPath === indexPath) {\n\t\t\t// 节流窗口内已积累的更新是对账基准：对账落盘不得把窗口内更新回退覆盖。\n\t\t\tstate = pendingFlush.state;\n\t\t} else {\n\t\t\tconst fromDisk = readIndexFile(indexPath);\n\t\t\tif (fromDisk === null) {\n\t\t\t\t// 缺失/损坏/版本不符 → 旧扫描全量重建并落盘（与旧行为同价，设计 §5.1）。\n\t\t\t\tconst sessions = await scanAll();\n\t\t\t\twriteStateSync(indexPath, await stateFromSessions(sessionsRoot, sessions));\n\t\t\t\treturn sessions;\n\t\t\t}\n\t\t\tstate = fromDisk;\n\t\t}\n\t\tconst changed = await reconcileIndex(sessionsRoot, state, buildInfo, signal);\n\t\tif (changed) {\n\t\t\tif (pendingFlush?.indexPath === indexPath) clearPending();\n\t\t\twriteStateSync(indexPath, state);\n\t\t}\n\t\tconst sessions = sortedSessions(sessionsRoot, state);\n\t\tonHit?.(sessions);\n\t\treturn sessions;\n\t} catch {\n\t\tsignal?.throwIfAborted();\n\t\treturn undefined;\n\t}\n}\n"]}

package/dist/core/session-manager.d.ts

@@ -297,6 +297,15 @@ export declare class SessionManager {
      */
     private _hasConversation;
     _persist(entry: SessionEntry): void;
+    /**
+     * 会话索引写钩子（设计 docs/design/会话索引.md §4）。定位是预热优化，不承担
+     * 正确性：条目缺失或过期由读路径的 mtime 令牌对账刷新。仅在默认布局且已落盘
+     * （flushed = 会话文件已存在于磁盘）时生效；自定义 --session-dir 与 inMemory
+     * 会话不进索引。字段从内存 fileEntries 派生（deriveSessionIndexFields，与
+     * buildSessionInfo 逐语义对齐）。索引维护的任何失败都在 recordSessionUpdate
+     * 内部吞掉，绝不影响会话持久化。
+     */
+    private notifySessionIndex;
     private _appendEntry;
     /** Append a message as child of current leaf, then advance leaf. Returns entry id.
      * Does not allow writing CompactionSummaryMessage and BranchSummaryMessage directly.