Feature/add architecture debt tracking baselines

[RaymondC-tech]

Feature Completion Checklist — Architecture Baselines & Drift Detection

• Baseline file

  • Generates .archctl/baseline.json
  • Stores current violations with stable fingerprints
  • Implemented in src/infrastructure/baseline/baselineService.ts

• Drift detection

  • archctl lint passes when violations match the baseline
  • Fails only when new violations are introduced
  • Implemented in src/commands/lint.ts (lines 158–160)

• Ratchet feature

  • --ratchet flag implemented
  • Warns or fails when baseline violations are resolved
  • Forces baseline update to progressively raise quality
  • Implemented in src/commands/lint.ts (lines 26, 164, 299–306)

• Metrics & trends tracking

  • Tracks coupling score, violation density, and health score
  • Stores historical data in baseline.metricsHistory
  • Implemented in src/infrastructure/baseline/baselineService.ts

• CLI trend display

  • Displays metric trends directly in CLI output
  • Example format: 500 → 490 → 485 (↓ 5%)
  • Implemented in src/commands/lint.ts (lines 238–291)

• HTML report trends

  • Added Trends tab to HTML report
  • Line charts powered by Chart.js for all metrics
  • Metrics history table with trend indicators
  • Implemented in src/services/htmlReportService.ts

• Usage commands

  • archctl lint --update-baseline creates or updates the baseline
  • archctl lint performs CI-safe drift checks
  • Commands behave as specified in the feature proposal

• CLI help documentation

  • --update-baseline and --ratchet flags documented
  • Usage examples included
  • Implemented in src/presentation/cliPresenter.ts

• Tests

  • 70 tests passing (51 unit, 13 integration, 6 HTML report)
  • Coverage includes baseline generation, drift detection, ratcheting, and trends

---

Summary

All requirements from Feature Request #8 are fully implemented:

• Baseline generation
• Drift detection
• Ratcheting mechanism
• Metrics and trend tracking
• CLI and HTML visualization
• Command support and documentation
• Comprehensive test coverage

The feature is complete and ready for use.