docs: update saturation analyzer documentation for v2 collector

[github-actions]

Summary

Updates the saturation analyzer documentation to reflect the v2 collector infrastructure migration that was completed in PR #560.

Changes Made

File: docs/saturation-analyzer.md

Path and Import Updates:

• ✅ Updated analyzer path: internal/capacity/analyzer.go → internal/saturation/analyzer.go
• ✅ Updated collector path: internal/collector/capacity_metrics.go → internal/engines/saturation/metrics/replica_metrics.go
• ✅ Updated interfaces path: internal/interfaces/capacity_analyzer.go → internal/interfaces/saturation_analyzer.go
• ✅ Fixed import statements to use v2 collector infrastructure:
  • Added collectorv2 "github.com/.../internal/collector/v2"
  • Added saturationmetrics "github.com/.../internal/engines/saturation/metrics"
• ✅ Updated test path: internal/capacity/analyzer_test.go → internal/saturation/analyzer_test.go

API Name Updates:

• ✅ AnalyzeModelCapacity → AnalyzeModelSaturation
• ✅ CalculateCapacityTargets → CalculateSaturationTargets
• ✅ CapacityScalingConfig → SaturationScalingConfig
• ✅ ModelCapacityAnalysis → ModelSaturationAnalysis

Feature Documentation:

• ✅ Added details about v2 collector features:
  • Uses registered query templates
  • Implements staleness filtering (2-minute default threshold)
  • Filters metrics from terminated pods
• ✅ Updated code examples to use correct v2 APIs
• ✅ Fixed ConfigMap name: capacity-scaling-config → saturation-scaling-config
• ✅ Removed outdated "NOTE: we are currently updating..." header

Terminology Refinement:

• ✅ Consistently uses "saturation" instead of "capacity" where appropriate
• ✅ Updated log messages and observability examples
• ✅ Fixed all cross-references and inline documentation

Related Changes

This documentation update corresponds to code changes in PR #560:

• Removed collector v1 implementation
• Migrated to v2 collector infrastructure with source registry
• Moved analyzer from internal/capacity to internal/saturation

Testing

• ✅ Verified all file paths exist in the current codebase
• ✅ Checked that all referenced functions and types match actual implementation
• ✅ Validated import paths against current package structure
• ✅ Confirmed code examples compile conceptually with current APIs

Checklist

• Documentation reflects current code structure
• All file paths are accurate
• Import statements use correct v2 collector packages
• API names match actual function signatures
• Code examples demonstrate correct usage patterns
• Terminology is consistent throughout
• Cross-references are valid

Impact

Users: This documentation update helps developers understand the current v2 collector architecture and provides accurate examples for using the saturation analyzer.

Breaking Changes: None - this is a documentation-only change that brings docs in sync with code.

---

Documentation Quality: Treats documentation gaps like failing tests - this PR fixes the "red build" created by the v2 collector migration.

AI generated by Update Docs