Merge pull request #4 from alpsla/clean_push_candidate

Clean push candidate

Author: alpsla

.github/workflows/ci.yml

@@ -17,10 +17,11 @@ jobs:
       uses: actions/setup-node@v3
       with:
         node-version: '18.x'
-        cache: 'npm'
+        # Disable npm caching to avoid ENOWORKSPACES error
+        # cache: 'npm'
 
     - name: Install dependencies
-      run: npm ci
+      run: npm ci --no-workspaces
 
     - name: Create .env file
       run: |
@@ -47,10 +48,10 @@ jobs:
         EOF
       
     - name: Lint
-      run: npm run lint
+      run: npm run lint --no-workspaces
 
     - name: Build
-      run: npm run build
+      run: npm run build --no-workspaces
 
     - name: Test
-      run: npm run test
+      run: npm run test --no-workspaces

README.md

@@ -1,98 +1,45 @@
 # CodeQual
 
-CodeQual is an intelligent code review system that analyzes pull requests, educates developers based on identified issues, and tracks individual and team growth over time.
+A comprehensive code quality analysis system powered by AI.
 
-## Overview
+## Directory Structure
 
-CodeQual uses a flexible, adaptive multi-agent architecture to provide:
+- `/scripts`: Core scripts for repository analysis and testing
+- `/reports`: Generated analysis reports (timestamped)
+- `/docs`: Documentation and guides
+- `/archive`: Archived files from previous versions
 
-- Code quality analysis
-- Security vulnerability detection
-- Performance optimization suggestions
-- Educational content tailored to developers
-- Skill tracking and professional growth insights
+## Getting Started
 
-## Features
-
-- **Two-Tier Analysis**: Choose between quick (1-3 minutes) or comprehensive (5-10 minutes) analysis
-- **Multi-Agent Architecture**: Uses several AI models to provide the best analysis for each context
-- **Repository Analysis Caching**: Stores deep repository analysis for efficient reuse
-- **Skills Tracking**: Monitors developer growth across various skill categories
-- **Visualization**: Grafana dashboards for insight visualization
-
-## Installation
-
-1. Clone the repository
-   ```bash
-   git clone https://github.com/your-username/codequal.git
-   cd codequal
-   ```
-
-2. Install dependencies
+1. Run a quick test to verify the integration is working:
    ```bash
-   npm install
+   ./scripts/quick_test.sh
    ```
 
-3. Set up environment variables
+2. Analyze a repository:
    ```bash
-   cp .env.sample .env
-   # Edit .env with your Supabase and API credentials
+   ./scripts/analyze_repository.sh <repository_url> [model_name]
    ```
-
-4. Set up the database
+   
+3. View the latest report:
    ```bash
-   ./scripts/make-scripts-executable.sh
-   ./scripts/migrate-database.sh
+   open ./reports/latest/comprehensive_analysis.md
    ```
 
-## Environment Variables
-
-CodeQual requires the following environment variables:
+## Documentation
 
-| Variable | Description | Required |
-|----------|-------------|----------|
-| SUPABASE_URL | URL for your Supabase project | Yes |
-| SUPABASE_SERVICE_ROLE_KEY | Service role key for Supabase | Yes |
-| PUBLIC_SUPABASE_ANON_KEY | Anonymous key for Supabase | No |
-| GITHUB_TOKEN | GitHub API token | No* |
-| OPENAI_API_KEY | OpenAI API key for GPT models | No* |
-| ANTHROPIC_API_KEY | Anthropic API key for Claude models | No* |
-| DEEPSEEK_API_KEY | DeepSeek API key | No* |
-| GEMINI_API_KEY | Google Gemini API key | No* |
+For detailed documentation, see:
 
-\* At least one model API key is required for functionality.
-
-For local development, create a `.env` file in the project root with these variables. For production, set them in your deployment environment.
-
-## Usage
-
-```bash
-# Start the CLI
-npm run cli
-
-# Run analysis on a PR
-codequal analyze-pr --repo owner/repo --pr 123 --mode quick
-```
+- [Repository Analysis Guide](./docs/guides/repository_analysis.md)
 
 ## Architecture
 
-The project uses a TypeScript monorepo structure with the following packages:
-
-- `agents`: AI agent integrations and orchestration
-- `cli`: Command-line interface
-- `core`: Core types and utilities
-- `database`: Database models and Supabase integration
-- `testing`: Testing utilities and test repositories
-- `ui`: User interface components
-
-## Contributing
-
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+CodeQual uses a multi-agent approach with fallback capabilities to analyze repositories across multiple dimensions:
 
-## License
+- Architecture
+- Code Quality
+- Security
+- Dependencies
+- Performance
 
-This project is licensed under the MIT License - see the LICENSE file for details.
+Each analysis produces a score from 1-10, which are combined to create an overall repository score.

apps/api/package.json

@@ -11,5 +11,12 @@
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "description": ""
+  "description": "",
+  "dependencies": {
+    "axios": "^1.9.0",
+    "dotenv": "^16.5.0"
+  },
+  "devDependencies": {
+    "@types/dotenv": "^6.1.1"
+  }
 }

apps/api/src/pages/api/pr-review.ts

@@ -1,6 +1,6 @@
 import { NextApiRequest, NextApiResponse } from 'next';
-import { PRReviewService } from '@pr-reviewer/core/services/pr-review-service';
-import { DEFAULT_AGENTS } from '@pr-reviewer/core/config/agent-registry';
+import { PRReviewService } from '@codequal/core/services/pr-review-service';
+import { DEFAULT_AGENTS } from '@codequal/core/config/agent-registry';
 
 /**
  * API endpoint for PR review
@@ -44,8 +44,9 @@ export default async function handler(
       suggestions: result.combinedResult.suggestions.length,
       educational: result.combinedResult.educational?.length || 0
     });
-  } catch (error: any) {
+  } catch (error: unknown) {
     console.error('Error handling PR review request:', error);
-    return res.status(500).json({ error: error.message });
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return res.status(500).json({ error: errorMessage });
   }
 }

apps/api/tsconfig.tsbuildinfo

@@ -11,5 +11,12 @@
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "description": ""
+  "description": "",
+  "dependencies": {
+    "axios": "^1.9.0",
+    "dotenv": "^16.5.0"
+  },
+  "devDependencies": {
+    "@types/dotenv": "^6.1.1"
+  }
 }

apps/web/package.json

@@ -25,7 +25,7 @@ export function PRReviewForm() {
     }
 
     // GitHub or GitLab PR URL validation
-    const validUrl = /https:\/\/(github|gitlab)\.com\/[^\/]+\/[^\/]+(\/pull\/\d+|\/\-\/merge_requests\/\d+)/;
+    const validUrl = /https:\/\/(github|gitlab)\.com\/[^/]+\/[^/]+(\/pull\/\d+|\/merge_requests\/\d+)/;
     if (!validUrl.test(prUrl)) {
       setError('Invalid PR URL. Must be a GitHub or GitLab PR URL.');
       return;
@@ -65,8 +65,9 @@ export function PRReviewForm() {
 
       // Redirect to results page
       router.push(`/results/${result.prReviewId}`);
-    } catch (error: any) {
-      setError(error.message);
+    } catch (error: unknown) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      setError(errorMessage);
     } finally {
       setIsSubmitting(false);
     }

apps/web/src/components/pr-review/pr-review-form.tsx

@@ -0,0 +1,152 @@
+API Endpoints:
+GET /models/config
+  Description: Get available model providers and their models.
+
+This endpoint returns the configuration of available model providers and their
+respective models that can be used throughout the application.
+
+Returns:
+    ModelConfig: A configuration object containing providers and their models
+  Parameters: []
+
+POST /export/wiki
+  Description: Export wiki content as Markdown or JSON.
+
+Args:
+    request: The export request containing wiki pages and format
+
+Returns:
+    A downloadable file in the requested format
+  Parameters: []
+
+GET /local_repo/structure
+  Description: Return the file tree and README content for a local repository.
+  Parameters: [
+  {
+    "name": "path",
+    "in": "query",
+    "required": false,
+    "schema": {
+      "type": "string",
+      "description": "Path to local repository",
+      "title": "Path"
+    },
+    "description": "Path to local repository"
+  }
+]
+
+POST /chat/completions/stream
+  Description: Stream a chat completion response directly using Google Generative AI
+  Parameters: []
+
+GET /api/wiki_cache
+  Description: Retrieves cached wiki data (structure and generated pages) for a repository.
+  Parameters: [
+  {
+    "name": "owner",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Repository owner",
+      "title": "Owner"
+    },
+    "description": "Repository owner"
+  },
+  {
+    "name": "repo",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Repository name",
+      "title": "Repo"
+    },
+    "description": "Repository name"
+  },
+  {
+    "name": "repo_type",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Repository type (e.g., github, gitlab)",
+      "title": "Repo Type"
+    },
+    "description": "Repository type (e.g., github, gitlab)"
+  },
+  {
+    "name": "language",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Language of the wiki content",
+      "title": "Language"
+    },
+    "description": "Language of the wiki content"
+  }
+]
+
+POST /api/wiki_cache
+  Description: Stores generated wiki data (structure and pages) to the server-side cache.
+  Parameters: []
+
+DELETE /api/wiki_cache
+  Description: Deletes a specific wiki cache from the file system.
+  Parameters: [
+  {
+    "name": "owner",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Repository owner",
+      "title": "Owner"
+    },
+    "description": "Repository owner"
+  },
+  {
+    "name": "repo",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Repository name",
+      "title": "Repo"
+    },
+    "description": "Repository name"
+  },
+  {
+    "name": "repo_type",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Repository type (e.g., github, gitlab)",
+      "title": "Repo Type"
+    },
+    "description": "Repository type (e.g., github, gitlab)"
+  },
+  {
+    "name": "language",
+    "in": "query",
+    "required": true,
+    "schema": {
+      "type": "string",
+      "description": "Language of the wiki content",
+      "title": "Language"
+    },
+    "description": "Language of the wiki content"
+  }
+]
+
+GET /
+  Description: Root endpoint to check if the API is running
+  Parameters: []
+
+GET /api/processed_projects
+  Description: Lists all processed projects found in the wiki cache directory.
+Projects are identified by files named like: deepwiki_cache_{repo_type}_{owner}_{repo}_{language}.json
+  Parameters: []
+