fix: Address remaining pre-commit hook issues

- Fix .yamllint duplicate key configuration
- Add pragma comments for secret detection false positives
- Clean up remaining linting issues from pre-commit hooks

Author: manavgup

.pre-commit-config.yaml

@@ -94,4 +94,4 @@ repos:
     rev: v3.5.3
     hooks:
       - id: commitizen
-        stages: [commit-msg]
+        stages: [commit-msg]

.yamllint

@@ -90,31 +90,9 @@ rules:
   # Key duplicates
   key-duplicates: enable
 
-  # Key ordering
-  key-ordering: disable
-
   # New line at end of file
   new-line-at-end-of-file: enable
 
   # New lines
   new-lines:
     type: unix
-
-  # Octal values
-  octal-values:
-    forbid-implicit-octal: true
-    forbid-explicit-octal: false
-
-  # Quoted strings
-  quoted-strings:
-    quote-type: single
-    check-keys: false
-
-  # Trailing spaces
-  trailing-spaces:
-    level: error
-
-  # Truthy
-  truthy:
-    allowed-values: ['true', 'false', 'yes', 'no', 'on', 'off']
-    check-keys: false

AGENTS.md

@@ -92,6 +92,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `make prod-status`: Check production service status
 
 ### Changed
+
 - **Milvus Connection Stability**: Improved connection handling in MilvusStore
   - Added explicit disconnection before reconnecting to prevent stale connections
   - Fixes issues with connection caching when switching between hosts
@@ -116,13 +117,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Proper FormData handling for multi-file uploads
 
 ### Fixed
+
 - **Collection Creation Modal**: Fixed document upload functionality
   - Removed fake upload simulation
   - Store actual File objects for upload
   - Fixed drag-and-drop file handling
   - Properly invoke document ingestion pipeline
 
 ### Technical Debt
+
 - Removed log file modifications from git tracking (already in .gitignore)
 - Cleaned up orphaned log files (logs/rag_modulo.log.1, logs/rag_modulo.log.3)
 
@@ -133,6 +136,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### [0.1.0] - 2025-09-30
 
 #### Major Features
+
 - Collection creation and management
 - Document processing and chunking
 - Vector store integration (Milvus)
@@ -142,6 +146,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Multi-provider LLM support (WatsonX, OpenAI, Anthropic)
 
 #### Infrastructure
+
 - Docker Compose orchestration
 - PostgreSQL for metadata
 - MLFlow for model tracking
@@ -154,11 +159,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Release Notes
 
 ### Version Numbering
+
 - **Major version** (X.0.0): Breaking changes, major architectural updates
 - **Minor version** (0.X.0): New features, non-breaking changes
 - **Patch version** (0.0.X): Bug fixes, minor improvements
 
 ### Categories
+
 - **Added**: New features
 - **Changed**: Changes to existing functionality
 - **Deprecated**: Soon-to-be removed features

CHANGELOG.md

@@ -20,6 +20,7 @@ Validate the installation instructions in README.md by executing them in a clean
 ### ✅ Python 3.12
 
 **README Instructions:**
+
 ```bash
 brew install python@3.12  # macOS
 apt install python3.12     # Ubuntu
@@ -30,13 +31,15 @@ apt install python3.12     # Ubuntu
 **Finding:** Ubuntu 22.04 does not include Python 3.12 in default repositories. The deadsnakes PPA is required.
 
 **Working Instructions:**
+
 ```bash
 sudo add-apt-repository ppa:deadsnakes/ppa
 sudo apt update
 sudo apt install python3.12 python3.12-venv python3.12-dev
 ```
 
 **Verification:**
+
 ```bash
 $ python3.12 --version
 Python 3.12.12
@@ -47,17 +50,20 @@ Python 3.12.12
 ### ✅ Make & Build Tools
 
 **README Instructions:**
+
 - Listed as "make" in prerequisites
 - Build-essential mentioned for Ubuntu
 
 **Test Result:** ✅ **PASSED**
 
 **Installation:**
+
 ```bash
 sudo apt install make build-essential
 ```
 
 **Verification:**
+
 ```bash
 $ make --version
 GNU Make 4.3
@@ -67,6 +73,7 @@ Built for aarch64-unknown-linux-gnu
 ### ✅ Environment File
 
 **README Instructions:**
+
 ```bash
 cp env.example .env
 ```
@@ -76,6 +83,7 @@ cp env.example .env
 **Finding:** The file is named `.env.example` (with leading dot), not `env.example`
 
 **Working Command:**
+
 ```bash
 cp .env.example .env
 ```
@@ -92,6 +100,7 @@ cp .env.example .env
 ### Step 2: Set up Environment Variables ✅
 
 **Test:**
+
 ```bash
 $ cd /workspace
 $ ls -la .env.example
@@ -103,6 +112,7 @@ $ ls -la .env.example
 ### Step 3: Install Dependencies
 
 **README Command:**
+
 ```bash
 make local-dev-setup
 ```
@@ -114,6 +124,7 @@ make local-dev-setup
 ### Step 4: Start Infrastructure
 
 **README Command:**
+
 ```bash
 make local-dev-infra
 ```
@@ -143,6 +154,7 @@ make local-dev-infra
    - macOS users should use Homebrew
 
 2. **Add verification step after prerequisites:**
+
    ```bash
    make check-docker  # Already exists!
    ```
@@ -169,6 +181,7 @@ make local-dev-infra
 The README installation instructions are accurate and comprehensive. The only issue found was the need for deadsnakes PPA on Ubuntu 22.04, which has been addressed.
 
 The prerequisites are correct, and the installation commands are valid. Full end-to-end testing would require:
+
 - More time (30-60 minutes)
 - Docker-in-Docker setup
 - API keys for LLM providers

INSTALLATION_TEST_RESULTS.md

@@ -9,6 +9,7 @@
 ## 📋 **Executive Summary**
 
 Successfully implemented both requested features:
+
 1. ✅ **New field support** for podcast customization (style, complexity, language)
 2. ✅ **Script-to-audio endpoint** for workflow optimization
 
@@ -35,6 +36,7 @@ All three phases (Verify, Implement, Test) completed successfully with zero lint
    - Updated both fallback template configurations
 
 ### **Files Modified**
+
 - `backend/rag_solution/services/podcast_service.py`:
   - Updated `PODCAST_SCRIPT_PROMPT` (lines 49-103)
   - Updated `variables` dictionary (lines 562-574)
@@ -43,20 +45,25 @@ All three phases (Verify, Implement, Test) completed successfully with zero lint
 ### **Testing Results**
 
 **Test 1: Beginner + Educational**
+
 ```bash
 curl -X POST /api/podcasts/generate-script \
   -d '{"podcast_style": "educational", "complexity_level": "beginner", ...}'
 ```
+
 **Result**: ✅ Generated 718 words with simplified language, clear explanations
 
 **Test 2: Advanced + Discussion**
+
 ```bash
 curl -X POST /api/podcasts/generate-script \
   -d '{"podcast_style": "discussion", "complexity_level": "advanced", ...}'
 ```
+
 **Result**: ✅ Generated 1,591 words with technical language, deeper analysis
 
 ### **Impact**
+
 - ✅ All new fields now properly affect script generation
 - ✅ Output quality varies significantly based on field values
 - ✅ Multi-language support enabled (pending model capability)
@@ -85,6 +92,7 @@ curl -X POST /api/podcasts/generate-script \
    - Background task processing
 
 ### **Files Modified**
+
 - `backend/rag_solution/schemas/podcast_schema.py`:
   - Added `PodcastAudioGenerationInput` schema (lines 344-409)
 - `backend/rag_solution/services/podcast_service.py`:
@@ -172,12 +180,14 @@ curl -X POST /api/podcasts/generate-script \
 ### **Quality Verification**
 
 **Test Case 1: Educational + Beginner**
+
 - **Word Count**: 718 words
 - **Language**: Simple, accessible
 - **Structure**: Step-by-step explanations
 - **Verdict**: ✅ Appropriate for beginners
 
 **Test Case 2: Discussion + Advanced**
+
 - **Word Count**: 1,591 words (2.2x more content)
 - **Language**: Technical, specialized
 - **Structure**: Debate-style with nuanced analysis
@@ -219,6 +229,7 @@ curl -X POST /api/podcasts/generate-script \
 The enhanced prompt template now includes:
 
 1. **Style-Specific Guidelines**
+
    ```
    - conversational_interview: Q&A with open-ended questions
    - narrative: Storytelling with smooth transitions
@@ -227,13 +238,15 @@ The enhanced prompt template now includes:
    ```
 
 2. **Complexity-Specific Guidelines**
+
    ```
    - beginner: Simple language, avoid jargon, use analogies
    - intermediate: Standard terminology, moderate depth
    - advanced: Technical language, deep analysis, nuances
    ```
 
 3. **Language Guidelines**
+
    ```
    - Generate ENTIRE script in specified language
    - Use natural expressions and idioms
@@ -243,6 +256,7 @@ The enhanced prompt template now includes:
 ### **Data Flow**
 
 **Full Generation (`/generate`):**
+
 ```
 Request → Validate → Create Record → Background Task:
     1. RAG Retrieval (30s)
@@ -254,6 +268,7 @@ Request → Validate → Create Record → Background Task:
 ```
 
 **Script-Only Generation (`/generate-script`):**
+
 ```
 Request → Validate → Background Task:
     1. RAG Retrieval (30s)
@@ -263,6 +278,7 @@ Request → Validate → Background Task:
 ```
 
 **Script-to-Audio (`/script-to-audio`):**
+
 ```
 Request → Validate → Create Record → Background Task:
     1. Parse Script (1s)
@@ -410,11 +426,13 @@ curl -X POST /api/podcasts/generate-script \
 **Scenario: Generate 15-minute podcast**
 
 **Without Script-to-Audio:**
+
 - Generate full podcast: $0.20
 - Not satisfied with script? Generate again: $0.20
 - Total: $0.40
 
 **With Script-to-Audio:**
+
 - Generate script: $0.03
 - Not satisfied? Generate script again: $0.03
 - Satisfied? Generate audio: $0.15
@@ -466,7 +484,7 @@ curl -X POST /api/podcasts/generate-script \
 - **Implementation Plan**: `PODCAST_IMPLEMENTATION_PLAN.md`
 - **Language Dropdown Issue**: `GITHUB_ISSUE_LANGUAGE_DROPDOWN.md`
 - **Model Selection Architecture**: To be documented in GitHub issue
-- **API Documentation**: http://localhost:8000/docs (when running locally)
+- **API Documentation**: <http://localhost:8000/docs> (when running locally)
 
 ---