session-weaver 1.1.1

package/dist/types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Session Handoff MCP - 数据类型定义
+ * 7工具完整版架构
+ */
+export type ModuleStatus = 'active' | 'completed' | 'archived';
+export type SessionStatus = 'active' | 'completed' | 'archived';
+export interface ModuleDecision {
+    description: string;
+    reason?: string;
+    createdAt: string;
+}
+export interface Module {
+    name: string;
+    status: ModuleStatus;
+    summary: string;
+    todos: string[];
+    decisions: ModuleDecision[];
+    techStack: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CodeState {
+    modifiedFiles: string[];
+    currentBranch?: string;
+    uncommittedChanges?: string;
+}
+export interface SessionDecision {
+    description: string;
+    reason: string;
+    alternatives?: string[];
+}
+export interface SessionTodo {
+    task: string;
+    priority?: 'high' | 'medium' | 'low';
+    done?: boolean;
+}
+export interface SessionPitfallRef {
+    pitfallId: string;
+    problem: string;
+}
+export interface Session {
+    sessionId: string;
+    project: string;
+    module?: string;
+    createdAt: string;
+    summary: string;
+    techStack: string[];
+    codeState: CodeState;
+    decisions: SessionDecision[];
+    pitfalls: SessionPitfallRef[];
+    todos: SessionTodo[];
+    status: SessionStatus;
+    metadata: {
+        aiTool: string;
+        version: string;
+    };
+}
+export interface Pitfall {
+    pitfallId: string;
+    project: string;
+    module?: string;
+    problem: string;
+    solution: string;
+    tags: string[];
+    sessionId?: string;
+    createdAt: string;
+}
+export interface ProjectFile {
+    project: string;
+    metadata: {
+        createdAt: string;
+        updatedAt: string;
+        version: string;
+    };
+    currentModule?: string;
+    modules: Record<string, Module>;
+    sessions: Session[];
+    pitfalls: Pitfall[];
+}
+export interface LoadContextInput {
+    project: string;
+    module?: string;
+    includePitfalls?: boolean;
+    sessionsLimit?: number;
+}
+export interface LoadContextOutput {
+    project: string;
+    module: string;
+    moduleData: Module;
+    recentSessions: Array<{
+        sessionId: string;
+        summary: string;
+        createdAt: string;
+        status: SessionStatus;
+    }>;
+    relatedPitfalls: Array<{
+        pitfallId: string;
+        problem: string;
+        solution: string;
+        tags: string[];
+        createdAt: string;
+    }>;
+    stats: {
+        totalSessions: number;
+        totalPitfalls: number;
+        totalModules: number;
+    };
+}
+export interface SaveContextInput {
+    project: string;
+    module?: string;
+    moduleUpdate?: {
+        status?: ModuleStatus;
+        summary?: string;
+        todos?: string[];
+        addTodos?: string[];
+        removeTodos?: string[];
+        addDecision?: {
+            description: string;
+            reason?: string;
+        };
+        techStack?: string[];
+    };
+    session?: {
+        note: string;
+        codeState?: CodeState;
+        todos?: SessionTodo[];
+        decisions?: SessionDecision[];
+        techStack?: string[];
+    };
+    newPitfall?: {
+        problem: string;
+        solution: string;
+        tags?: string[];
+    };
+}
+export interface SaveContextOutput {
+    success: boolean;
+    project: string;
+    module: string;
+    updates: {
+        moduleUpdated: boolean;
+        sessionCreated?: string;
+        pitfallCreated?: string;
+    };
+}
+export interface ListModulesInput {
+    project?: string;
+    status?: ModuleStatus;
+    includeArchived?: boolean;
+    withStats?: boolean;
+}
+export interface ProjectSummary {
+    name: string;
+    moduleCount: number;
+    sessionCount: number;
+    lastActivityAt: string;
+    modules?: ModuleSummary[];
+}
+export interface ModuleSummary {
+    name: string;
+    status: ModuleStatus;
+    summary: string;
+    todoCount: number;
+    updatedAt: string;
+    sessionCount?: number;
+    pitfallCount?: number;
+    lastSessionAt?: string;
+}
+export interface ListModulesOutput {
+    type: 'projects' | 'modules';
+    projects: ProjectSummary[];
+    currentProject?: string;
+    currentModule?: string;
+    total: number;
+}
+export interface ListPitfallsInput {
+    project?: string;
+    module?: string;
+    tags?: string[];
+    limit?: number;
+}
+export interface PitfallSummary {
+    pitfallId: string;
+    project: string;
+    module?: string;
+    problem: string;
+    tags: string[];
+    createdAt: string;
+}
+export interface ListPitfallsOutput {
+    pitfalls: PitfallSummary[];
+    total: number;
+}
+export interface DeleteDataInput {
+    project: string;
+    sessionId?: string;
+    pitfallId?: string;
+    moduleName?: string;
+    entireProject?: boolean;
+}
+export interface DeleteDataOutput {
+    success: boolean;
+    deletedType: 'session' | 'pitfall' | 'module' | 'project';
+    deletedId?: string;
+    deletedCount?: {
+        sessions?: number;
+        pitfalls?: number;
+    };
+    message: string;
+}
+export interface ExportHandoffInput {
+    project: string;
+    includeModules?: boolean;
+    includeSessions?: boolean;
+    includePitfalls?: boolean;
+}
+export interface ExportHandoffOutput {
+    handoffId: string;
+    markdown: string;
+    exportedAt: string;
+}
+export interface ImportHandoffInput {
+    handoffId?: string;
+    markdown?: string;
+    projectName?: string;
+    aiTool?: string;
+}
+export interface ImportHandoffOutput {
+    success: boolean;
+    project: string;
+    importedModules: string[];
+    importedSessions: number;
+    importedPitfalls: number;
+    importedAt: string;
+    warnings?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Session Handoff MCP - 数据类型定义
+ * 7工具完整版架构
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/format.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 格式化工具 - 生成 Markdown 摘要和交接文档
+ * 按照 docs/05-session-template.md 的模板结构
+ */
+import type { Session, Pitfall, SessionTodo, SessionDecision, Module } from '../types.js';
+/**
+ * 格式化单个 Session 为 Markdown 摘要
+ * 用于 load_session 返回的 markdownPreview
+ */
+export declare function formatSessionToMarkdown(session: Session, pitfalls?: Pitfall[], module?: Module): string;
+/**
+ * 生成完整的交接文档 Markdown
+ * 按照 docs/05-session-template.md 的完整结构
+ */
+export declare function generateHandoffMarkdown(session: Session, allPitfalls?: Pitfall[], options?: {
+    includePitfalls?: boolean;
+}): string;
+/**
+ * 解析交接文档 Markdown
+ * 从 Markdown 中提取关键信息
+ */
+export declare function parseHandoffMarkdown(markdown: string): {
+    project?: string;
+    summary?: string;
+    techStack?: string[];
+    sessionId?: string;
+    todos?: SessionTodo[];
+    decisions?: SessionDecision[];
+    warnings: string[];
+};
+/**
+ * 格式化 Session 摘要
+ */
+export declare function formatSessionSummary(session: Session): string;
+/**
+ * 格式化 Pitfall 摘要
+ */
+export declare function formatPitfallSummary(pitfall: Pitfall): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,OAAO,EAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAyJ3G;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,OAAO,EAAO,EAC3B,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,MAAM,CA0PR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAuDA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7D"}