# Detect languages in current project
cyrus detect .

# Analyze a specific file with detailed info
cyrus detect src/components/App.tsx --detailed

# Export project language analysis
cyrus detect . --json -o project-analysis.json

# Setup with local AI (no API key required!)
cyrus config init
# ✓ Found local AI models:
#   Ollama: llama3.2, codellama, mistral
#   LM Studio: deepseek-coder, code-llama-13b

# Switch between providers easily
cyrus config set provider ollama
cyrus config set model llama3.2

# Full analysis suite
cyrus analyze src/app.ts --security --metrics --explain

# Quick fix for critical issues
cyrus fix src/problematic-file.js

# Comprehensive code review
cyrus review src/components/UserAuth.tsx

# Get personalized mentoring
cyrus mentor src/algorithm.js --interactive

# Learning mode with detailed explanations
cyrus learn src/complex-component.tsx

# Generate comprehensive tests
cyrus generate tests src/utils/validator.js

# Create documentation
cyrus generate docs src/api/

# Get refactoring suggestions
cyrus generate refactor src/legacy-code.js --interactive

# Generate entire project
cyrus generate project "REST API with TypeScript and Prisma"

# Scan entire codebase health
cyrus health

# Detailed health report with trends
cyrus health --detailed --save

# Parallel processing for large codebases
cyrus health --parallel --output health-report.json

# Calculate quality score for entire project
cyrus quality .

# Quality score for specific file
cyrus quality src/components/UserAuth.tsx

# Analyze with custom limits
cyrus quality . --max-files 100

# Export quality report
cyrus quality . --json > quality-report.json

🎯 Code Quality Report
═══════════════════════════════════════════════════════════

Overall Quality Score: 87/100 (A)
████████████████████░

📊 Detailed Metrics:
  Code Health      92/100 ██████████
  Maintainability  85/100 ████████▌░
  Complexity       78/100 ███████▌░░
  Test Coverage    95/100 █████████▌
  Documentation    72/100 ███████▍░░
  Security         94/100 █████████▍

🚀 Improvement Recommendations:
• Reduce complexity in high-complexity functions (complexity.js:45-67)
• Add inline documentation for public APIs
• Consider extracting utility functions for better maintainability
• Review security practices in authentication modules

# Compare two code files
cyrus compare old.js new.js

# Word-by-word comparison
cyrus compare file1.py file2.py --words

# Detailed comparison with metrics
cyrus compare v1.ts v2.ts --detailed

# Include security analysis
cyrus compare auth-old.js auth-new.js --security

# Compare code snippets directly
cyrus compare "function old() { return 1; }" "const new = () => 1;"

# Export comparison report
cyrus compare src/v1/ src/v2/ --json > comparison-report.json

🔍 Code Comparison: old.js vs new.js
═══════════════════════════════════════════════════════════

📋 Line-by-line Comparison:
────────────────────────────────────────────────────────────
-   1 │ function calculateTotal(items) {
+   1 │ const calculateTotal = (items) => {
    2 │   let total = 0;
-   3 │   for (let i = 0; i < items.length; i++) {
-   4 │     total += items[i].price;
+   3 │   return items.reduce((sum, item) => sum + item.price, 0);
-   5 │   }
-   6 │   return total;
    7 │ }

🤖 AI-Powered Comparison Analysis

🔗 Key Similarities
• Both functions calculate the total price of items
• Same input parameter structure and expected output
• Both handle array iteration for summation

🔄 Key Differences  
• Modern ES6 arrow function syntax vs traditional function declaration
• Functional programming approach (reduce) vs imperative loop
• More concise implementation reduces code by 60%
• Better immutability practices in the new version

🚀 Improvements & Recommendations
• New version is more functional and concise
• Arrow function with reduce is more expressive
• Better performance with native reduce method
• Consider adding TypeScript for better type safety

🔒 Security Implications
• No security implications identified in this change
• Both versions handle input validation equally

⚡ Performance Notes
• New version likely faster due to native reduce optimization
• Reduced memory allocation with functional approach
• Less prone to off-by-one errors

💡 Expert Recommendations
• The new version represents a clear improvement
• Consider adding input validation for both versions
• Document the function purpose and expected input format

# Start interactive learning session
cyrus learn

# Take skill assessment
cyrus learn --assessment

# Start coding challenge
cyrus learn --challenge medium

# Begin personalized tutorial
cyrus learn --tutorial

# View learning progress
cyrus learn --progress

🎓 Welcome to Cyrus Learning Assistant!
══════════════════════════════════════════════════════════

🚀 Let's create your learning profile!
? What's your programming skill level? Intermediate - Have some experience
? Which programming languages are you interested in? JavaScript, TypeScript, Python
? What's your preferred learning style? Hands-on - Learn by doing and practicing
? What topics interest you most? Algorithms & Data Structures, Web Development

✅ Profile created successfully!

? What would you like to do today?
❯ 📚 Start Interactive Tutorial
  🏆 Take Coding Challenge  
  📊 Skill Assessment
  🎯 Personalized Learning Path
  📈 View Progress & Achievements

📚 Starting Tutorial: JavaScript Functions and Closures
────────────────────────────────────────────────────────

## 🎯 Learning Objectives
By the end of this tutorial, you'll understand:
• Function declarations vs expressions
• Scope and closures in JavaScript
• Practical use cases for closures
• Common closure patterns and pitfalls

## 📖 Functions Fundamentals
Functions are the building blocks of JavaScript...

🤔 Ready for some practice?
? Would you like to try some practice exercises? Yes

🏋️ Practice Session
────────────────────────────────────────────────────────

📝 Exercise: Create a Counter Function
Write a function that returns another function which increments a counter each time it's called.

💡 Starting code:
function createCounter() {
    // Your code here
}

🔍 Analyzing your solution...
✅ Analysis complete!

## ✨ Excellent Solution!

### 🎯 Correctness Assessment
Your solution correctly implements a closure-based counter! The inner function properly captures and modifies the outer variable.

### 💪 Code Quality Feedback
• Clean and readable implementation
• Proper use of closure concepts
• Good variable naming

### 🚀 Learning Points
• You've mastered the concept of closures
• Your understanding of function scope is solid
• Ready for more advanced closure patterns

🏆 Achievement Unlocked: Closure Master!
📈 Progress: Functions & Closures topic completed (8/10 points)

# You've just cloned a new repository
git clone https://github.com/company/mystery-project
cd mystery-project

# Understand the project structure instantly
cyrus detect .
# 📊 Project Analysis
# ─────────────────────────────
# Primary Language: TypeScript (React)
# Frameworks: Next.js, Tailwind CSS, Prisma
# Package Manager: pnpm
# Test Framework: Jest + Testing Library
# Total Files: 247

# Get a health overview
cyrus health
# 🏥 Codebase Health: 8.7/10
# ✅ Strong type safety
# ⚠️  Some duplicate code detected
# 📈 Excellent test coverage (94%)

# Found a problematic file
cyrus analyze src/utils/dateParser.js --explain --security
# 🔍 Analysis Results
# ─────────────────────────────
# Issues Found:
# 1. Line 15: Potential null pointer exception
# 2. Line 23: Inefficient regex pattern
# 3. Line 31: Missing input validation (Security Risk)
#
# 🤖 AI Explanation:
# The function doesn't handle edge cases where...
# [Detailed explanation with fix suggestions]

# Get mentoring on the complex parts
cyrus mentor src/utils/dateParser.js --interactive
# 🎓 Mentoring Session
# Let's walk through this code together...
# [Interactive Q&A session]

# Generate comprehensive tests
cyrus generate tests src/api/userController.js
# 🧪 Generated 47 test cases covering:
# ✅ Happy path scenarios (12 tests)
# ✅ Edge cases (18 tests)  
# ✅ Error conditions (12 tests)
# ✅ Security scenarios (5 tests)
#
# Tests saved to: src/api/__tests__/userController.test.js

# Generate tests for the entire module
cyrus generate tests src/utils/ --recursive

# Generate comprehensive documentation
cyrus generate docs src/api/
# 📖 Generated documentation:
# • API.md - Complete API documentation
# • src/api/README.md - Module overview
# • Inline JSDoc comments added
# • Type definitions documented

# Generate project documentation
cyrus generate docs . --type=project
# Creates: README.md, CONTRIBUTING.md, API.md

# Get refactoring suggestions
cyrus generate refactor src/legacy/oldCode.js --interactive
# 🔧 Refactoring Suggestions (5 found)
# ─────────────────────────────
# 1. Extract utility function (Line 45-67)
#    Impact: High | Confidence: 94%
#    Before: [long complex function]
#    After:  [clean, modular code]
#
# Apply this suggestion? (y/N) y
# ✅ Refactoring applied successfully!

# .husky/pre-commit
#!/usr/bin/env sh

# Get staged files
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(js|ts|jsx|tsx|py|java|go|rs)$')

if [ ${#STAGED_FILES[@]} -gt 0 ]; then
  echo "🔍 Running Cyrus analysis on staged files..."
  
  for FILE in $STAGED_FILES; do
    echo "Analyzing $FILE..."
    cyrus analyze "$FILE" --security --quiet
    
    if [ $? -ne 0 ]; then
      echo "❌ Analysis failed for $FILE"
      exit 1
    fi
  done
  
  echo "✅ All files passed analysis!"
fi

# Generate team health report
cyrus health --detailed --trends --save
# Creates comprehensive report with:
# • Overall health metrics
# • Language distribution changes
# • Technical debt trends
# • Security vulnerability tracking
# • Test coverage evolution

# Export for team dashboard
cyrus health --json | jq '.summary' > team-dashboard.json

# Generate complete project from description
cyrus generate project "REST API with TypeScript, Prisma, and Redis"
# 🏗️  Generating project structure...
# ✅ Created TypeScript configuration
# ✅ Set up Prisma with PostgreSQL
# ✅ Configured Redis connection
# ✅ Added Express.js server
# ✅ Generated API routes
# ✅ Created test suite
# ✅ Added Docker configuration
# ✅ Generated documentation

# Generate component with tests
cyrus generate component UserProfileCard --framework=react --tests

# Parallel processing for large codebases
cyrus health --parallel --workers=8

# Use local AI for unlimited analysis
cyrus config set provider ollama
cyrus analyze src/ --recursive  # No API costs!

# Cache analysis results
export CYRUS_CACHE_TTL=3600  # 1 hour cache
cyrus analyze src/  # Subsequent runs use cache

# Language-specific analysis
cyrus analyze src/ --language=typescript --framework=react

# Security-focused scanning
cyrus analyze src/ --security --owasp --severity=high

# Performance-focused analysis
cyrus analyze src/ --performance --metrics --bottlenecks

# Check your configuration
cyrus config show

# Set your API key
cyrus config set apikey sk-your-key-here

# Or use environment variables
export OPENAI_API_KEY="sk-your-key-here"

# Ensure Ollama is running
ollama serve

# Check if models are installed
ollama list

# Re-run configuration
cyrus config init

# Use verbose mode for debugging
cyrus analyze src/app.js --verbose

# Check file permissions
ls -la src/app.js

# Try with a different AI provider
cyrus config set provider anthropic

# Use parallel processing
cyrus health --parallel

# Increase timeout
export CYRUS_TIMEOUT=60000

# Use local AI to avoid rate limits
cyrus config set provider ollama

# Enable debug logging
export DEBUG=cyrus:*
cyrus analyze src/app.js

# Check configuration resolution
cyrus config show --debug

# Validate file detection
cyrus detect src/app.js --verbose

# Test AI connectivity
cyrus config test-connection