agentic-qe 1.8.3 → 1.9.0

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

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * 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
+ */
+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.getBaseDir = getBaseDir;
+exports.getDataDir = getDataDir;
+exports.getConfigDir = getConfigDir;
+exports.getAgentsDir = getAgentsDir;
+exports.getDocsDir = getDocsDir;
+exports.getRelativePath = getRelativePath;
+exports.getPackageRoot = getPackageRoot;
+exports.resolveTemplatePath = resolveTemplatePath;
+exports.resolveTemplatePathSync = resolveTemplatePathSync;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+/**
+ * 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
+ */
+function getBaseDir(cwd = process.cwd()) {
+    return path.join(cwd, '.agentic-qe');
+}
+/**
+ * Get the data directory for databases
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/data directory
+ */
+function getDataDir(cwd = process.cwd()) {
+    return path.join(getBaseDir(cwd), 'data');
+}
+/**
+ * Get the config directory
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/config directory
+ */
+function getConfigDir(cwd = process.cwd()) {
+    return path.join(getBaseDir(cwd), 'config');
+}
+/**
+ * Get the agents directory
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/agents directory
+ */
+function getAgentsDir(cwd = process.cwd()) {
+    return path.join(getBaseDir(cwd), 'agents');
+}
+/**
+ * Get the docs directory
+ *
+ * @param cwd - Current working directory (default: process.cwd())
+ * @returns Absolute path to .agentic-qe/docs directory
+ */
+function getDocsDir(cwd = process.cwd()) {
+    return path.join(getBaseDir(cwd), 'docs');
+}
+/**
+ * Get relative path from base directory
+ *
+ * @param fullPath - Absolute path
+ * @param baseDir - Base directory (default: process.cwd())
+ * @returns Relative path from base directory
+ */
+function getRelativePath(fullPath, baseDir = process.cwd()) {
+    return path.relative(baseDir, fullPath);
+}
+/**
+ * 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
+ */
+function getPackageRoot() {
+    let currentDir = __dirname;
+    const maxDepth = 10; // Safety limit to prevent infinite loops
+    let depth = 0;
+    while (depth < maxDepth) {
+        const packageJsonPath = path.join(currentDir, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            // Verify it's our package by checking name
+            try {
+                const pkg = require(packageJsonPath);
+                if (pkg.name === 'agentic-qe' || pkg.name === '@agentic-qe/core') {
+                    return currentDir;
+                }
+            }
+            catch {
+                // Not a valid package.json, keep searching
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached filesystem root
+            break;
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    throw new Error('Could not find agentic-qe package root (package.json not found)');
+}
+/**
+ * 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
+ */
+async function resolveTemplatePath(templateFileName, projectRoot = process.cwd()) {
+    const searchPaths = [
+        // 1. Project root templates/ (user customization)
+        path.join(projectRoot, 'templates', templateFileName),
+        // 2. Package root templates/ (development)
+        path.join(getPackageRoot(), 'templates', templateFileName),
+        // 3. node_modules/agentic-qe/templates/ (installed package)
+        path.join(projectRoot, 'node_modules', 'agentic-qe', 'templates', templateFileName),
+        // 4. Parent node_modules (monorepo scenario)
+        path.join(projectRoot, '..', 'node_modules', 'agentic-qe', 'templates', templateFileName),
+    ];
+    // Try each path in order
+    for (const templatePath of searchPaths) {
+        if (await fs.pathExists(templatePath)) {
+            return templatePath;
+        }
+    }
+    // Template not found anywhere
+    throw new Error(`Template file '${templateFileName}' not found. Searched:\n${searchPaths.map(p => `  - ${p}`).join('\n')}`);
+}
+/**
+ * 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
+ */
+function resolveTemplatePathSync(templateFileName, projectRoot = process.cwd()) {
+    const searchPaths = [
+        path.join(projectRoot, 'templates', templateFileName),
+        path.join(getPackageRoot(), 'templates', templateFileName),
+        path.join(projectRoot, 'node_modules', 'agentic-qe', 'templates', templateFileName),
+        path.join(projectRoot, '..', 'node_modules', 'agentic-qe', 'templates', templateFileName),
+    ];
+    for (const templatePath of searchPaths) {
+        if (fs.existsSync(templatePath)) {
+            return templatePath;
+        }
+    }
+    throw new Error(`Template file '${templateFileName}' not found. Searched:\n${searchPaths.map(p => `  - ${p}`).join('\n')}`);
+}
+//# sourceMappingURL=path-utils.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Validation utilities module
+ *
+ * Input validation and parsing utilities:
+ * - Numeric range validation
+ * - Enum validation
+ * - Comma-separated string parsing
+ * - Package version retrieval
+ *
+ * @module cli/init/utils/validation-utils
+ */
+/**
+ * Validate that a value is within a numeric range
+ *
+ * @param value - Value to validate
+ * @param min - Minimum allowed value (inclusive)
+ * @param max - Maximum allowed value (inclusive)
+ * @param fieldName - Name of field for error message
+ * @throws Error if value is out of range
+ */
+export declare function validateRange(value: number, min: number, max: number, fieldName: string): void;
+/**
+ * Validate that a value is one of allowed options
+ *
+ * @param value - Value to validate
+ * @param allowedValues - Array of allowed values
+ * @param fieldName - Name of field for error message
+ * @throws Error if value is not in allowed values
+ */
+export declare function validateEnum<T>(value: T, allowedValues: T[], fieldName: string): void;
+/**
+ * Parse comma-separated string into trimmed array
+ *
+ * @param input - Comma-separated string
+ * @returns Array of trimmed strings
+ */
+export declare function parseCommaSeparated(input: string): string[];
+/**
+ * Get the current package version
+ *
+ * @returns Package version from package.json
+ */
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=validation-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/utils/validation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EACR,aAAa,EAAE,CAAC,EAAE,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI,CAMN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C"}

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

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Validation utilities module
+ *
+ * Input validation and parsing utilities:
+ * - Numeric range validation
+ * - Enum validation
+ * - Comma-separated string parsing
+ * - Package version retrieval
+ *
+ * @module cli/init/utils/validation-utils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRange = validateRange;
+exports.validateEnum = validateEnum;
+exports.parseCommaSeparated = parseCommaSeparated;
+exports.getPackageVersion = getPackageVersion;
+/**
+ * Validate that a value is within a numeric range
+ *
+ * @param value - Value to validate
+ * @param min - Minimum allowed value (inclusive)
+ * @param max - Maximum allowed value (inclusive)
+ * @param fieldName - Name of field for error message
+ * @throws Error if value is out of range
+ */
+function validateRange(value, min, max, fieldName) {
+    if (value < min || value > max) {
+        throw new Error(`${fieldName} must be between ${min} and ${max}`);
+    }
+}
+/**
+ * Validate that a value is one of allowed options
+ *
+ * @param value - Value to validate
+ * @param allowedValues - Array of allowed values
+ * @param fieldName - Name of field for error message
+ * @throws Error if value is not in allowed values
+ */
+function validateEnum(value, allowedValues, fieldName) {
+    if (!allowedValues.includes(value)) {
+        throw new Error(`Invalid ${fieldName}. Must be one of: ${allowedValues.join(', ')}`);
+    }
+}
+/**
+ * Parse comma-separated string into trimmed array
+ *
+ * @param input - Comma-separated string
+ * @returns Array of trimmed strings
+ */
+function parseCommaSeparated(input) {
+    return input.split(',').map(item => item.trim()).filter(item => item.length > 0);
+}
+/**
+ * Get the current package version
+ *
+ * @returns Package version from package.json
+ */
+function getPackageVersion() {
+    try {
+        const packageJson = require('../../../../package.json');
+        return packageJson.version || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=validation-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.js","sourceRoot":"","sources":["../../../../src/cli/init/utils/validation-utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAWH,sCASC;AAUD,oCAUC;AAQD,kDAEC;AAOD,8CAOC;AA9DD;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAC3B,KAAa,EACb,GAAW,EACX,GAAW,EACX,SAAiB;IAEjB,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,oBAAoB,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAC1B,KAAQ,EACR,aAAkB,EAClB,SAAiB;IAEjB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,WAAW,SAAS,qBAAqB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB;IAC/B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACxD,OAAO,WAAW,CAAC,OAAO,IAAI,SAAS,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,183 @@
+/**
+ * Shared utilities module for init operations
+ *
+ * Common functions used across initialization modules for:
+ * - File system operations
+ * - Logging with chalk formatting
+ * - Path handling
+ * - Validation
+ *
+ * @module cli/init/utils
+ */
+/**
+ * Ensure directory exists, creating it if necessary
+ *
+ * @param dirPath - Absolute or relative path to directory
+ * @throws Error if directory creation fails
+ */
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+/**
+ * Check if a file exists
+ *
+ * @param filePath - Path to check
+ * @returns True if file exists, false otherwise
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Check if a directory exists
+ *
+ * @param dirPath - Path to check
+ * @returns True if directory exists, false otherwise
+ */
+export declare function directoryExists(dirPath: string): Promise<boolean>;
+/**
+ * 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
+ */
+export declare function safeWriteJson(filePath: string, data: any, indent?: number): Promise<void>;
+/**
+ * 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
+ */
+export declare function safeReadJson<T = any>(filePath: string): Promise<T>;
+/**
+ * Write text file with error handling
+ *
+ * @param filePath - Path to write file
+ * @param content - File content
+ * @throws Error if write fails
+ */
+export declare function safeWriteFile(filePath: string, content: string): Promise<void>;
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * Validate that a value is within a numeric range
+ *
+ * @param value - Value to validate
+ * @param min - Minimum allowed value (inclusive)
+ * @param max - Maximum allowed value (inclusive)
+ * @param fieldName - Name of field for error message
+ * @throws Error if value is out of range
+ */
+export declare function validateRange(value: number, min: number, max: number, fieldName: string): void;
+/**
+ * Validate that a value is one of allowed options
+ *
+ * @param value - Value to validate
+ * @param allowedValues - Array of allowed values
+ * @param fieldName - Name of field for error message
+ * @throws Error if value is not in allowed values
+ */
+export declare function validateEnum<T>(value: T, allowedValues: T[], fieldName: string): void;
+/**
+ * Parse comma-separated string into trimmed array
+ *
+ * @param input - Comma-separated string
+ * @returns Array of trimmed strings
+ */
+export declare function parseCommaSeparated(input: string): string[];
+/**
+ * Get the current package version
+ *
+ * @returns Package version from package.json
+ */
+export declare function getPackageVersion(): string;
+/**
+ * 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
+ */
+export declare function createDirectories(directories: string[], baseDir?: string, force?: boolean): Promise<string[]>;
+/**
+ * Format file size in human-readable format
+ *
+ * @param bytes - Size in bytes
+ * @returns Formatted string (e.g., "1.5 KB", "2.3 MB")
+ */
+export declare function formatFileSize(bytes: number): 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;
+//# sourceMappingURL=utils.d.ts.map

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

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