@agiflowai/scaffold-mcp 1.1.0 → 1.2.0

package/README.md

@@ -121,6 +121,25 @@ npx @agiflowai/scaffold-mcp scaffold list ./apps/my-app
 npx @agiflowai/scaffold-mcp scaffold add scaffold-nextjs-page \
   --project ./apps/my-app \
   --vars '{"pageTitle":"About","nextjsPagePath":"/about"}'
+
+# Create template authoring entries (CLI equivalents for admin MCP tools)
+npx @agiflowai/scaffold-mcp boilerplate generate scaffold-vite-app \
+  --template vite-react \
+  --description "React Vite starter" \
+  --target-folder apps \
+  --variables '[{"name":"appName","description":"Application name","type":"string","required":true}]'
+
+npx @agiflowai/scaffold-mcp scaffold generate scaffold-service \
+  --template typescript-lib \
+  --description "Generate a service class and unit test" \
+  --variables '[{"name":"serviceName","description":"Service name","type":"string","required":true}]'
+
+npx @agiflowai/scaffold-mcp template file create src/index.ts \
+  --template typescript-lib \
+  --content 'export const {{ name | camelCase }} = "{{ name }}";'
+
+npx @agiflowai/scaffold-mcp file write .env.local \
+  --content 'NEXT_PUBLIC_API_URL=https://api.example.com'
 ```
 
 ---

package/dist/{claudeCode-DNgNiLlL.mjs → claudeCode-DbKOy8W8.mjs}

@@ -1,5 +1,5 @@
 import { t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-DxdrPlcb.mjs";
-import "./tools-Cl06aoBi.mjs";
+import "./tools-Dn5KgBUI.mjs";
 import { n as resolveNewFileWriteTarget, t as formatScaffoldMethodsHookMessage } from "./shared-BVYIN3Is.mjs";
 import { ProjectFinderService, TemplatesManagerService } from "@agiflowai/aicode-utils";
 import path from "node:path";

package/dist/{claudeCode-BxcEboyM.cjs → claudeCode-g1eRidPR.cjs}

@@ -1,5 +1,5 @@
 const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-CYZtpU-W.cjs");
-require("./tools-CVSZSirE.cjs");
+require("./tools-COb9iBtt.cjs");
 const require_shared = require("./shared-QxPXh-L-.cjs");
 let _agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let node_path = require("node:path");

package/dist/cli.cjs

@@ -1,13 +1,54 @@
 #!/usr/bin/env node
 const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-CYZtpU-W.cjs");
-const require_src = require("./src-oF_UdSBu.cjs");
-const require_tools = require("./tools-CVSZSirE.cjs");
+const require_src = require("./src-BG_X82dw.cjs");
+const require_tools = require("./tools-COb9iBtt.cjs");
 let _agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let node_path = require("node:path");
 node_path = require_ListScaffoldingMethodsTool.__toESM(node_path, 1);
 let commander = require("commander");
 let _agiflowai_coding_agent_bridge = require("@agiflowai/coding-agent-bridge");
 let _agiflowai_hooks_adapter = require("@agiflowai/hooks-adapter");
+//#region src/commands/utils.ts
+function parseJsonOption(value, flagName) {
+	if (!value) throw new Error(`${flagName} is required`);
+	try {
+		return JSON.parse(value);
+	} catch (error) {
+		throw new Error(`Invalid JSON for ${flagName}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+async function resolveTemplatesPath() {
+	const templatesDir = await _agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath();
+	if (!templatesDir) throw new Error("Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml");
+	return templatesDir;
+}
+async function detectMonolithMode() {
+	try {
+		return (await _agiflowai_aicode_utils.ProjectConfigResolver.resolveProjectConfig(process.cwd())).type === "monolith";
+	} catch {
+		return false;
+	}
+}
+async function loadTextOption(config) {
+	const { value, filePath, valueFlag, fileFlag, required = false } = config;
+	if (value !== void 0 && filePath !== void 0) throw new Error(`Use only one of ${valueFlag} or ${fileFlag}`);
+	if (filePath !== void 0) return (0, _agiflowai_aicode_utils.readFile)(filePath, "utf-8");
+	if (value !== void 0) return value;
+	if (required) throw new Error(`${valueFlag} or ${fileFlag} is required`);
+}
+function collectOption(value, previous = []) {
+	return [...previous, value];
+}
+function firstTextContent(result) {
+	const firstContent = result.content[0];
+	return firstContent?.type === "text" ? firstContent.text : "";
+}
+function assertToolSuccess(result) {
+	const text = firstTextContent(result);
+	if (result.isError) throw new Error(text || "Tool execution failed");
+	return text;
+}
+//#endregion
 //#region src/commands/boilerplate.ts
 /**
 * Boilerplate CLI command
@@ -44,7 +85,7 @@ boilerplateCommand.command("list").description("List all available boilerplate t
 		process.exit(1);
 	}
 });
-boilerplateCommand.command("create <boilerplateName>").description("Create a new project from a boilerplate template").option("-v, --vars <json>", "JSON string containing variables for the boilerplate").option("-m, --monolith", "Create as monolith project at workspace root with toolkit.yaml (default: false, creates as monorepo with project.json)").option("-t, --target-folder <path>", "Override target folder (defaults to boilerplate targetFolder for monorepo, workspace root for monolith)").option("--verbose", "Enable verbose logging").action(async (boilerplateName, options) => {
+boilerplateCommand.command("create <boilerplateName>").description("Create a new project from a boilerplate template").option("-v, --vars <json>", "JSON string containing variables for the boilerplate").option("-m, --monolith", "Create as monolith project at workspace root with toolkit.yaml (default: false, creates as monorepo with project.json)").option("-t, --target-folder <path>", "Override target folder (defaults to boilerplate targetFolder for monorepo, workspace root for monolith)").option("--marker <tag>", "Custom scaffold marker tag to inject into generated code files").option("--verbose", "Enable verbose logging").action(async (boilerplateName, options) => {
 	try {
 		const templatesDir = await _agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath();
 		if (!templatesDir) {
@@ -94,7 +135,8 @@ boilerplateCommand.command("create <boilerplateName>").description("Create a new
 			boilerplateName,
 			variables,
 			monolith: options.monolith,
-			targetFolderOverride: options.targetFolder
+			targetFolderOverride: options.targetFolder,
+			marker: options.marker
 		});
 		if (result.success) {
 			_agiflowai_aicode_utils.messages.success("Project created successfully!");
@@ -121,6 +163,42 @@ boilerplateCommand.command("create <boilerplateName>").description("Create a new
 		process.exit(1);
 	}
 });
+boilerplateCommand.command("generate <boilerplateName>").description("Create a new boilerplate configuration in a template's scaffold.yaml").option("-t, --template <name>", "Template name (optional in monolith mode)").option("--description <text>", "Boilerplate description").option("--description-file <path>", "Read boilerplate description from a file").option("--instruction <text>", "Detailed boilerplate instructions").option("--instruction-file <path>", "Read detailed boilerplate instructions from a file").option("--target-folder <path>", "Target folder for generated projects").option("--variables <json>", "JSON array of variable definitions: [{\"name\":\"appName\",\"description\":\"App name\",\"type\":\"string\",\"required\":true}]").option("-i, --include <path>", "Template include path (repeatable)", collectOption, []).action(async (boilerplateName, options) => {
+	try {
+		const templatesPath = await resolveTemplatesPath();
+		const isMonolith = await detectMonolithMode();
+		const description = await loadTextOption({
+			value: options.description,
+			filePath: options.descriptionFile,
+			valueFlag: "--description",
+			fileFlag: "--description-file",
+			required: true
+		});
+		const instruction = await loadTextOption({
+			value: options.instruction,
+			filePath: options.instructionFile,
+			valueFlag: "--instruction",
+			fileFlag: "--instruction-file"
+		});
+		const variables = parseJsonOption(options.variables, "--variables");
+		if (!Array.isArray(variables)) throw new Error("--variables must be a JSON array");
+		const targetFolder = options.targetFolder ?? (isMonolith ? "." : void 0);
+		if (!targetFolder) throw new Error("--target-folder is required outside monolith mode");
+		const result = await new require_tools.GenerateBoilerplateTool(templatesPath, isMonolith).execute({
+			templateName: options.template,
+			boilerplateName,
+			description: description ?? "",
+			instruction,
+			targetFolder,
+			variables,
+			includes: options.include ?? []
+		});
+		_agiflowai_aicode_utils.print.info(assertToolSuccess(result));
+	} catch (error) {
+		_agiflowai_aicode_utils.print.error("Error generating boilerplate:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
 boilerplateCommand.command("info <boilerplateName>").description("Show detailed information about a boilerplate template").action(async (boilerplateName) => {
 	try {
 		const templatesDir = await _agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath();
@@ -146,6 +224,28 @@ boilerplateCommand.command("info <boilerplateName>").description("Show detailed
 	}
 });
 //#endregion
+//#region src/commands/file.ts
+const fileCommand$1 = new commander.Command("file").description("Workspace file utilities");
+fileCommand$1.command("write <filePath>").description("Write content to a file inside the current workspace").option("--content <text>", "Content to write").option("--content-file <path>", "Read content to write from a file").action(async (filePath, options) => {
+	try {
+		const content = await loadTextOption({
+			value: options.content,
+			filePath: options.contentFile,
+			valueFlag: "--content",
+			fileFlag: "--content-file",
+			required: true
+		});
+		const result = await new require_tools.WriteToFileTool().execute({
+			file_path: filePath,
+			content
+		});
+		_agiflowai_aicode_utils.print.info(assertToolSuccess(result));
+	} catch (error) {
+		_agiflowai_aicode_utils.print.error("Error writing file:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
+//#endregion
 //#region src/commands/mcp-serve.ts
 /**
 * MCP Serve Command
@@ -299,13 +399,6 @@ const mcpServeCommand = new commander.Command("mcp-serve").description("Start MC
 const scaffoldCommand = new commander.Command("scaffold").description("Add features to existing projects");
 scaffoldCommand.command("list [projectPath]").description("List available scaffolding methods for a project or template").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").option("-c, --cursor <cursor>", "Pagination cursor for next page").action(async (projectPath, options) => {
 	try {
-		if (!projectPath && !options.template) {
-			_agiflowai_aicode_utils.messages.error("Either projectPath or --template option must be provided");
-			_agiflowai_aicode_utils.messages.hint("Examples:");
-			_agiflowai_aicode_utils.print.debug("  scaffold-mcp scaffold list ./my-project");
-			_agiflowai_aicode_utils.print.debug("  scaffold-mcp scaffold list --template nextjs-15");
-			process.exit(1);
-		}
 		const templatesDir = await _agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath();
 		if (!templatesDir) {
 			_agiflowai_aicode_utils.messages.error("Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml");
@@ -314,15 +407,16 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 		const scaffoldingMethodsService = new require_ListScaffoldingMethodsTool.ScaffoldingMethodsService(new require_ListScaffoldingMethodsTool.FileSystemService(), templatesDir);
 		let result;
 		let displayName;
-		if (projectPath) {
-			const absolutePath = node_path.default.resolve(projectPath);
+		if (projectPath || !options.template) {
+			const inputProjectPath = projectPath ?? process.cwd();
+			const absolutePath = node_path.default.resolve(inputProjectPath);
 			if (!await _agiflowai_aicode_utils.ProjectConfigResolver.hasConfiguration(absolutePath)) {
 				_agiflowai_aicode_utils.messages.error(`No project configuration found in ${absolutePath}`);
 				_agiflowai_aicode_utils.messages.hint("For monorepo: ensure project.json exists with sourceTemplate field\nFor monolith: ensure toolkit.yaml exists at workspace root\nOr use --template option to list methods for a specific template");
 				process.exit(1);
 			}
 			result = await scaffoldingMethodsService.listScaffoldingMethods(absolutePath, options.cursor);
-			displayName = projectPath;
+			displayName = projectPath ?? absolutePath;
 		} else {
 			result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template, options.cursor);
 			displayName = `template: ${options.template}`;
@@ -351,7 +445,7 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 		process.exit(1);
 	}
 });
-scaffoldCommand.command("add <featureName>").description("Add a feature to an existing project").option("-p, --project <path>", "Project path", process.cwd()).option("-v, --vars <json>", "JSON string containing variables for the feature").option("--verbose", "Enable verbose logging").action(async (featureName, options) => {
+scaffoldCommand.command("add <featureName>").description("Add a feature to an existing project").option("-p, --project <path>", "Project path", process.cwd()).option("-v, --vars <json>", "JSON string containing variables for the feature").option("--marker <tag>", "Custom scaffold marker tag to inject into generated code files").option("--verbose", "Enable verbose logging").action(async (featureName, options) => {
 	try {
 		const projectPath = node_path.default.resolve(options.project);
 		if (!await _agiflowai_aicode_utils.ProjectConfigResolver.hasConfiguration(projectPath)) {
@@ -408,9 +502,17 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 		const result = await scaffoldingMethodsService.useScaffoldMethod({
 			projectPath,
 			scaffold_feature_name: featureName,
-			variables
+			variables,
+			marker: options.marker
 		});
 		if (result.success) {
+			const scaffoldId = (0, _agiflowai_aicode_utils.generateStableId)(6);
+			if (result.createdFiles && result.createdFiles.length > 0) await require_tools.writePendingScaffoldLog({
+				scaffoldId,
+				projectPath,
+				featureName,
+				generatedFiles: result.createdFiles
+			});
 			_agiflowai_aicode_utils.messages.success("✅ Feature added successfully!");
 			if (result.createdFiles && result.createdFiles.length > 0) {
 				_agiflowai_aicode_utils.print.header("\n📁 Created files:");
@@ -424,6 +526,7 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 					_agiflowai_aicode_utils.print.debug(`   - ${warning}`);
 				});
 			}
+			_agiflowai_aicode_utils.print.debug(`\nSCAFFOLD_ID:${scaffoldId}`);
 			_agiflowai_aicode_utils.print.header("\n📋 Next steps:");
 			_agiflowai_aicode_utils.print.debug("   - Review the generated files");
 			_agiflowai_aicode_utils.print.debug("   - Update imports if necessary");
@@ -437,6 +540,40 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 		process.exit(1);
 	}
 });
+scaffoldCommand.command("generate <featureName>").description("Create a new feature scaffold configuration in a template's scaffold.yaml").option("-t, --template <name>", "Template name (optional in monolith mode)").option("--description <text>", "Feature description").option("--description-file <path>", "Read feature description from a file").option("--instruction <text>", "Detailed feature instructions").option("--instruction-file <path>", "Read detailed feature instructions from a file").option("--variables <json>", "JSON array of variable definitions: [{\"name\":\"featureName\",\"description\":\"Feature name\",\"type\":\"string\",\"required\":true}]").option("-i, --include <path>", "Template include path (repeatable)", collectOption, []).option("--pattern <glob>", "File pattern this scaffold applies to (repeatable)", collectOption, []).action(async (featureName, options) => {
+	try {
+		const templatesPath = await resolveTemplatesPath();
+		const isMonolith = await detectMonolithMode();
+		const description = await loadTextOption({
+			value: options.description,
+			filePath: options.descriptionFile,
+			valueFlag: "--description",
+			fileFlag: "--description-file",
+			required: true
+		});
+		const instruction = await loadTextOption({
+			value: options.instruction,
+			filePath: options.instructionFile,
+			valueFlag: "--instruction",
+			fileFlag: "--instruction-file"
+		});
+		const variables = parseJsonOption(options.variables, "--variables");
+		if (!Array.isArray(variables)) throw new Error("--variables must be a JSON array");
+		const result = await new require_tools.GenerateFeatureScaffoldTool(templatesPath, isMonolith).execute({
+			templateName: options.template,
+			featureName,
+			description: description ?? "",
+			instruction,
+			variables,
+			includes: options.include ?? [],
+			patterns: options.pattern ?? []
+		});
+		_agiflowai_aicode_utils.print.info(assertToolSuccess(result));
+	} catch (error) {
+		_agiflowai_aicode_utils.print.error("Error generating feature scaffold:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
 scaffoldCommand.command("info <featureName>").description("Show detailed information about a scaffold method").option("-p, --project <path>", "Project path").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").action(async (featureName, options) => {
 	try {
 		if (!options.project && !options.template) {
@@ -575,7 +712,7 @@ const hookCommand = new commander.Command("hook").description("Execute scaffold
 		const resolvedAdapterConfig = Object.keys(adapterConfig).length > 0 ? adapterConfig : void 0;
 		if (!isHookMethod(hookMethod)) process.exit(0);
 		if (agent === _agiflowai_coding_agent_bridge.CLAUDE_CODE) {
-			const hookModule = await Promise.resolve().then(() => require("./claudeCode-BxcEboyM.cjs"));
+			const hookModule = await Promise.resolve().then(() => require("./claudeCode-g1eRidPR.cjs"));
 			const claudeCallbacks = [];
 			if (hookModule.UseScaffoldMethodHook) {
 				const hookInstance = new hookModule.UseScaffoldMethodHook();
@@ -606,6 +743,45 @@ const hookCommand = new commander.Command("hook").description("Execute scaffold
 	}
 });
 //#endregion
+//#region src/commands/template.ts
+const templateCommand = new commander.Command("template").description("Manage scaffold template authoring assets");
+const fileCommand = new commander.Command("file").description("Manage template files");
+fileCommand.command("create <filePath>").description("Create or update a Liquid template file for a boilerplate or feature").option("-t, --template <name>", "Template name (optional in monolith mode)").option("--content <text>", "Template file content").option("--content-file <path>", "Read template file content from a file").option("--source-file <path>", "Copy content from an existing source file").option("--header <text>", "Header comment to prepend to the template file").option("--header-file <path>", "Read header comment from a file").action(async (filePath, options) => {
+	try {
+		if ([
+			options.content !== void 0,
+			options.contentFile !== void 0,
+			options.sourceFile !== void 0
+		].filter(Boolean).length !== 1) throw new Error("Use exactly one of --content, --content-file, or --source-file");
+		const templatesPath = await resolveTemplatesPath();
+		const isMonolith = await detectMonolithMode();
+		const content = await loadTextOption({
+			value: options.content,
+			filePath: options.contentFile,
+			valueFlag: "--content",
+			fileFlag: "--content-file"
+		});
+		const header = await loadTextOption({
+			value: options.header,
+			filePath: options.headerFile,
+			valueFlag: "--header",
+			fileFlag: "--header-file"
+		});
+		const result = await new require_tools.GenerateBoilerplateFileTool(templatesPath, isMonolith).execute({
+			templateName: options.template,
+			filePath,
+			content,
+			sourceFile: options.sourceFile,
+			header
+		});
+		_agiflowai_aicode_utils.print.info(assertToolSuccess(result));
+	} catch (error) {
+		_agiflowai_aicode_utils.print.error("Error creating template file:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
+templateCommand.addCommand(fileCommand);
+//#endregion
 //#region src/cli.ts
 /**
 * Main entry point
@@ -616,6 +792,8 @@ async function main() {
 	program.addCommand(mcpServeCommand);
 	program.addCommand(boilerplateCommand);
 	program.addCommand(scaffoldCommand);
+	program.addCommand(templateCommand);
+	program.addCommand(fileCommand$1);
 	program.addCommand(hookCommand);
 	await program.parseAsync(process.argv);
 }

package/dist/cli.mjs

@@ -1,12 +1,53 @@
 #!/usr/bin/env node
-import { a as createServer, i as StdioTransportHandler, n as HttpTransportHandler, o as version, r as SseTransportHandler, t as TransportMode } from "./src-BEwgHhCT.mjs";
+import { a as createServer, i as StdioTransportHandler, n as HttpTransportHandler, o as version, r as SseTransportHandler, t as TransportMode } from "./src-DnVktdhD.mjs";
 import { n as ScaffoldingMethodsService, s as FileSystemService } from "./ListScaffoldingMethodsTool-DxdrPlcb.mjs";
-import { l as BoilerplateService } from "./tools-Cl06aoBi.mjs";
-import { ProjectConfigResolver, TemplatesManagerService, icons, messages, print, sections } from "@agiflowai/aicode-utils";
+import { c as GenerateBoilerplateFileTool, o as GenerateFeatureScaffoldTool, r as writePendingScaffoldLog, s as GenerateBoilerplateTool, t as WriteToFileTool, u as BoilerplateService } from "./tools-Dn5KgBUI.mjs";
+import { ProjectConfigResolver, TemplatesManagerService, generateStableId, icons, messages, print, readFile, sections } from "@agiflowai/aicode-utils";
 import path from "node:path";
 import { Command } from "commander";
 import { CLAUDE_CODE, GEMINI_CLI, SUPPORTED_LLM_TOOLS, isValidLlmTool } from "@agiflowai/coding-agent-bridge";
 import { ClaudeCodeAdapter, GeminiCliAdapter, parseHookType } from "@agiflowai/hooks-adapter";
+//#region src/commands/utils.ts
+function parseJsonOption(value, flagName) {
+	if (!value) throw new Error(`${flagName} is required`);
+	try {
+		return JSON.parse(value);
+	} catch (error) {
+		throw new Error(`Invalid JSON for ${flagName}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+async function resolveTemplatesPath() {
+	const templatesDir = await TemplatesManagerService.findTemplatesPath();
+	if (!templatesDir) throw new Error("Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml");
+	return templatesDir;
+}
+async function detectMonolithMode() {
+	try {
+		return (await ProjectConfigResolver.resolveProjectConfig(process.cwd())).type === "monolith";
+	} catch {
+		return false;
+	}
+}
+async function loadTextOption(config) {
+	const { value, filePath, valueFlag, fileFlag, required = false } = config;
+	if (value !== void 0 && filePath !== void 0) throw new Error(`Use only one of ${valueFlag} or ${fileFlag}`);
+	if (filePath !== void 0) return readFile(filePath, "utf-8");
+	if (value !== void 0) return value;
+	if (required) throw new Error(`${valueFlag} or ${fileFlag} is required`);
+}
+function collectOption(value, previous = []) {
+	return [...previous, value];
+}
+function firstTextContent(result) {
+	const firstContent = result.content[0];
+	return firstContent?.type === "text" ? firstContent.text : "";
+}
+function assertToolSuccess(result) {
+	const text = firstTextContent(result);
+	if (result.isError) throw new Error(text || "Tool execution failed");
+	return text;
+}
+//#endregion
 //#region src/commands/boilerplate.ts
 /**
 * Boilerplate CLI command
@@ -43,7 +84,7 @@ boilerplateCommand.command("list").description("List all available boilerplate t
 		process.exit(1);
 	}
 });
-boilerplateCommand.command("create <boilerplateName>").description("Create a new project from a boilerplate template").option("-v, --vars <json>", "JSON string containing variables for the boilerplate").option("-m, --monolith", "Create as monolith project at workspace root with toolkit.yaml (default: false, creates as monorepo with project.json)").option("-t, --target-folder <path>", "Override target folder (defaults to boilerplate targetFolder for monorepo, workspace root for monolith)").option("--verbose", "Enable verbose logging").action(async (boilerplateName, options) => {
+boilerplateCommand.command("create <boilerplateName>").description("Create a new project from a boilerplate template").option("-v, --vars <json>", "JSON string containing variables for the boilerplate").option("-m, --monolith", "Create as monolith project at workspace root with toolkit.yaml (default: false, creates as monorepo with project.json)").option("-t, --target-folder <path>", "Override target folder (defaults to boilerplate targetFolder for monorepo, workspace root for monolith)").option("--marker <tag>", "Custom scaffold marker tag to inject into generated code files").option("--verbose", "Enable verbose logging").action(async (boilerplateName, options) => {
 	try {
 		const templatesDir = await TemplatesManagerService.findTemplatesPath();
 		if (!templatesDir) {
@@ -93,7 +134,8 @@ boilerplateCommand.command("create <boilerplateName>").description("Create a new
 			boilerplateName,
 			variables,
 			monolith: options.monolith,
-			targetFolderOverride: options.targetFolder
+			targetFolderOverride: options.targetFolder,
+			marker: options.marker
 		});
 		if (result.success) {
 			messages.success("Project created successfully!");
@@ -120,6 +162,42 @@ boilerplateCommand.command("create <boilerplateName>").description("Create a new
 		process.exit(1);
 	}
 });
+boilerplateCommand.command("generate <boilerplateName>").description("Create a new boilerplate configuration in a template's scaffold.yaml").option("-t, --template <name>", "Template name (optional in monolith mode)").option("--description <text>", "Boilerplate description").option("--description-file <path>", "Read boilerplate description from a file").option("--instruction <text>", "Detailed boilerplate instructions").option("--instruction-file <path>", "Read detailed boilerplate instructions from a file").option("--target-folder <path>", "Target folder for generated projects").option("--variables <json>", "JSON array of variable definitions: [{\"name\":\"appName\",\"description\":\"App name\",\"type\":\"string\",\"required\":true}]").option("-i, --include <path>", "Template include path (repeatable)", collectOption, []).action(async (boilerplateName, options) => {
+	try {
+		const templatesPath = await resolveTemplatesPath();
+		const isMonolith = await detectMonolithMode();
+		const description = await loadTextOption({
+			value: options.description,
+			filePath: options.descriptionFile,
+			valueFlag: "--description",
+			fileFlag: "--description-file",
+			required: true
+		});
+		const instruction = await loadTextOption({
+			value: options.instruction,
+			filePath: options.instructionFile,
+			valueFlag: "--instruction",
+			fileFlag: "--instruction-file"
+		});
+		const variables = parseJsonOption(options.variables, "--variables");
+		if (!Array.isArray(variables)) throw new Error("--variables must be a JSON array");
+		const targetFolder = options.targetFolder ?? (isMonolith ? "." : void 0);
+		if (!targetFolder) throw new Error("--target-folder is required outside monolith mode");
+		const result = await new GenerateBoilerplateTool(templatesPath, isMonolith).execute({
+			templateName: options.template,
+			boilerplateName,
+			description: description ?? "",
+			instruction,
+			targetFolder,
+			variables,
+			includes: options.include ?? []
+		});
+		print.info(assertToolSuccess(result));
+	} catch (error) {
+		print.error("Error generating boilerplate:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
 boilerplateCommand.command("info <boilerplateName>").description("Show detailed information about a boilerplate template").action(async (boilerplateName) => {
 	try {
 		const templatesDir = await TemplatesManagerService.findTemplatesPath();
@@ -145,6 +223,28 @@ boilerplateCommand.command("info <boilerplateName>").description("Show detailed
 	}
 });
 //#endregion
+//#region src/commands/file.ts
+const fileCommand$1 = new Command("file").description("Workspace file utilities");
+fileCommand$1.command("write <filePath>").description("Write content to a file inside the current workspace").option("--content <text>", "Content to write").option("--content-file <path>", "Read content to write from a file").action(async (filePath, options) => {
+	try {
+		const content = await loadTextOption({
+			value: options.content,
+			filePath: options.contentFile,
+			valueFlag: "--content",
+			fileFlag: "--content-file",
+			required: true
+		});
+		const result = await new WriteToFileTool().execute({
+			file_path: filePath,
+			content
+		});
+		print.info(assertToolSuccess(result));
+	} catch (error) {
+		print.error("Error writing file:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
+//#endregion
 //#region src/commands/mcp-serve.ts
 /**
 * MCP Serve Command
@@ -298,13 +398,6 @@ const mcpServeCommand = new Command("mcp-serve").description("Start MCP server w
 const scaffoldCommand = new Command("scaffold").description("Add features to existing projects");
 scaffoldCommand.command("list [projectPath]").description("List available scaffolding methods for a project or template").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").option("-c, --cursor <cursor>", "Pagination cursor for next page").action(async (projectPath, options) => {
 	try {
-		if (!projectPath && !options.template) {
-			messages.error("Either projectPath or --template option must be provided");
-			messages.hint("Examples:");
-			print.debug("  scaffold-mcp scaffold list ./my-project");
-			print.debug("  scaffold-mcp scaffold list --template nextjs-15");
-			process.exit(1);
-		}
 		const templatesDir = await TemplatesManagerService.findTemplatesPath();
 		if (!templatesDir) {
 			messages.error("Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml");
@@ -313,15 +406,16 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 		const scaffoldingMethodsService = new ScaffoldingMethodsService(new FileSystemService(), templatesDir);
 		let result;
 		let displayName;
-		if (projectPath) {
-			const absolutePath = path.resolve(projectPath);
+		if (projectPath || !options.template) {
+			const inputProjectPath = projectPath ?? process.cwd();
+			const absolutePath = path.resolve(inputProjectPath);
 			if (!await ProjectConfigResolver.hasConfiguration(absolutePath)) {
 				messages.error(`No project configuration found in ${absolutePath}`);
 				messages.hint("For monorepo: ensure project.json exists with sourceTemplate field\nFor monolith: ensure toolkit.yaml exists at workspace root\nOr use --template option to list methods for a specific template");
 				process.exit(1);
 			}
 			result = await scaffoldingMethodsService.listScaffoldingMethods(absolutePath, options.cursor);
-			displayName = projectPath;
+			displayName = projectPath ?? absolutePath;
 		} else {
 			result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template, options.cursor);
 			displayName = `template: ${options.template}`;
@@ -350,7 +444,7 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 		process.exit(1);
 	}
 });
-scaffoldCommand.command("add <featureName>").description("Add a feature to an existing project").option("-p, --project <path>", "Project path", process.cwd()).option("-v, --vars <json>", "JSON string containing variables for the feature").option("--verbose", "Enable verbose logging").action(async (featureName, options) => {
+scaffoldCommand.command("add <featureName>").description("Add a feature to an existing project").option("-p, --project <path>", "Project path", process.cwd()).option("-v, --vars <json>", "JSON string containing variables for the feature").option("--marker <tag>", "Custom scaffold marker tag to inject into generated code files").option("--verbose", "Enable verbose logging").action(async (featureName, options) => {
 	try {
 		const projectPath = path.resolve(options.project);
 		if (!await ProjectConfigResolver.hasConfiguration(projectPath)) {
@@ -407,9 +501,17 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 		const result = await scaffoldingMethodsService.useScaffoldMethod({
 			projectPath,
 			scaffold_feature_name: featureName,
-			variables
+			variables,
+			marker: options.marker
 		});
 		if (result.success) {
+			const scaffoldId = generateStableId(6);
+			if (result.createdFiles && result.createdFiles.length > 0) await writePendingScaffoldLog({
+				scaffoldId,
+				projectPath,
+				featureName,
+				generatedFiles: result.createdFiles
+			});
 			messages.success("✅ Feature added successfully!");
 			if (result.createdFiles && result.createdFiles.length > 0) {
 				print.header("\n📁 Created files:");
@@ -423,6 +525,7 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 					print.debug(`   - ${warning}`);
 				});
 			}
+			print.debug(`\nSCAFFOLD_ID:${scaffoldId}`);
 			print.header("\n📋 Next steps:");
 			print.debug("   - Review the generated files");
 			print.debug("   - Update imports if necessary");
@@ -436,6 +539,40 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 		process.exit(1);
 	}
 });
+scaffoldCommand.command("generate <featureName>").description("Create a new feature scaffold configuration in a template's scaffold.yaml").option("-t, --template <name>", "Template name (optional in monolith mode)").option("--description <text>", "Feature description").option("--description-file <path>", "Read feature description from a file").option("--instruction <text>", "Detailed feature instructions").option("--instruction-file <path>", "Read detailed feature instructions from a file").option("--variables <json>", "JSON array of variable definitions: [{\"name\":\"featureName\",\"description\":\"Feature name\",\"type\":\"string\",\"required\":true}]").option("-i, --include <path>", "Template include path (repeatable)", collectOption, []).option("--pattern <glob>", "File pattern this scaffold applies to (repeatable)", collectOption, []).action(async (featureName, options) => {
+	try {
+		const templatesPath = await resolveTemplatesPath();
+		const isMonolith = await detectMonolithMode();
+		const description = await loadTextOption({
+			value: options.description,
+			filePath: options.descriptionFile,
+			valueFlag: "--description",
+			fileFlag: "--description-file",
+			required: true
+		});
+		const instruction = await loadTextOption({
+			value: options.instruction,
+			filePath: options.instructionFile,
+			valueFlag: "--instruction",
+			fileFlag: "--instruction-file"
+		});
+		const variables = parseJsonOption(options.variables, "--variables");
+		if (!Array.isArray(variables)) throw new Error("--variables must be a JSON array");
+		const result = await new GenerateFeatureScaffoldTool(templatesPath, isMonolith).execute({
+			templateName: options.template,
+			featureName,
+			description: description ?? "",
+			instruction,
+			variables,
+			includes: options.include ?? [],
+			patterns: options.pattern ?? []
+		});
+		print.info(assertToolSuccess(result));
+	} catch (error) {
+		print.error("Error generating feature scaffold:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
 scaffoldCommand.command("info <featureName>").description("Show detailed information about a scaffold method").option("-p, --project <path>", "Project path").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").action(async (featureName, options) => {
 	try {
 		if (!options.project && !options.template) {
@@ -574,7 +711,7 @@ const hookCommand = new Command("hook").description("Execute scaffold hooks for
 		const resolvedAdapterConfig = Object.keys(adapterConfig).length > 0 ? adapterConfig : void 0;
 		if (!isHookMethod(hookMethod)) process.exit(0);
 		if (agent === CLAUDE_CODE) {
-			const hookModule = await import("./claudeCode-DNgNiLlL.mjs");
+			const hookModule = await import("./claudeCode-DbKOy8W8.mjs");
 			const claudeCallbacks = [];
 			if (hookModule.UseScaffoldMethodHook) {
 				const hookInstance = new hookModule.UseScaffoldMethodHook();
@@ -605,6 +742,45 @@ const hookCommand = new Command("hook").description("Execute scaffold hooks for
 	}
 });
 //#endregion
+//#region src/commands/template.ts
+const templateCommand = new Command("template").description("Manage scaffold template authoring assets");
+const fileCommand = new Command("file").description("Manage template files");
+fileCommand.command("create <filePath>").description("Create or update a Liquid template file for a boilerplate or feature").option("-t, --template <name>", "Template name (optional in monolith mode)").option("--content <text>", "Template file content").option("--content-file <path>", "Read template file content from a file").option("--source-file <path>", "Copy content from an existing source file").option("--header <text>", "Header comment to prepend to the template file").option("--header-file <path>", "Read header comment from a file").action(async (filePath, options) => {
+	try {
+		if ([
+			options.content !== void 0,
+			options.contentFile !== void 0,
+			options.sourceFile !== void 0
+		].filter(Boolean).length !== 1) throw new Error("Use exactly one of --content, --content-file, or --source-file");
+		const templatesPath = await resolveTemplatesPath();
+		const isMonolith = await detectMonolithMode();
+		const content = await loadTextOption({
+			value: options.content,
+			filePath: options.contentFile,
+			valueFlag: "--content",
+			fileFlag: "--content-file"
+		});
+		const header = await loadTextOption({
+			value: options.header,
+			filePath: options.headerFile,
+			valueFlag: "--header",
+			fileFlag: "--header-file"
+		});
+		const result = await new GenerateBoilerplateFileTool(templatesPath, isMonolith).execute({
+			templateName: options.template,
+			filePath,
+			content,
+			sourceFile: options.sourceFile,
+			header
+		});
+		print.info(assertToolSuccess(result));
+	} catch (error) {
+		print.error("Error creating template file:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
+templateCommand.addCommand(fileCommand);
+//#endregion
 //#region src/cli.ts
 /**
 * Main entry point
@@ -615,6 +791,8 @@ async function main() {
 	program.addCommand(mcpServeCommand);
 	program.addCommand(boilerplateCommand);
 	program.addCommand(scaffoldCommand);
+	program.addCommand(templateCommand);
+	program.addCommand(fileCommand$1);
 	program.addCommand(hookCommand);
 	await program.parseAsync(process.argv);
 }

package/dist/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-CYZtpU-W.cjs");
-const require_src = require("./src-oF_UdSBu.cjs");
-const require_tools = require("./tools-CVSZSirE.cjs");
+const require_src = require("./src-BG_X82dw.cjs");
+const require_tools = require("./tools-COb9iBtt.cjs");
 exports.BoilerplateGeneratorService = require_tools.BoilerplateGeneratorService;
 exports.BoilerplateService = require_tools.BoilerplateService;
 exports.FileSystemService = require_ListScaffoldingMethodsTool.FileSystemService;

package/dist/index.d.cts

@@ -267,15 +267,10 @@ declare class UseBoilerplateTool {
 //#region src/tools/UseScaffoldMethodTool.d.ts
 declare class UseScaffoldMethodTool {
   static readonly TOOL_NAME = "use-scaffold-method";
-  private static readonly TEMP_LOG_DIR;
   private fileSystemService;
   private scaffoldingMethodsService;
   private isMonolith;
   constructor(templatesPath: string, isMonolith?: boolean);
-  /**
-   * Write scaffold execution info to temp log file for hook processing
-   */
-  private writePendingScaffoldLog;
   /**
    * Get the tool definition for MCP
    */

package/dist/index.d.mts

@@ -266,15 +266,10 @@ declare class UseBoilerplateTool {
 //#region src/tools/UseScaffoldMethodTool.d.ts
 declare class UseScaffoldMethodTool {
   static readonly TOOL_NAME = "use-scaffold-method";
-  private static readonly TEMP_LOG_DIR;
   private fileSystemService;
   private scaffoldingMethodsService;
   private isMonolith;
   constructor(templatesPath: string, isMonolith?: boolean);
-  /**
-   * Write scaffold execution info to temp log file for hook processing
-   */
-  private writePendingScaffoldLog;
   /**
    * Get the tool definition for MCP
    */

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as createServer, i as StdioTransportHandler, n as HttpTransportHandler, r as SseTransportHandler, t as TransportMode } from "./src-BEwgHhCT.mjs";
+import { a as createServer, i as StdioTransportHandler, n as HttpTransportHandler, r as SseTransportHandler, t as TransportMode } from "./src-DnVktdhD.mjs";
 import { a as ScaffoldProcessingService, i as ScaffoldService, l as TemplateService, n as ScaffoldingMethodsService, o as ScaffoldConfigLoader, r as VariableReplacementService, s as FileSystemService, t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-DxdrPlcb.mjs";
-import { a as GenerateFeatureScaffoldTool, c as ScaffoldGeneratorService, i as ListBoilerplatesTool, l as BoilerplateService, n as UseScaffoldMethodTool, o as GenerateBoilerplateTool, r as UseBoilerplateTool, s as GenerateBoilerplateFileTool, t as WriteToFileTool, u as BoilerplateGeneratorService } from "./tools-Cl06aoBi.mjs";
+import { a as ListBoilerplatesTool, c as GenerateBoilerplateFileTool, d as BoilerplateGeneratorService, i as UseBoilerplateTool, l as ScaffoldGeneratorService, n as UseScaffoldMethodTool, o as GenerateFeatureScaffoldTool, s as GenerateBoilerplateTool, t as WriteToFileTool, u as BoilerplateService } from "./tools-Dn5KgBUI.mjs";
 export { BoilerplateGeneratorService, BoilerplateService, FileSystemService, GenerateBoilerplateFileTool, GenerateBoilerplateTool, GenerateFeatureScaffoldTool, HttpTransportHandler, ListBoilerplatesTool, ListScaffoldingMethodsTool, ScaffoldConfigLoader, ScaffoldGeneratorService, ScaffoldProcessingService, ScaffoldService, ScaffoldingMethodsService, SseTransportHandler, StdioTransportHandler, TemplateService, TransportMode, UseBoilerplateTool, UseScaffoldMethodTool, VariableReplacementService, WriteToFileTool, createServer };

package/dist/{src-oF_UdSBu.cjs → src-BG_X82dw.cjs}

@@ -1,5 +1,5 @@
 const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-CYZtpU-W.cjs");
-const require_tools = require("./tools-CVSZSirE.cjs");
+const require_tools = require("./tools-COb9iBtt.cjs");
 let _agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let _modelcontextprotocol_sdk_server_index_js = require("@modelcontextprotocol/sdk/server/index.js");
 let _modelcontextprotocol_sdk_types_js = require("@modelcontextprotocol/sdk/types.js");
@@ -11,7 +11,7 @@ express = require_ListScaffoldingMethodsTool.__toESM(express, 1);
 let node_crypto = require("node:crypto");
 let _modelcontextprotocol_sdk_server_streamableHttp_js = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 //#region package.json
-var version = "1.0.27";
+var version = "1.1.0";
 //#endregion
 //#region src/instructions/server.md?raw
 var server_default = "Use this MCP server to {% if isMonolith %}create your monolith project and add features (pages, components, services, etc.){% else %}create new projects and add features (pages, components, services, etc.){% endif %}.\n\n## Workflow:\n{% if not isMonolith %}\n1. **Creating New Project**: Use `list-boilerplates` → `use-boilerplate`\n2. **Adding Features**: Use `list-scaffolding-methods` → `use-scaffold-method`\n{% else %}\n1. **Creating Project**: Use `use-boilerplate` (boilerplateName auto-detected from `.toolkit/settings.yaml`)\n2. **Adding Features**: Use `list-scaffolding-methods` → `use-scaffold-method`\n{% endif %}\n\n## AI Usage Guidelines:\n{% if not isMonolith %}\n- Always call `list-boilerplates` first when creating new projects to see available options\n{% endif %}\n- Always call `list-scaffolding-methods` first when adding features to understand what's available\n- Follow the exact variable schema provided - validation will fail if required fields are missing\n{% if not isMonolith %}\n- Use kebab-case for project names (e.g., \"my-new-app\")\n{% else %}\n- In monolith mode, parameters like `boilerplateName` and `templateName` are auto-detected from `.toolkit/settings.yaml`\n- You only need to provide `variables` when calling `use-boilerplate` or `use-scaffold-method`\n{% endif %}\n- The tools automatically handle file placement, imports, and code generation\n- Check the returned JSON schemas to understand required vs optional variables\n{% if adminEnabled %}\n\n## Admin Mode (Template Generation):\n\nWhen creating custom boilerplate templates for frameworks not yet supported:\n\n1. **Create Boilerplate Configuration**: Use `generate-boilerplate` to add a new boilerplate entry to a template's scaffold.yaml\n   - Specify template name, boilerplate name, description, target folder, and variable schema\n   - This creates the scaffold.yaml structure following the nextjs-15 pattern\n   - Optional: Add detailed instruction about file purposes and design patterns\n\n2. **Create Feature Configuration**: Use `generate-feature-scaffold` to add a new feature entry to a template's scaffold.yaml\n   - Specify template name, feature name, generator, description, and variable schema\n   - This creates the scaffold.yaml structure for feature scaffolds (pages, components, etc.)\n   - Optional: Add detailed instruction about file purposes and design patterns\n   - Optional: Specify patterns to match existing files this feature works with\n\n3. **Create Template Files**: Use `generate-boilerplate-file` to create the actual template files\n   - Create files referenced in the boilerplate's or feature's includes array\n   - Use {{ variableName }} syntax for Liquid variable placeholders\n   - Can copy from existing source files or provide content directly\n   - Files automatically get .liquid extension\n\n4. **Test the Template**: Use `list-boilerplates`/`list-scaffolding-methods` and `use-boilerplate`/`use-scaffold-method` to verify your template works\n\nExample workflow for boilerplate:\n```\n1. generate-boilerplate { templateName: \"react-vite\", boilerplateName: \"scaffold-vite-app\", ... }\n2. generate-boilerplate-file { templateName: \"react-vite\", filePath: \"package.json\", content: \"...\" }\n3. generate-boilerplate-file { templateName: \"react-vite\", filePath: \"src/App.tsx\", content: \"...\" }\n4. list-boilerplates (verify it appears)\n5. use-boilerplate { boilerplateName: \"scaffold-vite-app\", variables: {...} }\n```\n\nExample workflow for feature:\n```\n1. generate-feature-scaffold { templateName: \"nextjs-15\", featureName: \"scaffold-nextjs-component\", generator: \"componentGenerator.ts\", ... }\n2. generate-boilerplate-file { templateName: \"nextjs-15\", filePath: \"src/components/Component.tsx\", content: \"...\" }\n3. list-scaffolding-methods (verify it appears)\n4. use-scaffold-method { scaffoldName: \"scaffold-nextjs-component\", variables: {...} }\n```\n{% endif %}\n";

package/dist/{src-BEwgHhCT.mjs → src-DnVktdhD.mjs}

@@ -1,5 +1,5 @@
 import { l as TemplateService, t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-DxdrPlcb.mjs";
-import { a as GenerateFeatureScaffoldTool, i as ListBoilerplatesTool, n as UseScaffoldMethodTool, o as GenerateBoilerplateTool, r as UseBoilerplateTool, s as GenerateBoilerplateFileTool, t as WriteToFileTool } from "./tools-Cl06aoBi.mjs";
+import { a as ListBoilerplatesTool, c as GenerateBoilerplateFileTool, i as UseBoilerplateTool, n as UseScaffoldMethodTool, o as GenerateFeatureScaffoldTool, s as GenerateBoilerplateTool, t as WriteToFileTool } from "./tools-Dn5KgBUI.mjs";
 import { TemplatesManagerService } from "@agiflowai/aicode-utils";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListToolsRequestSchema, isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
@@ -10,7 +10,7 @@ import express from "express";
 import { randomUUID } from "node:crypto";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 //#region package.json
-var version = "1.0.27";
+var version = "1.1.0";
 //#endregion
 //#region src/instructions/server.md?raw
 var server_default = "Use this MCP server to {% if isMonolith %}create your monolith project and add features (pages, components, services, etc.){% else %}create new projects and add features (pages, components, services, etc.){% endif %}.\n\n## Workflow:\n{% if not isMonolith %}\n1. **Creating New Project**: Use `list-boilerplates` → `use-boilerplate`\n2. **Adding Features**: Use `list-scaffolding-methods` → `use-scaffold-method`\n{% else %}\n1. **Creating Project**: Use `use-boilerplate` (boilerplateName auto-detected from `.toolkit/settings.yaml`)\n2. **Adding Features**: Use `list-scaffolding-methods` → `use-scaffold-method`\n{% endif %}\n\n## AI Usage Guidelines:\n{% if not isMonolith %}\n- Always call `list-boilerplates` first when creating new projects to see available options\n{% endif %}\n- Always call `list-scaffolding-methods` first when adding features to understand what's available\n- Follow the exact variable schema provided - validation will fail if required fields are missing\n{% if not isMonolith %}\n- Use kebab-case for project names (e.g., \"my-new-app\")\n{% else %}\n- In monolith mode, parameters like `boilerplateName` and `templateName` are auto-detected from `.toolkit/settings.yaml`\n- You only need to provide `variables` when calling `use-boilerplate` or `use-scaffold-method`\n{% endif %}\n- The tools automatically handle file placement, imports, and code generation\n- Check the returned JSON schemas to understand required vs optional variables\n{% if adminEnabled %}\n\n## Admin Mode (Template Generation):\n\nWhen creating custom boilerplate templates for frameworks not yet supported:\n\n1. **Create Boilerplate Configuration**: Use `generate-boilerplate` to add a new boilerplate entry to a template's scaffold.yaml\n   - Specify template name, boilerplate name, description, target folder, and variable schema\n   - This creates the scaffold.yaml structure following the nextjs-15 pattern\n   - Optional: Add detailed instruction about file purposes and design patterns\n\n2. **Create Feature Configuration**: Use `generate-feature-scaffold` to add a new feature entry to a template's scaffold.yaml\n   - Specify template name, feature name, generator, description, and variable schema\n   - This creates the scaffold.yaml structure for feature scaffolds (pages, components, etc.)\n   - Optional: Add detailed instruction about file purposes and design patterns\n   - Optional: Specify patterns to match existing files this feature works with\n\n3. **Create Template Files**: Use `generate-boilerplate-file` to create the actual template files\n   - Create files referenced in the boilerplate's or feature's includes array\n   - Use {{ variableName }} syntax for Liquid variable placeholders\n   - Can copy from existing source files or provide content directly\n   - Files automatically get .liquid extension\n\n4. **Test the Template**: Use `list-boilerplates`/`list-scaffolding-methods` and `use-boilerplate`/`use-scaffold-method` to verify your template works\n\nExample workflow for boilerplate:\n```\n1. generate-boilerplate { templateName: \"react-vite\", boilerplateName: \"scaffold-vite-app\", ... }\n2. generate-boilerplate-file { templateName: \"react-vite\", filePath: \"package.json\", content: \"...\" }\n3. generate-boilerplate-file { templateName: \"react-vite\", filePath: \"src/App.tsx\", content: \"...\" }\n4. list-boilerplates (verify it appears)\n5. use-boilerplate { boilerplateName: \"scaffold-vite-app\", variables: {...} }\n```\n\nExample workflow for feature:\n```\n1. generate-feature-scaffold { templateName: \"nextjs-15\", featureName: \"scaffold-nextjs-component\", generator: \"componentGenerator.ts\", ... }\n2. generate-boilerplate-file { templateName: \"nextjs-15\", filePath: \"src/components/Component.tsx\", content: \"...\" }\n3. list-scaffolding-methods (verify it appears)\n4. use-scaffold-method { scaffoldName: \"scaffold-nextjs-component\", variables: {...} }\n```\n{% endif %}\n";

package/dist/{tools-CVSZSirE.cjs → tools-COb9iBtt.cjs}

@@ -8,7 +8,6 @@ js_yaml = require_ListScaffoldingMethodsTool.__toESM(js_yaml, 1);
 let node_fs = require("node:fs");
 let _composio_json_schema_to_zod = require("@composio/json-schema-to-zod");
 let node_fs_promises = require("node:fs/promises");
-node_fs_promises = require_ListScaffoldingMethodsTool.__toESM(node_fs_promises, 1);
 let node_os = require("node:os");
 node_os = require_ListScaffoldingMethodsTool.__toESM(node_os, 1);
 //#region src/services/BoilerplateGeneratorService.ts
@@ -1314,10 +1313,27 @@ The boilerplate provides a starting point - you may need to add features or cust
 	}
 };
 //#endregion
+//#region src/utils/scaffoldPendingLog.ts
+async function writePendingScaffoldLog(config) {
+	const { scaffoldId, projectPath, featureName, generatedFiles } = config;
+	try {
+		const logEntry = {
+			timestamp: Date.now(),
+			scaffoldId,
+			projectPath,
+			featureName,
+			generatedFiles,
+			operation: "scaffold"
+		};
+		await (0, node_fs_promises.appendFile)(node_path.join(node_os.tmpdir(), `scaffold-mcp-pending-${scaffoldId}.jsonl`), `${JSON.stringify(logEntry)}\n`, "utf-8");
+	} catch (error) {
+		console.error("Failed to write pending scaffold log:", error);
+	}
+}
+//#endregion
 //#region src/tools/UseScaffoldMethodTool.ts
 var UseScaffoldMethodTool = class UseScaffoldMethodTool {
 	static TOOL_NAME = "use-scaffold-method";
-	static TEMP_LOG_DIR = node_os.tmpdir();
 	fileSystemService;
 	scaffoldingMethodsService;
 	isMonolith;
@@ -1327,25 +1343,6 @@ var UseScaffoldMethodTool = class UseScaffoldMethodTool {
 		this.isMonolith = isMonolith;
 	}
 	/**
-	* Write scaffold execution info to temp log file for hook processing
-	*/
-	async writePendingScaffoldLog(scaffoldId, projectPath, featureName, generatedFiles) {
-		try {
-			const logEntry = {
-				timestamp: Date.now(),
-				scaffoldId,
-				projectPath,
-				featureName,
-				generatedFiles,
-				operation: "scaffold"
-			};
-			const tempLogFile = node_path.join(UseScaffoldMethodTool.TEMP_LOG_DIR, `scaffold-mcp-pending-${scaffoldId}.jsonl`);
-			await node_fs_promises.appendFile(tempLogFile, `${JSON.stringify(logEntry)}\n`, "utf-8");
-		} catch (error) {
-			console.error("Failed to write pending scaffold log:", error);
-		}
-	}
-	/**
 	* Get the tool definition for MCP
 	*/
 	getDefinition() {
@@ -1410,7 +1407,12 @@ IMPORTANT:
 				marker
 			});
 			const scaffoldId = (0, _agiflowai_aicode_utils.generateStableId)(6);
-			if (result.createdFiles && result.createdFiles.length > 0) await this.writePendingScaffoldLog(scaffoldId, resolvedProjectPath, scaffold_feature_name, result.createdFiles);
+			if (result.createdFiles && result.createdFiles.length > 0) await writePendingScaffoldLog({
+				scaffoldId,
+				projectPath: resolvedProjectPath,
+				featureName: scaffold_feature_name,
+				generatedFiles: result.createdFiles
+			});
 			return { content: [{
 				type: "text",
 				text: `${result.message}
@@ -1575,3 +1577,9 @@ Object.defineProperty(exports, "WriteToFileTool", {
 		return WriteToFileTool;
 	}
 });
+Object.defineProperty(exports, "writePendingScaffoldLog", {
+	enumerable: true,
+	get: function() {
+		return writePendingScaffoldLog;
+	}
+});

package/dist/{tools-Cl06aoBi.mjs → tools-Dn5KgBUI.mjs}

@@ -6,7 +6,7 @@ import path from "node:path";
 import * as yaml$1 from "js-yaml";
 import { readdirSync } from "node:fs";
 import { jsonSchemaToZod } from "@composio/json-schema-to-zod";
-import * as fs$1 from "node:fs/promises";
+import { appendFile } from "node:fs/promises";
 import * as os$1 from "node:os";
 //#region src/services/BoilerplateGeneratorService.ts
 /**
@@ -1311,10 +1311,27 @@ The boilerplate provides a starting point - you may need to add features or cust
 	}
 };
 //#endregion
+//#region src/utils/scaffoldPendingLog.ts
+async function writePendingScaffoldLog(config) {
+	const { scaffoldId, projectPath, featureName, generatedFiles } = config;
+	try {
+		const logEntry = {
+			timestamp: Date.now(),
+			scaffoldId,
+			projectPath,
+			featureName,
+			generatedFiles,
+			operation: "scaffold"
+		};
+		await appendFile(path$1.join(os$1.tmpdir(), `scaffold-mcp-pending-${scaffoldId}.jsonl`), `${JSON.stringify(logEntry)}\n`, "utf-8");
+	} catch (error) {
+		console.error("Failed to write pending scaffold log:", error);
+	}
+}
+//#endregion
 //#region src/tools/UseScaffoldMethodTool.ts
 var UseScaffoldMethodTool = class UseScaffoldMethodTool {
 	static TOOL_NAME = "use-scaffold-method";
-	static TEMP_LOG_DIR = os$1.tmpdir();
 	fileSystemService;
 	scaffoldingMethodsService;
 	isMonolith;
@@ -1324,25 +1341,6 @@ var UseScaffoldMethodTool = class UseScaffoldMethodTool {
 		this.isMonolith = isMonolith;
 	}
 	/**
-	* Write scaffold execution info to temp log file for hook processing
-	*/
-	async writePendingScaffoldLog(scaffoldId, projectPath, featureName, generatedFiles) {
-		try {
-			const logEntry = {
-				timestamp: Date.now(),
-				scaffoldId,
-				projectPath,
-				featureName,
-				generatedFiles,
-				operation: "scaffold"
-			};
-			const tempLogFile = path$1.join(UseScaffoldMethodTool.TEMP_LOG_DIR, `scaffold-mcp-pending-${scaffoldId}.jsonl`);
-			await fs$1.appendFile(tempLogFile, `${JSON.stringify(logEntry)}\n`, "utf-8");
-		} catch (error) {
-			console.error("Failed to write pending scaffold log:", error);
-		}
-	}
-	/**
 	* Get the tool definition for MCP
 	*/
 	getDefinition() {
@@ -1407,7 +1405,12 @@ IMPORTANT:
 				marker
 			});
 			const scaffoldId = generateStableId(6);
-			if (result.createdFiles && result.createdFiles.length > 0) await this.writePendingScaffoldLog(scaffoldId, resolvedProjectPath, scaffold_feature_name, result.createdFiles);
+			if (result.createdFiles && result.createdFiles.length > 0) await writePendingScaffoldLog({
+				scaffoldId,
+				projectPath: resolvedProjectPath,
+				featureName: scaffold_feature_name,
+				generatedFiles: result.createdFiles
+			});
 			return { content: [{
 				type: "text",
 				text: `${result.message}
@@ -1512,4 +1515,4 @@ Parameters:
 	}
 };
 //#endregion
-export { GenerateFeatureScaffoldTool as a, ScaffoldGeneratorService as c, ListBoilerplatesTool as i, BoilerplateService as l, UseScaffoldMethodTool as n, GenerateBoilerplateTool as o, UseBoilerplateTool as r, GenerateBoilerplateFileTool as s, WriteToFileTool as t, BoilerplateGeneratorService as u };
+export { ListBoilerplatesTool as a, GenerateBoilerplateFileTool as c, BoilerplateGeneratorService as d, UseBoilerplateTool as i, ScaffoldGeneratorService as l, UseScaffoldMethodTool as n, GenerateFeatureScaffoldTool as o, writePendingScaffoldLog as r, GenerateBoilerplateTool as s, WriteToFileTool as t, BoilerplateService as u };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/scaffold-mcp",
   "description": "MCP server for scaffolding applications with boilerplate templates",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {
@@ -42,16 +42,16 @@
     "commander": "14.0.3",
     "execa": "9.6.1",
     "express": "5.2.1",
-    "js-yaml": "4.1.1",
-    "liquidjs": "10.25.5",
+    "js-yaml": "4.2.0",
+    "liquidjs": "10.27.0",
     "minimatch": "10.2.5",
     "pino": "10.3.1",
     "pino-pretty": "13.1.3",
     "zod": "4.3.6",
-    "@agiflowai/aicode-utils": "1.1.0",
-    "@agiflowai/architect-mcp": "1.1.0",
-    "@agiflowai/hooks-adapter": "0.1.0",
-    "@agiflowai/coding-agent-bridge": "1.1.0"
+    "@agiflowai/aicode-utils": "1.2.0",
+    "@agiflowai/architect-mcp": "1.2.0",
+    "@agiflowai/hooks-adapter": "0.1.1",
+    "@agiflowai/coding-agent-bridge": "1.2.0"
   },
   "devDependencies": {
     "@types/express": "5.0.6",