Merge pull request #77 from alex-feel/alex-feel-dev

Add local file path support to environment configurations

Author: alex-feel

.github/workflows/validate-configs.yml

@@ -67,10 +67,10 @@ jobs:
               # Check if it's a template or library config
               if [[ "$config_file" == *"templates/"* ]]; then
                 echo "Note: Template file - allowing placeholder values"
-                python scripts/validate_environment_config.py "$config_file" || true
+                uv run python scripts/validate_environment_config.py "$config_file" || true
               else
                 # Library configs must pass strict validation
-                if ! python scripts/validate_environment_config.py "$config_file" --strict; then
+                if ! uv run python scripts/validate_environment_config.py "$config_file" --strict; then
                   exit_code=1
                 fi
               fi

.pre-commit-config.yaml

@@ -64,6 +64,6 @@ repos:
       args: [--severity=warning]
 
 - repo: https://github.com/commitizen-tools/commitizen
-  rev: v4.8.4
+  rev: v4.9.0
   hooks:
     - id: commitizen

agents/library/code-deep-researcher.md

@@ -170,7 +170,7 @@ Your mission is to deliver a comprehensive code investigation report that fully
    - Partial understanding: Medium confidence
    - Ambiguous implementation: Low confidence
 
-3. **Generate Structured Output:** (See schema below)
+3. **Generate Report:** Produce comprehensive code investigation findings
 
 ## 📚 Repository Registry
 
@@ -221,161 +221,6 @@ Only clone repositories that are:
 2. Relevant to the current QUESTION
 3. Necessary for complete understanding
 
-## 📋 Structured Output Schema (YAML)
-
-```yaml
-question: <verbatim QUESTION from orchestrator>
-context:
-  business_intent: <extracted from CONTEXT>
-  technical_scope: <inferred scope>
-
-repositories:
-  - name: <repo-name>
-    path: ./_repos/<repo-name>
-    commit: <short-hash>
-    status: cloned|updated|failed
-    files_examined: <count>
-
-search:
-  terms: [list, of, search, terms]
-  patterns: [grep, patterns, used]
-
-discovered_signals:
-  entry_points:
-    - path: <file-path>
-      lines: [start-end]
-      type: main|api|event|configuration
-      description: <what this entry point does>
-
-  key_components:
-    - name: <component-name>
-      path: <file-path>
-      lines: [start-end]
-      type: class|function|module|service
-      responsibility: <what it does>
-
-behavior_analysis:
-  overview: |
-    <Two-paragraph plain description of current behavior>
-
-  execution_flow:
-    inputs:
-      - source: <where input comes from>
-        type: <data type/format>
-        validation: <how it's validated>
-
-    processing_steps:
-      - step: 1
-        location: <file:lines>
-        description: <what happens>
-        data_transformation: <how data changes>
-
-    outputs:
-      - destination: <where output goes>
-        type: <data type/format>
-        side_effects: [list]
-
-  configuration:
-    files:
-      - path: <config-file>
-        relevant_sections: [section-names]
-
-    parameters:
-      - name: <param-name>
-        location: <file:lines>
-        default: <default-value>
-        effect: <how this influences behavior>
-
-  error_handling:
-    - condition: <error-condition>
-      location: <file:lines>
-      handling: <how it's handled>
-      recovery: <recovery strategy>
-
-  concurrency:
-    threading_model: <sync|async|concurrent>
-    synchronization: [mechanisms]
-    race_conditions: [potential issues]
-
-dependencies:
-  internal:
-    - from: <module>
-      to: <module>
-      type: import|inherit|compose|inject
-      purpose: <why this dependency exists>
-
-  external:
-    - library: <name>
-      version: <if found>
-      usage: <how it's used>
-      location: <where imported>
-
-impact_analysis:
-  affected_modules:
-    - path: <file-path>
-      impact_level: direct|indirect
-      reason: <why affected>
-
-  invariants:
-    - invariant: <what must remain true>
-      enforced_by: <mechanism>
-      location: <file:lines>
-
-  risks:
-    - risk: <potential issue>
-      likelihood: high|medium|low
-      mitigation: <how to avoid>
-
-  change_complexity:
-    estimate: trivial|simple|moderate|complex|very_complex
-    factors: [list of complicating factors]
-
-evidence:
-  files_read:
-    - path: <file-path>
-      lines: [start-end]
-      purpose: <why this file was examined>
-      key_findings: [list]
-
-  grep_results:
-    - pattern: <regex-pattern>
-      matches: <count>
-      relevant_files: [paths]
-
-  test_coverage:
-    - test_file: <path>
-      covers: <what it tests>
-      insights: <what tests reveal about behavior>
-
-open_questions:
-  - question: <specific question needing clarification>
-    blocking: yes|no
-    suggested_investigation: <next steps>
-
-recommendations:
-  implementation_approach: |
-    <If change is needed, high-level approach>
-
-  further_investigation:
-    - area: <what to investigate>
-      reason: <why it matters>
-      method: <how to investigate>
-
-confidence: 0.95  # 0.00-1.00 scale
-confidence_factors:
-  positive:
-    - <what increased confidence>
-  negative:
-    - <what reduced confidence>
-
-metadata:
-  execution_time_ms: <integer>
-  files_read: <count>
-  grep_operations: <count>
-  total_lines_analyzed: <approximate>
-  repository_size_mb: <total size>
-```yaml
-
 ## ⚡ Performance & Concurrency Guidelines
 
 ### 🚀 CRITICAL: CONCURRENT EXECUTION FOR ALL ACTIONS

agents/library/code-reviewer.md

@@ -176,74 +176,6 @@ __Ultrathink throughout your entire workflow:__
 - __Good Practices:__ [Patterns to replicate]
 - __Excellent Documentation:__ [Notable examples]
 
-## 📋 Structured Output Schema (YAML)
-
-```yaml
-review_summary:
-  metadata:
-    reviewer: code-reviewer
-    timestamp: 2024-12-20T10:30:00Z
-    review_id: REV-2024-001
-    duration_ms: 4500
-
-  scope:
-    files_reviewed: 15
-    lines_analyzed: 2340
-    languages: [python, javascript]
-    review_type: pull_request
-
-  findings:
-    total_count: 23
-    by_severity:
-      critical: 2
-      high: 5
-      medium: 8
-      low: 8
-    by_category:
-      security: 7
-      performance: 4
-      maintainability: 8
-      testing: 4
-
-  critical_issues:
-    - id: SEC-001
-      type: sql_injection
-      file: database/queries.py
-      lines: [45, 67, 89]
-      cwe: CWE-89
-      owasp: A03:2021
-      fix_required: true
-      estimated_effort: 2h
-
-  quality_metrics:
-    complexity:
-      cyclomatic: 12.5
-      cognitive: 8.3
-    duplication: 5.2%
-    test_coverage: 78%
-    documentation: 65%
-
-  recommendations:
-    immediate:
-      - Fix SQL injection vulnerabilities
-      - Add input validation for user data
-      - Remove hardcoded credentials
-    short_term:
-      - Refactor complex functions
-      - Increase test coverage to 85%
-      - Update deprecated dependencies
-    long_term:
-      - Implement security scanning in CI/CD
-      - Adopt architectural improvements
-      - Establish code review checklist
-
-  risk_assessment:
-    overall: HIGH
-    security_risk: CRITICAL
-    technical_debt: MEDIUM
-    maintainability: GOOD
-```
-
 ## 🎯 Domain-Specific Review Categories
 
 ### Security Review Checklist

agents/library/doc-writer.md

@@ -147,65 +147,6 @@ __Think a lot throughout your entire workflow:__
 - __Troubleshooting:__ Common issues and solutions
 - __Next Steps:__ Where to go from here
 
-## 📋 Structured Output Schema (YAML)
-
-```yaml
-documentation_summary:
-  metadata:
-    doc_type: [api|guide|tutorial|reference|architecture]
-    version: 1.0.0
-    last_updated: 2024-12-20T10:30:00Z
-    authors: [doc-writer]
-
-  coverage:
-    total_items: 150
-    documented: 145
-    coverage_percent: 96.7
-    missing_items:
-      - internal/utils/helper.js
-      - deprecated/old_api.py
-
-  sections_created:
-    - name: API Reference
-      files: [api.md, endpoints.md]
-      items_documented: 45
-    - name: Getting Started
-      files: [quickstart.md]
-      examples_included: 12
-    - name: Architecture
-      files: [architecture.md, decisions/adr-001.md]
-      diagrams_created: 3
-
-  quality_metrics:
-    readability_score: 72  # Flesch Reading Ease
-    example_coverage: 0.89
-    link_validity: 0.98
-    completeness: 0.95
-
-  code_examples:
-    total: 35
-    languages: [python, javascript, bash]
-    tested: 35
-    working: 34
-
-  improvements_made:
-    - Added missing parameter descriptions
-    - Created 12 new code examples
-    - Fixed 8 broken links
-    - Updated deprecated API warnings
-    - Added troubleshooting section
-
-  recommendations:
-    immediate:
-      - Document new v2 endpoints
-      - Update migration guide
-      - Fix broken example in auth.md
-    future:
-      - Add interactive API explorer
-      - Create video tutorials
-      - Translate to other languages
-```
-
 ## 🎯 Domain-Specific Documentation Types
 
 ### API Documentation Standards