@zeliper/zscode-mcp-server 1.0.0

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all ZSCode MCP tools
+ */
+export declare function registerAllTools(server: McpServer, projectRoot: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAkB7E"}

package/dist/tools/index.js

@@ -0,0 +1,24 @@
+import { registerContextTools } from "./context.js";
+import { registerPlanTools } from "./plan.js";
+import { registerStagingTools } from "./staging.js";
+import { registerStatusTool } from "./status.js";
+import { registerArchiveTool } from "./archive.js";
+import { registerCancelTool } from "./cancel.js";
+/**
+ * Register all ZSCode MCP tools
+ */
+export function registerAllTools(server, projectRoot) {
+    // Context tools: get_full_context, init_project
+    registerContextTools(server, projectRoot);
+    // Plan tools: create_plan, sync_plan, update_task
+    registerPlanTools(server);
+    // Staging tools: zscode:start, complete_staging, save_task_output, get_staging_artifacts
+    registerStagingTools(server, projectRoot);
+    // Status tool: zscode:status
+    registerStatusTool(server);
+    // Archive tool: zscode:archive
+    registerArchiveTool(server);
+    // Cancel tool: zscode:cancel
+    registerCancelTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,WAAmB;IACrE,gDAAgD;IAChD,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAE1C,kDAAkD;IAClD,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,yFAAyF;IACzF,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAE1C,6BAA6B;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,+BAA+B;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,6BAA6B;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/tools/plan.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register plan-related tools
+ */
+export declare function registerPlanTools(server: McpServer): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/tools/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwNzD"}

package/dist/tools/plan.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import { StateManager } from "../state/manager.js";
+import { withErrorHandling, ProjectNotInitializedError, TaskNotFoundError } from "../errors/index.js";
+/**
+ * Register plan-related tools
+ */
+export function registerPlanTools(server) {
+    // ============ create_plan ============
+    server.tool("create_plan", "Create a new plan with stagings and tasks. Plans organize work into sequential staging phases, each containing parallel or sequential tasks.", {
+        title: z.string().describe("Plan title"),
+        description: z.string().optional().describe("Plan description"),
+        stagings: z.array(z.object({
+            name: z.string().describe("Staging name (e.g., 'Phase 1: Setup')"),
+            description: z.string().optional().describe("Staging description"),
+            execution_type: z.enum(["parallel", "sequential"]).default("parallel")
+                .describe("How tasks in this staging are executed"),
+            tasks: z.array(z.object({
+                title: z.string().describe("Task title"),
+                description: z.string().optional().describe("Task description"),
+                priority: z.enum(["high", "medium", "low"]).default("medium").describe("Task priority"),
+                execution_mode: z.enum(["parallel", "sequential"]).default("parallel")
+                    .describe("Execution mode within staging"),
+                depends_on_index: z.array(z.number().int().min(0)).default([])
+                    .describe("Indices of tasks this task depends on (within same staging)"),
+            })).describe("Tasks in this staging"),
+        })).describe("Staging phases in execution order"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const stagingConfigs = args.stagings.map(s => ({
+                name: s.name,
+                description: s.description,
+                execution_type: s.execution_type,
+                tasks: s.tasks.map(t => ({
+                    title: t.title,
+                    description: t.description,
+                    priority: t.priority,
+                    execution_mode: t.execution_mode,
+                    depends_on_index: t.depends_on_index,
+                })),
+            }));
+            const plan = await manager.createPlan(args.title, args.description, stagingConfigs);
+            // Get created stagings and tasks for response
+            const stagings = manager.getStagingsByPlan(plan.id);
+            const taskCount = stagings.reduce((sum, s) => sum + s.tasks.length, 0);
+            return {
+                success: true,
+                message: `Plan "${args.title}" created with ${stagings.length} stagings and ${taskCount} tasks`,
+                plan: {
+                    id: plan.id,
+                    title: plan.title,
+                    status: plan.status,
+                    stagings: stagings.map(s => ({
+                        id: s.id,
+                        name: s.name,
+                        order: s.order,
+                        execution_type: s.execution_type,
+                        taskCount: s.tasks.length,
+                    })),
+                },
+            };
+        }, "create_plan");
+        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,
+            };
+        }
+    });
+    // ============ update_task ============
+    server.tool("update_task", "Update a task's status. Use this to mark tasks as in_progress, done, or blocked.", {
+        taskId: z.string().describe("Task ID to update"),
+        status: z.enum(["pending", "in_progress", "done", "blocked", "cancelled"])
+            .describe("New task status"),
+        notes: z.string().optional().describe("Notes about the status change"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const task = manager.getTask(args.taskId);
+            if (!task) {
+                throw new TaskNotFoundError(args.taskId);
+            }
+            const previousStatus = task.status;
+            await manager.updateTaskStatus(args.taskId, args.status, args.notes);
+            return {
+                success: true,
+                message: `Task status updated: ${previousStatus} -> ${args.status}`,
+                task: {
+                    id: task.id,
+                    title: task.title,
+                    previousStatus,
+                    newStatus: args.status,
+                    notes: args.notes,
+                },
+            };
+        }, "update_task");
+        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,
+            };
+        }
+    });
+    // ============ sync_plan ============
+    server.tool("sync_plan", "Synchronize plan status based on current task states. Automatically completes stagings and plans when all tasks are done.", {
+        planId: z.string().describe("Plan ID to synchronize"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const plan = manager.getPlan(args.planId);
+            if (!plan) {
+                throw new Error(`Plan not found: ${args.planId}`);
+            }
+            // Get all stagings and their status
+            const stagings = manager.getStagingsByPlan(args.planId);
+            const stagingStatus = stagings.map(staging => {
+                const tasks = manager.getTasksByStaging(staging.id);
+                const completedTasks = tasks.filter(t => t.status === "done").length;
+                const totalTasks = tasks.length;
+                const allDone = totalTasks > 0 && completedTasks === totalTasks;
+                return {
+                    id: staging.id,
+                    name: staging.name,
+                    status: staging.status,
+                    completedTasks,
+                    totalTasks,
+                    allTasksDone: allDone,
+                };
+            });
+            // Auto-complete stagings where all tasks are done
+            for (const s of stagingStatus) {
+                if (s.allTasksDone && s.status === "in_progress") {
+                    await manager.completestaging(s.id);
+                    s.status = "completed";
+                }
+            }
+            // Check if plan is complete
+            const allStagingsComplete = stagingStatus.every(s => s.status === "completed");
+            if (allStagingsComplete && plan.status === "active") {
+                await manager.updatePlanStatus(args.planId, "completed");
+            }
+            const updatedPlan = manager.getPlan(args.planId);
+            return {
+                success: true,
+                message: "Plan synchronized",
+                plan: {
+                    id: updatedPlan.id,
+                    title: updatedPlan.title,
+                    status: updatedPlan.status,
+                },
+                stagings: stagingStatus,
+            };
+        }, "sync_plan");
+        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=plan.js.map

package/dist/tools/plan.js.map

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

package/dist/tools/staging.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register staging-related tools
+ */
+export declare function registerStagingTools(server: McpServer, projectRoot: string): void;
+//# sourceMappingURL=staging.d.ts.map

package/dist/tools/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../../src/tools/staging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA8QjF"}

package/dist/tools/staging.js

@@ -0,0 +1,224 @@
+import { z } from "zod";
+import { StateManager } from "../state/manager.js";
+import { ArtifactsManager } from "../utils/artifacts.js";
+import { withErrorHandling, ProjectNotInitializedError, PlanNotFoundError, StagingNotFoundError, StagingPlanMismatchError, } from "../errors/index.js";
+/**
+ * Register staging-related tools
+ */
+export function registerStagingTools(server, projectRoot) {
+    const artifactsManager = new ArtifactsManager(projectRoot);
+    // ============ zscode:start ============
+    server.tool("zscode:start", "Start a specific staging phase of a plan. Sets the staging status to 'in_progress' and prepares the artifacts directory. Use this when you're ready to begin work on a staging.", {
+        planId: z.string().describe("Plan ID (e.g., plan-abc12345)"),
+        stagingId: z.string().describe("Staging ID to start (e.g., staging-0001)"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const plan = manager.getPlan(args.planId);
+            if (!plan) {
+                throw new PlanNotFoundError(args.planId);
+            }
+            const staging = manager.getStaging(args.stagingId);
+            if (!staging) {
+                throw new StagingNotFoundError(args.stagingId);
+            }
+            if (staging.planId !== args.planId) {
+                throw new StagingPlanMismatchError(args.stagingId, args.planId, staging.planId);
+            }
+            // Start the staging
+            const startedStaging = await manager.startStaging(args.planId, args.stagingId);
+            // Create artifacts directory
+            await artifactsManager.createStagingArtifactsDir(args.planId, args.stagingId);
+            // Get executable tasks
+            const executableTasks = manager.getExecutableTasks(args.stagingId);
+            const allTasks = manager.getTasksByStaging(args.stagingId);
+            return {
+                success: true,
+                message: `Staging "${startedStaging.name}" started`,
+                staging: {
+                    id: startedStaging.id,
+                    name: startedStaging.name,
+                    status: startedStaging.status,
+                    execution_type: startedStaging.execution_type,
+                },
+                artifactsPath: startedStaging.artifacts_path,
+                tasks: {
+                    total: allTasks.length,
+                    executable: executableTasks.map(t => ({
+                        id: t.id,
+                        title: t.title,
+                        priority: t.priority,
+                        execution_mode: t.execution_mode,
+                        depends_on: t.depends_on,
+                    })),
+                    pending: allTasks.filter(t => t.status === "pending").length,
+                },
+            };
+        }, "zscode:start");
+        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,
+            };
+        }
+    });
+    // ============ complete_staging ============
+    server.tool("complete_staging", "Manually complete a staging. Usually stagings are auto-completed when all tasks are done, but this can be used to force completion.", {
+        stagingId: z.string().describe("Staging ID to complete"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const staging = manager.getStaging(args.stagingId);
+            if (!staging) {
+                throw new StagingNotFoundError(args.stagingId);
+            }
+            await manager.completestaging(args.stagingId);
+            return {
+                success: true,
+                message: `Staging "${staging.name}" completed`,
+                staging: {
+                    id: staging.id,
+                    name: staging.name,
+                    status: "completed",
+                },
+            };
+        }, "complete_staging");
+        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,
+            };
+        }
+    });
+    // ============ save_task_output ============
+    server.tool("save_task_output", "Save the output/result of a completed task. This stores artifacts that can be used by subsequent tasks.", {
+        planId: z.string().describe("Plan ID"),
+        stagingId: z.string().describe("Staging ID"),
+        taskId: z.string().describe("Task ID"),
+        output: z.object({
+            status: z.enum(["success", "failure", "partial"]).describe("Output status"),
+            summary: z.string().describe("Summary of what was accomplished"),
+            artifacts: z.array(z.string()).default([]).describe("Paths to created files"),
+            data: z.record(z.unknown()).optional().describe("Arbitrary data to pass to next tasks"),
+            error: z.string().optional().describe("Error message if failed"),
+        }).describe("Task output data"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const task = manager.getTask(args.taskId);
+            if (!task) {
+                throw new Error(`Task not found: ${args.taskId}`);
+            }
+            const output = {
+                status: args.output.status,
+                summary: args.output.summary,
+                artifacts: args.output.artifacts,
+                data: args.output.data,
+                error: args.output.error,
+                completedAt: new Date().toISOString(),
+            };
+            // Save to state
+            await manager.saveTaskOutput(args.taskId, output);
+            // Save to artifacts file
+            const outputPath = await artifactsManager.saveTaskOutput(args.planId, args.stagingId, args.taskId, output);
+            return {
+                success: true,
+                message: "Task output saved",
+                task: {
+                    id: task.id,
+                    title: task.title,
+                },
+                outputPath,
+                output,
+            };
+        }, "save_task_output");
+        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_staging_artifacts ============
+    server.tool("get_staging_artifacts", "Get all artifacts (task outputs) from a completed staging. Use this to access results from previous stagings.", {
+        planId: z.string().describe("Plan ID"),
+        stagingId: z.string().describe("Staging ID to get artifacts from"),
+        taskId: z.string().optional().describe("Specific task ID (optional, if omitted returns all)"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const staging = manager.getStaging(args.stagingId);
+            if (!staging) {
+                throw new StagingNotFoundError(args.stagingId);
+            }
+            if (args.taskId) {
+                // Get specific task output
+                const output = await artifactsManager.getTaskOutput(args.planId, args.stagingId, args.taskId);
+                return {
+                    success: true,
+                    staging: {
+                        id: staging.id,
+                        name: staging.name,
+                        status: staging.status,
+                    },
+                    taskOutput: output,
+                };
+            }
+            else {
+                // Get all task outputs for staging
+                const outputs = await artifactsManager.getStagingOutputs(args.planId, args.stagingId);
+                const files = await artifactsManager.listStagingArtifacts(args.planId, args.stagingId);
+                return {
+                    success: true,
+                    staging: {
+                        id: staging.id,
+                        name: staging.name,
+                        status: staging.status,
+                        artifacts_path: staging.artifacts_path,
+                    },
+                    taskOutputs: outputs,
+                    files,
+                };
+            }
+        }, "get_staging_artifacts");
+        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=staging.js.map

package/dist/tools/staging.js.map

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

package/dist/tools/status.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register status tool
+ */
+export declare function registerStatusTool(server: McpServer): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqC1D"}

package/dist/tools/status.js

@@ -0,0 +1,144 @@
+import { z } from "zod";
+import { StateManager } from "../state/manager.js";
+import { withErrorHandling, ProjectNotInitializedError, PlanNotFoundError, } from "../errors/index.js";
+/**
+ * Register status tool
+ */
+export function registerStatusTool(server) {
+    // ============ zscode:status ============
+    server.tool("zscode:status", "Get the status of all plans or a specific plan. Shows progress, current staging, and task completion. Use without planId for overview, with planId for detailed view.", {
+        planId: z.string().optional().describe("Plan ID for detailed status (omit for overview of all plans)"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            if (args.planId) {
+                // Detailed status for specific plan
+                return getDetailedPlanStatus(manager, args.planId);
+            }
+            else {
+                // Overview of all plans
+                return getAllPlansStatus(manager);
+            }
+        }, "zscode:status");
+        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 overview status of all plans
+ */
+function getAllPlansStatus(manager) {
+    const allPlans = manager.getAllPlans();
+    const overview = {
+        totalPlans: allPlans.length,
+        activePlans: allPlans.filter(p => p.status === "active").length,
+        completedPlans: allPlans.filter(p => p.status === "completed").length,
+        archivedPlans: allPlans.filter(p => p.status === "archived").length,
+        cancelledPlans: allPlans.filter(p => p.status === "cancelled").length,
+    };
+    const planSummaries = allPlans.map(plan => {
+        const stagings = manager.getStagingsByPlan(plan.id);
+        const completedStagings = stagings.filter(s => s.status === "completed").length;
+        let totalTasks = 0;
+        let completedTasks = 0;
+        for (const staging of stagings) {
+            const tasks = manager.getTasksByStaging(staging.id);
+            totalTasks += tasks.length;
+            completedTasks += tasks.filter(t => t.status === "done").length;
+        }
+        const percentage = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+        const currentStaging = plan.currentStagingId
+            ? manager.getStaging(plan.currentStagingId)
+            : undefined;
+        return {
+            id: plan.id,
+            title: plan.title,
+            status: plan.status,
+            progress: {
+                totalStagings: stagings.length,
+                completedStagings,
+                totalTasks,
+                completedTasks,
+                percentage,
+            },
+            currentStaging: currentStaging
+                ? {
+                    id: currentStaging.id,
+                    name: currentStaging.name,
+                    status: currentStaging.status,
+                }
+                : undefined,
+        };
+    });
+    const state = manager.getState();
+    return {
+        success: true,
+        overview,
+        plans: planSummaries,
+        currentContext: {
+            planId: state?.context.currentPlanId,
+            stagingId: state?.context.currentStagingId,
+        },
+    };
+}
+/**
+ * Get detailed status for a specific plan
+ */
+function getDetailedPlanStatus(manager, planId) {
+    const plan = manager.getPlan(planId);
+    if (!plan) {
+        throw new PlanNotFoundError(planId);
+    }
+    const stagings = manager.getStagingsByPlan(planId);
+    const state = manager.getState();
+    const decisions = state?.context.decisions.filter(d => d.relatedPlanId === planId) ?? [];
+    const stagingDetails = stagings.map(staging => {
+        const tasks = manager.getTasksByStaging(staging.id);
+        const completedTasks = tasks.filter(t => t.status === "done").length;
+        return {
+            id: staging.id,
+            name: staging.name,
+            order: staging.order,
+            status: staging.status,
+            execution_type: staging.execution_type,
+            taskCount: tasks.length,
+            completedTaskCount: completedTasks,
+            tasks: tasks.map(task => ({
+                id: task.id,
+                title: task.title,
+                status: task.status,
+                priority: task.priority,
+                execution_mode: task.execution_mode,
+                depends_on: task.depends_on,
+                hasOutput: !!task.output,
+            })),
+        };
+    });
+    const planDetail = {
+        id: plan.id,
+        title: plan.title,
+        description: plan.description,
+        status: plan.status,
+        stagings: stagingDetails,
+        decisions,
+        createdAt: plan.createdAt,
+        updatedAt: plan.updatedAt,
+    };
+    return {
+        success: true,
+        plan: planDetail,
+    };
+}
+//# sourceMappingURL=status.js.map