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, }; } }