agentic-qe 1.8.3 → 1.9.0

package/dist/cli/init/utils/file-utils.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * File system utilities module
+ *
+ * Common file system operations for initialization:
+ * - Directory creation and validation
+ * - File existence checks
+ * - Safe JSON and file operations
+ * - Directory structure creation
+ *
+ * @module cli/init/utils/file-utils
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectory = ensureDirectory;
+exports.fileExists = fileExists;
+exports.directoryExists = directoryExists;
+exports.safeWriteJson = safeWriteJson;
+exports.safeReadJson = safeReadJson;
+exports.safeWriteFile = safeWriteFile;
+exports.createDirectories = createDirectories;
+exports.formatFileSize = formatFileSize;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const log_utils_1 = require("./log-utils");
+/**
+ * Ensure directory exists, creating it if necessary
+ *
+ * @param dirPath - Absolute or relative path to directory
+ * @throws Error if directory creation fails
+ */
+async function ensureDirectory(dirPath) {
+    try {
+        await fs.ensureDir(dirPath);
+    }
+    catch (error) {
+        throw new Error(`Failed to create directory ${dirPath}: ${error}`);
+    }
+}
+/**
+ * Check if a file exists
+ *
+ * @param filePath - Path to check
+ * @returns True if file exists, false otherwise
+ */
+async function fileExists(filePath) {
+    try {
+        return await fs.pathExists(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a directory exists
+ *
+ * @param dirPath - Path to check
+ * @returns True if directory exists, false otherwise
+ */
+async function directoryExists(dirPath) {
+    try {
+        const stats = await fs.stat(dirPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write JSON data to file with proper formatting and error handling
+ *
+ * @param filePath - Path to write JSON file
+ * @param data - Data to serialize to JSON
+ * @param indent - Number of spaces for indentation (default: 2)
+ * @throws Error if write fails
+ */
+async function safeWriteJson(filePath, data, indent = 2) {
+    try {
+        const jsonContent = JSON.stringify(data, null, indent);
+        await fs.writeFile(filePath, jsonContent, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to write JSON to ${filePath}: ${error}`);
+    }
+}
+/**
+ * Read and parse JSON file with error handling
+ *
+ * @param filePath - Path to JSON file
+ * @returns Parsed JSON data
+ * @throws Error if file doesn't exist or JSON is invalid
+ */
+async function safeReadJson(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to read JSON from ${filePath}: ${error}`);
+    }
+}
+/**
+ * Write text file with error handling
+ *
+ * @param filePath - Path to write file
+ * @param content - File content
+ * @throws Error if write fails
+ */
+async function safeWriteFile(filePath, content) {
+    try {
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to write file ${filePath}: ${error}`);
+    }
+}
+/**
+ * Create a safe directory structure (won't fail if directories exist)
+ *
+ * @param directories - Array of directory paths to create
+ * @param baseDir - Base directory (default: process.cwd())
+ * @param force - Force recreation if directory exists
+ * @returns Array of created directory paths
+ */
+async function createDirectories(directories, baseDir = process.cwd(), force = false) {
+    const created = [];
+    for (const dir of directories) {
+        const fullPath = path.join(baseDir, dir);
+        if (await fileExists(fullPath) && !force) {
+            (0, log_utils_1.logExists)(`Directory exists: ${dir}`);
+            continue;
+        }
+        await ensureDirectory(fullPath);
+        (0, log_utils_1.logSuccess)(`Created: ${dir}`);
+        created.push(fullPath);
+    }
+    return created;
+}
+/**
+ * Format file size in human-readable format
+ *
+ * @param bytes - Size in bytes
+ * @returns Formatted string (e.g., "1.5 KB", "2.3 MB")
+ */
+function formatFileSize(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/cli/init/utils/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../../../src/cli/init/utils/file-utils.ts"],"names":[],"mappings":"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"}

package/dist/cli/init/utils/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared utilities module for init operations
+ *
+ * Re-exports all utility functions from specialized modules:
+ * - File system operations (file-utils)
+ * - Logging with chalk formatting (log-utils)
+ * - Path handling (path-utils)
+ * - Validation (validation-utils)
+ *
+ * This barrel export maintains backward compatibility with existing imports.
+ *
+ * @module cli/init/utils
+ */
+export { ensureDirectory, fileExists, directoryExists, safeWriteJson, safeReadJson, safeWriteFile, createDirectories, formatFileSize, } from './file-utils';
+export { logSuccess, logWarning, logError, logInfo, logExists, } from './log-utils';
+export { getBaseDir, getDataDir, getConfigDir, getAgentsDir, getDocsDir, getRelativePath, } from './path-utils';
+export { validateRange, validateEnum, parseCommaSeparated, getPackageVersion, } from './validation-utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/init/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/cli/init/utils/index.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Shared utilities module for init operations
+ *
+ * Re-exports all utility functions from specialized modules:
+ * - File system operations (file-utils)
+ * - Logging with chalk formatting (log-utils)
+ * - Path handling (path-utils)
+ * - Validation (validation-utils)
+ *
+ * This barrel export maintains backward compatibility with existing imports.
+ *
+ * @module cli/init/utils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageVersion = exports.parseCommaSeparated = exports.validateEnum = exports.validateRange = exports.getRelativePath = exports.getDocsDir = exports.getAgentsDir = exports.getConfigDir = exports.getDataDir = exports.getBaseDir = exports.logExists = exports.logInfo = exports.logError = exports.logWarning = exports.logSuccess = exports.formatFileSize = exports.createDirectories = exports.safeWriteFile = exports.safeReadJson = exports.safeWriteJson = exports.directoryExists = exports.fileExists = exports.ensureDirectory = void 0;
+// File system utilities
+var file_utils_1 = require("./file-utils");
+Object.defineProperty(exports, "ensureDirectory", { enumerable: true, get: function () { return file_utils_1.ensureDirectory; } });
+Object.defineProperty(exports, "fileExists", { enumerable: true, get: function () { return file_utils_1.fileExists; } });
+Object.defineProperty(exports, "directoryExists", { enumerable: true, get: function () { return file_utils_1.directoryExists; } });
+Object.defineProperty(exports, "safeWriteJson", { enumerable: true, get: function () { return file_utils_1.safeWriteJson; } });
+Object.defineProperty(exports, "safeReadJson", { enumerable: true, get: function () { return file_utils_1.safeReadJson; } });
+Object.defineProperty(exports, "safeWriteFile", { enumerable: true, get: function () { return file_utils_1.safeWriteFile; } });
+Object.defineProperty(exports, "createDirectories", { enumerable: true, get: function () { return file_utils_1.createDirectories; } });
+Object.defineProperty(exports, "formatFileSize", { enumerable: true, get: function () { return file_utils_1.formatFileSize; } });
+// Logging utilities
+var log_utils_1 = require("./log-utils");
+Object.defineProperty(exports, "logSuccess", { enumerable: true, get: function () { return log_utils_1.logSuccess; } });
+Object.defineProperty(exports, "logWarning", { enumerable: true, get: function () { return log_utils_1.logWarning; } });
+Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return log_utils_1.logError; } });
+Object.defineProperty(exports, "logInfo", { enumerable: true, get: function () { return log_utils_1.logInfo; } });
+Object.defineProperty(exports, "logExists", { enumerable: true, get: function () { return log_utils_1.logExists; } });
+// Path utilities
+var path_utils_1 = require("./path-utils");
+Object.defineProperty(exports, "getBaseDir", { enumerable: true, get: function () { return path_utils_1.getBaseDir; } });
+Object.defineProperty(exports, "getDataDir", { enumerable: true, get: function () { return path_utils_1.getDataDir; } });
+Object.defineProperty(exports, "getConfigDir", { enumerable: true, get: function () { return path_utils_1.getConfigDir; } });
+Object.defineProperty(exports, "getAgentsDir", { enumerable: true, get: function () { return path_utils_1.getAgentsDir; } });
+Object.defineProperty(exports, "getDocsDir", { enumerable: true, get: function () { return path_utils_1.getDocsDir; } });
+Object.defineProperty(exports, "getRelativePath", { enumerable: true, get: function () { return path_utils_1.getRelativePath; } });
+// Validation utilities
+var validation_utils_1 = require("./validation-utils");
+Object.defineProperty(exports, "validateRange", { enumerable: true, get: function () { return validation_utils_1.validateRange; } });
+Object.defineProperty(exports, "validateEnum", { enumerable: true, get: function () { return validation_utils_1.validateEnum; } });
+Object.defineProperty(exports, "parseCommaSeparated", { enumerable: true, get: function () { return validation_utils_1.parseCommaSeparated; } });
+Object.defineProperty(exports, "getPackageVersion", { enumerable: true, get: function () { return validation_utils_1.getPackageVersion; } });
+//# sourceMappingURL=index.js.map

package/dist/cli/init/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/init/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,wBAAwB;AACxB,2CASsB;AARpB,6GAAA,eAAe,OAAA;AACf,wGAAA,UAAU,OAAA;AACV,6GAAA,eAAe,OAAA;AACf,2GAAA,aAAa,OAAA;AACb,0GAAA,YAAY,OAAA;AACZ,2GAAA,aAAa,OAAA;AACb,+GAAA,iBAAiB,OAAA;AACjB,4GAAA,cAAc,OAAA;AAGhB,oBAAoB;AACpB,yCAMqB;AALnB,uGAAA,UAAU,OAAA;AACV,uGAAA,UAAU,OAAA;AACV,qGAAA,QAAQ,OAAA;AACR,oGAAA,OAAO,OAAA;AACP,sGAAA,SAAS,OAAA;AAGX,iBAAiB;AACjB,2CAOsB;AANpB,wGAAA,UAAU,OAAA;AACV,wGAAA,UAAU,OAAA;AACV,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AACZ,wGAAA,UAAU,OAAA;AACV,6GAAA,eAAe,OAAA;AAGjB,uBAAuB;AACvB,uDAK4B;AAJ1B,iHAAA,aAAa,OAAA;AACb,gHAAA,YAAY,OAAA;AACZ,uHAAA,mBAAmB,OAAA;AACnB,qHAAA,iBAAiB,OAAA"}

package/dist/cli/init/utils/log-utils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Logging utilities module
+ *
+ * Formatted console logging with chalk:
+ * - Success messages (green)
+ * - Warning messages (yellow)
+ * - Error messages (red)
+ * - Info messages (gray)
+ * - Existence messages (gray)
+ *
+ * @module cli/init/utils/log-utils
+ */
+/**
+ * Log success message with green checkmark
+ *
+ * @param message - Success message
+ * @param prefix - Optional prefix (default: '✓')
+ */
+export declare function logSuccess(message: string, prefix?: string): void;
+/**
+ * Log warning message with yellow color
+ *
+ * @param message - Warning message
+ * @param prefix - Optional prefix (default: '⚠️')
+ */
+export declare function logWarning(message: string, prefix?: string): void;
+/**
+ * Log error message with red color
+ *
+ * @param message - Error message
+ * @param prefix - Optional prefix (default: '✗')
+ */
+export declare function logError(message: string, prefix?: string): void;
+/**
+ * Log info message with gray color
+ *
+ * @param message - Info message
+ * @param prefix - Optional prefix (default: '•')
+ */
+export declare function logInfo(message: string, prefix?: string): void;
+/**
+ * Log message indicating existing resource (gray checkmark)
+ *
+ * @param message - Message about existing resource
+ */
+export declare function logExists(message: string): void;
+//# sourceMappingURL=log-utils.d.ts.map

package/dist/cli/init/utils/log-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-utils.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/utils/log-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,IAAI,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,IAAI,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,IAAI,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/cli/init/utils/log-utils.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Logging utilities module
+ *
+ * Formatted console logging with chalk:
+ * - Success messages (green)
+ * - Warning messages (yellow)
+ * - Error messages (red)
+ * - Info messages (gray)
+ * - Existence messages (gray)
+ *
+ * @module cli/init/utils/log-utils
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logSuccess = logSuccess;
+exports.logWarning = logWarning;
+exports.logError = logError;
+exports.logInfo = logInfo;
+exports.logExists = logExists;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Log success message with green checkmark
+ *
+ * @param message - Success message
+ * @param prefix - Optional prefix (default: '✓')
+ */
+function logSuccess(message, prefix = '✓') {
+    console.log(chalk_1.default.green(`  ${prefix} ${message}`));
+}
+/**
+ * Log warning message with yellow color
+ *
+ * @param message - Warning message
+ * @param prefix - Optional prefix (default: '⚠️')
+ */
+function logWarning(message, prefix = '⚠️') {
+    console.log(chalk_1.default.yellow(`  ${prefix} ${message}`));
+}
+/**
+ * Log error message with red color
+ *
+ * @param message - Error message
+ * @param prefix - Optional prefix (default: '✗')
+ */
+function logError(message, prefix = '✗') {
+    console.log(chalk_1.default.red(`  ${prefix} ${message}`));
+}
+/**
+ * Log info message with gray color
+ *
+ * @param message - Info message
+ * @param prefix - Optional prefix (default: '•')
+ */
+function logInfo(message, prefix = '•') {
+    console.log(chalk_1.default.gray(`  ${prefix} ${message}`));
+}
+/**
+ * Log message indicating existing resource (gray checkmark)
+ *
+ * @param message - Message about existing resource
+ */
+function logExists(message) {
+    console.log(chalk_1.default.gray(`  ✓ ${message}`));
+}
+//# sourceMappingURL=log-utils.js.map

package/dist/cli/init/utils/log-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-utils.js","sourceRoot":"","sources":["../../../../src/cli/init/utils/log-utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;AAUH,gCAEC;AAQD,gCAEC;AAQD,4BAEC;AAQD,0BAEC;AAOD,8BAEC;AAjDD,kDAA0B;AAE1B;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,SAAiB,GAAG;IAC9D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,SAAiB,IAAI;IAC/D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,OAAe,EAAE,SAAiB,GAAG;IAC5D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,OAAe,EAAE,SAAiB,GAAG;IAC3D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cli/init/utils/path-utils.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Path utilities module
+ *
+ * Path handling for Agentic QE Fleet directories:
+ * - Base directory (.agentic-qe)
+ * - Data directory (databases)
+ * - Config directory
+ * - Agents directory
+ * - Docs directory
+ * - Template resolution (centralized)
+ * - Relative path conversion
+ *
+ * @module cli/init/utils/path-utils
+ */
+/**
+ * Get the base directory for Agentic QE Fleet (.agentic-qe)
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe directory
+ */
+export declare function getBaseDir(cwd?: string): string;
+/**
+ * Get the data directory for databases
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/data directory
+ */
+export declare function getDataDir(cwd?: string): string;
+/**
+ * Get the config directory
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/config directory
+ */
+export declare function getConfigDir(cwd?: string): string;
+/**
+ * Get the agents directory
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/agents directory
+ */
+export declare function getAgentsDir(cwd?: string): string;
+/**
+ * Get the docs directory
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/docs directory
+ */
+export declare function getDocsDir(cwd?: string): string;
+/**
+ * Get relative path from base directory
+ *
+ * @param fullPath - Absolute path
+ * @param baseDir - Base directory (default: process.cwd())
+ * @returns Relative path from base directory
+ */
+export declare function getRelativePath(fullPath: string, baseDir?: string): string;
+/**
+ * Get the package root directory (where package.json lives)
+ *
+ * Searches upward from __dirname until package.json is found.
+ * Handles both development and installed package scenarios.
+ *
+ * @returns Absolute path to package root directory
+ * @throws Error if package.json cannot be found
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Resolve template file path with centralized fallback logic
+ *
+ * Searches for templates in this order:
+ * 1. Project root templates/ directory (for user customization)
+ * 2. Package root templates/ directory (development)
+ * 3. node_modules/agentic-qe/templates/ (installed package)
+ *
+ * @param templateFileName - Template file name (e.g., 'aqe.sh')
+ * @param projectRoot - Project root directory (default: process.cwd())
+ * @returns Absolute path to template file
+ * @throws Error if template not found in any location
+ */
+export declare function resolveTemplatePath(templateFileName: string, projectRoot?: string): Promise<string>;
+/**
+ * Synchronous version of resolveTemplatePath for use in non-async contexts
+ *
+ * @param templateFileName - Template file name
+ * @param projectRoot - Project root directory (default: process.cwd())
+ * @returns Absolute path to template file
+ * @throws Error if template not found
+ */
+export declare function resolveTemplatePathSync(templateFileName: string, projectRoot?: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/cli/init/utils/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/utils/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,MAAM,CAEzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CA6BvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,gBAAgB,EAAE,MAAM,EACxB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EACxB,WAAW,GAAE,MAAsB,GAClC,MAAM,CAiBR"}