@bacnh85/pi-windows-tools 0.1.0

package/extensions/test/safety.test.ts

@@ -0,0 +1,96 @@
+import { describe, it } from "mocha";
+import { expect } from "chai";
+import { classifyCommand, isSensitivePath } from "../lib/safety";
+
+describe("safety", () => {
+
+	describe("classifyCommand", () => {
+		it("returns safe for echo", () => {
+			const r = classifyCommand("echo hello");
+			expect(r.risk).to.equal("safe");
+		});
+
+		it("returns confirm for rm -rf", () => {
+			const r = classifyCommand("rm -rf /some/dir");
+			expect(r.risk).to.equal("confirm");
+			expect(r.reasons.length).to.be.greaterThan(0);
+		});
+
+		it("returns confirm for Remove-Item -Recurse -Force", () => {
+			const r = classifyCommand("Remove-Item -Recurse -Force C:\\temp");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns confirm for git push --force", () => {
+			const r = classifyCommand("git push --force origin main");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns confirm for git clean -fdx", () => {
+			const r = classifyCommand("git clean -fdx");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns confirm for npm publish", () => {
+			const r = classifyCommand("npm publish");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns confirm for diskpart", () => {
+			const r = classifyCommand("diskpart");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns confirm for format command", () => {
+			const r = classifyCommand("format D: /fs:ntfs");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns confirm for takeown", () => {
+			const r = classifyCommand("takeown /f C:\\somefile");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("detects sensitive file paths in command", () => {
+			const r = classifyCommand("cat .env");
+			expect(r.risk).to.equal("confirm");
+			expect(r.reasons.some(r => r.includes("Environment"))).to.be.true;
+		});
+
+		it("detects SSH key paths", () => {
+			const r = classifyCommand("cat ~/.ssh/id_rsa");
+			expect(r.risk).to.equal("confirm");
+		});
+
+		it("returns safe for dir listing", () => {
+			const r = classifyCommand("Get-ChildItem -Recurse -Filter *.ts");
+			expect(r.risk).to.equal("safe");
+		});
+
+		it("returns safe for git status", () => {
+			const r = classifyCommand("git status");
+			expect(r.risk).to.equal("safe");
+		});
+	});
+
+	describe("isSensitivePath", () => {
+		it("detects .env", () => {
+			expect(isSensitivePath("C:\\project\\.env")).to.be.true;
+		});
+		it("detects .env.local", () => {
+			expect(isSensitivePath("C:\\project\\.env.local")).to.be.true;
+		});
+		it("detects .pem files", () => {
+			expect(isSensitivePath("C:\\keys\\cert.pem")).to.be.true;
+		});
+		it("detects .ssh dir", () => {
+			expect(isSensitivePath("C:\\Users\\me\\.ssh\\config")).to.be.true;
+		});
+		it("detects .aws dir", () => {
+			expect(isSensitivePath("/home/me/.aws/credentials")).to.be.true;
+		});
+		it("allows normal files", () => {
+			expect(isSensitivePath("C:\\project\\src\\index.ts")).to.be.false;
+		});
+	});
+});

package/extensions/test/shell-detect.test.ts

@@ -0,0 +1,53 @@
+import { describe, it } from "mocha";
+import { expect } from "chai";
+import { detectAllShells, detectShell, getAvailableShells, getDefaultShell } from "../lib/shell-detect";
+import type { WindowsShellKind } from "../lib/shell-detect";
+
+describe("shell-detect", () => {
+	it("detectAllShells returns 5 entries", () => {
+		const shells = detectAllShells();
+		expect(shells).to.have.length(5);
+		const kinds = shells.map(s => s.kind);
+		expect(kinds).to.include.members(["pwsh", "powershell", "cmd", "git-bash", "wsl"]);
+	});
+
+	it("each shell has kind, displayName, executable, available", () => {
+		for (const s of detectAllShells()) {
+			expect(s.kind).to.be.a("string");
+			expect(s.displayName).to.be.a("string");
+			expect(s.executable).to.be.a("string");
+			expect(s.available).to.be.a("boolean");
+		}
+	});
+
+	it("cmd is available on Windows", function () {
+		if (process.platform !== "win32") this.skip();
+		const cmd = detectShell("cmd");
+		expect(cmd.available).to.be.true;
+		expect(cmd.executable).to.match(/cmd(\.exe)?$/i);
+	});
+
+	it("detectShell returns info for each kind", () => {
+		const kinds: WindowsShellKind[] = ["pwsh", "powershell", "cmd", "git-bash", "wsl"];
+		for (const k of kinds) {
+			const info = detectShell(k);
+			expect(info.kind).to.equal(k);
+			expect(info.executable).to.be.a("string").and.not.empty;
+		}
+	});
+
+	it("getAvailableShells returns only available shells", function () {
+		if (process.platform !== "win32") this.skip();
+		const avail = getAvailableShells();
+		for (const s of avail) {
+			expect(s.available).to.be.true;
+		}
+	});
+
+	it("getDefaultShell returns a shell", function () {
+		if (process.platform !== "win32") this.skip();
+		const def = getDefaultShell();
+		expect(def.kind).to.be.a("string");
+		expect(def.available).to.be.true;
+	});
+});

package/extensions/test/shell-exec.test.ts

@@ -0,0 +1,76 @@
+import { describe, it } from "mocha";
+import { expect } from "chai";
+import { buildShellArgs, mergeEnv } from "../lib/shell-exec";
+
+describe("shell-exec", () => {
+
+	describe("buildShellArgs", () => {
+		it("pwsh: builds correct args", () => {
+			const { exe, args } = buildShellArgs("pwsh", "echo hello");
+			expect(exe).to.match(/pwsh(\.exe)?$/i);
+			expect(args).to.include("-NoLogo");
+			expect(args).to.include("-NoProfile");
+			expect(args).to.include("-NonInteractive");
+			expect(args).to.include("-ExecutionPolicy");
+			expect(args).to.include("Bypass");
+			expect(args).to.include("-Command");
+			expect(args).to.include("echo hello");
+		});
+
+		it("powershell: same args as pwsh", () => {
+			const { exe, args } = buildShellArgs("powershell", "Get-ChildItem");
+			expect(exe).to.match(/powershell(\.exe)?$/i);
+			expect(args).to.include("-NoLogo");
+			expect(args).to.include("-Command");
+			expect(args).to.include("Get-ChildItem");
+		});
+
+		it("cmd: builds /c command", () => {
+			const { exe, args } = buildShellArgs("cmd", "dir");
+			expect(args).to.deep.equal(["/c", "dir"]);
+		});
+
+		it("git-bash: builds -lc command", () => {
+			const { exe, args } = buildShellArgs("git-bash", "ls -la");
+			expect(args).to.deep.equal(["-lc", "ls -la"]);
+		});
+
+		it("wsl: builds wsl.exe bash -lc command", () => {
+			const { exe, args } = buildShellArgs("wsl", "uname -a");
+			expect(exe).to.equal("wsl.exe");
+			expect(args).to.deep.equal(["--", "bash", "-lc", "uname -a"]);
+		});
+
+		it("wsl with distro: includes -d flag", () => {
+			const { args } = buildShellArgs("wsl", "echo hi", "Ubuntu-24.04");
+			expect(args).to.deep.equal(["-d", "Ubuntu-24.04", "--", "bash", "-lc", "echo hi"]);
+		});
+	});
+
+	describe("mergeEnv", () => {
+		it("includes all process.env keys", () => {
+			const merged = mergeEnv({});
+			expect(merged.PATH || merged.Path).to.be.a("string");
+		});
+
+		it("custom env overrides process.env", () => {
+			const merged = mergeEnv({ NODE_ENV: "test" });
+			expect(merged.NODE_ENV).to.equal("test");
+		});
+
+		it("deduplicates case-insensitively", () => {
+			// Simulate process.env having "PATH" and custom having "Path"
+			// mergeEnv should not produce both
+			const merged = mergeEnv({ Path: "/custom/path" });
+			// Should have either PATH or Path, not both duplicated
+			const pathKeys = Object.keys(merged).filter(k => k.toLowerCase() === "path");
+			expect(pathKeys.length).to.equal(1);
+			expect(merged[pathKeys[0]]).to.equal("/custom/path");
+		});
+
+		it("handles empty custom env", () => {
+			const merged = mergeEnv({});
+			expect(Object.keys(merged).length).to.be.greaterThan(0);
+		});
+	});
+});

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@bacnh85/pi-windows-tools",
+  "version": "0.1.0",
+  "description": "Pi extension for Windows-native tool manipulation — shell profiles, path conversion, command execution, WSL bridge, safety policy, and developer tool discovery.",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/bacnh85/pi-extensions#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bacnh85/pi-extensions.git",
+    "directory": "pi-windows-tools"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "windows",
+    "powershell",
+    "wsl",
+    "cmd",
+    "shell",
+    "developer-tools"
+  ],
+  "scripts": {
+    "test": "cd extensions && mocha",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "README.md",
+    "extensions/",
+    "skills/",
+    "docs/"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@sinclair/typebox": "*"
+  },
+  "devDependencies": {
+    "@sinclair/typebox": "^0.34.41",
+    "@types/chai": "^4.3.20",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.0.0",
+    "chai": "^4.5.0",
+    "mocha": "^10.8.2",
+    "tsx": "^4.22.4",
+    "typescript": "^5.0.0"
+  }
+}

package/skills/pi-windows-tools/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: pi-windows-tools
+description: Provides Windows-native tool manipulation: shell profiles, path conversion, command execution, WSL bridge, safety policy, and developer tool discovery. Enables Pi to work correctly with PowerShell, cmd, Git Bash, and WSL.
+---
+
+# pi-windows-tools
+
+Provides Windows-native tool manipulation: shell profiles, path conversion, command execution, WSL bridge, safety policy, and developer tool discovery. Enables Pi to work correctly with PowerShell, cmd, Git Bash, and WSL.
+
+## When to use
+
+- You are working on Windows and Pi needs to execute shell commands
+- You need to convert paths between Windows, Git Bash, and WSL formats
+- You need to know what developer tools are installed (doctor)
+- You want safety checks on dangerous Windows commands
+- You need to run commands inside WSL
+
+## Configuration
+
+```json
+{
+  "extensions": ["pi-windows-tools"],
+  "windowsTools": {
+    "enabled": true,
+    "defaultShell": "pwsh"
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|------|-------------|
+| `windows_shell_detect` | List available shells with versions |
+| `windows_shell_exec` | Execute a command through a specific shell |
+| `windows_path_to_windows` | Convert `/c/` or `/mnt/c/` to `C:\` |
+| `windows_path_to_wsl` | Convert `C:\` to `/mnt/c/` |
+| `windows_path_to_gitbash` | Convert `C:\` to `/c/` |
+| `windows_path_quote` | Quote a path for a specific shell |
+| `windows_doctor` | Detect installed developer tools |
+| `windows_wsl_exec` | Run a Linux command in WSL |
+| `windows_safety_classify` | Check command for dangerous operations |
+| `windows_tool_discover` | Check if a tool exists in PATH |
+| `windows_wsl_list_distros` | Show installed WSL distros |
+
+## Commands
+
+- `pi windows doctor` — full system health report
+- `pi windows shell [name]` — show or set default shell
+
+## Prompt guidance
+
+On Windows, Pi automatically injects shell-specific syntax guidance (PowerShell by default) so it doesn't generate Bash-only commands.