- Add utils.sh with cross-platform timeout functions for macOS compatibility
- Fix sf-logs-tail to use portable_timeout instead of GNU timeout command
- Fix test-all-wrappers.sh to use portable_timeout_seconds for testing
- Update README.md with macOS compatibility documentation
The timeout command is not available by default on macOS, causing
sf-logs-tail and test scripts to fail. The new utils.sh provides
fallback timeout functionality that works on Linux, macOS with/without
GNU coreutils, maintaining exit code 124 compatibility.
- Update all Bash scripts (sf-check, sf-org-info, sf-data-export, sf-data-import, sf-logs-tail) to use -ve instead of -vb
- Update all PowerShell scripts (sf-org-info.ps1, sf-apex-run.ps1, sf-check.ps1, sf-data-export.ps1, sf-data-import.ps1) to use -ve instead of -vb
- Fix PowerShell parameter conflicts with built-in -Verbose parameter
- Update README.md, TESTING.md, and OPTION_CONSISTENCY.md documentation to reflect -ve parameter
- Update test scripts (test-wrapper-suite.sh, test-wrapper-suite.ps1, test-all-wrappers.sh) to use -ve
- Maintain cross-platform consistency with two-character option scheme
- Fix Unicode display issues in PowerShell output with UTF-8 encoding
🎯 PowerShell Testing Suite Completed:
✅ Cross-Platform Test Scripts:
- quick-test.ps1: PowerShell equivalent of essential validation
- test-wrapper-suite.ps1: Full comprehensive testing suite
- 100% feature parity with Bash versions
- PowerShell-native colored output and logging
- Cross-platform compatibility (Windows, macOS, Linux)
🧪 Test Features:
- Identical test coverage to Bash versions
- Same test structure and validation logic
- PowerShell-native error handling and object pipeline
- Compatible with PowerShell 5.1+ and PowerShell Core 6+
- Same output structure for compatibility
📚 Complete Documentation Updates:
- TESTING.md: Comprehensive PowerShell testing instructions
- README.md: Added testing section with both Bash and PowerShell examples
- Platform testing matrix and troubleshooting guides
- Cross-platform execution examples and prerequisites
🚀 Production Ready Features:
- Full cross-platform test validation
- Consistent two-character option scheme
- Professional documentation and user guidance
- Ready for Windows, macOS, and Linux environments
The SF CLI wrapper toolkit now offers complete cross-platform testing capabilities with equivalent Bash and PowerShell test suites, ensuring robust validation across all supported platforms.
MAJOR CLEANUP: Fixed all inconsistencies in README documentation
Fixed sections:
- sf-deploy: -o,-s,-d,-t → -to,-sr,-dr,-ts
- sf-dry-run: Updated to match sf-deploy options
- sf-web-open: -o,-p,-U → -to,-pt,-ur
- sf-check: -v,-h → -vb,-hp
- sf-logs-tail: -o → -to
- All example command lines in workflows section
- Automatic Environment Verification examples
- Common Workflows examples
The README now consistently uses two-character options throughout:
✅ Help sections show proper option syntax (-to, -sr, -dr, etc.)
✅ All examples use the new two-character scheme
✅ Error message examples updated
✅ Workflow examples updated
✅ No more confusing mix of old/new option styles
Documentation is now fully aligned with the updated wrapper scripts.
- Removed Windows PowerShell Examples section that contained old command patterns
- Replaced with concise Quick Start Examples using current two-character options
- All examples now reflect the modern command structure and syntax
- Maintains consistency with updated wrapper script functionality
- Replace single-character options with memorable two-character alternatives
- Based on syllable mapping: -to (target-org), -qy (query), -fm (format), etc.
- Updated all bash and PowerShell scripts with consistent options
- Added comprehensive documentation and examples to README.md
- Maintains backward compatibility with long options
- More intuitive and self-documenting than traditional CLI options
