feat: release:Develop

.env.example

@@ -0,0 +1,123 @@
+# ============================================
+# APPLICATION CONFIGURATION
+# ============================================
+NODE_ENV=development
+PORT=3000
+API_VERSION=v1
+APP_URL=http://localhost:3000
+
+# ============================================
+# DATABASE CONFIGURATION (PostgreSQL)
+# ============================================
+# Option 1: Use connection string (recommended)
+DATABASE_URL=postgresql://username:password@hostname:5432/database_name
+
+# Option 2: Use individual parameters
+DB_HOST=localhost
+DB_PORT=5432
+DB_USER=your_db_user
+DB_PASSWORD=your_db_password
+DB_NAME=your_db_name
+
+# Connection pool settings
+DB_POOL_MIN=2
+DB_POOL_MAX=10
+DB_IDLE_TIMEOUT_MS=30000
+DB_CONNECTION_TIMEOUT_MS=2000
+
+# ============================================
+# REDIS CONFIGURATION
+# ============================================
+# Option 1: Use connection string (recommended)
+REDIS_URL=redis://localhost:6379
+
+# Option 2: Use individual parameters
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_DB=0
+
+# ============================================
+# RATE LIMITING CONFIGURATION
+# ============================================
+RATE_LIMIT_WINDOW_MS=3600000
+RATE_LIMIT_FREE_TIER=100
+RATE_LIMIT_PRO_TIER=1000
+RATE_LIMIT_ENTERPRISE_TIER=10000
+
+# ============================================
+# GITHUB API CONFIGURATION
+# ============================================
+# Get your token from: https://github.com/settings/tokens
+# Permissions needed: public_repo (for public repos)
+GITHUB_TOKEN=your_github_personal_access_token_here
+GITHUB_API_URL=https://api.github.com
+GITHUB_RATE_LIMIT=5000
+
+# ============================================
+# SECURITY CONFIGURATION
+# ============================================
+# Generate with: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
+API_KEY_SECRET=generate_a_random_secret_key_here
+
+# CORS allowed origins (comma-separated)
+CORS_ORIGIN=http://localhost:3000,http://localhost:3001
+
+# ============================================
+# LOGGING CONFIGURATION
+# ============================================
+# Options: error, warn, info, http, debug
+LOG_LEVEL=info
+LOG_TO_FILE=true
+
+# ============================================
+# CACHE CONFIGURATION
+# ============================================
+CACHE_TTL_SHORT=300
+CACHE_TTL_MEDIUM=900
+CACHE_TTL_LONG=3600
+CACHE_TTL_VERY_LONG=86400
+
+# ============================================
+# JOB QUEUE CONFIGURATION
+# ============================================
+JOB_TIMEOUT_MS=300000
+JOB_MAX_RETRIES=3
+JOB_RETRY_DELAY_MS=5000
+
+# ============================================
+# PAGINATION DEFAULTS
+# ============================================
+PAGINATION_DEFAULT_PAGE=1
+PAGINATION_DEFAULT_LIMIT=20
+PAGINATION_MAX_LIMIT=100
+
+# ============================================
+# REPOSITORY ANALYSIS CONFIGURATION
+# ============================================
+MAX_COMMITS_TO_ANALYZE=1000
+MAX_FILE_SIZE_BYTES=1048576
+GIT_OPERATION_TIMEOUT_MS=60000
+
+# ============================================
+# EMAIL CONFIGURATION (Future feature)
+# ============================================
+# SMTP_HOST=smtp.gmail.com
+# SMTP_PORT=587
+# SMTP_USER=your-email@gmail.com
+# SMTP_PASSWORD=your-app-password
+# SMTP_FROM=noreply@devmetrics.com
+
+# ============================================
+# MONITORING & OBSERVABILITY (Future feature)
+# ============================================
+# SENTRY_DSN=your_sentry_dsn_here
+# ENABLE_APM=false
+
+# ============================================
+# FEATURE FLAGS
+# ============================================
+ENABLE_WEBHOOKS=false
+ENABLE_EMAIL_NOTIFICATIONS=false
+ENABLE_COMPLEXITY_ANALYSIS=true
+ENABLE_HEALTH_SCORE=true

.github/workflows/ci.yml

@@ -0,0 +1,164 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  # Job 1: Code Quality Checks
+  quality:
+    name: Code Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      # - name: Run ESLint
+      #   run: npm run lint
+      #   continue-on-error: true
+
+      - name: TypeScript type check
+        run: npm run typecheck
+
+  # Job 2: Run Tests
+  test:
+    name: Tests
+    runs-on: ubuntu-latest
+    needs: quality
+
+    services:
+      # PostgreSQL test database
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_USER: devmetrics
+          POSTGRES_PASSWORD: test_password
+          POSTGRES_DB: devmetrics_test
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5433:5432
+
+      # Redis test instance
+      redis:
+        image: redis:7-alpine
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 6380:6379
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm run test:coverage
+        env:
+          NODE_ENV: test
+          TEST_DATABASE_URL: postgresql://devmetrics:test_password@localhost:5433/devmetrics_test
+          DATABASE_URL: postgresql://devmetrics:test_password@localhost:5433/devmetrics_test
+          TEST_REDIS_URL: redis://localhost:6380
+          REDIS_URL: redis://localhost:6380
+          API_KEY_SECRET: test-secret-key-for-ci-only-minimum-32-chars
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_API_URL: https://api.github.com
+          CACHE_TTL_SHORT: 300
+          CACHE_TTL_MEDIUM: 900
+          CACHE_TTL_LONG: 3600
+
+      # - name: Upload coverage to Codecov
+      #   uses: codecov/codecov-action@v4
+      #   with:
+      #     files: ./coverage/lcov.info
+      #     flags: unittests
+      #     name: codecov-umbrella
+      #     fail_ci_if_error: false
+      #   env:
+      #     CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+      # - name: Comment coverage on PR
+      #   if: github.event_name == 'pull_request'
+      #   uses: romeovs/lcov-reporter-action@v0.3.1
+      #   with:
+      #     github-token: ${{ secrets.GITHUB_TOKEN }}
+      #     lcov-file: ./coverage/lcov.info
+
+  # Job 3: Build Check
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build TypeScript
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7
+
+  # Job 4: Security Audit
+  security:
+    name: Security Audit
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Run npm audit
+        run: npm audit --audit-level=moderate
+        continue-on-error: true
+
+      - name: Check for vulnerable dependencies
+        run: |
+          npm install -g npm-check-updates
+          ncu --doctor --doctorTest "npm test"
+        continue-on-error: true

.github/workflows/pr.yml

@@ -0,0 +1,67 @@
+name: Pull Request Checks
+
+on:
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  # PR Title Check
+  pr-title:
+    name: PR Title Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            docs
+            style
+            refactor
+            perf
+            test
+            chore
+          requireScope: false
+
+  # Changed files check
+  changes:
+    name: Detect Changes
+    runs-on: ubuntu-latest
+    outputs:
+      src: ${{ steps.filter.outputs.src }}
+      tests: ${{ steps.filter.outputs.tests }}
+      docs: ${{ steps.filter.outputs.docs }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            src:
+              - 'src/**'
+            tests:
+              - 'tests/**'
+            docs:
+              - 'docs/**'
+              - '*.md'
+
+  # Size label
+  pr-size:
+    name: PR Size Label
+    runs-on: ubuntu-latest
+    steps:
+      - uses: codelytv/pr-size-labeler@v1
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          xs_label: 'size/xs'
+          xs_max_size: 10
+          s_label: 'size/s'
+          s_max_size: 100
+          m_label: 'size/m'
+          m_max_size: 500
+          l_label: 'size/l'
+          l_max_size: 1000
+          xl_label: 'size/xl'