PowerShell.MCP v1.3.9 - Breaking Change: -Contains to -OldText & BOM Preservation Fix

[yotsuda]

Breaking Change: -Contains to -OldText & BOM Preservation Fix

This release includes a breaking parameter rename in Update-MatchInFile, BOM preservation fix for UTF-8 files, tail line removal support, and significant code quality improvements.

⚠️ Breaking Change

-Contains → -OldText in Update-MatchInFile

The -Contains parameter has been renamed to -OldText for clarity:

# Before (v1.3.8)
Update-MatchInFile file.txt -Contains "old" -Replacement "new"

# After (v1.3.9)
Update-MatchInFile file.txt -OldText "old" -Replacement "new"

---

📊 What's Changed Since v1.3.8

Bug Fixes

• BOM preservation: UTF-8 files with BOM now retain BOM when entire content is replaced

New Features

• Tail line removal: Remove-LinesFromFile supports negative LineRange (e.g., -LineRange -10 removes last 10 lines)

Improvements

• Updated tool descriptions with -WhatIf recommendations and tail removal syntax
• Renamed CreateInteractiveMap to ShowInteractiveMap with localized display text

Code Quality

• Extracted AnsiColors class for centralized ANSI color code management
• Extracted ContentAccumulatingCmdletBase for shared pipeline input handling
• Added IsWhatIfMode helper method to TextFileCmdletBase
• Translated all Japanese comments to English
• Removed unused NotificationService and debug comments

---

📄 Installation & Upgrade

# New installation
Install-Module PowerShell.MCP -Force

# Upgrade existing
Update-Module PowerShell.MCP

Update MCP Configuration

1. Get new module path:

(Get-Module PowerShell.MCP).ModuleBase

2. Update claude_desktop_config.json with the path from step 1:

{
  "mcpServers": {
    "PowerShell": {
      "command": "C:\\Users\\YourName\\Documents\\PowerShell\\Modules\\PowerShell.MCP\\1.3.9\\bin\\PowerShell.MCP.Proxy.exe"
    }
  }
}

3. Restart Claude Desktop

📖 Full Guide: https://github.com/yotsuda/PowerShell.MCP#quick-start

---

Full Documentation: https://github.com/yotsuda/PowerShell.MCP

Questions? GitHub Discussions | Report Issues: GitHub Issues

⚠ Security Notice: Provides complete PowerShell access. Use in trusted environments only.

---

This discussion was created from the release PowerShell.MCP v1.3.9 - Breaking Change: -Contains to -OldText & BOM Preservation Fix.