@agiflowai/aicode-utils 1.0.5 → 1.0.6

package/dist/index.cjs

@@ -748,6 +748,36 @@ var ScaffoldProcessingService = class {
 	}
 };
 
+//#endregion
+//#region src/utils/generateStableId.ts
+/**
+* Generate a stable, random ID string
+*
+* @param length - Length of the ID to generate (default: 8)
+* @returns A random alphanumeric ID string (lowercase)
+*
+* @remarks
+* Negative or non-integer lengths are normalized (floored and clamped to 0).
+* Returns empty string for length <= 0.
+*
+* @example
+* ```typescript
+* const id = generateStableId(6); // Returns something like "a3f9k2"
+* ```
+*/
+function generateStableId(length = 8) {
+	const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+	let result = "";
+	const normalizedLength = Math.max(0, Math.floor(length));
+	if (normalizedLength === 0) return "";
+	if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+		const values = new Uint8Array(normalizedLength);
+		crypto.getRandomValues(values);
+		for (let i = 0; i < normalizedLength; i++) result += chars[values[i] % 36];
+	} else for (let i = 0; i < normalizedLength; i++) result += chars[Math.floor(Math.random() * 36)];
+	return result;
+}
+
 //#endregion
 //#region src/utils/print.ts
 /**
@@ -995,6 +1025,7 @@ Object.defineProperty(exports, 'fs', {
     return node_fs_promises;
   }
 });
+exports.generateStableId = generateStableId;
 exports.icons = icons;
 exports.isMonolith = isMonolith;
 exports.isMonorepo = isMonorepo;

package/dist/index.d.cts

@@ -403,6 +403,24 @@ declare const rename: typeof fs.rename;
 declare const rm: typeof fs.rm;
 declare const cp: typeof fs.cp;
 //#endregion
+//#region src/utils/generateStableId.d.ts
+/**
+ * Generate a stable, random ID string
+ *
+ * @param length - Length of the ID to generate (default: 8)
+ * @returns A random alphanumeric ID string (lowercase)
+ *
+ * @remarks
+ * Negative or non-integer lengths are normalized (floored and clamped to 0).
+ * Returns empty string for length <= 0.
+ *
+ * @example
+ * ```typescript
+ * const id = generateStableId(6); // Returns something like "a3f9k2"
+ * ```
+ */
+declare function generateStableId(length?: number): string;
+//#endregion
 //#region src/utils/logger.d.ts
 declare const logger: pino.Logger<never, boolean>;
 declare const log: {
@@ -580,4 +598,4 @@ declare function isMonorepo(workspaceRoot: string): Promise<boolean>;
  */
 declare function isMonolith(workspaceRoot: string): Promise<boolean>;
 //#endregion
-export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };
+export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, generateStableId, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };

package/dist/index.d.mts

@@ -403,6 +403,24 @@ declare const rename: typeof fs.rename;
 declare const rm: typeof fs.rm;
 declare const cp: typeof fs.cp;
 //#endregion
+//#region src/utils/generateStableId.d.ts
+/**
+ * Generate a stable, random ID string
+ *
+ * @param length - Length of the ID to generate (default: 8)
+ * @returns A random alphanumeric ID string (lowercase)
+ *
+ * @remarks
+ * Negative or non-integer lengths are normalized (floored and clamped to 0).
+ * Returns empty string for length <= 0.
+ *
+ * @example
+ * ```typescript
+ * const id = generateStableId(6); // Returns something like "a3f9k2"
+ * ```
+ */
+declare function generateStableId(length?: number): string;
+//#endregion
 //#region src/utils/logger.d.ts
 declare const logger: pino.Logger<never, boolean>;
 declare const log: {
@@ -580,4 +598,4 @@ declare function isMonorepo(workspaceRoot: string): Promise<boolean>;
  */
 declare function isMonolith(workspaceRoot: string): Promise<boolean>;
 //#endregion
-export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };
+export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, generateStableId, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };

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";
@@ -89,7 +89,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);
 }
 /**
@@ -123,7 +123,7 @@ function writeJsonSync(filePath, data, options) {
 * Output file - writes content ensuring directory exists
 */
 async function outputFile(filePath, content) {
-	await ensureDir(path.dirname(filePath));
+	await ensureDir(nodePath.dirname(filePath));
 	await fs.writeFile(filePath, content, "utf-8");
 }
 const readFile = fs.readFile;
@@ -138,12 +138,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
 }));
@@ -200,18 +200,18 @@ var TemplatesManagerService = class TemplatesManagerService {
 	*/
 	static async findTemplatesPath(startPath = process.cwd()) {
 		const workspaceRoot = await TemplatesManagerService.findWorkspaceRoot(startPath);
-		const toolkitConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const toolkitConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		if (await pathExists(toolkitConfigPath)) {
 			const yaml$1 = await import("js-yaml");
 			const content = await fs.readFile(toolkitConfigPath, "utf-8");
 			const config = yaml$1.load(content);
 			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;
 				else throw new Error(`Templates path specified in toolkit.yaml does not exist: ${templatesPath$1}`);
 			}
 		}
-		const templatesPath = path.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
+		const templatesPath = nodePath.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
 		if (await pathExists(templatesPath)) return templatesPath;
 		throw new Error(`Templates folder not found at ${templatesPath}.\nEither create a 'templates' folder or specify templatesPath in toolkit.yaml`);
 	}
@@ -219,12 +219,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);
 		}
 	}
 	/**
@@ -237,18 +237,18 @@ var TemplatesManagerService = class TemplatesManagerService {
 	*/
 	static findTemplatesPathSync(startPath = process.cwd()) {
 		const workspaceRoot = TemplatesManagerService.findWorkspaceRootSync(startPath);
-		const toolkitConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const toolkitConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		if (pathExistsSync(toolkitConfigPath)) {
 			const yaml$1 = __require("js-yaml");
 			const content = readFileSync$1(toolkitConfigPath, "utf-8");
 			const config = yaml$1.load(content);
 			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;
 				else throw new Error(`Templates path specified in toolkit.yaml does not exist: ${templatesPath$1}`);
 			}
 		}
-		const templatesPath = path.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
+		const templatesPath = nodePath.join(workspaceRoot, TemplatesManagerService.TEMPLATES_FOLDER);
 		if (pathExistsSync(templatesPath)) return templatesPath;
 		throw new Error(`Templates folder not found at ${templatesPath}.\nEither create a 'templates' folder or specify templatesPath in toolkit.yaml`);
 	}
@@ -256,12 +256,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);
 		}
 	}
 	/**
@@ -294,7 +294,7 @@ var TemplatesManagerService = class TemplatesManagerService {
 	*/
 	static async readToolkitConfig(startPath = process.cwd()) {
 		const workspaceRoot = await TemplatesManagerService.findWorkspaceRoot(startPath);
-		const toolkitConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const toolkitConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		if (!await pathExists(toolkitConfigPath)) return null;
 		const yaml$1 = await import("js-yaml");
 		const content = await fs.readFile(toolkitConfigPath, "utf-8");
@@ -308,7 +308,7 @@ var TemplatesManagerService = class TemplatesManagerService {
 	*/
 	static readToolkitConfigSync(startPath = process.cwd()) {
 		const workspaceRoot = TemplatesManagerService.findWorkspaceRootSync(startPath);
-		const toolkitConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const toolkitConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		if (!pathExistsSync(toolkitConfigPath)) return null;
 		const yaml$1 = __require("js-yaml");
 		const content = readFileSync$1(toolkitConfigPath, "utf-8");
@@ -322,7 +322,7 @@ var TemplatesManagerService = class TemplatesManagerService {
 	*/
 	static async writeToolkitConfig(config, startPath = process.cwd()) {
 		const workspaceRoot = await TemplatesManagerService.findWorkspaceRoot(startPath);
-		const toolkitConfigPath = path.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
+		const toolkitConfigPath = nodePath.join(workspaceRoot, TemplatesManagerService.TOOLKIT_CONFIG_FILE);
 		const content = (await import("js-yaml")).dump(config, { indent: 2 });
 		await fs.writeFile(toolkitConfigPath, content, "utf-8");
 	}
@@ -393,13 +393,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 {
@@ -490,12 +490,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",
@@ -547,15 +547,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;
 	}
@@ -566,15 +566,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;
 	}
@@ -587,8 +587,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
 			};
@@ -607,8 +607,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
 			};
@@ -668,7 +668,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;
@@ -690,7 +690,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);
@@ -713,7 +713,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);
@@ -725,6 +725,36 @@ var ScaffoldProcessingService = class {
 	}
 };
 
+//#endregion
+//#region src/utils/generateStableId.ts
+/**
+* Generate a stable, random ID string
+*
+* @param length - Length of the ID to generate (default: 8)
+* @returns A random alphanumeric ID string (lowercase)
+*
+* @remarks
+* Negative or non-integer lengths are normalized (floored and clamped to 0).
+* Returns empty string for length <= 0.
+*
+* @example
+* ```typescript
+* const id = generateStableId(6); // Returns something like "a3f9k2"
+* ```
+*/
+function generateStableId(length = 8) {
+	const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+	let result = "";
+	const normalizedLength = Math.max(0, Math.floor(length));
+	if (normalizedLength === 0) return "";
+	if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+		const values = new Uint8Array(normalizedLength);
+		crypto.getRandomValues(values);
+		for (let i = 0; i < normalizedLength; i++) result += chars[values[i] % 36];
+	} else for (let i = 0; i < normalizedLength; i++) result += chars[Math.floor(Math.random() * 36)];
+	return result;
+}
+
 //#endregion
 //#region src/utils/print.ts
 /**
@@ -897,7 +927,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);
@@ -909,14 +939,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");
@@ -954,4 +984,4 @@ async function isMonolith(workspaceRoot) {
 }
 
 //#endregion
-export { ConfigSource, ProjectConfigResolver, ProjectFinderService, ProjectType, ScaffoldProcessingService, TemplatesManagerService, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };
+export { ConfigSource, ProjectConfigResolver, ProjectFinderService, ProjectType, ScaffoldProcessingService, TemplatesManagerService, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, generateStableId, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };

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.5",
+  "version": "1.0.6",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {
@@ -40,6 +40,7 @@
     "@types/node": "^22.0.0",
     "@types/ora": "^3.2.0",
     "@vitest/coverage-v8": "^3.0.0",
+    "chance": "^1.1.13",
     "tsdown": "^0.16.4",
     "typescript": "5.9.3",
     "vitest": "^3.0.0"