codereview-aia 0.1.3 → 0.2.0

package/{src/types/reviewSchema.ts → dist/types/reviewSchema.js}

@@ -1,129 +1,69 @@
+"use strict";
 /**
  * Structured code review schema definitions used by cr-aia prompts and validators.
  *
  * We keep the TypeScript interfaces with matching Zod schemas so the runtime,
  * validator, and prompt generator all stay in sync.
  */
-
-import { z } from 'zod';
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reviewSchema = exports.codeReviewSchema = exports.reviewSummarySchema = exports.fileReviewSchema = exports.reviewIssueSchema = exports.issueLocationSchema = exports.issuePrioritySchema = exports.IssuePriority = void 0;
+exports.getSchemaAsString = getSchemaAsString;
+exports.getSchemaInstructions = getSchemaInstructions;
+const zod_1 = require("zod");
 /**
  * Priority level for code review issues
  */
-export enum IssuePriority {
-  HIGH = 'HIGH',
-  MEDIUM = 'MEDIUM',
-  LOW = 'LOW',
-}
-
+var IssuePriority;
+(function (IssuePriority) {
+    IssuePriority["HIGH"] = "HIGH";
+    IssuePriority["MEDIUM"] = "MEDIUM";
+    IssuePriority["LOW"] = "LOW";
+})(IssuePriority || (exports.IssuePriority = IssuePriority = {}));
 // Zod schema for issue priority
-export const issuePrioritySchema = z.nativeEnum(IssuePriority);
-
-/**
- * Location of an issue in the code
- */
-export interface IssueLocation {
-  startLine: number;
-  endLine: number;
-}
-
+exports.issuePrioritySchema = zod_1.z.nativeEnum(IssuePriority);
 // Zod schema for issue location
-export const issueLocationSchema = z.object({
-  startLine: z.number(),
-  endLine: z.number(),
+exports.issueLocationSchema = zod_1.z.object({
+    startLine: zod_1.z.number(),
+    endLine: zod_1.z.number(),
 });
-
-/**
- * A single issue identified in the code review
- */
-export interface ReviewIssue {
-  id: string;
-  priority: IssuePriority;
-  description: string;
-  location: IssueLocation;
-  currentCode: string;
-  suggestedCode: string;
-  explanation: string;
-}
-
 // Zod schema for review issue
-export const reviewIssueSchema = z.object({
-  id: z.string(),
-  priority: issuePrioritySchema,
-  description: z.string(),
-  location: issueLocationSchema,
-  currentCode: z.string(),
-  suggestedCode: z.string(),
-  explanation: z.string(),
+exports.reviewIssueSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    priority: exports.issuePrioritySchema,
+    description: zod_1.z.string(),
+    location: exports.issueLocationSchema,
+    currentCode: zod_1.z.string(),
+    suggestedCode: zod_1.z.string(),
+    explanation: zod_1.z.string(),
 });
-
-/**
- * Review results for a single file
- */
-export interface FileReview {
-  filePath: string;
-  issues: ReviewIssue[];
-}
-
 // Zod schema for file review
-export const fileReviewSchema = z.object({
-  filePath: z.string(),
-  issues: z.array(reviewIssueSchema),
+exports.fileReviewSchema = zod_1.z.object({
+    filePath: zod_1.z.string(),
+    issues: zod_1.z.array(exports.reviewIssueSchema),
 });
-
-/**
- * Summary statistics for the code review
- */
-export interface ReviewSummary {
-  highPriorityIssues: number;
-  mediumPriorityIssues: number;
-  lowPriorityIssues: number;
-  totalIssues: number;
-}
-
 // Zod schema for review summary
-export const reviewSummarySchema = z.object({
-  highPriorityIssues: z.number(),
-  mediumPriorityIssues: z.number(),
-  lowPriorityIssues: z.number(),
-  totalIssues: z.number(),
+exports.reviewSummarySchema = zod_1.z.object({
+    highPriorityIssues: zod_1.z.number(),
+    mediumPriorityIssues: zod_1.z.number(),
+    lowPriorityIssues: zod_1.z.number(),
+    totalIssues: zod_1.z.number(),
 });
-
-/**
- * Complete code review results
- */
-export interface CodeReview {
-  version: string;
-  timestamp: string;
-  files: FileReview[];
-  summary: ReviewSummary;
-}
-
 // Zod schema for code review
-export const codeReviewSchema = z.object({
-  version: z.string(),
-  timestamp: z.string(),
-  files: z.array(fileReviewSchema),
-  summary: reviewSummarySchema,
+exports.codeReviewSchema = zod_1.z.object({
+    version: zod_1.z.string(),
+    timestamp: zod_1.z.string(),
+    files: zod_1.z.array(exports.fileReviewSchema),
+    summary: exports.reviewSummarySchema,
 });
-
-/**
- * Root object for the code review schema
- */
-export interface ReviewSchema {
-  review: CodeReview;
-}
-
 // Zod schema for review schema
-export const reviewSchema = z.object({
-  review: codeReviewSchema,
+exports.reviewSchema = zod_1.z.object({
+    review: exports.codeReviewSchema,
 });
-
 /**
  * Get the schema as a string for inclusion in prompts
  */
-export function getSchemaAsString(): string {
-  return `
+function getSchemaAsString() {
+    return `
 {
   "review": {
     "version": "1.0",
@@ -157,12 +97,11 @@ export function getSchemaAsString(): string {
 }
 `;
 }
-
 /**
  * Get schema instructions for inclusion in prompts
  */
-export function getSchemaInstructions(): string {
-  return `
+function getSchemaInstructions() {
+    return `
 IMPORTANT: In interactive mode, you MUST format your response as a valid JSON object following this exact schema:
 
 ${getSchemaAsString()}
@@ -179,3 +118,4 @@ Guidelines for filling the schema:
 Your response must be valid JSON that can be parsed programmatically. Do not include any text outside of the JSON structure.
 `;
 }
+//# sourceMappingURL=reviewSchema.js.map

package/dist/types/reviewSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewSchema.js","sourceRoot":"","sources":["../../src/types/reviewSchema.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuHH,8CAkCC;AAKD,sDAiBC;AA7KD,6BAAwB;AAExB;;GAEG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACb,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED,gCAAgC;AACnB,QAAA,mBAAmB,GAAG,OAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAU/D,gCAAgC;AACnB,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAeH,8BAA8B;AACjB,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,2BAAmB;IAC7B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,2BAAmB;IAC7B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAUH,6BAA6B;AAChB,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yBAAiB,CAAC;CACnC,CAAC,CAAC;AAYH,gCAAgC;AACnB,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC9B,oBAAoB,EAAE,OAAC,CAAC,MAAM,EAAE;IAChC,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC7B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAYH,6BAA6B;AAChB,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,wBAAgB,CAAC;IAChC,OAAO,EAAE,2BAAmB;CAC7B,CAAC,CAAC;AASH,+BAA+B;AAClB,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,wBAAgB;CACzB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO;;;EAGP,iBAAiB,EAAE;;;;;;;;;;;;CAYpB,CAAC;AACF,CAAC"}

package/dist/types/structuredReview.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Type definitions for the structured review output that cr-aia emits.
+ */
+/**
+ * Priority levels for code review issues
+ */
+export type IssuePriority = 'high' | 'medium' | 'low';
+/**
+ * Types of code review issues
+ */
+export type IssueType = 'bug' | 'security' | 'performance' | 'maintainability' | 'readability' | 'architecture' | 'best-practice' | 'documentation' | 'testing' | 'other';
+/**
+ * A single code review issue
+ */
+export interface ReviewIssue {
+    /**
+     * Title of the issue
+     */
+    title: string;
+    /**
+     * Priority level of the issue
+     */
+    priority: IssuePriority;
+    /**
+     * Type of issue
+     */
+    type: IssueType;
+    /**
+     * File path where the issue was found
+     */
+    filePath: string;
+    /**
+     * Line number(s) where the issue was found
+     * Can be a single line number or a range (e.g., "10-15")
+     */
+    lineNumbers?: string;
+    /**
+     * Description of the issue
+     */
+    description: string;
+    /**
+     * Code snippet showing the issue
+     */
+    codeSnippet?: string;
+    /**
+     * Suggested fix for the issue
+     */
+    suggestedFix?: string;
+    /**
+     * Impact of the issue
+     */
+    impact?: string;
+}
+/**
+ * Grade level types for overall code quality
+ */
+export type GradeLevel = 'A+' | 'A' | 'A-' | 'B+' | 'B' | 'B-' | 'C+' | 'C' | 'C-' | 'D+' | 'D' | 'D-' | 'F';
+/**
+ * Code quality assessment categories
+ */
+export interface GradeCategories {
+    /**
+     * Code functionality grade
+     */
+    functionality?: GradeLevel;
+    /**
+     * Code quality grade
+     */
+    codeQuality?: GradeLevel;
+    /**
+     * Documentation grade
+     */
+    documentation?: GradeLevel;
+    /**
+     * Testing grade
+     */
+    testing?: GradeLevel;
+    /**
+     * Maintainability grade
+     */
+    maintainability?: GradeLevel;
+    /**
+     * Security grade
+     */
+    security?: GradeLevel;
+    /**
+     * Performance grade
+     */
+    performance?: GradeLevel;
+}
+/**
+ * Structured code review output
+ */
+export interface StructuredReview {
+    /**
+     * Overall grade for the codebase
+     */
+    grade?: GradeLevel;
+    /**
+     * Detailed grade breakdown by category
+     */
+    gradeCategories?: GradeCategories;
+    /**
+     * Summary of the code review
+     */
+    summary: string;
+    /**
+     * List of issues found in the code review
+     */
+    issues: ReviewIssue[];
+    /**
+     * General recommendations that don't fit into specific issues
+     */
+    recommendations?: string[];
+    /**
+     * Positive aspects of the code
+     */
+    positiveAspects?: string[];
+}

package/dist/types/structuredReview.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for the structured review output that cr-aia emits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=structuredReview.js.map

package/dist/types/structuredReview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredReview.js","sourceRoot":"","sources":["../../src/types/structuredReview.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/tokenAnalysis.d.ts

@@ -0,0 +1,44 @@
+/** Token analysis primitives shared across the CLI. */
+import type { FileInfo } from './review';
+export interface FileTokenAnalysis {
+    path: string;
+    relativePath: string | undefined;
+    tokenCount: number;
+    sizeInBytes: number;
+    tokensPerByte: number;
+}
+export interface TokenAnalysisResult {
+    files: FileTokenAnalysis[];
+    totalTokens: number;
+    totalSizeInBytes: number;
+    averageTokensPerByte: number;
+    fileCount: number;
+    promptOverheadTokens: number;
+    estimatedTotalTokens: number;
+    contextWindowSize: number;
+    exceedsContextWindow: boolean;
+    estimatedPassesNeeded: number;
+    chunkingRecommendation: ChunkingRecommendation;
+}
+export interface ChunkingRecommendation {
+    chunkingRecommended: boolean;
+    recommendedChunks: FileChunk[];
+    reason: string;
+}
+export interface FileChunk {
+    files: string[];
+    estimatedTokenCount: number;
+    priority: number;
+}
+export interface TokenAnalysisOptions {
+    reviewType: string;
+    modelName: string;
+    optimizeForSpeed?: boolean;
+    additionalPromptOverhead?: number;
+    contextMaintenanceFactor?: number;
+}
+export declare class TokenAnalyzer {
+    static analyzeFile(file: FileInfo, options: TokenAnalysisOptions): FileTokenAnalysis;
+    static analyzeFiles(files: FileInfo[], options: TokenAnalysisOptions): TokenAnalysisResult;
+}
+export declare function formatTokenAnalysis(analysis: TokenAnalysisResult, modelName: string, includeFiles?: boolean): string;

package/dist/types/tokenAnalysis.js

@@ -0,0 +1,4 @@
+"use strict";
+/** Token analysis primitives shared across the CLI. */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tokenAnalysis.js.map

package/dist/types/tokenAnalysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenAnalysis.js","sourceRoot":"","sources":["../../src/types/tokenAnalysis.ts"],"names":[],"mappings":";AAAA,uDAAuD"}

package/dist/utils/FileReader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview File reading utilities.
+ *
+ * This module provides utilities for reading files and directories,
+ * with error handling and logging.
+ */
+import type { FileInfo } from '../types/review';
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Promise resolving to the file content
+ * @throws Error if the file cannot be read
+ */
+export declare function readFile(filePath: string): Promise<string>;
+/**
+ * Read a file and return its content with file info
+ * @param filePath Path to the file
+ * @returns Promise resolving to a FileInfo object
+ */
+export declare function readFileWithInfo(filePath: string): Promise<FileInfo>;
+/**
+ * Read multiple files and return their contents with file info
+ * @param filePaths Array of file paths
+ * @returns Promise resolving to an array of FileInfo objects
+ */
+export declare function readFilesWithInfo(filePaths: string[]): Promise<FileInfo[]>;
+/**
+ * Read all files in a directory recursively
+ * @param dirPath Path to the directory
+ * @param filter Optional filter function to exclude certain files
+ * @returns Promise resolving to an array of file paths
+ */
+export declare function readFilesInDirectory(dirPath: string, filter?: (filePath: string) => boolean): Promise<string[]>;

package/dist/utils/FileReader.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * @fileoverview File reading utilities.
+ *
+ * This module provides utilities for reading files and directories,
+ * with error handling and logging.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFile = readFile;
+exports.readFileWithInfo = readFileWithInfo;
+exports.readFilesWithInfo = readFilesWithInfo;
+exports.readFilesInDirectory = readFilesInDirectory;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = __importDefault(require("./logger"));
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Promise resolving to the file content
+ * @throws Error if the file cannot be read
+ */
+async function readFile(filePath) {
+    try {
+        return await promises_1.default.readFile(filePath, 'utf-8');
+    }
+    catch (error) {
+        logger_1.default.error(`Error reading file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Read a file and return its content with file info
+ * @param filePath Path to the file
+ * @returns Promise resolving to a FileInfo object
+ */
+async function readFileWithInfo(filePath) {
+    try {
+        const content = await promises_1.default.readFile(filePath, 'utf-8');
+        const extension = node_path_1.default.extname(filePath).slice(1);
+        return {
+            path: filePath,
+            content,
+            extension,
+        };
+    }
+    catch (error) {
+        logger_1.default.error(`Error reading file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Read multiple files and return their contents with file info
+ * @param filePaths Array of file paths
+ * @returns Promise resolving to an array of FileInfo objects
+ */
+async function readFilesWithInfo(filePaths) {
+    const fileInfoPromises = filePaths.map((filePath) => readFileWithInfo(filePath));
+    return Promise.all(fileInfoPromises);
+}
+/**
+ * Read all files in a directory recursively
+ * @param dirPath Path to the directory
+ * @param filter Optional filter function to exclude certain files
+ * @returns Promise resolving to an array of file paths
+ */
+async function readFilesInDirectory(dirPath, filter) {
+    const result = [];
+    async function processDirectory(currentPath) {
+        const entries = await promises_1.default.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = node_path_1.default.join(currentPath, entry.name);
+            if (entry.isDirectory()) {
+                await processDirectory(entryPath);
+            }
+            else if (entry.isFile()) {
+                if (!filter || filter(entryPath)) {
+                    result.push(entryPath);
+                }
+            }
+        }
+    }
+    await processDirectory(dirPath);
+    return result;
+}
+//# sourceMappingURL=FileReader.js.map

package/dist/utils/FileReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileReader.js","sourceRoot":"","sources":["../../src/utils/FileReader.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAaH,4BASC;AAOD,4CAgBC;AAOD,8CAGC;AAQD,oDAwBC;AArFD,gEAAkC;AAClC,0DAA6B;AAE7B,sDAA8B;AAE9B;;;;;GAKG;AACI,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,sBAAsB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAElD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO;YACP,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,sBAAsB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,iBAAiB,CAAC,SAAmB;IACzD,MAAM,gBAAgB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,MAAsC;IAEtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,UAAU,gBAAgB,CAAC,WAAmB;QACjD,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAErD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;oBACjC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/FileWriter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview File writing utilities.
+ *
+ * This module provides utilities for writing files and creating directories,
+ * with error handling and logging.
+ */
+/**
+ * Create a directory if it doesn't exist
+ * @param dirPath Path to the directory
+ * @returns Promise resolving when the directory is created or already exists
+ */
+export declare function ensureDirectoryExists(dirPath: string): Promise<void>;
+/**
+ * Write content to a file, creating the directory if needed
+ * @param filePath Path to the file
+ * @param content Content to write
+ * @returns Promise resolving when the file is written
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+/**
+ * Append content to a file, creating the file if it doesn't exist
+ * @param filePath Path to the file
+ * @param content Content to append
+ * @returns Promise resolving when the content is appended
+ */
+export declare function appendFile(filePath: string, content: string): Promise<void>;

package/dist/utils/FileWriter.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @fileoverview File writing utilities.
+ *
+ * This module provides utilities for writing files and creating directories,
+ * with error handling and logging.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectoryExists = ensureDirectoryExists;
+exports.writeFile = writeFile;
+exports.appendFile = appendFile;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = __importDefault(require("./logger"));
+const pathValidator_1 = require("./pathValidator");
+/**
+ * Create a directory if it doesn't exist
+ * @param dirPath Path to the directory
+ * @returns Promise resolving when the directory is created or already exists
+ */
+async function ensureDirectoryExists(dirPath) {
+    try {
+        if (!(0, pathValidator_1.pathExists)(dirPath)) {
+            await promises_1.default.mkdir(dirPath, { recursive: true });
+            logger_1.default.debug(`Created directory: ${dirPath}`);
+        }
+    }
+    catch (error) {
+        logger_1.default.error(`Error creating directory ${dirPath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Write content to a file, creating the directory if needed
+ * @param filePath Path to the file
+ * @param content Content to write
+ * @returns Promise resolving when the file is written
+ */
+async function writeFile(filePath, content) {
+    try {
+        // Ensure the directory exists
+        const dirPath = node_path_1.default.dirname(filePath);
+        await ensureDirectoryExists(dirPath);
+        // Write the file
+        await promises_1.default.writeFile(filePath, content);
+        logger_1.default.debug(`Wrote file: ${filePath}`);
+    }
+    catch (error) {
+        logger_1.default.error(`Error writing file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Append content to a file, creating the file if it doesn't exist
+ * @param filePath Path to the file
+ * @param content Content to append
+ * @returns Promise resolving when the content is appended
+ */
+async function appendFile(filePath, content) {
+    try {
+        // Ensure the directory exists
+        const dirPath = node_path_1.default.dirname(filePath);
+        await ensureDirectoryExists(dirPath);
+        // Append to the file
+        await promises_1.default.appendFile(filePath, content);
+        logger_1.default.debug(`Appended to file: ${filePath}`);
+    }
+    catch (error) {
+        logger_1.default.error(`Error appending to file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=FileWriter.js.map

package/dist/utils/FileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileWriter.js","sourceRoot":"","sources":["../../src/utils/FileWriter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAYH,sDAYC;AAQD,8BAeC;AAQD,gCAeC;AApED,gEAAkC;AAClC,0DAA6B;AAC7B,sDAA8B;AAC9B,mDAA6C;AAE7C;;;;GAIG;AACI,KAAK,UAAU,qBAAqB,CAAC,OAAe;IACzD,IAAI,CAAC;QACH,IAAI,CAAC,IAAA,0BAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,kBAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,gBAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,4BAA4B,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAErC,iBAAiB;QACjB,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,gBAAM,CAAC,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,sBAAsB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAChE,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAErC,qBAAqB;QACrB,MAAM,kBAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvC,gBAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,2BAA2B,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/PathGenerator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Path generation utilities.
+ *
+ * This module provides utilities for generating file and directory paths,
+ * including versioned output paths for review results.
+ */
+/**
+ * Generate a versioned output path for a file
+ * @param baseDir Base directory for the output
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @param modelName Name of the model used for the review
+ * @param targetName Name of the target file or directory
+ * @returns Promise resolving to the generated path
+ */
+export declare function generateVersionedOutputPath(baseDir: string, prefix: string, extension: string, modelName: string, targetName: string): Promise<string>;
+/**
+ * Generate an output path for a file with a unique name
+ * @param baseDir Base directory for the output
+ * @param filename Desired filename
+ * @returns Promise resolving to the generated path
+ */
+export declare function generateUniqueOutputPath(baseDir: string, filename: string): Promise<string>;
+/**
+ * Generate a temporary file path
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @returns Generated temporary file path
+ */
+export declare function generateTempFilePath(prefix: string, extension: string): string;