Support PowerShell Get-Content First alias

Author: SqlRush

docs/cc-100-roadmap.md

@@ -221,6 +221,8 @@ M5 补充：PowerShell native read-only classifier 现在覆盖 Windows `sort.ex
 
 M5 补充：PowerShell native read-only classifier 现在覆盖显式 `more.com <path>` 的安全相对路径读取子集，并拒绝裸 `more`、空输入、pass-through 和越界路径。
 
+M5 补充：PowerShell read-only classifier 现在把 `Get-Content -First` 作为 `-TotalCount`/`-Head` 的安全读取 alias 处理，保留缺值和越界路径拒绝。
+
 M5 补充：Bash 前台输出和 `BashOutput` 现在都走统一 tool-result budget 截断/落盘路径；`BashOutput` 增加 100k 最大结果限制，大后台输出会保存完整内容并返回 `full_output_path` 元数据。
 
 M5 补充：Bash/PowerShell 后台任务现在会发 `*_background_started` 和 `*_background_finished` tool progress 事件，包含后台 ID、shell/status、exit/timed_out/cancelled、duration、时间戳和输出字节数，不携带 command 文本；completed、timed_out、cancelled 终态均已覆盖测试。

docs/claude-code-go-rewrite-plan.md

@@ -222,6 +222,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：PowerShell command canonicalization 现在补齐 `Compare-Object` 的常见 `compare`/`diff` alias，同时继续保留 `diff.exe` 这类原生命令后缀，避免外部命令误套 cmdlet 分类。
 - 本轮补充：PowerShell native read-only classifier 现在覆盖 Windows `sort.exe <path>`/`sort.exe /R <path>` 的安全相对路径读取子集，并拒绝空输入、`/O` 输出文件、pass-through 和越界路径。
 - 本轮补充：PowerShell native read-only classifier 现在覆盖显式 `more.com <path>` 的安全相对路径读取子集，并拒绝裸 `more`、空输入、pass-through 和越界路径。
+- 本轮补充：PowerShell read-only classifier 现在把 `Get-Content -First` 作为 `-TotalCount`/`-Head` 的安全读取 alias 处理，保留缺值和越界路径拒绝。
 - 本轮补充：`BashOutput` 现在设置 100k 最大结果大小，和前台 `Bash` 一起覆盖大输出 tool-result preview 截断、完整输出落盘及 `full_output_path` 元数据。
 - 本轮补充：Bash/PowerShell 后台命令现在会通过 tool progress 通道发 started/finished 事件，记录后台 ID、shell/status、exit/timed_out/cancelled、duration、时间戳和 stdout/stderr byte count，且 completed、timed_out、cancelled 终态测试确保 progress 不携带 command 文本。
 - 本轮补充：WebSearch domain filters 现在在 schema 层声明 array `items:string`，通用 tool schema validator 同步支持 `items` 校验；`allowed_domains`/`blocked_domains` 会拒绝空字符串、URL/port、非法 wildcard 和非域名 label。

internal/tools/powershell/tools.go

@@ -1217,10 +1217,10 @@ var powerShellReadOnlyCmdlets = map[string]powerShellReadOnlyConfig{
 		validatePositionalsAsPaths: true,
 	},
 	"get-content": {
-		allowedFlags:               stringSet("path", "literalpath", "totalcount", "head", "tail", "raw", "encoding", "delimiter", "readcount"),
+		allowedFlags:               stringSet("path", "literalpath", "totalcount", "head", "first", "tail", "raw", "encoding", "delimiter", "readcount"),
 		unsafeFlags:                stringSet("wait"),
 		pathFlags:                  stringSet("path", "literalpath"),
-		valueFlags:                 stringSet("totalcount", "head", "tail", "encoding", "delimiter", "readcount"),
+		valueFlags:                 stringSet("totalcount", "head", "first", "tail", "encoding", "delimiter", "readcount"),
 		validatePositionalsAsPaths: true,
 	},
 	"get-item": {

internal/tools/powershell/tools_test.go

@@ -110,6 +110,7 @@ func TestPowerShellCommandClassification(t *testing.T) {
 		"Get-Content -Encoding UTF8 README.md",
 		"Get-Content -ReadCount 0 README.md",
 		"Get-Content -Tail 10 README.md",
+		"Get-Content -First 5 README.md",
 		`Get-Content .\README.md`,
 		"type README.md",
 		"gi README.md",
@@ -277,6 +278,8 @@ func TestPowerShellCommandClassification(t *testing.T) {
 		"Get-Content -Credential admin README.md",
 		"Get-Content -Raw:unexpected README.md",
 		"Get-Content -Encoding",
+		"Get-Content -First",
+		"Get-Content -First 5 /etc/passwd",
 		"Get-ChildItem -Credential admin ./internal",
 		"Select-String -Pattern TODO -Path /etc/passwd",
 		"Get-Process -ComputerName server",