session-weaver 1.1.1

package/dist/managers/session.js

@@ -0,0 +1,248 @@
+/**
+ * Session Manager - 会话管理
+ */
+import { nanoid } from 'nanoid';
+import { StorageManager } from './storage.js';
+import { formatSessionToMarkdown } from '../utils/format.js';
+const VERSION = '2.0.0';
+export class SessionManager {
+    storage;
+    constructor(storage) {
+        this.storage = storage || new StorageManager();
+    }
+    async saveSession(input) {
+        const sessionId = nanoid(12);
+        const createdAt = new Date().toISOString();
+        // 确定关联的模块
+        let moduleName = input.module;
+        if (!moduleName) {
+            // 自动使用当前模块
+            moduleName = await this.storage.getCurrentModule(input.project) || undefined;
+        }
+        // 处理传入的 pitfalls，保存为独立的 Pitfall 记录
+        const pitfallRefs = [];
+        if (input.pitfalls && input.pitfalls.length > 0) {
+            for (const pitfallInput of input.pitfalls) {
+                const pitfallId = nanoid(12);
+                const pitfall = {
+                    pitfallId,
+                    project: input.project,
+                    module: moduleName, // 关联到模块
+                    problem: pitfallInput.problem,
+                    solution: pitfallInput.solution,
+                    tags: pitfallInput.tags || [],
+                    sessionId,
+                    createdAt
+                };
+                await this.storage.savePitfall(pitfall);
+                pitfallRefs.push({ pitfallId, problem: pitfallInput.problem });
+            }
+        }
+        // 根据待办事项状态决定会话状态
+        const todos = input.todos || [];
+        const pendingTodos = todos.filter(t => !t.done);
+        let status = 'active';
+        if (pendingTodos.length === 0 && todos.length > 0) {
+            status = 'completed';
+        }
+        const session = {
+            sessionId,
+            project: input.project,
+            module: moduleName,
+            createdAt,
+            summary: input.summary,
+            techStack: input.techStack || [],
+            codeState: input.codeState || {
+                modifiedFiles: [],
+                currentBranch: '',
+                uncommittedChanges: ''
+            },
+            decisions: input.decisions || [],
+            pitfalls: pitfallRefs,
+            todos: todos,
+            status,
+            metadata: {
+                aiTool: input.aiTool || 'unknown',
+                version: VERSION
+            }
+        };
+        await this.storage.saveSession(session);
+        // 自动更新关联模块的 summary 和 updatedAt
+        if (moduleName && input.updateModule !== false) {
+            const module = await this.storage.getModule(input.project, moduleName);
+            if (module) {
+                module.summary = input.summary;
+                module.updatedAt = createdAt;
+                await this.storage.saveModule(input.project, module);
+            }
+        }
+        return {
+            sessionId,
+            module: moduleName,
+            savedAt: createdAt,
+            path: this.storage.getBaseDir()
+        };
+    }
+    async loadSession(input) {
+        let session = null;
+        if (input.sessionId) {
+            // 扫描所有项目查找 session（因为不知道项目名）
+            const projects = await this.storage.listProjects();
+            for (const project of projects) {
+                session = await this.storage.loadSession(project, input.sessionId);
+                if (session)
+                    break;
+            }
+        }
+        else if (input.project) {
+            // 加载项目的最新 session
+            session = await this.storage.loadLatestSession(input.project);
+        }
+        if (!session) {
+            return null;
+        }
+        // 加载关联的模块数据
+        let moduleData;
+        if (session.module) {
+            moduleData = await this.storage.getModule(session.project, session.module) || undefined;
+        }
+        // 加载关联的 pitfall 详情
+        const pitfalls = await Promise.all(session.pitfalls.map(async (ref) => {
+            // 从项目中查找 pitfall
+            const projectFile = await this.storage.loadProjectFile(session.project);
+            return projectFile?.pitfalls.find(p => p.pitfallId === ref.pitfallId) || null;
+        }));
+        const validPitfalls = pitfalls.filter((p) => p !== null);
+        const markdownPreview = formatSessionToMarkdown(session, validPitfalls, moduleData);
+        return {
+            session,
+            module: moduleData || undefined,
+            markdownPreview
+        };
+    }
+    async listSessions(input) {
+        if (!input.project) {
+            // 列出所有项目的 sessions
+            const projects = await this.storage.listProjects();
+            let allSessions = [];
+            for (const project of projects) {
+                const sessions = await this.storage.listSessions(project, {
+                    module: input.module,
+                    limit: input.limit,
+                    includeArchived: input.includeArchived
+                });
+                allSessions.push(...sessions);
+            }
+            // 按时间倒序排序
+            allSessions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+            const limit = input.limit || 20;
+            allSessions = allSessions.slice(0, limit);
+            const summaries = allSessions.map(s => ({
+                sessionId: s.sessionId,
+                project: s.project,
+                module: s.module,
+                summary: s.summary,
+                createdAt: s.createdAt,
+                status: s.status
+            }));
+            return {
+                sessions: summaries,
+                total: summaries.length
+            };
+        }
+        // 列出指定项目的 sessions
+        const sessions = await this.storage.listSessions(input.project, {
+            module: input.module,
+            limit: input.limit,
+            includeArchived: input.includeArchived
+        });
+        const summaries = sessions.map(s => ({
+            sessionId: s.sessionId,
+            project: s.project,
+            module: s.module,
+            summary: s.summary,
+            createdAt: s.createdAt,
+            status: s.status
+        }));
+        return {
+            sessions: summaries,
+            total: summaries.length
+        };
+    }
+    async deleteSession(input) {
+        // 查找 session 所属项目
+        let projectName = null;
+        const projects = await this.storage.listProjects();
+        for (const project of projects) {
+            const session = await this.storage.loadSession(project, input.sessionId);
+            if (session) {
+                projectName = project;
+                break;
+            }
+        }
+        if (!projectName) {
+            return {
+                success: false,
+                message: `会话 ${input.sessionId} 不存在`
+            };
+        }
+        const success = await this.storage.deleteSession(projectName, input.sessionId);
+        return {
+            success,
+            message: success
+                ? `会话 ${input.sessionId} 已删除`
+                : `删除会话 ${input.sessionId} 失败`
+        };
+    }
+    async archiveSession(input) {
+        // 查找 session 所属项目
+        let projectName = null;
+        const projects = await this.storage.listProjects();
+        for (const project of projects) {
+            const session = await this.storage.loadSession(project, input.sessionId);
+            if (session) {
+                projectName = project;
+                break;
+            }
+        }
+        if (!projectName) {
+            return {
+                success: false,
+                message: `会话 ${input.sessionId} 不存在`
+            };
+        }
+        const success = await this.storage.archiveSession(projectName, input.sessionId);
+        return {
+            success,
+            message: success
+                ? `会话 ${input.sessionId} 已归档`
+                : `会话 ${input.sessionId} 不存在`
+        };
+    }
+    async unarchiveSession(input) {
+        // 查找 session 所属项目
+        let projectName = null;
+        const projects = await this.storage.listProjects();
+        for (const project of projects) {
+            const session = await this.storage.loadSession(project, input.sessionId);
+            if (session) {
+                projectName = project;
+                break;
+            }
+        }
+        if (!projectName) {
+            return {
+                success: false,
+                message: `会话 ${input.sessionId} 不存在`
+            };
+        }
+        const success = await this.storage.unarchiveSession(projectName, input.sessionId);
+        return {
+            success,
+            message: success
+                ? `会话 ${input.sessionId} 已取消归档`
+                : `会话 ${input.sessionId} 不存在`
+        };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/managers/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/managers/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAoBhC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,cAAc;IACjB,OAAO,CAAiB;IAEhC,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,cAAc,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,UAAU;QACV,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,WAAW;YACX,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;QAC/E,CAAC;QAED,mCAAmC;QACnC,MAAM,WAAW,GAA6C,EAAE,CAAC;QACjE,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,MAAM,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC7B,MAAM,OAAO,GAAY;oBACvB,SAAS;oBACT,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,UAAU,EAAG,QAAQ;oBAC7B,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,QAAQ,EAAE,YAAY,CAAC,QAAQ;oBAC/B,IAAI,EAAE,YAAY,CAAC,IAAI,IAAI,EAAE;oBAC7B,SAAS;oBACT,SAAS;iBACV,CAAC;gBACF,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACxC,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,MAAM,GAAsB,QAAQ,CAAC;QACzC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,WAAW,CAAC;QACvB,CAAC;QAED,MAAM,OAAO,GAAY;YACvB,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI;gBAC5B,aAAa,EAAE,EAAE;gBACjB,aAAa,EAAE,EAAE;gBACjB,kBAAkB,EAAE,EAAE;aACvB;YACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;YAChC,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,KAAK;YACZ,MAAM;YACN,QAAQ,EAAE;gBACR,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;gBACjC,OAAO,EAAE,OAAO;aACjB;SACF,CAAC;QAEF,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAExC,gCAAgC;QAChC,IAAI,UAAU,IAAI,KAAK,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACvE,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;gBAC/B,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS;YACT,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;SAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,IAAI,OAAO,GAAmB,IAAI,CAAC;QAEnC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,6BAA6B;YAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YACnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;gBACnE,IAAI,OAAO;oBAAE,MAAM;YACrB,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACzB,kBAAkB;YAClB,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,YAAY;QACZ,IAAI,UAA8B,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QAC1F,CAAC;QAED,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,iBAAiB;YACjB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAQ,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QAChF,CAAC,CAAC,CACH,CAAC;QACF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAgB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAEvE,MAAM,eAAe,GAAG,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;QAEpF,OAAO;YACL,OAAO;YACP,MAAM,EAAE,UAAU,IAAI,SAAS;YAC/B,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwB;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,mBAAmB;YACnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YACnD,IAAI,WAAW,GAAU,EAAE,CAAC;YAE5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE;oBACxD,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,eAAe,EAAE,KAAK,CAAC,eAAe;iBACvC,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAChC,CAAC;YAED,UAAU;YACV,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAE9F,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAE1C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtC,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,SAAS,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE;YAC9D,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnC,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAyB;QAC3C,kBAAkB;QAClB,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAEnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACzE,IAAI,OAAO,EAAE,CAAC;gBACZ,WAAW,GAAG,OAAO,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,MAAM,KAAK,CAAC,SAAS,MAAM;aACrC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAE/E,OAAO;YACL,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,MAAM;gBAC7B,CAAC,CAAC,QAAQ,KAAK,CAAC,SAAS,KAAK;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,kBAAkB;QAClB,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAEnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACzE,IAAI,OAAO,EAAE,CAAC;gBACZ,WAAW,GAAG,OAAO,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,MAAM,KAAK,CAAC,SAAS,MAAM;aACrC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAEhF,OAAO;YACL,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,MAAM;gBAC7B,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,MAAM;SAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAA4B;QACjD,kBAAkB;QAClB,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAEnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACzE,IAAI,OAAO,EAAE,CAAC;gBACZ,WAAW,GAAG,OAAO,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,MAAM,KAAK,CAAC,SAAS,MAAM;aACrC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAElF,OAAO;YACL,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,QAAQ;gBAC/B,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,MAAM;SAChC,CAAC;IACJ,CAAC;CACF"}

package/dist/managers/storage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Storage Manager - 单文件项目存储
+ * 支持原子写入：先写临时文件，再重命名
+ * ~/.session-handoff/projects/{project}.json
+ */
+import type { ProjectFile } from '../types.js';
+export declare class StorageManager {
+    private baseDir;
+    constructor(customPath?: string);
+    getBaseDir(): string;
+    private getProjectsDir;
+    private getProjectPath;
+    private getHandoffsDir;
+    private getHandoffPath;
+    private ensureDir;
+    /**
+     * 原子写入文件
+     * 1. 写入临时文件
+     * 2. 重命名为目标文件
+     * 保证写入操作的原子性
+     */
+    private atomicWrite;
+    loadProjectFile(project: string): Promise<ProjectFile | null>;
+    /**
+     * 原子保存项目文件
+     * 使用临时文件+重命名保证原子性
+     */
+    saveProjectFile(projectFile: ProjectFile): Promise<void>;
+    createProjectFile(project: string): Promise<ProjectFile>;
+    ensureProjectFile(project: string): Promise<ProjectFile>;
+    deleteProjectFile(project: string): Promise<boolean>;
+    listProjects(): Promise<Array<{
+        name: string;
+        modifiedAt: Date;
+    }>>;
+    /**
+     * 原子保存交接文档
+     */
+    saveHandoff(handoffId: string, markdown: string): Promise<string>;
+    loadHandoff(handoffId: string): Promise<string | null>;
+    listHandoffs(limit?: number): Promise<Array<{
+        handoffId: string;
+        createdAt: string;
+    }>>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/managers/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/managers/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,CAAC,EAAE,MAAM;IAI/B,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;YAIR,SAAS;IAMvB;;;;;OAKG;YACW,WAAW;IA4BnB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUnE;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpD,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAoBxE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMtD,YAAY,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAqBjG"}

package/dist/managers/storage.js

@@ -0,0 +1,166 @@
+/**
+ * Storage Manager - 单文件项目存储
+ * 支持原子写入：先写临时文件，再重命名
+ * ~/.session-handoff/projects/{project}.json
+ */
+import { mkdir, writeFile, readFile, readdir, unlink, rename, stat } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+const VERSION = '2.0.0';
+export class StorageManager {
+    baseDir;
+    constructor(customPath) {
+        this.baseDir = customPath || join(homedir(), '.session-handoff');
+    }
+    getBaseDir() {
+        return this.baseDir;
+    }
+    getProjectsDir() {
+        return join(this.baseDir, 'projects');
+    }
+    getProjectPath(project) {
+        return join(this.getProjectsDir(), `${project}.json`);
+    }
+    getHandoffsDir() {
+        return join(this.baseDir, 'handoffs');
+    }
+    getHandoffPath(handoffId) {
+        return join(this.getHandoffsDir(), `${handoffId}.md`);
+    }
+    async ensureDir(dir) {
+        await mkdir(dir, { recursive: true });
+    }
+    // ============ 原子文件写入 ============
+    /**
+     * 原子写入文件
+     * 1. 写入临时文件
+     * 2. 重命名为目标文件
+     * 保证写入操作的原子性
+     */
+    async atomicWrite(filePath, content) {
+        const dir = dirname(filePath);
+        const tempPath = join(dir, `.tmp_${Date.now()}_${Math.random().toString(36).slice(2)}`);
+        try {
+            // 1. 确保目录存在
+            await this.ensureDir(dir);
+            // 2. 写入临时文件
+            await writeFile(tempPath, content, 'utf-8');
+            // 3. 原子重命名
+            await rename(tempPath, filePath);
+        }
+        catch (error) {
+            // 清理临时文件
+            try {
+                if (existsSync(tempPath)) {
+                    await unlink(tempPath);
+                }
+            }
+            catch {
+                // 忽略清理错误
+            }
+            throw error;
+        }
+    }
+    // ============ 项目文件操作 ============
+    async loadProjectFile(project) {
+        const filePath = this.getProjectPath(project);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    /**
+     * 原子保存项目文件
+     * 使用临时文件+重命名保证原子性
+     */
+    async saveProjectFile(projectFile) {
+        const filePath = this.getProjectPath(projectFile.project);
+        // 更新元数据
+        projectFile.metadata.updatedAt = new Date().toISOString();
+        // 原子写入
+        await this.atomicWrite(filePath, JSON.stringify(projectFile, null, 2));
+    }
+    async createProjectFile(project) {
+        const now = new Date().toISOString();
+        const projectFile = {
+            project,
+            metadata: {
+                createdAt: now,
+                updatedAt: now,
+                version: VERSION
+            },
+            modules: {},
+            sessions: [],
+            pitfalls: []
+        };
+        await this.saveProjectFile(projectFile);
+        return projectFile;
+    }
+    async ensureProjectFile(project) {
+        let projectFile = await this.loadProjectFile(project);
+        if (!projectFile) {
+            projectFile = await this.createProjectFile(project);
+        }
+        return projectFile;
+    }
+    async deleteProjectFile(project) {
+        const filePath = this.getProjectPath(project);
+        if (!existsSync(filePath))
+            return false;
+        await unlink(filePath);
+        return true;
+    }
+    // ============ 项目列表 ============
+    async listProjects() {
+        const projectsDir = this.getProjectsDir();
+        if (!existsSync(projectsDir))
+            return [];
+        const files = await readdir(projectsDir);
+        const projects = [];
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                const name = file.replace('.json', '');
+                const statInfo = await stat(join(projectsDir, file));
+                projects.push({ name, modifiedAt: statInfo.mtime });
+            }
+        }
+        return projects.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
+    }
+    // ============ Handoff 操作 ============
+    /**
+     * 原子保存交接文档
+     */
+    async saveHandoff(handoffId, markdown) {
+        const filePath = this.getHandoffPath(handoffId);
+        await this.atomicWrite(filePath, markdown);
+        return filePath;
+    }
+    async loadHandoff(handoffId) {
+        const filePath = this.getHandoffPath(handoffId);
+        if (!existsSync(filePath))
+            return null;
+        return readFile(filePath, 'utf-8');
+    }
+    async listHandoffs(limit = 20) {
+        const handoffsDir = this.getHandoffsDir();
+        if (!existsSync(handoffsDir))
+            return [];
+        const files = await readdir(handoffsDir);
+        const handoffs = [];
+        for (const file of files) {
+            if (file.endsWith('.md')) {
+                const handoffId = file.replace('.md', '');
+                const statInfo = await stat(join(handoffsDir, file));
+                handoffs.push({
+                    handoffId,
+                    createdAt: statInfo.ctime.toISOString()
+                });
+            }
+        }
+        handoffs.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        return handoffs.slice(0, limit);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/managers/storage.js.map

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