@agiflowai/scaffold-mcp 1.2.0 → 1.3.0

package/README.md

@@ -303,6 +303,20 @@ Hooks let scaffold-mcp proactively suggest templates when your AI agent creates
 
 When Claude tries to write a new file, the hook shows available scaffolding methods that match, so Claude can use templates instead of writing from scratch.
 
+Hooks are also available for **Gemini CLI** and **OpenAI Codex CLI** (`--type codex.preToolUse`, configured in `.codex/config.toml`); see the hooks docs for setup.
+
+**Relaxing enforcement:** to let some files (docs, content, generated code) be written directly, add exclude globs — workspace-wide via `scaffold-mcp.hook.excludeGlobs` in `.toolkit/settings.yaml`, or per-template via a top-level `exclude` in `scaffold.yaml`:
+
+```yaml
+# .toolkit/settings.yaml
+scaffold-mcp:
+  hook:
+    excludeGlobs:
+      - '**/*.md'
+      - '**/*.mdx'
+      - '**/src/content/**'
+```
+
 See [Hooks Documentation](./docs/hooks.md) for details.
 
 ---

package/dist/{ListScaffoldingMethodsTool-DxdrPlcb.mjs → ListScaffoldingMethodsTool-dHaM4QXT.mjs}

@@ -174,6 +174,7 @@ const ScaffoldConfigEntrySchema = z.object({
 	patterns: z.array(z.string()).optional()
 });
 const ScaffoldYamlSchema = z.object({
+	exclude: z.array(z.string()).optional(),
 	boilerplate: z.union([ScaffoldConfigEntrySchema, z.array(ScaffoldConfigEntrySchema)]).optional(),
 	features: z.union([ScaffoldConfigEntrySchema, z.array(ScaffoldConfigEntrySchema)]).optional()
 }).catchall(z.union([ScaffoldConfigEntrySchema, z.array(ScaffoldConfigEntrySchema)]));
@@ -761,6 +762,7 @@ var ScaffoldingMethodsService = class {
 		if (!await this.fileSystem.pathExists(scaffoldYamlPath)) throw new Error(`scaffold.yaml not found at ${scaffoldYamlPath}`);
 		const scaffoldContent = await this.fileSystem.readFile(scaffoldYamlPath, "utf8");
 		const architectConfig = yaml.load(scaffoldContent);
+		const excludeGlobs = Array.isArray(architectConfig.exclude) ? architectConfig.exclude : [];
 		const methods = [];
 		if (architectConfig.features && Array.isArray(architectConfig.features)) architectConfig.features.forEach((feature) => {
 			const featureName = feature.name || `scaffold-${templateName}`;
@@ -779,16 +781,18 @@ var ScaffoldingMethodsService = class {
 		});
 		return {
 			templatePath,
-			methods
+			methods,
+			excludeGlobs
 		};
 	}
 	async listScaffoldingMethodsByTemplate(templateName, cursor) {
-		const { templatePath, methods } = await this.collectAllMethodsByTemplate(templateName);
+		const { templatePath, methods, excludeGlobs } = await this.collectAllMethodsByTemplate(templateName);
 		const paginatedResult = PaginationHelper.paginate(methods, cursor);
 		return {
 			sourceTemplate: templateName,
 			templatePath,
 			methods: paginatedResult.items,
+			excludeGlobs,
 			nextCursor: paginatedResult.nextCursor,
 			_meta: paginatedResult._meta
 		};

package/dist/{ListScaffoldingMethodsTool-CYZtpU-W.cjs → ListScaffoldingMethodsTool-rX9Hxn2d.cjs}

@@ -198,6 +198,7 @@ const ScaffoldConfigEntrySchema = zod.z.object({
 	patterns: zod.z.array(zod.z.string()).optional()
 });
 const ScaffoldYamlSchema = zod.z.object({
+	exclude: zod.z.array(zod.z.string()).optional(),
 	boilerplate: zod.z.union([ScaffoldConfigEntrySchema, zod.z.array(ScaffoldConfigEntrySchema)]).optional(),
 	features: zod.z.union([ScaffoldConfigEntrySchema, zod.z.array(ScaffoldConfigEntrySchema)]).optional()
 }).catchall(zod.z.union([ScaffoldConfigEntrySchema, zod.z.array(ScaffoldConfigEntrySchema)]));
@@ -785,6 +786,7 @@ var ScaffoldingMethodsService = class {
 		if (!await this.fileSystem.pathExists(scaffoldYamlPath)) throw new Error(`scaffold.yaml not found at ${scaffoldYamlPath}`);
 		const scaffoldContent = await this.fileSystem.readFile(scaffoldYamlPath, "utf8");
 		const architectConfig = js_yaml.default.load(scaffoldContent);
+		const excludeGlobs = Array.isArray(architectConfig.exclude) ? architectConfig.exclude : [];
 		const methods = [];
 		if (architectConfig.features && Array.isArray(architectConfig.features)) architectConfig.features.forEach((feature) => {
 			const featureName = feature.name || `scaffold-${templateName}`;
@@ -803,16 +805,18 @@ var ScaffoldingMethodsService = class {
 		});
 		return {
 			templatePath,
-			methods
+			methods,
+			excludeGlobs
 		};
 	}
 	async listScaffoldingMethodsByTemplate(templateName, cursor) {
-		const { templatePath, methods } = await this.collectAllMethodsByTemplate(templateName);
+		const { templatePath, methods, excludeGlobs } = await this.collectAllMethodsByTemplate(templateName);
 		const paginatedResult = PaginationHelper.paginate(methods, cursor);
 		return {
 			sourceTemplate: templateName,
 			templatePath,
 			methods: paginatedResult.items,
+			excludeGlobs,
 			nextCursor: paginatedResult.nextCursor,
 			_meta: paginatedResult._meta
 		};

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

@@ -1,6 +1,6 @@
-import { t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-DxdrPlcb.mjs";
-import "./tools-Dn5KgBUI.mjs";
-import { n as resolveNewFileWriteTarget, t as formatScaffoldMethodsHookMessage } from "./shared-BVYIN3Is.mjs";
+import { t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-dHaM4QXT.mjs";
+import "./tools-BR1vQd_Y.mjs";
+import { n as getGlobalExcludeGlobs, o as resolveNewFileWriteTarget, r as matchesExcludeGlob, t as formatScaffoldMethodsHookMessage } from "./shared-BJjclypj.mjs";
 import { ProjectFinderService, TemplatesManagerService } from "@agiflowai/aicode-utils";
 import path from "node:path";
 import fs from "node:fs/promises";
@@ -152,6 +152,7 @@ var PhantomCodeCheckHook = class {
 function isScaffoldMethodsResponse(value) {
 	if (typeof value !== "object" || value === null) return false;
 	if ("methods" in value && !Array.isArray(value.methods)) return false;
+	if ("excludeGlobs" in value && !Array.isArray(value.excludeGlobs)) return false;
 	if ("nextCursor" in value && typeof value.nextCursor !== "string") return false;
 	return true;
 }
@@ -189,6 +190,10 @@ var UseScaffoldMethodHook = class {
 				decision: DECISION_SKIP,
 				message: "Not a new file write operation"
 			};
+			if (matchesExcludeGlob(absoluteFilePath, await getGlobalExcludeGlobs(context.cwd))) return {
+				decision: DECISION_ALLOW,
+				message: "File matches configured excludeGlobs - writing directly."
+			};
 			const executionLog = new ExecutionLogService(context.session_id);
 			if (await executionLog.hasExecuted({
 				filePath,
@@ -225,6 +230,10 @@ var UseScaffoldMethodHook = class {
 				message: "⚠️ Unexpected response shape from scaffolding methods tool"
 			};
 			const data = parsed;
+			if (matchesExcludeGlob(absoluteFilePath, data.excludeGlobs)) return {
+				decision: DECISION_ALLOW,
+				message: "File matches template exclude globs - writing directly."
+			};
 			if (!data.methods || data.methods.length === 0) {
 				await executionLog.logExecution({
 					filePath,

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

@@ -1,6 +1,6 @@
-const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-CYZtpU-W.cjs");
-require("./tools-COb9iBtt.cjs");
-const require_shared = require("./shared-QxPXh-L-.cjs");
+const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-rX9Hxn2d.cjs");
+require("./tools-CV6GWs6f.cjs");
+const require_shared = require("./shared-B0H-6AUG.cjs");
 let _agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let node_path = require("node:path");
 node_path = require_ListScaffoldingMethodsTool.__toESM(node_path, 1);
@@ -155,6 +155,7 @@ var PhantomCodeCheckHook = class {
 function isScaffoldMethodsResponse(value) {
 	if (typeof value !== "object" || value === null) return false;
 	if ("methods" in value && !Array.isArray(value.methods)) return false;
+	if ("excludeGlobs" in value && !Array.isArray(value.excludeGlobs)) return false;
 	if ("nextCursor" in value && typeof value.nextCursor !== "string") return false;
 	return true;
 }
@@ -192,6 +193,10 @@ var UseScaffoldMethodHook = class {
 				decision: _agiflowai_hooks_adapter.DECISION_SKIP,
 				message: "Not a new file write operation"
 			};
+			if (require_shared.matchesExcludeGlob(absoluteFilePath, await require_shared.getGlobalExcludeGlobs(context.cwd))) return {
+				decision: _agiflowai_hooks_adapter.DECISION_ALLOW,
+				message: "File matches configured excludeGlobs - writing directly."
+			};
 			const executionLog = new _agiflowai_hooks_adapter.ExecutionLogService(context.session_id);
 			if (await executionLog.hasExecuted({
 				filePath,
@@ -228,6 +233,10 @@ var UseScaffoldMethodHook = class {
 				message: "⚠️ Unexpected response shape from scaffolding methods tool"
 			};
 			const data = parsed;
+			if (require_shared.matchesExcludeGlob(absoluteFilePath, data.excludeGlobs)) return {
+				decision: _agiflowai_hooks_adapter.DECISION_ALLOW,
+				message: "File matches template exclude globs - writing directly."
+			};
 			if (!data.methods || data.methods.length === 0) {
 				await executionLog.logExecution({
 					filePath,

package/dist/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-CYZtpU-W.cjs");
-const require_src = require("./src-BG_X82dw.cjs");
-const require_tools = require("./tools-COb9iBtt.cjs");
+const require_ListScaffoldingMethodsTool = require("./ListScaffoldingMethodsTool-rX9Hxn2d.cjs");
+const require_src = require("./src-CRT1Er93.cjs");
+const require_tools = require("./tools-CV6GWs6f.cjs");
 let _agiflowai_aicode_utils = require("@agiflowai/aicode-utils");
 let node_path = require("node:path");
 node_path = require_ListScaffoldingMethodsTool.__toESM(node_path, 1);
@@ -712,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-g1eRidPR.cjs"));
+			const hookModule = await Promise.resolve().then(() => require("./claudeCode-DZnJyFQt.cjs"));
 			const claudeCallbacks = [];
 			if (hookModule.UseScaffoldMethodHook) {
 				const hookInstance = new hookModule.UseScaffoldMethodHook();
@@ -727,7 +727,7 @@ const hookCommand = new commander.Command("hook").description("Execute scaffold
 			if (claudeCallbacks.length === 0) process.exit(0);
 			await new _agiflowai_hooks_adapter.ClaudeCodeAdapter().executeMultiple(claudeCallbacks, resolvedAdapterConfig);
 		} else if (agent === _agiflowai_coding_agent_bridge.GEMINI_CLI) {
-			const hookModule = await Promise.resolve().then(() => require("./geminiCli--s1Qy7ZP.cjs"));
+			const hookModule = await Promise.resolve().then(() => require("./geminiCli-wTHUG-A6.cjs"));
 			const geminiCallbacks = [];
 			if (hookModule.UseScaffoldMethodHook) {
 				const hookInstance = new hookModule.UseScaffoldMethodHook();
@@ -736,7 +736,17 @@ const hookCommand = new commander.Command("hook").description("Execute scaffold
 			}
 			if (geminiCallbacks.length === 0) process.exit(0);
 			await new _agiflowai_hooks_adapter.GeminiCliAdapter().executeMultiple(geminiCallbacks, resolvedAdapterConfig);
-		} else throw new Error(`Unsupported agent: ${agent}. Supported: ${_agiflowai_coding_agent_bridge.CLAUDE_CODE}, ${_agiflowai_coding_agent_bridge.GEMINI_CLI}`);
+		} else if (agent === _agiflowai_coding_agent_bridge.CODEX) {
+			const hookModule = await Promise.resolve().then(() => require("./codex-CfOJFx29.cjs"));
+			const codexCallbacks = [];
+			if (hookModule.UseScaffoldMethodHook) {
+				const hookInstance = new hookModule.UseScaffoldMethodHook();
+				const hookFn = hookInstance[hookMethod];
+				if (hookFn) codexCallbacks.push(hookFn.bind(hookInstance));
+			}
+			if (codexCallbacks.length === 0) process.exit(0);
+			await new _agiflowai_hooks_adapter.CodexAdapter().executeMultiple(codexCallbacks, resolvedAdapterConfig);
+		} else throw new Error(`Unsupported agent: ${agent}. Supported: ${_agiflowai_coding_agent_bridge.CLAUDE_CODE}, ${_agiflowai_coding_agent_bridge.GEMINI_CLI}, ${_agiflowai_coding_agent_bridge.CODEX}`);
 	} catch (error) {
 		_agiflowai_aicode_utils.print.error(`Hook error: ${error instanceof Error ? error.message : String(error)}`);
 		process.exit(1);

package/dist/cli.mjs

@@ -1,12 +1,12 @@
 #!/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-DnVktdhD.mjs";
-import { n as ScaffoldingMethodsService, s as FileSystemService } from "./ListScaffoldingMethodsTool-DxdrPlcb.mjs";
-import { c as GenerateBoilerplateFileTool, o as GenerateFeatureScaffoldTool, r as writePendingScaffoldLog, s as GenerateBoilerplateTool, t as WriteToFileTool, u as BoilerplateService } from "./tools-Dn5KgBUI.mjs";
+import { a as createServer, i as StdioTransportHandler, n as HttpTransportHandler, o as version, r as SseTransportHandler, t as TransportMode } from "./src-CUQR93cQ.mjs";
+import { n as ScaffoldingMethodsService, s as FileSystemService } from "./ListScaffoldingMethodsTool-dHaM4QXT.mjs";
+import { c as GenerateBoilerplateFileTool, o as GenerateFeatureScaffoldTool, r as writePendingScaffoldLog, s as GenerateBoilerplateTool, t as WriteToFileTool, u as BoilerplateService } from "./tools-BR1vQd_Y.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";
+import { CLAUDE_CODE, CODEX, GEMINI_CLI, SUPPORTED_LLM_TOOLS, isValidLlmTool } from "@agiflowai/coding-agent-bridge";
+import { ClaudeCodeAdapter, CodexAdapter, GeminiCliAdapter, parseHookType } from "@agiflowai/hooks-adapter";
 //#region src/commands/utils.ts
 function parseJsonOption(value, flagName) {
 	if (!value) throw new Error(`${flagName} is required`);
@@ -711,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-DbKOy8W8.mjs");
+			const hookModule = await import("./claudeCode-CyHppxA_.mjs");
 			const claudeCallbacks = [];
 			if (hookModule.UseScaffoldMethodHook) {
 				const hookInstance = new hookModule.UseScaffoldMethodHook();
@@ -726,7 +726,7 @@ const hookCommand = new Command("hook").description("Execute scaffold hooks for
 			if (claudeCallbacks.length === 0) process.exit(0);
 			await new ClaudeCodeAdapter().executeMultiple(claudeCallbacks, resolvedAdapterConfig);
 		} else if (agent === GEMINI_CLI) {
-			const hookModule = await import("./geminiCli-CcrZEqsz.mjs");
+			const hookModule = await import("./geminiCli-CgajucCd.mjs");
 			const geminiCallbacks = [];
 			if (hookModule.UseScaffoldMethodHook) {
 				const hookInstance = new hookModule.UseScaffoldMethodHook();
@@ -735,7 +735,17 @@ const hookCommand = new Command("hook").description("Execute scaffold hooks for
 			}
 			if (geminiCallbacks.length === 0) process.exit(0);
 			await new GeminiCliAdapter().executeMultiple(geminiCallbacks, resolvedAdapterConfig);
-		} else throw new Error(`Unsupported agent: ${agent}. Supported: ${CLAUDE_CODE}, ${GEMINI_CLI}`);
+		} else if (agent === CODEX) {
+			const hookModule = await import("./codex-7ry557jE.mjs");
+			const codexCallbacks = [];
+			if (hookModule.UseScaffoldMethodHook) {
+				const hookInstance = new hookModule.UseScaffoldMethodHook();
+				const hookFn = hookInstance[hookMethod];
+				if (hookFn) codexCallbacks.push(hookFn.bind(hookInstance));
+			}
+			if (codexCallbacks.length === 0) process.exit(0);
+			await new CodexAdapter().executeMultiple(codexCallbacks, resolvedAdapterConfig);
+		} else throw new Error(`Unsupported agent: ${agent}. Supported: ${CLAUDE_CODE}, ${GEMINI_CLI}, ${CODEX}`);
 	} catch (error) {
 		print.error(`Hook error: ${error instanceof Error ? error.message : String(error)}`);
 		process.exit(1);

package/dist/codex-7ry557jE.mjs

@@ -0,0 +1,254 @@
+import { t as ListScaffoldingMethodsTool } from "./ListScaffoldingMethodsTool-dHaM4QXT.mjs";
+import { a as resolveApplyPatchNewFileTargets, i as resolveApplyPatchEditedPaths, n as getGlobalExcludeGlobs, r as matchesExcludeGlob, t as formatScaffoldMethodsHookMessage } from "./shared-BJjclypj.mjs";
+import { ProjectFinderService, TemplatesManagerService } from "@agiflowai/aicode-utils";
+import path from "node:path";
+import { DECISION_ALLOW, DECISION_DENY, DECISION_SKIP, ExecutionLogService } from "@agiflowai/hooks-adapter";
+//#region src/hooks/codex/useScaffoldMethod.ts
+/**
+* Type guard for ScaffoldMethodsResponse
+*/
+function isScaffoldMethodsResponse(value) {
+	if (typeof value !== "object" || value === null) return false;
+	if ("methods" in value && !Array.isArray(value.methods)) return false;
+	if ("excludeGlobs" in value && !Array.isArray(value.excludeGlobs)) return false;
+	if ("nextCursor" in value && typeof value.nextCursor !== "string") return false;
+	return true;
+}
+/**
+* UseScaffoldMethod Hook class for Codex CLI
+*
+* Provides lifecycle hooks for tool execution:
+* - preToolUse: Shows available scaffolding methods before an apply_patch creates new files
+* - postToolUse: Tracks scaffold completion progress after file edits
+*/
+var UseScaffoldMethodHook = class {
+	/**
+	* PreToolUse hook for Codex CLI
+	* Proactively shows available scaffolding methods and guides the agent to use them
+	* when an apply_patch is about to create a new file.
+	*
+	* @param context - Codex CLI hook input
+	* @returns Hook response with scaffolding methods guidance
+	*/
+	async preToolUse(context) {
+		try {
+			if (!("tool_name" in context)) return {
+				decision: DECISION_SKIP,
+				message: "Not a tool use event"
+			};
+			const command = typeof context.tool_input?.command === "string" ? context.tool_input.command : void 0;
+			const newFileTargets = resolveApplyPatchNewFileTargets(context.cwd, context.tool_name, command);
+			if (newFileTargets.length === 0) return {
+				decision: DECISION_SKIP,
+				message: "Not a new-file apply_patch operation"
+			};
+			const globalExcludeGlobs = await getGlobalExcludeGlobs(context.cwd);
+			const target = newFileTargets.find((p) => !matchesExcludeGlob(p, globalExcludeGlobs));
+			if (!target) return {
+				decision: DECISION_ALLOW,
+				message: "New file(s) match configured excludeGlobs - writing directly."
+			};
+			const executionLog = new ExecutionLogService(context.session_id);
+			if (await executionLog.hasExecuted({
+				filePath: target,
+				decision: DECISION_DENY
+			})) return {
+				decision: DECISION_SKIP,
+				message: "Scaffolding methods already provided for this file"
+			};
+			const templatesPath = await TemplatesManagerService.findTemplatesPath();
+			if (!templatesPath) return {
+				decision: DECISION_SKIP,
+				message: "Templates folder not found - skipping scaffold method check"
+			};
+			const tool = new ListScaffoldingMethodsTool(templatesPath, false);
+			const projectPath = (await new ProjectFinderService(await TemplatesManagerService.getWorkspaceRoot(context.cwd)).findProjectForFile(target))?.root || context.cwd;
+			const result = await tool.execute({ projectPath });
+			const firstContent = result.content[0];
+			if (firstContent?.type !== "text") return {
+				decision: DECISION_SKIP,
+				message: "⚠️ Unexpected response type from scaffolding methods tool"
+			};
+			if (result.isError) return {
+				decision: DECISION_SKIP,
+				message: `⚠️ Could not load scaffolding methods: ${firstContent.text}`
+			};
+			const resultText = firstContent.text;
+			if (typeof resultText !== "string") return {
+				decision: DECISION_SKIP,
+				message: "⚠️ Invalid response format from scaffolding methods tool"
+			};
+			const parsed = JSON.parse(resultText);
+			if (!isScaffoldMethodsResponse(parsed)) return {
+				decision: DECISION_SKIP,
+				message: "⚠️ Unexpected response shape from scaffolding methods tool"
+			};
+			const data = parsed;
+			if (matchesExcludeGlob(target, data.excludeGlobs)) return {
+				decision: DECISION_ALLOW,
+				message: "File matches template exclude globs - writing directly."
+			};
+			if (!data.methods || data.methods.length === 0) {
+				await executionLog.logExecution({
+					filePath: target,
+					operation: "list-scaffold-methods",
+					decision: DECISION_ALLOW
+				});
+				return {
+					decision: DECISION_ALLOW,
+					message: "No scaffolding methods are available for this project template. You should write new files directly."
+				};
+			}
+			const message = formatScaffoldMethodsHookMessage(data.methods);
+			await executionLog.logExecution({
+				filePath: target,
+				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 Codex CLI
+	* Tracks file edits after scaffold generation and reminds the agent to complete
+	* the implementation of all scaffold-generated files.
+	*
+	* @param context - Codex CLI hook input
+	* @returns Hook response with scaffold completion tracking
+	*/
+	async postToolUse(context) {
+		try {
+			if (!("tool_name" in context)) return {
+				decision: DECISION_SKIP,
+				message: "Not a tool use event"
+			};
+			const executionLog = new ExecutionLogService(context.session_id);
+			if (context.tool_name === "use-scaffold-method" || context.tool_input?.toolName === "use-scaffold-method") return {
+				decision: DECISION_ALLOW,
+				message: "Scaffold execution logged for progress tracking"
+			};
+			const command = typeof context.tool_input?.command === "string" ? context.tool_input.command : void 0;
+			const editedPaths = resolveApplyPatchEditedPaths(context.tool_name, command);
+			if (editedPaths.length === 0) 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"
+			};
+			let touchedScaffoldFile = false;
+			for (const editedPath of editedPaths) {
+				const absoluteEditedPath = path.isAbsolute(editedPath) ? editedPath : path.join(context.cwd, editedPath);
+				const generatedMatch = generatedFiles.find((f) => f === editedPath || f === absoluteEditedPath);
+				if (!generatedMatch) continue;
+				touchedScaffoldFile = true;
+				const editKey = `scaffold-edit-${scaffoldId}-${generatedMatch}`;
+				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 (touchedScaffoldFile) {
+				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)}`
+			};
+		}
+	}
+};
+/**
+* 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 the list of edited scaffold files.
+* Returns an 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 };