@zeliper/zscode-mcp-server 1.0.2 → 1.0.3

package/dist/tools/summary.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { StateManager } from "../state/manager.js";
+import { withErrorHandling, ProjectNotInitializedError } from "../errors/index.js";
+/**
+ * Register summary-related tools
+ * Summary generates a project overview that's auto-injected with general memories
+ */
+export function registerSummaryTools(server) {
+    // ============ generate_summary ============
+    server.tool("generate_summary", "Generate or update the project summary. Creates a memory in 'project-summary' category that is automatically included with get_full_context and zscode:start. Run again to update with current project state.", {
+        customContent: z.string().optional().describe("Optional custom content to use instead of auto-generated summary. If not provided, summary is auto-generated from current project state."),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const existingSummary = manager.getProjectSummary();
+            const isUpdate = existingSummary !== undefined;
+            const memory = await manager.saveProjectSummary(args.customContent);
+            return {
+                success: true,
+                action: isUpdate ? "updated" : "created",
+                message: isUpdate
+                    ? `Project summary updated. Memory ID: ${memory.id}`
+                    : `Project summary created. Memory ID: ${memory.id}`,
+                memory: {
+                    id: memory.id,
+                    category: memory.category,
+                    title: memory.title,
+                    priority: memory.priority,
+                    contentPreview: memory.content.substring(0, 200) + (memory.content.length > 200 ? "..." : ""),
+                },
+                note: "This summary will be automatically included in get_full_context and zscode:start responses.",
+            };
+        }, "generate_summary");
+        if (result.success) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }],
+            };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: JSON.stringify(result.error, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+    // ============ get_project_summary ============
+    server.tool("get_project_summary", "Get the current project summary content. Returns the auto-generated summary if no custom summary exists.", {}, async () => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const existingSummary = manager.getProjectSummary();
+            const generatedContent = manager.generateProjectSummaryContent();
+            if (existingSummary) {
+                return {
+                    success: true,
+                    exists: true,
+                    memory: {
+                        id: existingSummary.id,
+                        title: existingSummary.title,
+                        content: existingSummary.content,
+                        updatedAt: existingSummary.updatedAt,
+                    },
+                    generatedPreview: generatedContent.substring(0, 500) + (generatedContent.length > 500 ? "..." : ""),
+                    note: "Use generate_summary to update with latest project state.",
+                };
+            }
+            else {
+                return {
+                    success: true,
+                    exists: false,
+                    generatedContent,
+                    note: "No summary exists yet. Use generate_summary to create one.",
+                };
+            }
+        }, "get_project_summary");
+        if (result.success) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }],
+            };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: JSON.stringify(result.error, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+    // ============ delete_project_summary ============
+    server.tool("delete_project_summary", "Delete the project summary memory. The summary will no longer be auto-injected.", {}, async () => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const existingSummary = manager.getProjectSummary();
+            if (!existingSummary) {
+                return {
+                    success: false,
+                    message: "No project summary exists to delete.",
+                };
+            }
+            await manager.removeMemory(existingSummary.id);
+            return {
+                success: true,
+                message: "Project summary deleted.",
+                deletedMemoryId: existingSummary.id,
+            };
+        }, "delete_project_summary");
+        if (result.success) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }],
+            };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: JSON.stringify(result.error, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=summary.js.map

package/dist/tools/summary.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeliper/zscode-mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "ZSCode MCP Server for Claude Code - Project planning and task management",
   "publishConfig": {
     "access": "public"