Add --verbose flag to show detailed file changes in staleness warnings

[nikblanchet]

Summary

When staleness is detected in workflow commands (audit, plan, improve), show which specific files changed instead of just a count.

Current Behavior

Warning: Audit data may be stale (3 file(s) modified since audit).
Run 'docimp analyze --help' to see file details.

Desired Behavior

With --verbose flag:

$ docimp plan ./src --verbose

Output:

Warning: Audit data may be stale (3 file(s) modified since audit):
  • src/parser.ts (modified)
  • src/analyzer.ts (modified)
  • src/writer.py (added)

Run 'docimp audit ./src' to update ratings.

Implementation

1. Add --verbose flag to plan and improve commands
2. Update WorkflowValidator to return list of changed files (not just count)
3. Update display methods to show file list when verbose enabled
4. Show change type: modified, added, removed

Design Decisions (from Phase 3.9)

• Default: Show summary count + guidance
• With --verbose: Show full list of changed files with change types
• Helps users understand exactly what changed without manual investigation

Related

• Phase 3.9: File-Level Checksum Staleness (implements the underlying detection)
• Issue where this feature was requested: Phase 3.9 planning session