@agiflowai/aicode-utils 1.0.16 → 1.0.18

package/dist/index.cjs

@@ -783,6 +783,27 @@ var ScaffoldProcessingService = class {
 	}
 };
 
+//#endregion
+//#region src/utils/fallbacks.ts
+function resolveFallbackConfig(config) {
+	if (!config) return {};
+	const tool = ("fallbackTool" in config ? config.fallbackTool : void 0) ?? ("fallback-tool" in config ? config["fallback-tool"] : void 0);
+	const fallbackConfig = ("fallbackToolConfig" in config ? config.fallbackToolConfig : void 0) ?? ("fallback-tool-config" in config ? config["fallback-tool-config"] : void 0);
+	if (tool) return {
+		tool,
+		config: fallbackConfig
+	};
+	const firstValidFallback = config.fallbacks?.find((entry) => isFallbackConfigEntry(entry));
+	if (!firstValidFallback) return {};
+	return {
+		tool: firstValidFallback.tool,
+		config: firstValidFallback.config
+	};
+}
+function isFallbackConfigEntry(entry) {
+	return Boolean(entry?.tool && typeof entry.tool === "string");
+}
+
 //#endregion
 //#region src/utils/generateStableId.ts
 /**
@@ -1307,6 +1328,7 @@ exports.readJson = readJson;
 exports.readJsonSync = readJsonSync;
 exports.readdir = readdir;
 exports.remove = remove;
+exports.resolveFallbackConfig = resolveFallbackConfig;
 exports.sections = sections;
 exports.stat = stat;
 exports.statSync = node_fs.statSync;

package/dist/index.d.cts

@@ -46,6 +46,15 @@ interface NxProjectJson {
 //#endregion
 //#region src/types/index.d.ts
 
+/**
+ * Ordered fallback LLM entry used in toolkit settings.
+ */
+interface FallbackConfigEntry {
+  /** Fallback LLM tool identifier. */
+  tool: string;
+  /** Config object forwarded when this fallback tool is selected. */
+  config?: Record<string, unknown>;
+}
 /**
  * Configuration for the scaffold-mcp mcp-serve command.
  * Keys map 1-to-1 with CLI flags (camelCase).
@@ -65,6 +74,8 @@ interface McpServeConfig {
   fallbackTool?: string;
   /** Config passed to the fallback LLM tool. */
   fallbackToolConfig?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallbackTool is not set. */
+  fallbacks?: FallbackConfigEntry[];
   /** Extra CLI args merged into the mcp-serve command (key → --key value). */
   args?: Record<string, string | boolean | number>;
 }
@@ -81,6 +92,10 @@ interface HookMethodConfig {
   'fallback-tool'?: string;
   /** Config object forwarded to the fallback LLM tool. */
   'fallback-tool-config'?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallback-tool is not set. */
+  fallbacks?: FallbackConfigEntry[];
+  /** Optional Claude Code tool matcher written to .claude/settings.json. */
+  matcher?: string;
   /** Extra CLI args appended to the generated hook command (key → --key value). */
   args?: Record<string, string | boolean | number>;
 }
@@ -134,6 +149,8 @@ interface ArchitectMcpServeConfig {
   fallbackTool?: string;
   /** Config passed to the fallback LLM tool. */
   fallbackToolConfig?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallbackTool is not set. */
+  fallbacks?: FallbackConfigEntry[];
   /** LLM tool used specifically for get-file-design-pattern analysis. */
   designPatternTool?: string;
   /** Config passed to the design-pattern LLM tool. */
@@ -154,6 +171,14 @@ interface ArchitectHookMethodConfig {
   'llm-tool'?: string;
   /** Config object forwarded to the LLM tool. */
   'tool-config'?: Record<string, unknown>;
+  /** Fallback LLM tool used when llm-tool is not set. */
+  'fallback-tool'?: string;
+  /** Config object forwarded to the fallback LLM tool. */
+  'fallback-tool-config'?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallback-tool is not set. */
+  fallbacks?: FallbackConfigEntry[];
+  /** Optional Claude Code tool matcher written to .claude/settings.json. */
+  matcher?: string;
   /** Extra CLI args appended to the generated hook command (key → --key value). */
   args?: Record<string, string | boolean | number>;
 }
@@ -653,6 +678,24 @@ declare const readdir: typeof fs.readdir;
 declare const mkdir: typeof fs.mkdir;
 declare const stat: typeof fs.stat;
 //#endregion
+//#region src/utils/fallbacks.d.ts
+interface SingleFallbackShape {
+  fallbackTool?: string;
+  fallbackToolConfig?: Record<string, unknown>;
+}
+interface HookFallbackShape {
+  'fallback-tool'?: string;
+  'fallback-tool-config'?: Record<string, unknown>;
+}
+interface FallbackListShape {
+  fallbacks?: FallbackConfigEntry[];
+}
+interface ResolvedFallbackConfig {
+  tool?: string;
+  config?: Record<string, unknown>;
+}
+declare function resolveFallbackConfig(config?: (SingleFallbackShape | HookFallbackShape) & FallbackListShape): ResolvedFallbackConfig;
+//#endregion
 //#region src/utils/generateStableId.d.ts
 /**
  * Generate a stable, random ID string
@@ -956,4 +999,4 @@ interface ProjectTypeDetectionResult {
  */
 declare function detectProjectType(workspaceRoot: string): Promise<ProjectTypeDetectionResult>;
 //#endregion
-export { ArchitectHookAgentConfig, ArchitectHookConfig, ArchitectHookMethodConfig, ArchitectMcpConfig, ArchitectMcpServeConfig, ConfigSource, FileStat, GeneratorContext, GeneratorFunction, GitHubDirectoryEntry, HookAgentConfig, HookConfig, HookMethodConfig, IFileSystemService, IVariableReplacementService, McpServeConfig, type NxProjectJson, ParsedGitHubUrl, ParsedInclude, ProjectConfig, ProjectConfigResolver, type ProjectConfigResult, ProjectFinderService, ProjectType, ScaffoldMcpConfig, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, cloneRepository, cloneSubdirectory, copy, detectProjectType, ensureDir, fetchGitHubDirectoryContents, findWorkspaceRoot, generateStableId, gitInit, icons, log, logger, messages, mkdir, mkdirSync, move, parseGitHubUrl, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, sections, stat, statSync, writeFile, writeFileSync };
+export { ArchitectHookAgentConfig, ArchitectHookConfig, ArchitectHookMethodConfig, ArchitectMcpConfig, ArchitectMcpServeConfig, ConfigSource, FallbackConfigEntry, FileStat, GeneratorContext, GeneratorFunction, GitHubDirectoryEntry, HookAgentConfig, HookConfig, HookMethodConfig, IFileSystemService, IVariableReplacementService, McpServeConfig, type NxProjectJson, ParsedGitHubUrl, ParsedInclude, ProjectConfig, ProjectConfigResolver, type ProjectConfigResult, ProjectFinderService, ProjectType, ResolvedFallbackConfig, ScaffoldMcpConfig, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, cloneRepository, cloneSubdirectory, copy, detectProjectType, ensureDir, fetchGitHubDirectoryContents, findWorkspaceRoot, generateStableId, gitInit, icons, log, logger, messages, mkdir, mkdirSync, move, parseGitHubUrl, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, resolveFallbackConfig, sections, stat, statSync, writeFile, writeFileSync };

package/dist/index.d.mts

@@ -46,6 +46,15 @@ interface NxProjectJson {
 //#endregion
 //#region src/types/index.d.ts
 
+/**
+ * Ordered fallback LLM entry used in toolkit settings.
+ */
+interface FallbackConfigEntry {
+  /** Fallback LLM tool identifier. */
+  tool: string;
+  /** Config object forwarded when this fallback tool is selected. */
+  config?: Record<string, unknown>;
+}
 /**
  * Configuration for the scaffold-mcp mcp-serve command.
  * Keys map 1-to-1 with CLI flags (camelCase).
@@ -65,6 +74,8 @@ interface McpServeConfig {
   fallbackTool?: string;
   /** Config passed to the fallback LLM tool. */
   fallbackToolConfig?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallbackTool is not set. */
+  fallbacks?: FallbackConfigEntry[];
   /** Extra CLI args merged into the mcp-serve command (key → --key value). */
   args?: Record<string, string | boolean | number>;
 }
@@ -81,6 +92,10 @@ interface HookMethodConfig {
   'fallback-tool'?: string;
   /** Config object forwarded to the fallback LLM tool. */
   'fallback-tool-config'?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallback-tool is not set. */
+  fallbacks?: FallbackConfigEntry[];
+  /** Optional Claude Code tool matcher written to .claude/settings.json. */
+  matcher?: string;
   /** Extra CLI args appended to the generated hook command (key → --key value). */
   args?: Record<string, string | boolean | number>;
 }
@@ -134,6 +149,8 @@ interface ArchitectMcpServeConfig {
   fallbackTool?: string;
   /** Config passed to the fallback LLM tool. */
   fallbackToolConfig?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallbackTool is not set. */
+  fallbacks?: FallbackConfigEntry[];
   /** LLM tool used specifically for get-file-design-pattern analysis. */
   designPatternTool?: string;
   /** Config passed to the design-pattern LLM tool. */
@@ -154,6 +171,14 @@ interface ArchitectHookMethodConfig {
   'llm-tool'?: string;
   /** Config object forwarded to the LLM tool. */
   'tool-config'?: Record<string, unknown>;
+  /** Fallback LLM tool used when llm-tool is not set. */
+  'fallback-tool'?: string;
+  /** Config object forwarded to the fallback LLM tool. */
+  'fallback-tool-config'?: Record<string, unknown>;
+  /** Ordered fallback LLM chain consulted when fallback-tool is not set. */
+  fallbacks?: FallbackConfigEntry[];
+  /** Optional Claude Code tool matcher written to .claude/settings.json. */
+  matcher?: string;
   /** Extra CLI args appended to the generated hook command (key → --key value). */
   args?: Record<string, string | boolean | number>;
 }
@@ -653,6 +678,24 @@ declare const readdir: typeof fs.readdir;
 declare const mkdir: typeof fs.mkdir;
 declare const stat: typeof fs.stat;
 //#endregion
+//#region src/utils/fallbacks.d.ts
+interface SingleFallbackShape {
+  fallbackTool?: string;
+  fallbackToolConfig?: Record<string, unknown>;
+}
+interface HookFallbackShape {
+  'fallback-tool'?: string;
+  'fallback-tool-config'?: Record<string, unknown>;
+}
+interface FallbackListShape {
+  fallbacks?: FallbackConfigEntry[];
+}
+interface ResolvedFallbackConfig {
+  tool?: string;
+  config?: Record<string, unknown>;
+}
+declare function resolveFallbackConfig(config?: (SingleFallbackShape | HookFallbackShape) & FallbackListShape): ResolvedFallbackConfig;
+//#endregion
 //#region src/utils/generateStableId.d.ts
 /**
  * Generate a stable, random ID string
@@ -956,4 +999,4 @@ interface ProjectTypeDetectionResult {
  */
 declare function detectProjectType(workspaceRoot: string): Promise<ProjectTypeDetectionResult>;
 //#endregion
-export { ArchitectHookAgentConfig, ArchitectHookConfig, ArchitectHookMethodConfig, ArchitectMcpConfig, ArchitectMcpServeConfig, ConfigSource, FileStat, GeneratorContext, GeneratorFunction, type GitHubDirectoryEntry, HookAgentConfig, HookConfig, HookMethodConfig, IFileSystemService, IVariableReplacementService, McpServeConfig, type NxProjectJson, type ParsedGitHubUrl, ParsedInclude, ProjectConfig, ProjectConfigResolver, type ProjectConfigResult, ProjectFinderService, ProjectType, ScaffoldMcpConfig, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, cloneRepository, cloneSubdirectory, copy, detectProjectType, ensureDir, fetchGitHubDirectoryContents, findWorkspaceRoot, generateStableId, gitInit, icons, log, logger, messages, mkdir, mkdirSync, move, parseGitHubUrl, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, sections, stat, statSync, writeFile, writeFileSync };
+export { ArchitectHookAgentConfig, ArchitectHookConfig, ArchitectHookMethodConfig, ArchitectMcpConfig, ArchitectMcpServeConfig, ConfigSource, FallbackConfigEntry, FileStat, GeneratorContext, GeneratorFunction, type GitHubDirectoryEntry, HookAgentConfig, HookConfig, HookMethodConfig, IFileSystemService, IVariableReplacementService, McpServeConfig, type NxProjectJson, type ParsedGitHubUrl, ParsedInclude, ProjectConfig, ProjectConfigResolver, type ProjectConfigResult, ProjectFinderService, ProjectType, type ResolvedFallbackConfig, ScaffoldMcpConfig, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, cloneRepository, cloneSubdirectory, copy, detectProjectType, ensureDir, fetchGitHubDirectoryContents, findWorkspaceRoot, generateStableId, gitInit, icons, log, logger, messages, mkdir, mkdirSync, move, parseGitHubUrl, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, resolveFallbackConfig, sections, stat, statSync, writeFile, writeFileSync };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
-import * as path$1 from "node:path";
-import path from "node:path";
+import * as path from "node:path";
+import nodePath from "node:path";
 import * as fs from "node:fs/promises";
 import { accessSync, mkdirSync, readFileSync, readFileSync as readFileSync$1, statSync, writeFileSync } from "node:fs";
 import * as os from "node:os";
@@ -84,7 +84,7 @@ async function copy(src, dest) {
 * Move a file or directory
 */
 async function move(src, dest) {
-	await ensureDir(path.dirname(dest));
+	await ensureDir(nodePath.dirname(dest));
 	await fs.rename(src, dest);
 }
 /**
@@ -120,12 +120,12 @@ const cp = fs.cp;
 
 //#endregion
 //#region src/utils/logger.ts
-const logsDir = path$1.join(os.tmpdir(), "scaffold-mcp-logs");
+const logsDir = path.join(os.tmpdir(), "scaffold-mcp-logs");
 const logger = pino({
 	level: process.env.LOG_LEVEL || "debug",
 	timestamp: pino.stdTimeFunctions.isoTime
 }, pino.destination({
-	dest: path$1.join(logsDir, "scaffold-mcp.log"),
+	dest: path.join(logsDir, "scaffold-mcp.log"),
 	mkdir: true,
 	sync: true
 }));
@@ -208,11 +208,11 @@ var TemplatesManagerService = class TemplatesManagerService {
 		const workspaceRoot = await TemplatesManagerService.findWorkspaceRoot(startPath);
 		const config = await TemplatesManagerService.readToolkitConfig(startPath);
 		if (config?.templatesPath) {
-			const templatesPath$1 = path.isAbsolute(config.templatesPath) ? config.templatesPath : path.join(workspaceRoot, config.templatesPath);
+			const templatesPath$1 = nodePath.isAbsolute(config.templatesPath) ? config.templatesPath : nodePath.join(workspaceRoot, config.templatesPath);
 			if (await pathExists(templatesPath$1)) return templatesPath$1;
 			return null;
 		}
-		const templatesPath = path.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
+		const templatesPath = nodePath.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
 		if (await pathExists(templatesPath)) return templatesPath;
 		return null;
 	}
@@ -220,12 +220,12 @@ var TemplatesManagerService = class TemplatesManagerService {
 	* Find the workspace root by searching upwards for .git folder
 	*/
 	static async findWorkspaceRoot(startPath) {
-		let currentPath = path.resolve(startPath);
-		const rootPath = path.parse(currentPath).root;
+		let currentPath = nodePath.resolve(startPath);
+		const rootPath = nodePath.parse(currentPath).root;
 		while (true) {
-			if (await pathExists(path.join(currentPath, ".git"))) return currentPath;
+			if (await pathExists(nodePath.join(currentPath, ".git"))) return currentPath;
 			if (currentPath === rootPath) return process.cwd();
-			currentPath = path.dirname(currentPath);
+			currentPath = nodePath.dirname(currentPath);
 		}
 	}
 	/**
@@ -239,11 +239,11 @@ var TemplatesManagerService = class TemplatesManagerService {
 		const workspaceRoot = TemplatesManagerService.findWorkspaceRootSync(startPath);
 		const config = TemplatesManagerService.readToolkitConfigSync(startPath);
 		if (config?.templatesPath) {
-			const templatesPath$1 = path.isAbsolute(config.templatesPath) ? config.templatesPath : path.join(workspaceRoot, config.templatesPath);
+			const templatesPath$1 = nodePath.isAbsolute(config.templatesPath) ? config.templatesPath : nodePath.join(workspaceRoot, config.templatesPath);
 			if (pathExistsSync(templatesPath$1)) return templatesPath$1;
 			return null;
 		}
-		const templatesPath = path.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
+		const templatesPath = nodePath.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
 		if (pathExistsSync(templatesPath)) return templatesPath;
 		return null;
 	}
@@ -251,12 +251,12 @@ var TemplatesManagerService = class TemplatesManagerService {
 	* Find the workspace root synchronously by searching upwards for .git folder
 	*/
 	static findWorkspaceRootSync(startPath) {
-		let currentPath = path.resolve(startPath);
-		const rootPath = path.parse(currentPath).root;
+		let currentPath = nodePath.resolve(startPath);
+		const rootPath = nodePath.parse(currentPath).root;
 		while (true) {
-			if (pathExistsSync(path.join(currentPath, ".git"))) return currentPath;
+			if (pathExistsSync(nodePath.join(currentPath, ".git"))) return currentPath;
 			if (currentPath === rootPath) return process.cwd();
-			currentPath = path.dirname(currentPath);
+			currentPath = nodePath.dirname(currentPath);
 		}
 	}
 	/**
@@ -295,9 +295,9 @@ var TemplatesManagerService = class TemplatesManagerService {
 	static async readToolkitConfig(startPath = process.cwd()) {
 		const workspaceRoot = await TemplatesManagerService.findWorkspaceRoot(startPath);
 		const yaml$1 = await import("js-yaml");
-		const toolkitFolder = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_FOLDER);
-		const settingsPath = path.join(toolkitFolder, TemplatesManagerService.SETTINGS_FILE);
-		const settingsLocalPath = path.join(toolkitFolder, TemplatesManagerService.SETTINGS_LOCAL_FILE);
+		const toolkitFolder = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_FOLDER);
+		const settingsPath = nodePath.join(toolkitFolder, TemplatesManagerService.SETTINGS_FILE);
+		const settingsLocalPath = nodePath.join(toolkitFolder, TemplatesManagerService.SETTINGS_LOCAL_FILE);
 		if (await pathExists(settingsPath)) {
 			const baseContent = await fs.readFile(settingsPath, "utf-8");
 			const base = yaml$1.load(baseContent);
@@ -308,7 +308,7 @@ var TemplatesManagerService = class TemplatesManagerService {
 			}
 			return base;
 		}
-		const legacyConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const legacyConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		if (!await pathExists(legacyConfigPath)) return null;
 		const content = await fs.readFile(legacyConfigPath, "utf-8");
 		return yaml$1.load(content);
@@ -327,9 +327,9 @@ var TemplatesManagerService = class TemplatesManagerService {
 	static readToolkitConfigSync(startPath = process.cwd()) {
 		const workspaceRoot = TemplatesManagerService.findWorkspaceRootSync(startPath);
 		const yaml$1 = __require("js-yaml");
-		const toolkitFolder = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_FOLDER);
-		const settingsPath = path.join(toolkitFolder, TemplatesManagerService.SETTINGS_FILE);
-		const settingsLocalPath = path.join(toolkitFolder, TemplatesManagerService.SETTINGS_LOCAL_FILE);
+		const toolkitFolder = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_FOLDER);
+		const settingsPath = nodePath.join(toolkitFolder, TemplatesManagerService.SETTINGS_FILE);
+		const settingsLocalPath = nodePath.join(toolkitFolder, TemplatesManagerService.SETTINGS_LOCAL_FILE);
 		if (pathExistsSync(settingsPath)) {
 			const base = yaml$1.load(readFileSync$1(settingsPath, "utf-8"));
 			if (pathExistsSync(settingsLocalPath)) {
@@ -338,7 +338,7 @@ var TemplatesManagerService = class TemplatesManagerService {
 			}
 			return base;
 		}
-		const legacyConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const legacyConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		if (!pathExistsSync(legacyConfigPath)) return null;
 		return yaml$1.load(readFileSync$1(legacyConfigPath, "utf-8"));
 	}
@@ -351,8 +351,8 @@ var TemplatesManagerService = class TemplatesManagerService {
 	*/
 	static async writeToolkitConfig(config, startPath = process.cwd()) {
 		const workspaceRoot = await TemplatesManagerService.findWorkspaceRoot(startPath);
-		const toolkitFolder = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_FOLDER);
-		const settingsPath = path.join(toolkitFolder, TemplatesManagerService.SETTINGS_FILE);
+		const toolkitFolder = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_FOLDER);
+		const settingsPath = nodePath.join(toolkitFolder, TemplatesManagerService.SETTINGS_FILE);
 		await fs.mkdir(toolkitFolder, { recursive: true });
 		const content = (await import("js-yaml")).dump(config, { indent: 2 });
 		await fs.writeFile(settingsPath, content, "utf-8");
@@ -424,13 +424,13 @@ var ProjectConfigResolver = class ProjectConfigResolver {
 	*/
 	static async resolveProjectConfig(projectPath, explicitTemplate) {
 		try {
-			const absolutePath = path.resolve(projectPath);
+			const absolutePath = nodePath.resolve(projectPath);
 			if (explicitTemplate) return {
 				type: ProjectType.MONOLITH,
 				sourceTemplate: explicitTemplate,
 				configSource: ConfigSource.TOOLKIT_YAML
 			};
-			const projectJsonPath = path.join(absolutePath, "project.json");
+			const projectJsonPath = nodePath.join(absolutePath, "project.json");
 			if (await pathExists(projectJsonPath)) {
 				const projectJson = await readJson(projectJsonPath);
 				if (projectJson.sourceTemplate && typeof projectJson.sourceTemplate === "string" && projectJson.sourceTemplate.trim()) return {
@@ -521,12 +521,12 @@ Run 'scaffold-mcp scaffold list --help' for more info.`;
 	* @param sourceTemplate - The template identifier
 	*/
 	static async createProjectJson(projectPath, projectName, sourceTemplate) {
-		const projectJsonPath = path.join(projectPath, "project.json");
+		const projectJsonPath = nodePath.join(projectPath, "project.json");
 		try {
 			let projectJson;
 			if (await pathExists(projectJsonPath)) projectJson = await readJson(projectJsonPath);
 			else {
-				const relativePath = path.relative(projectPath, process.cwd());
+				const relativePath = nodePath.relative(projectPath, process.cwd());
 				projectJson = {
 					name: projectName,
 					$schema: relativePath ? `${relativePath}/node_modules/nx/schemas/project-schema.json` : "node_modules/nx/schemas/project-schema.json",
@@ -578,15 +578,15 @@ var ProjectFinderService = class {
 	* @returns Project configuration or null if not found
 	*/
 	async findProjectForFile(filePath) {
-		const normalizedPath = path.isAbsolute(filePath) ? filePath : path.join(this.workspaceRoot, filePath);
-		let currentDir = path.dirname(normalizedPath);
+		const normalizedPath = nodePath.isAbsolute(filePath) ? filePath : nodePath.join(this.workspaceRoot, filePath);
+		let currentDir = nodePath.dirname(normalizedPath);
 		while (currentDir !== "/" && currentDir.startsWith(this.workspaceRoot)) {
-			const projectJsonPath = path.join(currentDir, "project.json");
+			const projectJsonPath = nodePath.join(currentDir, "project.json");
 			try {
 				const project = await this.loadProjectConfig(projectJsonPath);
 				if (project) return project;
 			} catch {}
-			currentDir = path.dirname(currentDir);
+			currentDir = nodePath.dirname(currentDir);
 		}
 		return null;
 	}
@@ -597,15 +597,15 @@ var ProjectFinderService = class {
 	* @returns Project configuration or null if not found
 	*/
 	findProjectForFileSync(filePath) {
-		const normalizedPath = path.isAbsolute(filePath) ? filePath : path.join(this.workspaceRoot, filePath);
-		let currentDir = path.dirname(normalizedPath);
+		const normalizedPath = nodePath.isAbsolute(filePath) ? filePath : nodePath.join(this.workspaceRoot, filePath);
+		let currentDir = nodePath.dirname(normalizedPath);
 		while (currentDir !== "/" && currentDir.startsWith(this.workspaceRoot)) {
-			const projectJsonPath = path.join(currentDir, "project.json");
+			const projectJsonPath = nodePath.join(currentDir, "project.json");
 			try {
 				const project = this.loadProjectConfigSync(projectJsonPath);
 				if (project) return project;
 			} catch {}
-			currentDir = path.dirname(currentDir);
+			currentDir = nodePath.dirname(currentDir);
 		}
 		return null;
 	}
@@ -618,8 +618,8 @@ var ProjectFinderService = class {
 			const content = await fs.readFile(projectJsonPath, "utf-8");
 			const config = JSON.parse(content);
 			const projectConfig = {
-				name: config.name || path.basename(path.dirname(projectJsonPath)),
-				root: path.dirname(projectJsonPath),
+				name: config.name || nodePath.basename(nodePath.dirname(projectJsonPath)),
+				root: nodePath.dirname(projectJsonPath),
 				sourceTemplate: config.sourceTemplate,
 				projectType: config.projectType
 			};
@@ -638,8 +638,8 @@ var ProjectFinderService = class {
 			const content = readFileSync$1(projectJsonPath, "utf-8");
 			const config = JSON.parse(content);
 			const projectConfig = {
-				name: config.name || path.basename(path.dirname(projectJsonPath)),
-				root: path.dirname(projectJsonPath),
+				name: config.name || nodePath.basename(nodePath.dirname(projectJsonPath)),
+				root: nodePath.dirname(projectJsonPath),
 				sourceTemplate: config.sourceTemplate,
 				projectType: config.projectType
 			};
@@ -699,7 +699,7 @@ var ScaffoldProcessingService = class {
 	* Now supports tracking existing files separately from created files
 	*/
 	async copyAndProcess(sourcePath, targetPath, variables, createdFiles, existingFiles) {
-		await this.fileSystem.ensureDir(path.dirname(targetPath));
+		await this.fileSystem.ensureDir(nodePath.dirname(targetPath));
 		if (await this.fileSystem.pathExists(targetPath) && existingFiles) {
 			await this.trackExistingFiles(targetPath, existingFiles);
 			return;
@@ -721,7 +721,7 @@ var ScaffoldProcessingService = class {
 		}
 		for (const item of items) {
 			if (!item) continue;
-			const itemPath = path.join(dirPath, item);
+			const itemPath = nodePath.join(dirPath, item);
 			try {
 				const stat$1 = await this.fileSystem.stat(itemPath);
 				if (stat$1.isDirectory()) await this.trackCreatedFilesRecursive(itemPath, createdFiles);
@@ -744,7 +744,7 @@ var ScaffoldProcessingService = class {
 		}
 		for (const item of items) {
 			if (!item) continue;
-			const itemPath = path.join(dirPath, item);
+			const itemPath = nodePath.join(dirPath, item);
 			try {
 				const stat$1 = await this.fileSystem.stat(itemPath);
 				if (stat$1.isDirectory()) await this.trackExistingFilesRecursive(itemPath, existingFiles);
@@ -756,6 +756,27 @@ var ScaffoldProcessingService = class {
 	}
 };
 
+//#endregion
+//#region src/utils/fallbacks.ts
+function resolveFallbackConfig(config) {
+	if (!config) return {};
+	const tool = ("fallbackTool" in config ? config.fallbackTool : void 0) ?? ("fallback-tool" in config ? config["fallback-tool"] : void 0);
+	const fallbackConfig = ("fallbackToolConfig" in config ? config.fallbackToolConfig : void 0) ?? ("fallback-tool-config" in config ? config["fallback-tool-config"] : void 0);
+	if (tool) return {
+		tool,
+		config: fallbackConfig
+	};
+	const firstValidFallback = config.fallbacks?.find((entry) => isFallbackConfigEntry(entry));
+	if (!firstValidFallback) return {};
+	return {
+		tool: firstValidFallback.tool,
+		config: firstValidFallback.config
+	};
+}
+function isFallbackConfigEntry(entry) {
+	return Boolean(entry?.tool && typeof entry.tool === "string");
+}
+
 //#endregion
 //#region src/utils/generateStableId.ts
 /**
@@ -871,12 +892,12 @@ async function gitInit(projectPath) {
 * }
 */
 async function findWorkspaceRoot(startPath = process.cwd()) {
-	let currentPath = path.resolve(startPath);
-	const rootPath = path.parse(currentPath).root;
+	let currentPath = nodePath.resolve(startPath);
+	const rootPath = nodePath.parse(currentPath).root;
 	while (true) {
-		if (await pathExists(path.join(currentPath, ".git"))) return currentPath;
+		if (await pathExists(nodePath.join(currentPath, ".git"))) return currentPath;
 		if (currentPath === rootPath) return null;
-		currentPath = path.dirname(currentPath);
+		currentPath = nodePath.dirname(currentPath);
 	}
 }
 /**
@@ -958,7 +979,7 @@ async function cloneSubdirectory(repoUrl, branch, subdirectory, targetFolder) {
 			"core.sparseCheckout",
 			"true"
 		], tempFolder);
-		await writeFile(path.join(tempFolder, ".git", "info", "sparse-checkout"), `${subdirectory}\n`);
+		await writeFile(nodePath.join(tempFolder, ".git", "info", "sparse-checkout"), `${subdirectory}\n`);
 		await execGit([
 			"pull",
 			"--depth=1",
@@ -966,7 +987,7 @@ async function cloneSubdirectory(repoUrl, branch, subdirectory, targetFolder) {
 			"--",
 			branch
 		], tempFolder);
-		const sourceDir = path.join(tempFolder, subdirectory);
+		const sourceDir = nodePath.join(tempFolder, subdirectory);
 		if (!await pathExists(sourceDir)) throw new Error(`Subdirectory '${subdirectory}' not found in repository at branch '${branch}'`);
 		if (await pathExists(targetFolder)) throw new Error(`Target folder already exists: ${targetFolder}`);
 		await move(sourceDir, targetFolder);
@@ -993,7 +1014,7 @@ async function cloneRepository(repoUrl, targetFolder) {
 		repoUrl,
 		targetFolder
 	]);
-	const gitFolder = path.join(targetFolder, ".git");
+	const gitFolder = nodePath.join(targetFolder, ".git");
 	if (await pathExists(gitFolder)) await remove(gitFolder);
 }
 /**
@@ -1210,7 +1231,7 @@ const MONOREPO_INDICATOR_FILES = [
 */
 async function detectProjectType(workspaceRoot) {
 	const indicators = [];
-	const toolkitYamlPath = path.join(workspaceRoot, "toolkit.yaml");
+	const toolkitYamlPath = nodePath.join(workspaceRoot, "toolkit.yaml");
 	if (await pathExists(toolkitYamlPath)) try {
 		const content = await fs.readFile(toolkitYamlPath, "utf-8");
 		const config = yaml.load(content);
@@ -1222,14 +1243,14 @@ async function detectProjectType(workspaceRoot) {
 			};
 		}
 	} catch {}
-	for (const filename of MONOREPO_INDICATOR_FILES) if (await pathExists(path.join(workspaceRoot, filename))) {
+	for (const filename of MONOREPO_INDICATOR_FILES) if (await pathExists(nodePath.join(workspaceRoot, filename))) {
 		indicators.push(`${filename} found`);
 		return {
 			projectType: ProjectType.MONOREPO,
 			indicators
 		};
 	}
-	const packageJsonPath = path.join(workspaceRoot, "package.json");
+	const packageJsonPath = nodePath.join(workspaceRoot, "package.json");
 	if (await pathExists(packageJsonPath)) try {
 		if ((await readJson(packageJsonPath)).workspaces) {
 			indicators.push("package.json with workspaces found");
@@ -1247,4 +1268,4 @@ async function detectProjectType(workspaceRoot) {
 }
 
 //#endregion
-export { ConfigSource, ProjectConfigResolver, ProjectFinderService, ProjectType, ScaffoldProcessingService, TemplatesManagerService, accessSync, cloneRepository, cloneSubdirectory, copy, detectProjectType, ensureDir, fetchGitHubDirectoryContents, findWorkspaceRoot, generateStableId, gitInit, icons, log, logger, messages, mkdir, mkdirSync, move, parseGitHubUrl, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, sections, stat, statSync, writeFile, writeFileSync };
+export { ConfigSource, ProjectConfigResolver, ProjectFinderService, ProjectType, ScaffoldProcessingService, TemplatesManagerService, accessSync, cloneRepository, cloneSubdirectory, copy, detectProjectType, ensureDir, fetchGitHubDirectoryContents, findWorkspaceRoot, generateStableId, gitInit, icons, log, logger, messages, mkdir, mkdirSync, move, parseGitHubUrl, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, resolveFallbackConfig, sections, stat, statSync, writeFile, writeFileSync };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/aicode-utils",
   "description": "Shared utilities and types for AI-powered code generation, scaffolding, and analysis",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {