@agiflowai/scaffold-mcp 1.0.5 → 1.0.7

package/dist/useScaffoldMethod-CHJAsgA2.mjs

@@ -0,0 +1,236 @@
+import { t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-BLTCwsd1.mjs";
+import "./TemplateService-CVDL2uqt.mjs";
+import { TemplatesManagerService } from "@agiflowai/aicode-utils";
+import { DECISION_ALLOW, DECISION_DENY, DECISION_SKIP, ExecutionLogService } from "@agiflowai/hooks-adapter";
+
+//#region src/hooks/geminiCli/useScaffoldMethod.ts
+/**
+* UseScaffoldMethod Hook class for Gemini CLI
+*
+* Provides lifecycle hooks for tool execution:
+* - preToolUse: Shows available scaffolding methods before operations
+* - postToolUse: Tracks scaffold completion progress after file edits
+*/
+var UseScaffoldMethodHook = class {
+	/**
+	* PreToolUse hook for Gemini CLI
+	* Proactively shows available scaffolding methods and guides AI to use them
+	*
+	* @param context - Gemini CLI hook input
+	* @returns Hook response with scaffolding methods guidance
+	*/
+	async preToolUse(context) {
+		try {
+			const executionLog = new ExecutionLogService(context.session_id);
+			const sessionKey = `list-scaffold-methods-${context.session_id}`;
+			if (await executionLog.hasExecuted({
+				filePath: sessionKey,
+				decision: DECISION_DENY
+			})) {
+				await executionLog.logExecution({
+					filePath: sessionKey,
+					operation: "list-scaffold-methods",
+					decision: DECISION_SKIP
+				});
+				return {
+					decision: DECISION_SKIP,
+					message: "Scaffolding methods already provided in this session"
+				};
+			}
+			const result = await new ListScaffoldingMethodsTool(await TemplatesManagerService.findTemplatesPath(), false).execute(context.tool_input || {});
+			if (result.isError) {
+				await executionLog.logExecution({
+					filePath: sessionKey,
+					operation: "list-scaffold-methods",
+					decision: DECISION_SKIP
+				});
+				return {
+					decision: DECISION_SKIP,
+					message: `⚠️ Could not load scaffolding methods: ${result.content[0].text}`
+				};
+			}
+			const resultText = result.content[0]?.text;
+			if (typeof resultText !== "string") return {
+				decision: DECISION_SKIP,
+				message: "⚠️ Invalid response format from scaffolding methods tool"
+			};
+			const data = JSON.parse(resultText);
+			if (!data.methods || data.methods.length === 0) {
+				await executionLog.logExecution({
+					filePath: sessionKey,
+					operation: "list-scaffold-methods",
+					decision: DECISION_DENY
+				});
+				return {
+					decision: DECISION_DENY,
+					message: "No scaffolding methods are available for this project template. You should write new files directly using the Write tool."
+				};
+			}
+			let message = "🎯 **Scaffolding Methods Available**\n\n";
+			message += "Before writing new files, check if any of these scaffolding methods match your needs:\n\n";
+			for (const method of data.methods) {
+				message += `**${method.name}**\n`;
+				message += `${method.instruction || method.description || "No description available"}\n`;
+				if (method.variables_schema?.required && method.variables_schema.required.length > 0) message += `Required: ${method.variables_schema.required.join(", ")}\n`;
+				message += "\n";
+			}
+			if (data.nextCursor) message += `\n_Note: More methods available. Use cursor "${data.nextCursor}" to see more._\n\n`;
+			message += "\n**Instructions:**\n";
+			message += "1. If one of these scaffold methods matches what you need to create, use the `use-scaffold-method` MCP tool instead of writing files manually\n";
+			message += "2. If none of these methods are relevant to your task, proceed to write new files directly using the Write tool\n";
+			message += "3. Using scaffold methods ensures consistency with project patterns and includes all necessary boilerplate\n";
+			await executionLog.logExecution({
+				filePath: sessionKey,
+				operation: "list-scaffold-methods",
+				decision: DECISION_DENY
+			});
+			return {
+				decision: DECISION_DENY,
+				message
+			};
+		} catch (error) {
+			return {
+				decision: DECISION_SKIP,
+				message: `⚠️ Hook error: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+	/**
+	* PostToolUse hook for Gemini CLI
+	* Tracks file edits after scaffold generation and reminds AI to complete implementation
+	*
+	* @param context - Gemini CLI hook input
+	* @returns Hook response with scaffold completion tracking
+	*/
+	async postToolUse(context) {
+		try {
+			const executionLog = new ExecutionLogService(context.session_id);
+			const filePath = context.tool_input?.file_path;
+			const actualToolName = context.tool_name === "mcp__one-mcp__use_tool" ? context.tool_input?.toolName : context.tool_name;
+			if (actualToolName === "use-scaffold-method") return {
+				decision: DECISION_ALLOW,
+				message: "Scaffold execution logged for progress tracking"
+			};
+			const operation = extractOperation(actualToolName);
+			if (!filePath || operation !== "edit" && operation !== "write") return {
+				decision: DECISION_SKIP,
+				message: "Not a file edit/write operation"
+			};
+			const lastScaffoldExecution = await getLastScaffoldExecution(executionLog);
+			if (!lastScaffoldExecution) return {
+				decision: DECISION_SKIP,
+				message: "No scaffold execution found"
+			};
+			const { scaffoldId, generatedFiles, featureName } = lastScaffoldExecution;
+			const fulfilledKey = `scaffold-fulfilled-${scaffoldId}`;
+			if (await executionLog.hasExecuted({
+				filePath: fulfilledKey,
+				decision: DECISION_ALLOW
+			})) return {
+				decision: DECISION_SKIP,
+				message: "Scaffold already fulfilled"
+			};
+			const isScaffoldedFile = generatedFiles.includes(filePath);
+			if (isScaffoldedFile) {
+				const editKey = `scaffold-edit-${scaffoldId}-${filePath}`;
+				if (!await executionLog.hasExecuted({
+					filePath: editKey,
+					decision: DECISION_ALLOW
+				})) await executionLog.logExecution({
+					filePath: editKey,
+					operation: "scaffold-file-edit",
+					decision: DECISION_ALLOW
+				});
+			}
+			const editedFiles = await getEditedScaffoldFiles(executionLog, scaffoldId);
+			const totalFiles = generatedFiles.length;
+			const remainingFiles = generatedFiles.filter((f) => !editedFiles.includes(f));
+			if (remainingFiles.length === 0) {
+				await executionLog.logExecution({
+					filePath: fulfilledKey,
+					operation: "scaffold-fulfilled",
+					decision: DECISION_ALLOW
+				});
+				return {
+					decision: DECISION_ALLOW,
+					message: `✅ All scaffold files${featureName ? ` for "${featureName}"` : ""} have been implemented! (${totalFiles}/${totalFiles} files completed)`
+				};
+			}
+			if (isScaffoldedFile) {
+				const remainingFilesList = remainingFiles.map((f) => `  - ${f}`).join("\n");
+				return {
+					decision: DECISION_ALLOW,
+					message: `
+⚠️ **Scaffold Implementation Progress${featureName ? ` for "${featureName}"` : ""}: ${editedFiles.length}/${totalFiles} files completed**
+
+**Remaining files to implement:**
+${remainingFilesList}
+
+Don't forget to complete the implementation for all scaffolded files!
+        `.trim()
+				};
+			}
+			return {
+				decision: DECISION_SKIP,
+				message: "Edited file not part of last scaffold execution"
+			};
+		} catch (error) {
+			return {
+				decision: DECISION_SKIP,
+				message: `⚠️ Hook error: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+};
+/**
+* Extract operation type from tool name
+*/
+function extractOperation(toolName) {
+	const lowerToolName = toolName.toLowerCase();
+	if (lowerToolName === "edit" || lowerToolName === "update") return "edit";
+	if (lowerToolName === "write") return "write";
+	if (lowerToolName === "read") return "read";
+	return "unknown";
+}
+/**
+* Helper function to get the last scaffold execution for a session
+* Returns null if no scaffold execution found or on error
+*/
+async function getLastScaffoldExecution(executionLog) {
+	try {
+		const entries = await executionLog.loadLog();
+		for (let i = entries.length - 1; i >= 0; i--) {
+			const entry = entries[i];
+			if (entry.operation === "scaffold" && entry.scaffoldId && entry.generatedFiles && entry.generatedFiles.length > 0) return {
+				scaffoldId: entry.scaffoldId,
+				generatedFiles: entry.generatedFiles,
+				featureName: entry.featureName
+			};
+		}
+		return null;
+	} catch (error) {
+		console.error("Error getting last scaffold execution:", error);
+		return null;
+	}
+}
+/**
+* Helper function to get list of edited scaffold files
+* Returns empty array if no files found or on error
+*/
+async function getEditedScaffoldFiles(executionLog, scaffoldId) {
+	try {
+		const entries = await executionLog.loadLog();
+		const editedFiles = [];
+		for (const entry of entries) if (entry.operation === "scaffold-file-edit" && entry.filePath.startsWith(`scaffold-edit-${scaffoldId}-`)) {
+			const filePath = entry.filePath.replace(`scaffold-edit-${scaffoldId}-`, "");
+			editedFiles.push(filePath);
+		}
+		return editedFiles;
+	} catch (error) {
+		console.error(`Error getting edited scaffold files for ${scaffoldId}:`, error);
+		return [];
+	}
+}
+
+//#endregion
+export { UseScaffoldMethodHook };

package/dist/useScaffoldMethod-CsBTssSw.mjs

@@ -0,0 +1,263 @@
+import { t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-BLTCwsd1.mjs";
+import "./TemplateService-CVDL2uqt.mjs";
+import path from "node:path";
+import { ProjectFinderService, TemplatesManagerService } from "@agiflowai/aicode-utils";
+import fs from "node:fs/promises";
+import os from "node:os";
+import { DECISION_ALLOW, DECISION_DENY, DECISION_SKIP, ExecutionLogService } from "@agiflowai/hooks-adapter";
+
+//#region src/hooks/claudeCode/useScaffoldMethod.ts
+/**
+* UseScaffoldMethod Hook class for Claude Code
+*
+* Provides lifecycle hooks for tool execution:
+* - preToolUse: Shows available scaffolding methods before Write operations
+* - postToolUse: Tracks scaffold completion progress after file edits
+*/
+var UseScaffoldMethodHook = class {
+	/**
+	* PreToolUse hook for Claude Code
+	* Proactively shows available scaffolding methods and guides AI to use them
+	*
+	* @param context - Claude Code hook input
+	* @returns Hook response with scaffolding methods guidance
+	*/
+	async preToolUse(context) {
+		try {
+			const filePath = context.tool_input?.file_path;
+			if (!filePath || context.tool_name !== "Write") return {
+				decision: DECISION_SKIP,
+				message: "Not a file write operation"
+			};
+			const executionLog = new ExecutionLogService(context.session_id);
+			if (await executionLog.hasExecuted({
+				filePath,
+				decision: DECISION_DENY
+			})) return {
+				decision: DECISION_SKIP,
+				message: "Scaffolding methods already provided for this file"
+			};
+			const tool = new ListScaffoldingMethodsTool(await TemplatesManagerService.findTemplatesPath(), false);
+			const projectFinder = new ProjectFinderService(await TemplatesManagerService.getWorkspaceRoot(context.cwd));
+			const absoluteFilePath = path.isAbsolute(filePath) ? filePath : path.join(context.cwd, filePath);
+			const projectPath = (await projectFinder.findProjectForFile(absoluteFilePath))?.root || context.cwd;
+			const result = await tool.execute({ projectPath });
+			if (result.isError) return {
+				decision: DECISION_SKIP,
+				message: `⚠️ Could not load scaffolding methods: ${result.content[0].text}`
+			};
+			const resultText = result.content[0]?.text;
+			if (typeof resultText !== "string") return {
+				decision: DECISION_SKIP,
+				message: "⚠️ Invalid response format from scaffolding methods tool"
+			};
+			const data = JSON.parse(resultText);
+			if (!data.methods || data.methods.length === 0) {
+				await executionLog.logExecution({
+					filePath,
+					operation: "list-scaffold-methods",
+					decision: DECISION_DENY
+				});
+				return {
+					decision: DECISION_DENY,
+					message: "No scaffolding methods are available for this project template. You should write new files directly using the Write tool."
+				};
+			}
+			let message = "🎯 **Scaffolding Methods Available**\\n\\n";
+			message += "Before writing new files, check if any of these scaffolding methods match your needs:\\n\\n";
+			for (const method of data.methods) {
+				message += `**${method.name}**\\n`;
+				message += `${method.instruction || method.description || "No description available"}\\n`;
+				if (method.variables_schema?.required && method.variables_schema.required.length > 0) message += `Required: ${method.variables_schema.required.join(", ")}\\n`;
+				message += "\\n";
+			}
+			if (data.nextCursor) message += `\\n_Note: More methods available. Use cursor "${data.nextCursor}" to see more._\\n\\n`;
+			message += "\\n**Instructions:**\\n";
+			message += "1. If one of these scaffold methods matches what you need to create, use the `use-scaffold-method` MCP tool instead of writing files manually\\n";
+			message += "2. If none of these methods are relevant to your task, proceed to write new files directly using the Write tool\\n";
+			message += "3. Using scaffold methods ensures consistency with project patterns and includes all necessary boilerplate\\n";
+			await executionLog.logExecution({
+				filePath,
+				operation: "list-scaffold-methods",
+				decision: DECISION_DENY
+			});
+			return {
+				decision: DECISION_DENY,
+				message
+			};
+		} catch (error) {
+			return {
+				decision: DECISION_SKIP,
+				message: `⚠️ Hook error: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+	/**
+	* PostToolUse hook for Claude Code
+	* Tracks file edits after scaffold generation and reminds AI to complete implementation
+	*
+	* @param context - Claude Code hook input
+	* @returns Hook response with scaffold completion tracking
+	*/
+	async postToolUse(context) {
+		try {
+			const executionLog = new ExecutionLogService(context.session_id);
+			const filePath = context.tool_input?.file_path;
+			if ((context.tool_name === "mcp__one-mcp__use_tool" ? context.tool_input?.toolName : context.tool_name) === "use-scaffold-method") {
+				if (context.hook_event_name === "PostToolUse") {
+					const scaffoldId$1 = extractScaffoldId(context.tool_response);
+					if (scaffoldId$1) await processPendingScaffoldLogs(context.session_id, scaffoldId$1);
+				}
+				return {
+					decision: DECISION_ALLOW,
+					message: "Scaffold execution logged for progress tracking"
+				};
+			}
+			if (!filePath || context.tool_name !== "Edit" && context.tool_name !== "Write" && context.tool_name !== "Update") return {
+				decision: DECISION_SKIP,
+				message: "Not a file edit/write operation"
+			};
+			const lastScaffoldExecution = await getLastScaffoldExecution(executionLog);
+			if (!lastScaffoldExecution) return {
+				decision: DECISION_SKIP,
+				message: "No scaffold execution found"
+			};
+			const { scaffoldId, generatedFiles, featureName } = lastScaffoldExecution;
+			const fulfilledKey = `scaffold-fulfilled-${scaffoldId}`;
+			if (await executionLog.hasExecuted({
+				filePath: fulfilledKey,
+				decision: DECISION_ALLOW
+			})) return {
+				decision: DECISION_SKIP,
+				message: "Scaffold already fulfilled"
+			};
+			const isScaffoldedFile = generatedFiles.includes(filePath);
+			if (isScaffoldedFile) {
+				const editKey = `scaffold-edit-${scaffoldId}-${filePath}`;
+				if (!await executionLog.hasExecuted({
+					filePath: editKey,
+					decision: DECISION_ALLOW
+				})) await executionLog.logExecution({
+					filePath: editKey,
+					operation: "scaffold-file-edit",
+					decision: DECISION_ALLOW
+				});
+			}
+			const editedFiles = await getEditedScaffoldFiles(executionLog, scaffoldId);
+			const totalFiles = generatedFiles.length;
+			const remainingFiles = generatedFiles.filter((f) => !editedFiles.includes(f));
+			if (remainingFiles.length === 0) {
+				await executionLog.logExecution({
+					filePath: fulfilledKey,
+					operation: "scaffold-fulfilled",
+					decision: DECISION_ALLOW
+				});
+				return {
+					decision: DECISION_ALLOW,
+					message: `✅ All scaffold files${featureName ? ` for "${featureName}"` : ""} have been implemented! (${totalFiles}/${totalFiles} files completed)`
+				};
+			}
+			if (isScaffoldedFile) {
+				const remainingFilesList = remainingFiles.map((f) => `  - ${f}`).join("\\n");
+				return {
+					decision: DECISION_ALLOW,
+					message: `
+⚠️ **Scaffold Implementation Progress${featureName ? ` for "${featureName}"` : ""}: ${editedFiles.length}/${totalFiles} files completed**
+
+**Remaining files to implement:**
+${remainingFilesList}
+
+Don't forget to complete the implementation for all scaffolded files!
+        `.trim()
+				};
+			}
+			return {
+				decision: DECISION_SKIP,
+				message: "Edited file not part of last scaffold execution"
+			};
+		} catch (error) {
+			return {
+				decision: DECISION_SKIP,
+				message: `⚠️ Hook error: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+};
+/**
+* Extract scaffold ID from tool result
+*/
+function extractScaffoldId(toolResult) {
+	try {
+		if (!toolResult || !toolResult.content) return null;
+		for (const item of toolResult.content) if (item.type === "text" && typeof item.text === "string") {
+			const match = item.text.match(/^SCAFFOLD_ID:([a-z0-9]+)$/);
+			if (match) return match[1];
+		}
+		return null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Helper function to get the last scaffold execution for a session
+*/
+async function getLastScaffoldExecution(executionLog) {
+	const entries = await executionLog.loadLog();
+	for (let i = entries.length - 1; i >= 0; i--) {
+		const entry = entries[i];
+		if (entry.operation === "scaffold" && entry.scaffoldId && entry.generatedFiles && entry.generatedFiles.length > 0) return {
+			scaffoldId: entry.scaffoldId,
+			generatedFiles: entry.generatedFiles,
+			featureName: entry.featureName
+		};
+	}
+	return null;
+}
+/**
+* Helper function to get list of edited scaffold files
+*/
+async function getEditedScaffoldFiles(executionLog, scaffoldId) {
+	const entries = await executionLog.loadLog();
+	const editedFiles = [];
+	for (const entry of entries) if (entry.operation === "scaffold-file-edit" && entry.filePath.startsWith(`scaffold-edit-${scaffoldId}-`)) {
+		const filePath = entry.filePath.replace(`scaffold-edit-${scaffoldId}-`, "");
+		editedFiles.push(filePath);
+	}
+	return editedFiles;
+}
+/**
+* Process pending scaffold logs from temp file and copy to ExecutionLogService
+* Called when use-scaffold-method tool is executed
+*/
+async function processPendingScaffoldLogs(sessionId, scaffoldId) {
+	const tempLogFile = path.join(os.tmpdir(), `scaffold-mcp-pending-${scaffoldId}.jsonl`);
+	try {
+		const lines = (await fs.readFile(tempLogFile, "utf-8")).trim().split("\\n").filter(Boolean);
+		const executionLog = new ExecutionLogService(sessionId);
+		try {
+			for (const line of lines) try {
+				const entry = JSON.parse(line);
+				await executionLog.logExecution({
+					filePath: `scaffold-${entry.scaffoldId}`,
+					operation: "scaffold",
+					decision: DECISION_ALLOW,
+					generatedFiles: entry.generatedFiles,
+					scaffoldId: entry.scaffoldId,
+					projectPath: entry.projectPath,
+					featureName: entry.featureName
+				});
+			} catch (parseError) {
+				console.error("Failed to parse pending scaffold log entry:", parseError);
+			}
+		} finally {
+			try {
+				await fs.unlink(tempLogFile);
+			} catch {}
+		}
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code !== "ENOENT") console.error("Error processing pending scaffold logs:", error);
+	}
+}
+
+//#endregion
+export { UseScaffoldMethodHook };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/scaffold-mcp",
   "description": "MCP server for scaffolding applications with boilerplate templates",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {
@@ -44,10 +44,14 @@
     "express": "^4.21.2",
     "js-yaml": "4.1.0",
     "liquidjs": "10.21.1",
+    "minimatch": "^10.0.1",
     "pino": "^10.0.0",
     "pino-pretty": "^13.1.1",
     "zod": "3.25.76",
-    "@agiflowai/aicode-utils": "1.0.4"
+    "@agiflowai/aicode-utils": "1.0.6",
+    "@agiflowai/architect-mcp": "1.0.7",
+    "@agiflowai/hooks-adapter": "0.0.2",
+    "@agiflowai/coding-agent-bridge": "1.0.6"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",

package/dist/ScaffoldService-BNOyoqSb.cjs

@@ -1,3 +0,0 @@
-const require_ScaffoldService = require('./ScaffoldService-ChzxM0Yc.cjs');
-
-exports.ScaffoldService = require_ScaffoldService.ScaffoldService;

package/dist/ScaffoldService-BNdfC21Z.mjs

@@ -1,3 +0,0 @@
-import { t as ScaffoldService } from "./ScaffoldService-BNuN00Fm.mjs";
-
-export { ScaffoldService };

package/dist/TemplateService-BRfzfaZs.mjs

@@ -1,3 +0,0 @@
-import { t as TemplateService } from "./TemplateService-Cg5QV29n.mjs";
-
-export { TemplateService };

package/dist/TemplateService-DqieT1Tq.cjs

@@ -1,3 +0,0 @@
-const require_TemplateService = require('./TemplateService-D3ydJR_R.cjs');
-
-exports.TemplateService = require_TemplateService.TemplateService;

package/dist/VariableReplacementService-BWCd-z7X.mjs

@@ -1,3 +0,0 @@
-import { t as VariableReplacementService } from "./VariableReplacementService-DHIINRnJ.mjs";
-
-export { VariableReplacementService };