warden_start_project

Initialize a Warden-managed Magento 2 development environment by specifying the project directory path to automate project setup and configuration.

Instructions

Start a Warden project environment

Input Schema

TableJSON Schema

Name	Required	Description	Default
`project_path`	Yes	Path to the project directory

Implementation Reference

server.js:511-518 (handler)
The handler function for the 'warden_start_project' tool. It destructures the project_path from arguments and invokes executeWardenCommand to run 'warden env up' in the specified project directory.
```
async startProject(args) {
  const { project_path } = args;
  return await this.executeWardenCommand(
    project_path,
    ["env", "up"],
    "Starting Warden project environment",
  );
}
```

server.js:44-56 (registration)

Registers the 'warden_start_project' tool in the ListTools response, including name, description, and input schema.

{
  name: "warden_start_project",
  description: "Start a Warden project environment",
  inputSchema: {
    type: "object",
    properties: {
      project_path: {
        type: "string",
        description: "Path to the project directory",
      },
    },
    required: ["project_path"],
  },

server.js:47-56 (schema)

Defines the input schema for the 'warden_start_project' tool, requiring a 'project_path' string.

inputSchema: {
  type: "object",
  properties: {
    project_path: {
      type: "string",
      description: "Path to the project directory",
    },
  },
  required: ["project_path"],
},

server.js:323-324 (registration)
Registers the handler dispatch for 'warden_start_project' in the CallToolRequestHandler switch statement.
```
case "warden_start_project":
  return await this.startProject(request.params.arguments);
```

server.js:831-876 (helper)

Helper function used by the handler to execute the 'warden' CLI command in the project directory, with full validation, execution via spawn, and structured result return.

async executeWardenCommand(project_path, wardenArgs, description) {
  if (!project_path) {
    throw new Error("project_path is required");
  }

  const normalizedProjectPath = project_path.replace(/\/+$/, "");
  const absoluteProjectPath = resolve(normalizedProjectPath);

  if (!existsSync(absoluteProjectPath)) {
    throw new Error(
      `Project directory does not exist: ${absoluteProjectPath}`,
    );
  }

  try {
    const result = await this.executeCommand(
      "warden",
      wardenArgs,
      absoluteProjectPath,
    );

    const commandStr = `warden ${wardenArgs.join(" ")}`;
    const isSuccess = result.code === 0;

    return {
      content: [
        {
          type: "text",
          text: `${description} ${isSuccess ? "completed successfully" : "failed"}!\n\nCommand: ${commandStr}\nWorking directory: ${absoluteProjectPath}\nExit Code: ${result.code}\n\nOutput:\n${result.stdout || "(no output)"}\n\nErrors:\n${result.stderr || "(no errors)"}`,
        },
      ],
      isError: !isSuccess,
    };
  } catch (error) {
    const commandStr = `warden ${wardenArgs.join(" ")}`;
    return {
      content: [
        {
          type: "text",
          text: `Failed to execute command:\n\nCommand: ${commandStr}\nWorking directory: ${absoluteProjectPath}\nError: ${error.message}\n\nOutput:\n${error.stdout || "(no output)"}\n\nErrors:\n${error.stderr || "(no errors)"}`,
        },
      ],
      isError: true,
    };
  }
}

Warden Magento MCP Server