Simplify suews-convert interface and fix remaining YAML conversion issues (builds on #581)

[sunt05]

Summary

This PR builds upon PR #581 (which fixes issue #566) and additionally simplifies the suews-convert command interface while resolving all remaining issues preventing YAML conversion from working properly.

Relationship to PR #581

• PR Fix to_yaml module and enhance converter with auto-detection and unified path handling (#566) #581 fixes the missing to_yaml module issue (No module named supy.cmd.to_yaml #566)
• This PR (targeting PR Fix to_yaml module and enhance converter with auto-detection and unified path handling (#566) #581's branch) adds the interface simplification and additional bug fixes
• Once both are merged, users will have a fully functional and intuitive conversion tool

Changes (beyond PR #581)

1. Simplified Command Interface

• Removed redundant yaml option since 2025+ only supports YAML format
• Automatically determine conversion type based on target version:
  • Pre-2025 (e.g., 2024a): Table-to-table conversion
  • 2025+ (e.g., 2025a): Convert to YAML format
• No subcommands needed - single unified interface

2. Fixed Additional YAML Conversion Issues

• Fixed empty DataFrame handling when STEBBS is disabled (prevented column name mismatch)
• Added graceful handling of missing columns in legacy format conversion (lambda_c, etc.)
• Fixed water surface soilstore validation - water surfaces can now have soilstore=0 (physically correct)
• Provided default values for missing config/description columns in legacy conversion

3. Updated Documentation

• Updated existing documentation to reflect the simplified interface
• Consolidated converter documentation in input_converter.rst (removed duplicate)
• Updated transition_guide.rst with new command syntax
• Removed references to supy-to-yaml and subcommands
• Added clear examples for both conversion types

4. Updated Tests

• Modified test suite to work with new unified interface
• Added tests for both table and YAML conversion
• Moved legacy format files to test fixtures

Usage Examples

# Table-to-table conversion (pre-2025)
suews-convert -f 2020a -t 2024a -i input_dir -o output_dir

# Table-to-YAML conversion (2025+)
suews-convert -f 2024a -t 2025a -i input_dir -o config.yml

Testing

• All conversion logic has been tested with legacy format fixtures
• Tests pass for both table-to-table and table-to-YAML conversions
• Documentation has been reviewed for consistency and duplicates removed

Builds on #581, fixes #566

[github-actions]

🤖 I've automatically formatted the code in this PR using:

• Python: ruff v0.8.6
• Fortran: fprettify v0.3.7

Please pull the latest changes before making further edits.

[github-actions]

🤖 I've automatically formatted the code in this PR using:

• Python: ruff v0.8.6
• Fortran: fprettify v0.3.7

Please pull the latest changes before making further edits.