@agiflowai/scaffold-mcp 0.0.0 → 0.2.0

package/dist/index.js

@@ -519,11 +519,25 @@ boilerplateCommand.command("info <boilerplateName>").description("Show detailed
 //#endregion
 //#region src/cli/init.ts
 /**
+* Find the workspace root by searching upwards for .git folder
+*/
+async function findWorkspaceRoot(startPath = process.cwd()) {
+	let currentPath = path.resolve(startPath);
+	const rootPath = path.parse(currentPath).root;
+	while (true) {
+		const gitPath = path.join(currentPath, ".git");
+		if (await fs$1.pathExists(gitPath)) return currentPath;
+		if (currentPath === rootPath) return process.cwd();
+		currentPath = path.dirname(currentPath);
+	}
+}
+/**
 * Init command - initialize templates folder
 */
-const initCommand = new Command("init").description("Initialize templates folder structure").option("--path <path>", "Path to templates folder", "./templates").action(async (options) => {
+const initCommand = new Command("init").description("Initialize templates folder structure at workspace root").action(async () => {
 	try {
-		const templatesPath = path.resolve(options.path);
+		const workspaceRoot = await findWorkspaceRoot();
+		const templatesPath = path.join(workspaceRoot, "templates");
 		logger.info(`${icons.rocket} Initializing templates folder at: ${templatesPath}`);
 		await fs$1.ensureDir(templatesPath);
 		await fs$1.ensureDir(path.join(templatesPath, "boilerplates"));
@@ -790,6 +804,213 @@ Template File Content Guidelines:
 	}
 };
 
+//#endregion
+//#region src/prompts/ScaffoldApplicationPrompt.ts
+/**
+* Prompt for scaffolding a new application using boilerplate templates
+*/
+var ScaffoldApplicationPrompt = class ScaffoldApplicationPrompt {
+	static PROMPT_NAME = "scaffold-application";
+	/**
+	* Get the prompt definition for MCP
+	*/
+	getDefinition() {
+		return {
+			name: ScaffoldApplicationPrompt.PROMPT_NAME,
+			description: "Scaffold a new application from a boilerplate template",
+			arguments: [{
+				name: "request",
+				description: "Describe the application you want to create (optional)",
+				required: false
+			}]
+		};
+	}
+	/**
+	* Get the prompt messages
+	*/
+	getMessages(args) {
+		const userRequest = args?.request || "";
+		return [{
+			role: "user",
+			content: {
+				type: "text",
+				text: `You are helping create a new application using the scaffold-mcp MCP tools.
+
+${userRequest ? `User request: ${userRequest}\n` : ""}
+Your task is to scaffold a new application by following this workflow:
+
+## Step 1: List Available Boilerplates
+Use the \`list-boilerplates\` tool to see all available project templates.
+
+**What to look for:**
+- Boilerplate name (e.g., "scaffold-nextjs-app", "scaffold-vite-app")
+- Description of what the boilerplate creates
+- Target folder where projects will be created (e.g., "apps", "packages")
+- Required and optional variables in the variables_schema
+
+## Step 2: Gather Required Information
+Based on the selected boilerplate's variables_schema, collect:
+- **Project name**: Must be kebab-case (e.g., "my-new-app", not "MyNewApp")
+- **Required variables**: All variables marked as required: true
+- **Optional variables**: Variables with required: false (ask user if needed)
+
+Common variables:
+- \`appName\` or \`packageName\`: The project name (kebab-case)
+- \`description\`: Brief description of what the project does
+- \`author\`: Author name
+
+## Step 3: Execute the Boilerplate
+Use the \`use-boilerplate\` tool with:
+- \`boilerplateName\`: Exact name from list-boilerplates response
+- \`variables\`: Object matching the variables_schema exactly
+
+**Example:**
+\`\`\`json
+{
+  "boilerplateName": "scaffold-nextjs-app",
+  "variables": {
+    "appName": "my-dashboard",
+    "description": "Admin dashboard for managing users",
+    "author": "John Doe"
+  }
+}
+\`\`\`
+
+## Important Guidelines:
+- **Always call \`list-boilerplates\` first** to see available options and their schemas
+- **Use exact variable names** from the schema (case-sensitive)
+- **Provide all required variables** - the tool will fail if any are missing
+- **Use kebab-case for project names** (e.g., "user-dashboard", not "UserDashboard")
+- The tool will create the project in the appropriate directory automatically
+- After creation, inform the user where the project was created
+
+## Example Workflow:
+1. Call \`list-boilerplates\` → See available templates
+2. Ask user which template to use (or infer from request)
+3. Collect required variables based on schema
+4. Call \`use-boilerplate\` with boilerplateName and variables
+5. Report success and next steps to the user`
+			}
+		}];
+	}
+};
+
+//#endregion
+//#region src/prompts/ScaffoldFeaturePrompt.ts
+/**
+* Prompt for scaffolding a new feature in an existing project
+*/
+var ScaffoldFeaturePrompt = class ScaffoldFeaturePrompt {
+	static PROMPT_NAME = "scaffold-feature";
+	/**
+	* Get the prompt definition for MCP
+	*/
+	getDefinition() {
+		return {
+			name: ScaffoldFeaturePrompt.PROMPT_NAME,
+			description: "Scaffold a new feature (page, component, service, etc.) in an existing project",
+			arguments: [{
+				name: "request",
+				description: "Describe the feature you want to add (optional)",
+				required: false
+			}, {
+				name: "projectPath",
+				description: "Path to the project (e.g., \"apps/my-app\") - optional if can be inferred",
+				required: false
+			}]
+		};
+	}
+	/**
+	* Get the prompt messages
+	*/
+	getMessages(args) {
+		const userRequest = args?.request || "";
+		const projectPath = args?.projectPath || "";
+		return [{
+			role: "user",
+			content: {
+				type: "text",
+				text: `You are helping add a new feature to an existing project using the scaffold-mcp MCP tools.
+
+${userRequest ? `User request: ${userRequest}\n` : ""}${projectPath ? `Project path: ${projectPath}\n` : ""}
+Your task is to scaffold a new feature by following this workflow:
+
+## Step 1: Identify the Project
+Determine the project path where the feature will be added:
+- If projectPath is provided, use it
+- Otherwise, ask the user or infer from context (e.g., "apps/my-app", "packages/my-lib")
+- The path should point to a directory containing a \`project.json\` file
+
+## Step 2: List Available Scaffolding Methods
+Use the \`list-scaffolding-methods\` tool with the projectPath.
+
+**What to look for:**
+- Feature name (e.g., "scaffold-nextjs-page", "scaffold-react-component")
+- Description of what files/code it generates
+- Required and optional variables in the variables_schema
+- The template type (derived from project's sourceTemplate)
+
+**Example:**
+\`\`\`json
+{
+  "projectPath": "apps/my-dashboard"
+}
+\`\`\`
+
+## Step 3: Gather Required Information
+Based on the selected scaffolding method's variables_schema, collect:
+- **Feature-specific variables**: Name, path, type, etc.
+- **Required variables**: All variables marked as required: true
+- **Optional variables**: Variables with required: false (ask user if needed)
+
+Common variables:
+- \`componentName\` / \`pageName\` / \`serviceName\`: Name in PascalCase
+- \`componentPath\` / \`pagePath\`: Where to place the file (may use kebab-case)
+- Boolean flags: \`withTests\`, \`withLayout\`, \`withStyles\`, etc.
+
+## Step 4: Execute the Scaffolding Method
+Use the \`use-scaffold-method\` tool with:
+- \`projectPath\`: Same path from step 1
+- \`scaffold_feature_name\`: Exact name from list-scaffolding-methods response
+- \`variables\`: Object matching the variables_schema exactly
+
+**Example:**
+\`\`\`json
+{
+  "projectPath": "apps/my-dashboard",
+  "scaffold_feature_name": "scaffold-nextjs-page",
+  "variables": {
+    "pageName": "UserProfile",
+    "pagePath": "user/profile",
+    "withLayout": true,
+    "withTests": false
+  }
+}
+\`\`\`
+
+## Important Guidelines:
+- **Always call \`list-scaffolding-methods\` first** with the projectPath
+- **Use exact variable names** from the schema (case-sensitive)
+- **Provide all required variables** - the tool will fail if any are missing
+- **Follow naming conventions**:
+  - Component/Page/Service names: PascalCase (e.g., "UserProfile")
+  - File paths: kebab-case or as specified in schema (e.g., "user/profile")
+- **Conditional files**: Files with \`?condition=true\` are only included when the variable is true
+- The tool will create files in the appropriate locations automatically
+- After creation, inform the user what files were created
+
+## Example Workflow:
+1. Identify project path (provided or ask user)
+2. Call \`list-scaffolding-methods\` → See available features for this project
+3. Ask user which feature to add (or infer from request)
+4. Collect required variables based on schema
+5. Call \`use-scaffold-method\` with projectPath, scaffold_feature_name, and variables
+6. Report success and list created files`
+			}
+		}];
+	}
+};
+
 //#endregion
 //#region src/services/BoilerplateGeneratorService.ts
 /**
@@ -2136,6 +2357,8 @@ function createServer(options = {}) {
 	const generateFeatureScaffoldTool = adminEnabled ? new GenerateFeatureScaffoldTool(templatesPath) : null;
 	const generateBoilerplatePrompt = adminEnabled ? new GenerateBoilerplatePrompt() : null;
 	const generateFeatureScaffoldPrompt = adminEnabled ? new GenerateFeatureScaffoldPrompt() : null;
+	const scaffoldApplicationPrompt = new ScaffoldApplicationPrompt();
+	const scaffoldFeaturePrompt = new ScaffoldFeaturePrompt();
 	const server = new Server({
 		name: "scaffold-mcp",
 		version: "1.0.0"
@@ -2241,26 +2464,30 @@ Example workflow for feature:
 		}
 		throw new Error(`Unknown tool: ${name}`);
 	});
-	if (adminEnabled) {
-		server.setRequestHandler(ListPromptsRequestSchema, async () => {
-			const prompts = [];
+	server.setRequestHandler(ListPromptsRequestSchema, async () => {
+		const prompts = [];
+		prompts.push(scaffoldApplicationPrompt.getDefinition());
+		prompts.push(scaffoldFeaturePrompt.getDefinition());
+		if (adminEnabled) {
 			if (generateBoilerplatePrompt) prompts.push(generateBoilerplatePrompt.getDefinition());
 			if (generateFeatureScaffoldPrompt) prompts.push(generateFeatureScaffoldPrompt.getDefinition());
-			return { prompts };
-		});
-		server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-			const { name, arguments: args } = request.params;
-			if (name === GenerateBoilerplatePrompt.PROMPT_NAME) {
-				if (!generateBoilerplatePrompt) throw new Error("Prompt not available");
-				return { messages: generateBoilerplatePrompt.getMessages(args) };
-			}
-			if (name === GenerateFeatureScaffoldPrompt.PROMPT_NAME) {
-				if (!generateFeatureScaffoldPrompt) throw new Error("Prompt not available");
-				return { messages: generateFeatureScaffoldPrompt.getMessages(args) };
-			}
-			throw new Error(`Unknown prompt: ${name}`);
-		});
-	}
+		}
+		return { prompts };
+	});
+	server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+		const { name, arguments: args } = request.params;
+		if (name === ScaffoldApplicationPrompt.PROMPT_NAME) return { messages: scaffoldApplicationPrompt.getMessages(args) };
+		if (name === ScaffoldFeaturePrompt.PROMPT_NAME) return { messages: scaffoldFeaturePrompt.getMessages(args) };
+		if (name === GenerateBoilerplatePrompt.PROMPT_NAME) {
+			if (!generateBoilerplatePrompt) throw new Error("Prompt not available");
+			return { messages: generateBoilerplatePrompt.getMessages(args) };
+		}
+		if (name === GenerateFeatureScaffoldPrompt.PROMPT_NAME) {
+			if (!generateFeatureScaffoldPrompt) throw new Error("Prompt not available");
+			return { messages: generateFeatureScaffoldPrompt.getMessages(args) };
+		}
+		throw new Error(`Unknown prompt: ${name}`);
+	});
 	return server;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/scaffold-mcp",
   "description": "MCP server for scaffolding applications with boilerplate templates",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {
@@ -42,7 +42,7 @@
     "js-yaml": "4.1.0",
     "liquidjs": "10.21.1",
     "zod": "3.25.76",
-    "@agiflowai/scaffold-generator": "0.0.0"
+    "@agiflowai/scaffold-generator": "0.2.0"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",