@agiflowai/scaffold-mcp 1.0.22 → 1.0.24

package/README.md

@@ -149,6 +149,17 @@ npx @agiflowai/scaffold-mcp mcp-serve --type sse --port 3000
 
 # With admin tools enabled
 npx @agiflowai/scaffold-mcp mcp-serve --admin-enable
+
+# With Claude Code skill front matter on prompts
+npx @agiflowai/scaffold-mcp mcp-serve --prompt-as-skill
+
+# With a fallback LLM tool for scaffold operations
+npx @agiflowai/scaffold-mcp mcp-serve --fallback-tool claude-code
+
+# Fallback tool with a specific model config
+npx @agiflowai/scaffold-mcp mcp-serve \
+  --fallback-tool claude-code \
+  --fallback-tool-config '{"model":"claude-sonnet-4-6"}'
 ```
 
 | Option | Description | Default |
@@ -157,6 +168,9 @@ npx @agiflowai/scaffold-mcp mcp-serve --admin-enable
 | `-p, --port` | Port for HTTP/SSE | `3000` |
 | `--host` | Host for HTTP/SSE | `localhost` |
 | `--admin-enable` | Enable template creation tools | `false` |
+| `--prompt-as-skill` | Render MCP prompts with Claude Code skill front matter, exposing them as `/skill` commands | `false` |
+| `--fallback-tool` | LLM tool for scaffold operations (`claude-code`, `gemini-cli`, `codex`) | disabled |
+| `--fallback-tool-config` | JSON config for the fallback tool (e.g., `{"model":"claude-sonnet-4-6"}`) | `{}` |
 
 ---
 

package/dist/{ListScaffoldingMethodsTool-Dnd3E5X_.cjs → ListScaffoldingMethodsTool-CkIkgP_u.cjs}

@@ -25,16 +25,91 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
+let __agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
+let zod = require("zod");
+let liquidjs = require("liquidjs");
 let node_path = require("node:path");
 node_path = __toESM(node_path);
-let __agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let js_yaml = require("js-yaml");
 js_yaml = __toESM(js_yaml);
 let __composio_json_schema_to_zod = require("@composio/json-schema-to-zod");
-let zod = require("zod");
 let node_url = require("node:url");
-let liquidjs = require("liquidjs");
 
+//#region src/services/TemplateService.ts
+var TemplateService = class {
+	liquid;
+	constructor() {
+		this.liquid = new liquidjs.Liquid({
+			strictFilters: false,
+			strictVariables: false
+		});
+		this.setupCustomFilters();
+		__agiflowai_aicode_utils.log.info("TemplateService initialized");
+	}
+	toPascalCase(str) {
+		const camelCase = str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
+		return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
+	}
+	setupCustomFilters() {
+		this.liquid.registerFilter("camelCase", (str) => {
+			return str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
+		});
+		this.liquid.registerFilter("pascalCase", (str) => {
+			return this.toPascalCase(str);
+		});
+		this.liquid.registerFilter("titleCase", (str) => {
+			return this.toPascalCase(str);
+		});
+		this.liquid.registerFilter("kebabCase", (str) => {
+			return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+		});
+		this.liquid.registerFilter("snakeCase", (str) => {
+			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
+		});
+		this.liquid.registerFilter("upperCase", (str) => {
+			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toUpperCase();
+		});
+		this.liquid.registerFilter("lower", (str) => str.toLowerCase());
+		this.liquid.registerFilter("upper", (str) => str.toUpperCase());
+		this.liquid.registerFilter("pluralize", (str) => {
+			if (str.endsWith("y")) return `${str.slice(0, -1)}ies`;
+			else if (str.endsWith("s") || str.endsWith("sh") || str.endsWith("ch") || str.endsWith("x") || str.endsWith("z")) return `${str}es`;
+			else return `${str}s`;
+		});
+		this.liquid.registerFilter("singularize", (str) => {
+			if (str.endsWith("ies")) return `${str.slice(0, -3)}y`;
+			else if (str.endsWith("es")) return str.slice(0, -2);
+			else if (str.endsWith("s") && !str.endsWith("ss")) return str.slice(0, -1);
+			else return str;
+		});
+		this.liquid.registerFilter("strip", (str) => {
+			return str.trim();
+		});
+	}
+	renderString(template, variables) {
+		try {
+			__agiflowai_aicode_utils.log.debug("Rendering template", {
+				variables,
+				templatePreview: template.substring(0, 100)
+			});
+			const result = this.liquid.parseAndRenderSync(template, variables);
+			__agiflowai_aicode_utils.log.debug("Rendered template", { resultPreview: result.substring(0, 100) });
+			return result;
+		} catch (error) {
+			__agiflowai_aicode_utils.log.error("LiquidJS rendering error", {
+				error: error instanceof Error ? error.message : String(error),
+				templatePreview: template.substring(0, 200),
+				variables
+			});
+			return template;
+		}
+	}
+	containsTemplateVariables(content) {
+		return [/\{\{.*?\}\}/, /\{%.*?%\}/].some((pattern) => pattern.test(content));
+	}
+};
+
+//#endregion
 //#region src/utils/pagination.ts
 var PaginationHelper = class PaginationHelper {
 	/**
@@ -622,81 +697,6 @@ var ScaffoldService = class ScaffoldService {
 	}
 };
 
-//#endregion
-//#region src/services/TemplateService.ts
-var TemplateService = class {
-	liquid;
-	constructor() {
-		this.liquid = new liquidjs.Liquid({
-			strictFilters: false,
-			strictVariables: false
-		});
-		this.setupCustomFilters();
-		__agiflowai_aicode_utils.log.info("TemplateService initialized");
-	}
-	toPascalCase(str) {
-		const camelCase = str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
-		return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
-	}
-	setupCustomFilters() {
-		this.liquid.registerFilter("camelCase", (str) => {
-			return str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
-		});
-		this.liquid.registerFilter("pascalCase", (str) => {
-			return this.toPascalCase(str);
-		});
-		this.liquid.registerFilter("titleCase", (str) => {
-			return this.toPascalCase(str);
-		});
-		this.liquid.registerFilter("kebabCase", (str) => {
-			return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-		});
-		this.liquid.registerFilter("snakeCase", (str) => {
-			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
-		});
-		this.liquid.registerFilter("upperCase", (str) => {
-			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toUpperCase();
-		});
-		this.liquid.registerFilter("lower", (str) => str.toLowerCase());
-		this.liquid.registerFilter("upper", (str) => str.toUpperCase());
-		this.liquid.registerFilter("pluralize", (str) => {
-			if (str.endsWith("y")) return `${str.slice(0, -1)}ies`;
-			else if (str.endsWith("s") || str.endsWith("sh") || str.endsWith("ch") || str.endsWith("x") || str.endsWith("z")) return `${str}es`;
-			else return `${str}s`;
-		});
-		this.liquid.registerFilter("singularize", (str) => {
-			if (str.endsWith("ies")) return `${str.slice(0, -3)}y`;
-			else if (str.endsWith("es")) return str.slice(0, -2);
-			else if (str.endsWith("s") && !str.endsWith("ss")) return str.slice(0, -1);
-			else return str;
-		});
-		this.liquid.registerFilter("strip", (str) => {
-			return str.trim();
-		});
-	}
-	renderString(template, variables) {
-		try {
-			__agiflowai_aicode_utils.log.debug("Rendering template", {
-				variables,
-				templatePreview: template.substring(0, 100)
-			});
-			const result = this.liquid.parseAndRenderSync(template, variables);
-			__agiflowai_aicode_utils.log.debug("Rendered template", { resultPreview: result.substring(0, 100) });
-			return result;
-		} catch (error) {
-			__agiflowai_aicode_utils.log.error("LiquidJS rendering error", {
-				error: error instanceof Error ? error.message : String(error),
-				templatePreview: template.substring(0, 200),
-				variables
-			});
-			return template;
-		}
-	}
-	containsTemplateVariables(content) {
-		return [/\{\{.*?\}\}/, /\{%.*?%\}/].some((pattern) => pattern.test(content));
-	}
-};
-
 //#endregion
 //#region src/services/VariableReplacementService.ts
 var VariableReplacementService = class {

package/dist/{ListScaffoldingMethodsTool-DjhhMWjh.mjs → ListScaffoldingMethodsTool-Cx-0gpV3.mjs}

@@ -1,11 +1,86 @@
-import path from "node:path";
 import { ProjectConfigResolver, TemplatesManagerService, copy, ensureDir, log, pathExists, readFile, readJson, readdir, stat, writeFile } from "@agiflowai/aicode-utils";
+import { z } from "zod";
+import { Liquid } from "liquidjs";
+import path from "node:path";
 import yaml from "js-yaml";
 import { jsonSchemaToZod } from "@composio/json-schema-to-zod";
-import { z } from "zod";
 import { fileURLToPath } from "node:url";
-import { Liquid } from "liquidjs";
 
+//#region src/services/TemplateService.ts
+var TemplateService = class {
+	liquid;
+	constructor() {
+		this.liquid = new Liquid({
+			strictFilters: false,
+			strictVariables: false
+		});
+		this.setupCustomFilters();
+		log.info("TemplateService initialized");
+	}
+	toPascalCase(str) {
+		const camelCase = str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
+		return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
+	}
+	setupCustomFilters() {
+		this.liquid.registerFilter("camelCase", (str) => {
+			return str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
+		});
+		this.liquid.registerFilter("pascalCase", (str) => {
+			return this.toPascalCase(str);
+		});
+		this.liquid.registerFilter("titleCase", (str) => {
+			return this.toPascalCase(str);
+		});
+		this.liquid.registerFilter("kebabCase", (str) => {
+			return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+		});
+		this.liquid.registerFilter("snakeCase", (str) => {
+			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
+		});
+		this.liquid.registerFilter("upperCase", (str) => {
+			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toUpperCase();
+		});
+		this.liquid.registerFilter("lower", (str) => str.toLowerCase());
+		this.liquid.registerFilter("upper", (str) => str.toUpperCase());
+		this.liquid.registerFilter("pluralize", (str) => {
+			if (str.endsWith("y")) return `${str.slice(0, -1)}ies`;
+			else if (str.endsWith("s") || str.endsWith("sh") || str.endsWith("ch") || str.endsWith("x") || str.endsWith("z")) return `${str}es`;
+			else return `${str}s`;
+		});
+		this.liquid.registerFilter("singularize", (str) => {
+			if (str.endsWith("ies")) return `${str.slice(0, -3)}y`;
+			else if (str.endsWith("es")) return str.slice(0, -2);
+			else if (str.endsWith("s") && !str.endsWith("ss")) return str.slice(0, -1);
+			else return str;
+		});
+		this.liquid.registerFilter("strip", (str) => {
+			return str.trim();
+		});
+	}
+	renderString(template, variables) {
+		try {
+			log.debug("Rendering template", {
+				variables,
+				templatePreview: template.substring(0, 100)
+			});
+			const result = this.liquid.parseAndRenderSync(template, variables);
+			log.debug("Rendered template", { resultPreview: result.substring(0, 100) });
+			return result;
+		} catch (error) {
+			log.error("LiquidJS rendering error", {
+				error: error instanceof Error ? error.message : String(error),
+				templatePreview: template.substring(0, 200),
+				variables
+			});
+			return template;
+		}
+	}
+	containsTemplateVariables(content) {
+		return [/\{\{.*?\}\}/, /\{%.*?%\}/].some((pattern) => pattern.test(content));
+	}
+};
+
+//#endregion
 //#region src/utils/pagination.ts
 var PaginationHelper = class PaginationHelper {
 	/**
@@ -593,81 +668,6 @@ var ScaffoldService = class ScaffoldService {
 	}
 };
 
-//#endregion
-//#region src/services/TemplateService.ts
-var TemplateService = class {
-	liquid;
-	constructor() {
-		this.liquid = new Liquid({
-			strictFilters: false,
-			strictVariables: false
-		});
-		this.setupCustomFilters();
-		log.info("TemplateService initialized");
-	}
-	toPascalCase(str) {
-		const camelCase = str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
-		return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
-	}
-	setupCustomFilters() {
-		this.liquid.registerFilter("camelCase", (str) => {
-			return str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "");
-		});
-		this.liquid.registerFilter("pascalCase", (str) => {
-			return this.toPascalCase(str);
-		});
-		this.liquid.registerFilter("titleCase", (str) => {
-			return this.toPascalCase(str);
-		});
-		this.liquid.registerFilter("kebabCase", (str) => {
-			return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-		});
-		this.liquid.registerFilter("snakeCase", (str) => {
-			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
-		});
-		this.liquid.registerFilter("upperCase", (str) => {
-			return str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toUpperCase();
-		});
-		this.liquid.registerFilter("lower", (str) => str.toLowerCase());
-		this.liquid.registerFilter("upper", (str) => str.toUpperCase());
-		this.liquid.registerFilter("pluralize", (str) => {
-			if (str.endsWith("y")) return `${str.slice(0, -1)}ies`;
-			else if (str.endsWith("s") || str.endsWith("sh") || str.endsWith("ch") || str.endsWith("x") || str.endsWith("z")) return `${str}es`;
-			else return `${str}s`;
-		});
-		this.liquid.registerFilter("singularize", (str) => {
-			if (str.endsWith("ies")) return `${str.slice(0, -3)}y`;
-			else if (str.endsWith("es")) return str.slice(0, -2);
-			else if (str.endsWith("s") && !str.endsWith("ss")) return str.slice(0, -1);
-			else return str;
-		});
-		this.liquid.registerFilter("strip", (str) => {
-			return str.trim();
-		});
-	}
-	renderString(template, variables) {
-		try {
-			log.debug("Rendering template", {
-				variables,
-				templatePreview: template.substring(0, 100)
-			});
-			const result = this.liquid.parseAndRenderSync(template, variables);
-			log.debug("Rendered template", { resultPreview: result.substring(0, 100) });
-			return result;
-		} catch (error) {
-			log.error("LiquidJS rendering error", {
-				error: error instanceof Error ? error.message : String(error),
-				templatePreview: template.substring(0, 200),
-				variables
-			});
-			return template;
-		}
-	}
-	containsTemplateVariables(content) {
-		return [/\{\{.*?\}\}/, /\{%.*?%\}/].some((pattern) => pattern.test(content));
-	}
-};
-
 //#endregion
 //#region src/services/VariableReplacementService.ts
 var VariableReplacementService = class {
@@ -1054,4 +1054,4 @@ var ListScaffoldingMethodsTool = class ListScaffoldingMethodsTool {
 };
 
 //#endregion
-export { ScaffoldService as a, FileSystemService as c, TemplateService as i, PaginationHelper as l, ScaffoldingMethodsService as n, ScaffoldProcessingService as o, VariableReplacementService as r, ScaffoldConfigLoader as s, ListScaffoldingMethodsTool as t };
+export { ScaffoldProcessingService as a, PaginationHelper as c, ScaffoldService as i, TemplateService as l, ScaffoldingMethodsService as n, ScaffoldConfigLoader as o, VariableReplacementService as r, FileSystemService as s, ListScaffoldingMethodsTool as t };

package/dist/{useScaffoldMethod-CmnKY0Vu.cjs → claudeCode-DBoEGOeu.cjs}

@@ -1,14 +1,154 @@
-const require_ListScaffoldingMethodsTool = require('./ListScaffoldingMethodsTool-Dnd3E5X_.cjs');
-require('./tools-S18iKO9I.cjs');
+const require_ListScaffoldingMethodsTool = require('./ListScaffoldingMethodsTool-CkIkgP_u.cjs');
+require('./tools-CC-lrhQ8.cjs');
+let __agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let node_path = require("node:path");
 node_path = require_ListScaffoldingMethodsTool.__toESM(node_path);
-let __agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_ListScaffoldingMethodsTool.__toESM(node_fs_promises);
 let node_os = require("node:os");
 node_os = require_ListScaffoldingMethodsTool.__toESM(node_os);
 let __agiflowai_hooks_adapter = require("@agiflowai/hooks-adapter");
+let node_child_process = require("node:child_process");
+
+//#region src/hooks/claudeCode/phantomCodeCheck.ts
+/**
+* PhantomCodeCheck Hook for Claude Code
+*
+* DESIGN PATTERNS:
+* - Class-based hook pattern: Encapsulates lifecycle hooks in a single class
+* - Fail-open pattern: Errors allow operation to proceed (return DECISION_SKIP)
+* - Marker-based detection: Scans for scaffold marker comments in code files
+*
+* CODING STANDARDS:
+* - Export a class with stop, userPromptSubmit, taskCompleted methods
+* - Handle all errors gracefully with fail-open behavior
+* - Use execFileSync with args array to avoid shell injection
+*
+* AVOID:
+* - Blocking operations on errors
+* - Shell injection via marker parameter
+* - Mutating context object
+*/
+const EXCLUDED_DIRS = [
+	"node_modules",
+	"dist",
+	".git",
+	".next",
+	"build",
+	"coverage",
+	".claude"
+];
+/**
+* PhantomCodeCheckHook — scans for unimplemented scaffold files containing marker comments.
+*
+* Checks at session boundaries (Stop, UserPromptSubmit, TaskCompleted) whether
+* any generated files still carry the `// <marker>` comment, indicating they
+* have not yet been implemented by the AI agent.
+*/
+var PhantomCodeCheckHook = class {
+	markerComment;
+	constructor(marker = "@scaffold-generated") {
+		this.markerComment = `// ${marker}`;
+	}
+	/**
+	* Scans cwd for files containing the scaffold marker comment.
+	* Returns relative file paths. Returns empty array on any error (fail-open).
+	*/
+	scanForPhantomFiles(cwd) {
+		try {
+			return (0, node_child_process.execFileSync)("grep", [
+				"-rl",
+				this.markerComment,
+				"--include=*.ts",
+				"--include=*.tsx",
+				"--include=*.js",
+				"--include=*.jsx",
+				...EXCLUDED_DIRS.map((dir) => `--exclude-dir=${dir}`),
+				"."
+			], {
+				cwd,
+				timeout: 1e4,
+				encoding: "utf8"
+			}).trim().split("\n").filter(Boolean).map((f) => f.replace(/^\.\//, ""));
+		} catch (error) {
+			if (error instanceof Error && "status" in error && error.status === 1) return [];
+			return [];
+		}
+	}
+	/**
+	* Stop hook — blocks session end if phantom files are found.
+	* Returns DECISION_DENY to prevent Claude from stopping with unimplemented files.
+	*/
+	async stop(context) {
+		try {
+			const phantomFiles = this.scanForPhantomFiles(context.cwd);
+			if (phantomFiles.length === 0) return {
+				decision: __agiflowai_hooks_adapter.DECISION_SKIP,
+				message: "No phantom scaffold files found"
+			};
+			const fileList = phantomFiles.map((f) => `  - ${f}`).join("\n");
+			return {
+				decision: __agiflowai_hooks_adapter.DECISION_DENY,
+				message: `⚠️ ${phantomFiles.length} scaffold file(s) still contain \`${this.markerComment}\` and have not been implemented:\n${fileList}\n\nPlease implement these files and remove the marker comment before ending the session.`
+			};
+		} catch {
+			return {
+				decision: __agiflowai_hooks_adapter.DECISION_SKIP,
+				message: "PhantomCodeCheckHook.stop error — skipping"
+			};
+		}
+	}
+	/**
+	* UserPromptSubmit hook — warns about phantom files without blocking.
+	* Returns DECISION_ALLOW with userMessage written to stderr (visible to user, not LLM).
+	*/
+	async userPromptSubmit(context) {
+		try {
+			const phantomFiles = this.scanForPhantomFiles(context.cwd);
+			if (phantomFiles.length === 0) return {
+				decision: __agiflowai_hooks_adapter.DECISION_SKIP,
+				message: "No phantom scaffold files found"
+			};
+			const fileList = phantomFiles.map((f) => `  - ${f}`).join("\n");
+			return {
+				decision: __agiflowai_hooks_adapter.DECISION_ALLOW,
+				message: "",
+				userMessage: `⚠️ Reminder: ${phantomFiles.length} scaffold file(s) still contain \`${this.markerComment}\`:\n${fileList}\n\nPlease implement these files and remove the marker comment.`
+			};
+		} catch {
+			return {
+				decision: __agiflowai_hooks_adapter.DECISION_SKIP,
+				message: "PhantomCodeCheckHook.userPromptSubmit error — skipping"
+			};
+		}
+	}
+	/**
+	* TaskCompleted hook — blocks task completion if phantom files are found.
+	* Returns DECISION_DENY with exitCode 2 to signal incomplete scaffolding.
+	*/
+	async taskCompleted(context) {
+		try {
+			const phantomFiles = this.scanForPhantomFiles(context.cwd);
+			if (phantomFiles.length === 0) return {
+				decision: __agiflowai_hooks_adapter.DECISION_SKIP,
+				message: "No phantom scaffold files found"
+			};
+			const fileList = phantomFiles.map((f) => `  - ${f}`).join("\n");
+			return {
+				decision: __agiflowai_hooks_adapter.DECISION_DENY,
+				exitCode: 2,
+				message: `⚠️ ${phantomFiles.length} scaffold file(s) still contain \`${this.markerComment}\` and have not been implemented:\n${fileList}\n\nTask cannot complete until all scaffold files are implemented.`
+			};
+		} catch {
+			return {
+				decision: __agiflowai_hooks_adapter.DECISION_SKIP,
+				message: "PhantomCodeCheckHook.taskCompleted error — skipping"
+			};
+		}
+	}
+};
 
+//#endregion
 //#region src/hooks/claudeCode/useScaffoldMethod.ts
 /**
 * Type guard for ScaffoldMethodsResponse
@@ -323,4 +463,5 @@ async function processPendingScaffoldLogs(sessionId, scaffoldId) {
 }
 
 //#endregion
+exports.PhantomCodeCheckHook = PhantomCodeCheckHook;
 exports.UseScaffoldMethodHook = UseScaffoldMethodHook;