@zeliper/zscode-mcp-server 1.0.0

package/dist/errors/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Base error class for ZSCode
+ */
+export declare class ZSCodeError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * State-related errors
+ */
+export declare class StateError extends ZSCodeError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class StateNotFoundError extends StateError {
+    constructor(projectRoot: string);
+}
+export declare class StateValidationError extends StateError {
+    constructor(validationErrors: unknown[]);
+}
+export declare class ProjectNotInitializedError extends StateError {
+    constructor();
+}
+/**
+ * Plan-related errors
+ */
+export declare class PlanError extends ZSCodeError {
+    readonly planId: string;
+    constructor(message: string, planId: string, details?: Record<string, unknown>);
+}
+export declare class PlanNotFoundError extends PlanError {
+    constructor(planId: string);
+}
+export declare class PlanInvalidStateError extends PlanError {
+    constructor(planId: string, currentState: string, expectedStates: string[]);
+}
+export declare class PlanAlreadyExistsError extends PlanError {
+    constructor(planId: string);
+}
+/**
+ * Staging-related errors
+ */
+export declare class StagingError extends ZSCodeError {
+    readonly stagingId: string;
+    constructor(message: string, stagingId: string, details?: Record<string, unknown>);
+}
+export declare class StagingNotFoundError extends StagingError {
+    constructor(stagingId: string);
+}
+export declare class StagingOrderError extends StagingError {
+    constructor(stagingId: string, previousStagingId: string);
+}
+export declare class StagingInvalidStateError extends StagingError {
+    constructor(stagingId: string, currentState: string, expectedStates: string[]);
+}
+export declare class StagingPlanMismatchError extends StagingError {
+    constructor(stagingId: string, expectedPlanId: string, actualPlanId: string);
+}
+/**
+ * Task-related errors
+ */
+export declare class TaskError extends ZSCodeError {
+    readonly taskId: string;
+    constructor(message: string, taskId: string, details?: Record<string, unknown>);
+}
+export declare class TaskNotFoundError extends TaskError {
+    constructor(taskId: string);
+}
+export declare class TaskInvalidStateError extends TaskError {
+    constructor(taskId: string, currentState: string, expectedStates: string[]);
+}
+export declare class TaskDependencyError extends TaskError {
+    constructor(taskId: string, unmetDependencies: string[]);
+}
+/**
+ * File system errors
+ */
+export declare class FileSystemError extends ZSCodeError {
+    constructor(operation: string, path: string, originalError?: Error);
+}
+/**
+ * Validation errors
+ */
+export declare class ValidationError extends ZSCodeError {
+    constructor(message: string, field?: string, details?: Record<string, unknown>);
+}
+/**
+ * Get suggestion for error
+ */
+export declare function getSuggestion(error: ZSCodeError): string | undefined;
+/**
+ * Error handler wrapper for tools
+ */
+export interface ToolErrorResult {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+        suggestion?: string;
+    };
+}
+export declare function createToolErrorResult(error: unknown): ToolErrorResult;
+/**
+ * Async wrapper for tool handlers with error handling
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, context: string): Promise<{
+    success: true;
+    data: T;
+} | ToolErrorResult>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/errors/index.js

@@ -0,0 +1,231 @@
+/**
+ * Base error class for ZSCode
+ */
+export class ZSCodeError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.name = "ZSCodeError";
+        this.code = code;
+        this.details = details;
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            error: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+}
+/**
+ * State-related errors
+ */
+export class StateError extends ZSCodeError {
+    constructor(message, details) {
+        super(message, "STATE_ERROR", details);
+        this.name = "StateError";
+    }
+}
+export class StateNotFoundError extends StateError {
+    constructor(projectRoot) {
+        super(`state.json not found at ${projectRoot}/.claude/state.json`, {
+            projectRoot,
+            suggestion: "Run 'npx zscode init' to initialize the project",
+        });
+        this.name = "StateNotFoundError";
+    }
+}
+export class StateValidationError extends StateError {
+    constructor(validationErrors) {
+        super("state.json validation failed", { validationErrors });
+        this.name = "StateValidationError";
+    }
+}
+export class ProjectNotInitializedError extends StateError {
+    constructor() {
+        super("Project not initialized", {
+            suggestion: "Run 'npx zscode init' to initialize the project",
+        });
+        this.name = "ProjectNotInitializedError";
+    }
+}
+/**
+ * Plan-related errors
+ */
+export class PlanError extends ZSCodeError {
+    planId;
+    constructor(message, planId, details) {
+        super(message, "PLAN_ERROR", { planId, ...details });
+        this.name = "PlanError";
+        this.planId = planId;
+    }
+}
+export class PlanNotFoundError extends PlanError {
+    constructor(planId) {
+        super(`Plan not found: ${planId}`, planId, {
+            suggestion: "Use 'zscode:status' to see available plans",
+        });
+        this.name = "PlanNotFoundError";
+    }
+}
+export class PlanInvalidStateError extends PlanError {
+    constructor(planId, currentState, expectedStates) {
+        super(`Plan ${planId} is in '${currentState}' state, expected one of: ${expectedStates.join(", ")}`, planId, { currentState, expectedStates });
+        this.name = "PlanInvalidStateError";
+    }
+}
+export class PlanAlreadyExistsError extends PlanError {
+    constructor(planId) {
+        super(`Plan already exists: ${planId}`, planId);
+        this.name = "PlanAlreadyExistsError";
+    }
+}
+/**
+ * Staging-related errors
+ */
+export class StagingError extends ZSCodeError {
+    stagingId;
+    constructor(message, stagingId, details) {
+        super(message, "STAGING_ERROR", { stagingId, ...details });
+        this.name = "StagingError";
+        this.stagingId = stagingId;
+    }
+}
+export class StagingNotFoundError extends StagingError {
+    constructor(stagingId) {
+        super(`Staging not found: ${stagingId}`, stagingId);
+        this.name = "StagingNotFoundError";
+    }
+}
+export class StagingOrderError extends StagingError {
+    constructor(stagingId, previousStagingId) {
+        super(`Cannot start staging ${stagingId}: previous staging ${previousStagingId} is not completed`, stagingId, {
+            previousStagingId,
+            suggestion: "Complete the previous staging first or use 'zscode:cancel' to skip",
+        });
+        this.name = "StagingOrderError";
+    }
+}
+export class StagingInvalidStateError extends StagingError {
+    constructor(stagingId, currentState, expectedStates) {
+        super(`Staging ${stagingId} is in '${currentState}' state, expected one of: ${expectedStates.join(", ")}`, stagingId, { currentState, expectedStates });
+        this.name = "StagingInvalidStateError";
+    }
+}
+export class StagingPlanMismatchError extends StagingError {
+    constructor(stagingId, expectedPlanId, actualPlanId) {
+        super(`Staging ${stagingId} does not belong to plan ${expectedPlanId}`, stagingId, { expectedPlanId, actualPlanId });
+        this.name = "StagingPlanMismatchError";
+    }
+}
+/**
+ * Task-related errors
+ */
+export class TaskError extends ZSCodeError {
+    taskId;
+    constructor(message, taskId, details) {
+        super(message, "TASK_ERROR", { taskId, ...details });
+        this.name = "TaskError";
+        this.taskId = taskId;
+    }
+}
+export class TaskNotFoundError extends TaskError {
+    constructor(taskId) {
+        super(`Task not found: ${taskId}`, taskId);
+        this.name = "TaskNotFoundError";
+    }
+}
+export class TaskInvalidStateError extends TaskError {
+    constructor(taskId, currentState, expectedStates) {
+        super(`Task ${taskId} is in '${currentState}' state, expected one of: ${expectedStates.join(", ")}`, taskId, { currentState, expectedStates });
+        this.name = "TaskInvalidStateError";
+    }
+}
+export class TaskDependencyError extends TaskError {
+    constructor(taskId, unmetDependencies) {
+        super(`Task ${taskId} has unmet dependencies: ${unmetDependencies.join(", ")}`, taskId, { unmetDependencies });
+        this.name = "TaskDependencyError";
+    }
+}
+/**
+ * File system errors
+ */
+export class FileSystemError extends ZSCodeError {
+    constructor(operation, path, originalError) {
+        super(`File system error during ${operation}: ${path}`, "FS_ERROR", {
+            operation,
+            path,
+            originalError: originalError?.message,
+        });
+        this.name = "FileSystemError";
+    }
+}
+/**
+ * Validation errors
+ */
+export class ValidationError extends ZSCodeError {
+    constructor(message, field, details) {
+        super(message, "VALIDATION_ERROR", { field, ...details });
+        this.name = "ValidationError";
+    }
+}
+/**
+ * Get suggestion for error
+ */
+export function getSuggestion(error) {
+    const details = error.details;
+    if (details && typeof details.suggestion === "string") {
+        return details.suggestion;
+    }
+    switch (error.name) {
+        case "StateNotFoundError":
+        case "ProjectNotInitializedError":
+            return "Run 'npx zscode init' to initialize the project";
+        case "PlanNotFoundError":
+            return "Use 'zscode:status' to see available plans";
+        case "StagingOrderError":
+            return "Complete the previous staging first or use 'zscode:cancel' to skip";
+        default:
+            return undefined;
+    }
+}
+export function createToolErrorResult(error) {
+    if (error instanceof ZSCodeError) {
+        return {
+            success: false,
+            error: {
+                code: error.code,
+                message: error.message,
+                details: error.details,
+                suggestion: getSuggestion(error),
+            },
+        };
+    }
+    // Unknown error
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        success: false,
+        error: {
+            code: "UNEXPECTED_ERROR",
+            message: `Unexpected error: ${message}`,
+            details: { originalError: String(error) },
+        },
+    };
+}
+/**
+ * Async wrapper for tool handlers with error handling
+ */
+export async function withErrorHandling(operation, context) {
+    try {
+        const data = await operation();
+        return { success: true, data };
+    }
+    catch (error) {
+        console.error(`[${context}] Error:`, error);
+        return createToolErrorResult(error);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StateManager } from "./state/manager.js";
+import { registerAllTools } from "./tools/index.js";
+import { normalizePath } from "./utils/paths.js";
+const SERVER_NAME = "zscode";
+const SERVER_VERSION = "1.0.0";
+async function main() {
+    // Get project root from environment variable or current working directory
+    const projectRoot = process.env.ZSCODE_PROJECT_ROOT || process.cwd();
+    const normalizedRoot = normalizePath(projectRoot);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    console.error(`[${SERVER_NAME}] Starting MCP server v${SERVER_VERSION}`);
+    console.error(`[${SERVER_NAME}] Project root: ${normalizedRoot}`);
+    // Initialize state manager
+    try {
+        await StateManager.initialize(normalizedRoot);
+        console.error(`[${SERVER_NAME}] State manager initialized`);
+    }
+    catch (error) {
+        console.error(`[${SERVER_NAME}] Warning: Could not load state.json (project may not be initialized)`);
+    }
+    // Create MCP server
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    // Register all tools
+    registerAllTools(server, normalizedRoot);
+    console.error(`[${SERVER_NAME}] Tools registered`);
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[${SERVER_NAME}] Server connected and ready`);
+    // Handle shutdown
+    process.on("SIGINT", () => {
+        console.error(`[${SERVER_NAME}] Shutting down...`);
+        process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+        console.error(`[${SERVER_NAME}] Shutting down...`);
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    console.error(`[${SERVER_NAME}] Fatal error:`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,0EAA0E;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrE,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAElD,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,0BAA0B,cAAc,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,mBAAmB,cAAc,EAAE,CAAC,CAAC;IAElE,2BAA2B;IAC3B,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,6BAA6B,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,uEAAuE,CAAC,CAAC;IACxG,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,qBAAqB;IACrB,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,oBAAoB,CAAC,CAAC;IAEnD,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,8BAA8B,CAAC,CAAC;IAE7D,kBAAkB;IAClB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,oBAAoB,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,oBAAoB,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/state/manager.d.ts

@@ -0,0 +1,54 @@
+import type { State, Plan, Staging, Task, Project, Decision, TaskStatus, PlanStatus, HistoryEntryType, TaskOutput, IdGenerator } from "./types.js";
+declare const idGenerator: IdGenerator;
+export declare class StateManager {
+    private static instance;
+    private state;
+    private projectRoot;
+    private stateFilePath;
+    private constructor();
+    static initialize(projectRoot: string): Promise<StateManager>;
+    static getInstance(): StateManager;
+    private load;
+    private save;
+    getState(): State | null;
+    getProject(): Project | null;
+    getPlan(planId: string): Plan | undefined;
+    getStaging(stagingId: string): Staging | undefined;
+    getTask(taskId: string): Task | undefined;
+    getAllPlans(): Plan[];
+    getStagingsByPlan(planId: string): Staging[];
+    getTasksByStaging(stagingId: string): Task[];
+    getStagingByOrder(planId: string, order: number): Staging | undefined;
+    initializeProject(name: string, description?: string, goals?: string[], constraints?: string[]): Promise<Project>;
+    createPlan(title: string, description: string | undefined, stagingConfigs: Array<{
+        name: string;
+        description?: string;
+        execution_type: "parallel" | "sequential";
+        tasks: Array<{
+            title: string;
+            description?: string;
+            priority: "high" | "medium" | "low";
+            execution_mode: "parallel" | "sequential";
+            depends_on_index: number[];
+        }>;
+    }>): Promise<Plan>;
+    updatePlanStatus(planId: string, status: PlanStatus): Promise<void>;
+    startStaging(planId: string, stagingId: string): Promise<Staging>;
+    completestaging(stagingId: string): Promise<void>;
+    updateTaskStatus(taskId: string, status: TaskStatus, notes?: string): Promise<void>;
+    saveTaskOutput(taskId: string, output: TaskOutput): Promise<void>;
+    getExecutableTasks(stagingId: string): Task[];
+    archivePlan(planId: string, reason?: string): Promise<string>;
+    cancelPlan(planId: string, reason?: string): Promise<{
+        affectedStagings: number;
+        affectedTasks: number;
+    }>;
+    addHistory(type: HistoryEntryType, details: Record<string, unknown>): Promise<void>;
+    addDecision(title: string, decision: string, rationale?: string, relatedPlanId?: string, relatedStagingId?: string): Promise<Decision>;
+    startSession(): Promise<void>;
+    endSession(summary?: string): Promise<void>;
+    getProjectRoot(): string;
+    isInitialized(): boolean;
+}
+export { idGenerator };
+//# sourceMappingURL=manager.d.ts.map

package/dist/state/manager.d.ts.map

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