@agiflowai/aicode-utils 1.0.17 → 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

@@ -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
 /**
@@ -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.17",
+  "version": "1.0.18",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {