codereview-aia 0.1.0 → 0.1.2

package/dist/utils/logger.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * @fileoverview Centralized logging system for the cr-aia tool.
+ *
+ * This module provides a standardized logging interface with support for
+ * different log levels, colored output, and log level control via environment
+ * variables. It's designed to be used throughout the codebase to ensure
+ * consistent logging behavior.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
+exports.enableFileLogging = enableFileLogging;
+exports.disableFileLogging = disableFileLogging;
+exports.debug = debug;
+exports.info = info;
+exports.warn = warn;
+exports.error = error;
+exports.createLogger = createLogger;
+// Define log levels with numeric values for comparison
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["NONE"] = 4] = "NONE";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+// Map string log level names to enum values
+const LOG_LEVEL_MAP = {
+    debug: LogLevel.DEBUG,
+    info: LogLevel.INFO,
+    warn: LogLevel.WARN,
+    error: LogLevel.ERROR,
+    none: LogLevel.NONE,
+};
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ANSI color codes for terminal output
+const COLORS = {
+    reset: '\x1b[0m',
+    dim: '\x1b[2m',
+    bright: '\x1b[1m',
+    debug: '\x1b[36m', // Cyan
+    info: '\x1b[32m', // Green
+    warn: '\x1b[33m', // Yellow
+    error: '\x1b[31m', // Red
+    time: '\x1b[90m', // Gray
+};
+// Track if we're initializing to avoid circular dependencies
+const isInitializing = false;
+let logFileStream = null;
+let suppressConsoleOutput = false;
+// Get the current log level from environment variables
+function getCurrentLogLevel() {
+    // Avoid debug logs during initialization to prevent overwhelming output
+    const shouldLog = process.argv.includes('--trace-logger') && !isInitializing;
+    if (shouldLog) {
+        // Only print when explicitly requested with --trace-logger
+        console.error(`Debug: getCurrentLogLevel called, AI_CODE_REVIEW_LOG_LEVEL=${process.env.AI_CODE_REVIEW_LOG_LEVEL}`);
+    }
+    // Always check CLI flags first - highest priority
+    if (process.argv.includes('--debug')) {
+        if (shouldLog) {
+            console.error('Debug: Debug flag found in process.argv, forcing DEBUG level');
+        }
+        return LogLevel.DEBUG;
+    }
+    // Next check environment variable
+    const envLogLevel = process.env.AI_CODE_REVIEW_LOG_LEVEL?.toLowerCase();
+    if (envLogLevel) {
+        if (shouldLog) {
+            console.error(`Debug: Found AI_CODE_REVIEW_LOG_LEVEL environment variable: ${envLogLevel}`);
+        }
+        if (envLogLevel in LOG_LEVEL_MAP) {
+            if (shouldLog) {
+                console.error(`Debug: Mapped log level ${envLogLevel} -> ${LOG_LEVEL_MAP[envLogLevel]}`);
+            }
+            return LOG_LEVEL_MAP[envLogLevel];
+        }
+        if (shouldLog) {
+            console.error(`Debug: Invalid log level: ${envLogLevel}, valid options are: ${Object.keys(LOG_LEVEL_MAP).join(', ')}`);
+        }
+    }
+    else if (shouldLog) {
+        console.error('Debug: AI_CODE_REVIEW_LOG_LEVEL environment variable not found');
+    }
+    // Default to INFO if not specified
+    if (shouldLog) {
+        console.error('Debug: No valid log level found, defaulting to INFO');
+    }
+    return LogLevel.INFO;
+}
+// The current log level
+let currentLogLevel = getCurrentLogLevel();
+/**
+ * Set the current log level
+ * @param level The log level to set
+ */
+function setLogLevel(level) {
+    // Only log when explicitly requested with --trace-logger
+    const shouldLog = process.argv.includes('--trace-logger');
+    if (shouldLog) {
+        console.error(`Debug: setLogLevel called with ${level}`);
+    }
+    if (typeof level === 'string') {
+        const levelLower = level.toLowerCase();
+        if (levelLower in LOG_LEVEL_MAP) {
+            currentLogLevel = LOG_LEVEL_MAP[levelLower];
+            if (shouldLog) {
+                console.error(`Debug: Log level set to ${levelLower} -> ${currentLogLevel}`);
+            }
+        }
+        else {
+            console.warn(`Invalid log level: ${level}. Using default.`);
+        }
+    }
+    else {
+        currentLogLevel = level;
+        if (shouldLog) {
+            console.error(`Debug: Log level set to numeric value ${level}`);
+        }
+    }
+}
+/**
+ * Get the current log level
+ * @returns The current log level
+ */
+function getLogLevel() {
+    return currentLogLevel;
+}
+function formatConsoleMessage(level, message, timestamp) {
+    const levelUpper = level.toUpperCase().padEnd(5);
+    return `${COLORS.time}[${timestamp}]${COLORS.reset} ${COLORS[level]}${levelUpper}${COLORS.reset} ${message}`;
+}
+function formatFileMessage(level, message, timestamp, args) {
+    const levelUpper = level.toUpperCase().padEnd(5);
+    const extras = args.length ? ` ${args.map((arg) => serializeLogArg(arg)).join(' ')}` : '';
+    return `[${timestamp}] ${levelUpper} ${message}${extras}`;
+}
+function serializeLogArg(arg) {
+    if (typeof arg === 'string') {
+        return arg;
+    }
+    if (arg instanceof Error) {
+        return arg.stack || arg.message;
+    }
+    try {
+        return JSON.stringify(arg);
+    }
+    catch {
+        return String(arg);
+    }
+}
+function enableFileLogging(filePath, options) {
+    try {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(filePath), { recursive: true });
+        if (logFileStream) {
+            logFileStream.end();
+        }
+        logFileStream = (0, node_fs_1.createWriteStream)(filePath, { flags: 'a' });
+        suppressConsoleOutput = options?.suppressConsole ?? true;
+    }
+    catch (error) {
+        console.error('Failed to enable file logging:', error);
+        logFileStream = null;
+        suppressConsoleOutput = false;
+    }
+}
+function disableFileLogging() {
+    if (logFileStream) {
+        logFileStream.end();
+        logFileStream = null;
+    }
+    suppressConsoleOutput = false;
+}
+/**
+ * Log a message if the current log level allows it
+ * @param level The log level
+ * @param message The message to log
+ * @param args Additional arguments to log
+ */
+function log(level, levelName, message, ...args) {
+    const timestamp = new Date().toISOString();
+    if (logFileStream) {
+        logFileStream.write(`${formatFileMessage(levelName, message, timestamp, args)}\n`);
+    }
+    const shouldLogToConsole = !suppressConsoleOutput && level >= currentLogLevel;
+    if (shouldLogToConsole) {
+        const formattedMessage = formatConsoleMessage(levelName, message, timestamp);
+        switch (level) {
+            case LogLevel.DEBUG:
+                console.debug(formattedMessage, ...args);
+                break;
+            case LogLevel.INFO:
+                console.log(formattedMessage, ...args);
+                break;
+            case LogLevel.WARN:
+                console.warn(formattedMessage, ...args);
+                break;
+            case LogLevel.ERROR:
+                console.error(formattedMessage, ...args);
+                break;
+            default:
+                break;
+        }
+    }
+    else if (!suppressConsoleOutput && level === LogLevel.DEBUG && process.argv.includes('--trace-logger')) {
+        console.error(`Suppressing DEBUG log because currentLogLevel=${currentLogLevel}, message was: ${message}`);
+    }
+}
+/**
+ * Log a debug message
+ * @param message The message to log
+ * @param args Additional arguments to log
+ */
+function debug(message, ...args) {
+    log(LogLevel.DEBUG, 'debug', message, ...args);
+}
+/**
+ * Log an info message
+ * @param message The message to log
+ * @param args Additional arguments to log
+ */
+function info(message, ...args) {
+    log(LogLevel.INFO, 'info', message, ...args);
+}
+/**
+ * Log a warning message
+ * @param message The message to log
+ * @param args Additional arguments to log
+ */
+function warn(message, ...args) {
+    log(LogLevel.WARN, 'warn', message, ...args);
+}
+/**
+ * Log an error message
+ * @param message The message to log
+ * @param args Additional arguments to log
+ */
+function error(message, ...args) {
+    log(LogLevel.ERROR, 'error', message, ...args);
+}
+/**
+ * Create a logger instance with a specific prefix
+ * @param prefix The prefix to add to all log messages
+ * @returns An object with debug, info, warn, and error methods
+ */
+function createLogger(prefix) {
+    return {
+        debug: (message, ...args) => debug(`[${prefix}] ${message}`, ...args),
+        info: (message, ...args) => info(`[${prefix}] ${message}`, ...args),
+        warn: (message, ...args) => warn(`[${prefix}] ${message}`, ...args),
+        error: (message, ...args) => error(`[${prefix}] ${message}`, ...args),
+    };
+}
+// Export a default logger instance
+exports.default = {
+    debug,
+    info,
+    warn,
+    error,
+    setLogLevel,
+    getLogLevel,
+    createLogger,
+    LogLevel,
+    enableFileLogging,
+    disableFileLogging,
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/pathValidator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Path validation utilities.
+ *
+ * This module provides utilities for validating file and directory paths,
+ * ensuring they are safe to use and exist on the file system.
+ */
+/**
+ * Check if a path is within the current directory or its subdirectories
+ * @param targetPath Path to check
+ * @returns True if the path is within the current directory, false otherwise
+ */
+export declare function isPathWithinCwd(targetPath: string): boolean;
+/**
+ * Check if a path exists
+ * @param targetPath Path to check
+ * @returns True if the path exists, false otherwise
+ */
+export declare function pathExists(targetPath: string): boolean;
+/**
+ * Check if a path is a directory
+ * @param targetPath Path to check
+ * @returns True if the path is a directory, false otherwise
+ */
+export declare function isDirectory(targetPath: string): boolean;
+/**
+ * Check if a path is a file
+ * @param targetPath Path to check
+ * @returns True if the path is a file, false otherwise
+ */
+export declare function isFile(targetPath: string): boolean;
+/**
+ * Validate a target path for security and existence
+ * @param targetPath Path to validate
+ * @returns Object with validation results
+ */
+export declare function validateTargetPath(targetPath: string): {
+    isValid: boolean;
+    isDir: boolean;
+    error?: string;
+};

package/dist/utils/pathValidator.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * @fileoverview Path validation utilities.
+ *
+ * This module provides utilities for validating file and directory paths,
+ * ensuring they are safe to use and exist on the file system.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPathWithinCwd = isPathWithinCwd;
+exports.pathExists = pathExists;
+exports.isDirectory = isDirectory;
+exports.isFile = isFile;
+exports.validateTargetPath = validateTargetPath;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Check if a path is within the current directory or its subdirectories
+ * @param targetPath Path to check
+ * @returns True if the path is within the current directory, false otherwise
+ */
+function isPathWithinCwd(targetPath) {
+    const resolvedPath = node_path_1.default.resolve(targetPath);
+    const resolvedCwd = node_path_1.default.resolve(process.cwd());
+    return resolvedPath.startsWith(resolvedCwd);
+}
+/**
+ * Check if a path exists
+ * @param targetPath Path to check
+ * @returns True if the path exists, false otherwise
+ */
+function pathExists(targetPath) {
+    try {
+        node_fs_1.default.accessSync(targetPath);
+        return true;
+    }
+    catch (_error) {
+        return false;
+    }
+}
+/**
+ * Check if a path is a directory
+ * @param targetPath Path to check
+ * @returns True if the path is a directory, false otherwise
+ */
+function isDirectory(targetPath) {
+    try {
+        return node_fs_1.default.statSync(targetPath).isDirectory();
+    }
+    catch (_error) {
+        return false;
+    }
+}
+/**
+ * Check if a path is a file
+ * @param targetPath Path to check
+ * @returns True if the path is a file, false otherwise
+ */
+function isFile(targetPath) {
+    try {
+        return node_fs_1.default.statSync(targetPath).isFile();
+    }
+    catch (_error) {
+        return false;
+    }
+}
+/**
+ * Validate a target path for security and existence
+ * @param targetPath Path to validate
+ * @returns Object with validation results
+ */
+function validateTargetPath(targetPath) {
+    // Check if the path is within the current directory
+    if (!isPathWithinCwd(targetPath)) {
+        return {
+            isValid: false,
+            isDir: false,
+            error: `Path must be within the current directory: ${process.cwd()}`,
+        };
+    }
+    // Check if the path exists
+    if (!pathExists(targetPath)) {
+        return {
+            isValid: false,
+            isDir: false,
+            error: `Path does not exist: ${targetPath}`,
+        };
+    }
+    // Check if the path is a directory or file
+    const isDir = isDirectory(targetPath);
+    return {
+        isValid: true,
+        isDir,
+    };
+}
+//# sourceMappingURL=pathValidator.js.map

package/dist/utils/pathValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathValidator.js","sourceRoot":"","sources":["../../src/utils/pathValidator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAUH,0CAKC;AAOD,gCAOC;AAOD,kCAMC;AAOD,wBAMC;AAOD,gDA8BC;AA1FD,sDAAyB;AACzB,0DAA6B;AAE7B;;;;GAIG;AACH,SAAgB,eAAe,CAAC,UAAkB;IAChD,MAAM,YAAY,GAAG,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEhD,OAAO,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,UAAkB;IAC3C,IAAI,CAAC;QACH,iBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,UAAkB;IAC5C,IAAI,CAAC;QACH,OAAO,iBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,MAAM,CAAC,UAAkB;IACvC,IAAI,CAAC;QACH,OAAO,iBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,UAAkB;IAKnD,oDAAoD;IACpD,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,8CAA8C,OAAO,CAAC,GAAG,EAAE,EAAE;SACrE,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,wBAAwB,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/utils/priorityFilter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Utility functions for handling priority filters.
+ *
+ * This module provides utility functions for working with priority filters
+ * in interactive mode, including extracting priority filters from command line
+ * arguments and review options.
+ */
+import type { ReviewOptions } from '../types/review';
+import type { PriorityFilter } from '../types/common';
+/**
+ * Get the priority filter from command line arguments or options
+ *
+ * This function extracts the priority filter from either:
+ * 1. The options object (if the interactive property is a string)
+ * 2. The command line arguments (if --interactive or -i is followed by a priority filter)
+ *
+ * Priority filters determine which issues to display in interactive mode:
+ * - 'h': High priority issues only
+ * - 'm': Medium and high priority issues
+ * - 'l': Low, medium, and high priority issues
+ * - 'a': All issues (including informational)
+ *
+ * @param options Review options that may contain the priority filter
+ * @returns The priority filter (h, m, l, or a) or undefined if not specified
+ * @example
+ * // With options object
+ * const filter = getPriorityFilterFromArgs({ interactive: 'h' });
+ * // filter === 'h'
+ *
+ * // With command line arguments (if process.argv includes '--interactive h')
+ * const filter = getPriorityFilterFromArgs();
+ * // filter === 'h'
+ */
+export declare function getPriorityFilterFromArgs(options?: ReviewOptions): PriorityFilter | undefined;

package/dist/utils/priorityFilter.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * @fileoverview Utility functions for handling priority filters.
+ *
+ * This module provides utility functions for working with priority filters
+ * in interactive mode, including extracting priority filters from command line
+ * arguments and review options.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPriorityFilterFromArgs = getPriorityFilterFromArgs;
+/**
+ * Get the priority filter from command line arguments or options
+ *
+ * This function extracts the priority filter from either:
+ * 1. The options object (if the interactive property is a string)
+ * 2. The command line arguments (if --interactive or -i is followed by a priority filter)
+ *
+ * Priority filters determine which issues to display in interactive mode:
+ * - 'h': High priority issues only
+ * - 'm': Medium and high priority issues
+ * - 'l': Low, medium, and high priority issues
+ * - 'a': All issues (including informational)
+ *
+ * @param options Review options that may contain the priority filter
+ * @returns The priority filter (h, m, l, or a) or undefined if not specified
+ * @example
+ * // With options object
+ * const filter = getPriorityFilterFromArgs({ interactive: 'h' });
+ * // filter === 'h'
+ *
+ * // With command line arguments (if process.argv includes '--interactive h')
+ * const filter = getPriorityFilterFromArgs();
+ * // filter === 'h'
+ */
+function getPriorityFilterFromArgs(options) {
+    // First check if the interactive option is a string (priority filter)
+    if (options &&
+        typeof options.interactive === 'string' &&
+        ['h', 'm', 'l', 'a'].includes(options.interactive)) {
+        return options.interactive;
+    }
+    // Otherwise check if there's a priority filter argument after --interactive
+    const args = process.argv;
+    const interactiveIndex = args.findIndex((arg) => arg === '--interactive' || arg === '-i');
+    if (interactiveIndex !== -1 && interactiveIndex < args.length - 1) {
+        const nextArg = args[interactiveIndex + 1];
+        // Check if the next argument is a priority filter and not another option
+        if (['h', 'm', 'l', 'a'].includes(nextArg) && !nextArg.startsWith('-')) {
+            return nextArg;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=priorityFilter.js.map

package/dist/utils/priorityFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priorityFilter.js","sourceRoot":"","sources":["../../src/utils/priorityFilter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA6BH,8DAuBC;AA/CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,yBAAyB,CAAC,OAAuB;IAC/D,sEAAsE;IACtE,IACE,OAAO;QACP,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QACvC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,EAClD,CAAC;QACD,OAAO,OAAO,CAAC,WAA6B,CAAC;IAC/C,CAAC;IAED,4EAA4E;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,eAAe,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC;IAE1F,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,gBAAgB,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;QAC3C,yEAAyE;QACzE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,OAAyB,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/projectDocs.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Utilities for reading and processing project documentation.
+ *
+ * This module provides functionality for reading and processing project documentation
+ * files like README.md, PROJECT.md, and PROGRESS.md. These files provide important
+ * context for code reviews, helping the AI model understand the project's purpose,
+ * structure, and current state.
+ */
+/**
+ * Project documentation interface
+ */
+export interface ProjectDocs {
+    readme?: string;
+    project?: string;
+    progress?: string;
+    contributing?: string;
+    architecture?: string;
+    custom?: Record<string, string>;
+    metadata?: Record<string, string>;
+}
+/**
+ * Read project documentation files
+ * @param projectDir Project directory
+ * @returns Project documentation
+ */
+export declare function readProjectDocs(projectDir: string): Promise<ProjectDocs>;
+/**
+ * Add metadata to project documentation
+ * @param docs Project documentation object
+ * @param key Metadata key
+ * @param value Metadata value
+ * @returns Project documentation with added metadata
+ */
+export declare function addMetadataToProjectDocs(docs: ProjectDocs, key: string, value: string): ProjectDocs;
+/**
+ * Format project documentation for inclusion in prompts
+ * @param docs Project documentation
+ * @returns Formatted documentation string
+ */
+export declare function formatProjectDocs(docs: ProjectDocs): string;
+/**
+ * Add project documentation to a prompt
+ * @param prompt The prompt to add documentation to
+ * @param docs Project documentation object
+ * @returns The prompt with documentation added
+ */
+export declare function addProjectDocsToPrompt(prompt: string, docs: ProjectDocs): string;