pi-powershell 1.0.1

package/README.md

@@ -0,0 +1,89 @@
+# pi-powershell
+
+PowerShell extension for [pi](https://pi.dev) - the terminal coding harness.
+
+## Features
+
+- **Replaces bash with PowerShell** on Windows
+- **Auto-translates bash commands** to PowerShell equivalents
+- **Preserves native PowerShell** cmdlets
+
+## Auto-Translation Support
+
+| Bash | PowerShell |
+|------|------------|
+| `ls`, `ll`, `la` | `Get-ChildItem` |
+| `pwd` | `Get-Location` |
+| `cat file` | `Get-Content file` |
+| `echo "text"` | `Write-Output "text"` |
+| `mkdir dir` | `New-Item -ItemType Directory` |
+| `touch file` | `New-Item -ItemType File` |
+| `rm -rf dir` | `Remove-Item -Recurse -Force` |
+| `grep pattern file` | `Select-String -Pattern` |
+| `ps` | `Get-Process` |
+| `which cmd` | `Get-Command \| Select-Object -ExpandProperty Source` |
+| `ls \| grep pattern` | `Get-ChildItem \| Where-Object` |
+| `ls \| wc -l` | `Get-ChildItem \| Measure-Object -Line` |
+| `ls \| head -n` | `Get-ChildItem \| Select-Object -First` |
+| `$HOME`, `$PATH` | `$env:HOME`, `$env:PATH` |
+| `export VAR=value` | `$env:VAR=value` |
+
+Native PowerShell cmdlets pass through unchanged:
+```bash
+!Get-Process | Select-Object -First 5
+!Get-Service | Where-Object {$_.Status -eq 'Running'}
+```
+
+## Installation
+
+### Option 1: Install via npm
+```bash
+npm install -g @marcfargas/pi-powershell
+```
+
+### Option 2: Add to your project
+```bash
+cd your-project
+pi install @marcfargas/pi-powershell
+```
+
+### Option 3: Local extension
+```bash
+pi -e ./pi-powershell-extension.ts
+```
+
+## Requirements
+
+- Windows (PowerShell 7+ or Windows PowerShell)
+- Node.js 18+
+
+## Scripts (Windows)
+
+| Command | Description |
+|---------|-------------|
+| `npm run serve` | Start static server (foreground) |
+| `npm run serve:bg` | Start server in new window |
+| `npm run dev:bg` | Start dev server in new window |
+| `npm run http` | Simple HTTP server (port 8080) |
+| `npm run http:bg` | HTTP server in new window |
+| `npm run run -- "cmd"` | Run any command in background |
+| `npm run kill` | Kill all node processes |
+
+### Examples
+
+```bash
+# Start server in new window
+npm run serve:bg
+
+# Run any command in background
+npm run run -- "npm run dev"
+npm run run -- "node server.js --port 3000"
+npm run run -- "npx next dev"
+
+# Stop all node processes
+npm run kill
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "pi-powershell",
+  "version": "1.0.1",
+  "description": "PowerShell extension for pi - replaces bash with PowerShell on Windows and auto-translates bash commands",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "powershell",
+    "windows",
+    "bash-to-powershell"
+  ],
+  "scripts": {
+    "clean": "echo 'cleaning...'",
+    "build": "echo 'no build needed'",
+    "check": "echo 'no checks'",
+    "serve": "node node_modules/serve/build/main.js . -l 3000",
+    "serve:bg": "pwsh -File ./run-bg.ps1 \"node node_modules/serve/build/main.js . -l 3000\"",
+    "dev": "node node_modules/serve/build/main.js . -l 3000",
+    "dev:bg": "pwsh -File ./run-bg.ps1 \"node node_modules/serve/build/main.js . -l 3000\"",
+    "http": "node -e \"require('http').createServer((q,s)=>{s.writeHead(200,{'Content-Type':'text/html'});s.end('<h1>Hello</h1>')}).listen(8080);console.log('http://localhost:8080')\"",
+    "http:bg": "pwsh -File ./run-bg.ps1 \"node -e require('http').createServer((q,s)=>{s.writeHead(200,{Content-Type:'text/html'});s.end('<h1>Hello</h1>')}).listen(8080)\"",
+    "run": "pwsh -File ./run-bg.ps1",
+    "kill": "pwsh -Command \"Get-Process -Name node,cmd | Stop-Process -Force -ErrorAction SilentlyContinue; Get-Process -Name pwsh | Where-Object { \\$_.CommandLine -like '*serve*' } | Stop-Process -Force -ErrorAction SilentlyContinue\""
+  },
+  "pi": {
+    "extensions": [
+      "./pi-powershell-extension.ts"
+    ]
+  },
+  "author": "ngsoftware",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ngsoftware/pi-powershell.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.75.0"
+  },
+  "dependencies": {
+    "serve": "^14.2.0"
+  }
+}

package/pi-powershell-extension.ts

@@ -0,0 +1,269 @@
+/**
+ * PowerShell Extension for pi
+ * 
+ * Replaces bash with PowerShell on Windows.
+ * Includes auto-translation of bash-style commands to PowerShell.
+ * 
+ * Usage:
+ *   pi -e ./pi-powershell-extension.ts
+ * 
+ * Or add to settings.json:
+ *   { "extensions": ["./path/to/pi-powershell-extension.ts"] }
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { existsSync } from "node:fs";
+import { spawn } from "child_process";
+
+export default function (pi: ExtensionAPI) {
+  const powershellPath = resolvePowerShell();
+
+  if (!powershellPath) {
+    console.warn("[pi-powershell] No PowerShell found. Bash will be used.");
+    return;
+  }
+
+  console.log(`[pi-powershell] Using: ${powershellPath}`);
+
+  // Intercept all user bash commands and redirect to PowerShell
+  pi.on("user_bash", (_event, _ctx) => {
+    return {
+      operations: createPowerShellOperations(powershellPath),
+    };
+  });
+}
+
+function resolvePowerShell(): string | null {
+  // Try PowerShell 7+ (pwsh) first
+  const pwshPaths = [
+    "C:/Program Files/PowerShell/7/pwsh.exe",
+    "C:/Program Files (x86)/PowerShell/7/pwsh.exe",
+  ];
+
+  for (const path of pwshPaths) {
+    if (path && existsSync(path)) {
+      return path;
+    }
+  }
+
+  // Fall back to Windows PowerShell
+  const windowsPowerShell = "C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe";
+  if (existsSync(windowsPowerShell)) {
+    return windowsPowerShell;
+  }
+
+  // Try PATH lookup
+  try {
+    const { spawnSync } = require("child_process");
+    const result = spawnSync("where", ["pwsh.exe"], { encoding: "utf-8", windowsHide: true });
+    if (result.status === 0 && result.stdout) {
+      const firstMatch = result.stdout.trim().split(/\r?\n/)[0];
+      if (firstMatch && existsSync(firstMatch)) {
+        return firstMatch;
+      }
+    }
+  } catch {
+    // Ignore
+  }
+
+  return null;
+}
+
+interface ExecOptions {
+  onData: (data: Buffer) => void;
+  signal?: AbortSignal;
+  timeout?: number;
+  env?: NodeJS.ProcessEnv;
+}
+
+function createPowerShellOperations(shellPath: string) {
+  return {
+    exec(
+      command: string,
+      cwd: string,
+      { onData, signal, timeout, env }: ExecOptions
+    ): Promise<{ exitCode: number | null }> {
+      return new Promise((resolve) => {
+        if (!existsSync(cwd)) {
+          resolve({ exitCode: 1 });
+          return;
+        }
+
+        // Auto-translate bash to PowerShell
+        const translatedCommand = translateBashToPowerShell(command);
+        
+        // Set UTF-8 encoding for proper character handling
+        const psCommand = `[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; ${translatedCommand}`;
+
+        const child = spawn(shellPath, [
+          "-NoProfile",
+          "-NonInteractive",
+          "-Command",
+          psCommand,
+        ], {
+          cwd,
+          detached: false,
+          env: env ?? process.env,
+          stdio: ["ignore", "pipe", "pipe"],
+          windowsHide: true,
+        });
+
+        let exitCode: number | null = null;
+
+        child.stdout?.on("data", (data: Buffer) => onData(data));
+        child.stderr?.on("data", (data: Buffer) => onData(data));
+
+        child.on("error", () => {
+          exitCode = 1;
+        });
+
+        child.on("close", (code: number) => {
+          exitCode = code;
+          resolve({ exitCode });
+        });
+
+        if (timeout) {
+          const timer = setTimeout(() => child.kill(), timeout * 1000);
+          signal?.addEventListener("abort", () => clearTimeout(timer));
+        }
+
+        signal?.addEventListener("abort", () => child.kill());
+      });
+    },
+  };
+}
+
+/**
+ * Translate bash-style commands to PowerShell equivalents.
+ * Skips translation for full PowerShell cmdlets (Get-, Set-, etc.)
+ */
+function translateBashToPowerShell(cmd: string): string {
+  // Skip translation for full PowerShell cmdlets
+  if (/^(Get|Set|New|Remove|Copy|Move|Test|Write|Read|Select|Where|Sort|Measure|Start|Stop|Import|Export)\s/.test(cmd)) {
+    return cmd;
+  }
+  
+  let result = cmd;
+  
+  // === Basic commands ===
+  
+  // cd
+  result = result.replace(/^cd\s+(\S+)/, (_, p) => `Set-Location ${p.replace(/\//g, "\\")}`);
+  
+  // pwd
+  if (result === "pwd") return "Get-Location";
+  
+  // ls variants
+  result = result.replace(/^ll\b/, "Get-ChildItem -Force");
+  result = result.replace(/^la\b/, "Get-ChildItem -Force -Attributes Hidden");
+  result = result.replace(/^ls\s+(-[a-zA-Z]+)\s*$/, () => "Get-ChildItem");
+  result = result.replace(/^ls\s*$/, "Get-ChildItem");
+  result = result.replace(/^ls\s+(-[a-zA-Z]+)/, "Get-ChildItem");
+  
+  // cat -> Get-Content
+  result = result.replace(/^cat\s+(\S+)/, (_, f) => `Get-Content ${f.replace(/\//g, "\\")}`);
+  
+  // echo -> Write-Output
+  result = result.replace(/^echo\s+['"](.+)['"]/, (_, t) => `Write-Output "${t}"`);
+  result = result.replace(/^echo\s+(.+)$/, (_, t) => `Write-Output "${t}"`);
+  
+  // mkdir
+  result = result.replace(/^mkdir\s+(?:-\w+\s+)?(\S+)/, (_, d) => `New-Item -ItemType Directory -Path "${d.replace(/\//g, "\\")}" -Force`);
+  
+  // rm -rf
+  result = result.replace(/^rm\s+-rf\s+(\S+)/, (_, t) => `Remove-Item "${t.replace(/\//g, "\\")}" -Recurse -Force`);
+  
+  // grep standalone -> Select-String
+  result = result.replace(/^grep\s+(-[a-zA-Z]+)?\s+['"](.+)['"]\s*(\S+)?/, (_, flags, pattern, file) => {
+    const ci = flags?.includes("i") ? " -CaseSensitive:$false" : "";
+    if (file) {
+      return `Select-String -Pattern "${pattern}" -Path "${file.replace(/\//g, "\\")}"${ci}`;
+    }
+    return `Select-String -Pattern "${pattern}"${ci}`;
+  });
+  
+  // ps
+  if (/^ps\s*(?:aux|-ef)?\s*$/.test(result)) return "Get-Process";
+  
+  // which
+  result = result.replace(/^which\s+(\S+)/, (_, c) => `Get-Command ${c} | Select-Object -ExpandProperty Source`);
+  
+  // touch
+  result = result.replace(/^touch\s+(\S+)/, (_, f) => `New-Item -ItemType File -Path "${f.replace(/\//g, "\\")}" -Force`);
+  
+  // clear
+  if (result === "clear") return "Clear-Host";
+  
+  // env
+  if (result === "env") return "Get-ChildItem Env:";
+  
+  // export
+  result = result.replace(/^export\s+(\w+)=(.+)/, (_, v, val) => `$env:${v}=${val.trim()}`);
+  
+  // source / dot
+  result = result.replace(/^(?:source|\.)\s+(\S+)/, (_, file) => `. "${file.replace(/\//g, "\\")}"`);
+  
+  // exit
+  result = result.replace(/^exit\s*(\d*)/, (_, code) => `exit ${code || 0}`);
+  
+  // === Pipes ===
+  
+  // ls | grep -> Get-ChildItem | Where-Object
+  result = result.replace(/^Get-ChildItem\s*\|\s*grep\s+(-i)?\s+['"]?(\S+?)['"]?\s*$/, (_, ci, pattern) => {
+    const caseF = ci ? " -CaseSensitive:$false" : "";
+    return `Get-ChildItem | Where-Object { $_.Name -match "${pattern}"${caseF} }`;
+  });
+  
+  result = result.replace(/^ls\s*\|\s*grep\s+(-i)?\s+['"]?(\S+?)['"]?\s*$/, (_, ci, pattern) => {
+    const caseF = ci ? " -CaseSensitive:$false" : "";
+    return `Get-ChildItem | Where-Object { $_.Name -match "${pattern}"${caseF} }`;
+  });
+  
+  // ls | head -> Get-ChildItem | Select-Object -First
+  result = result.replace(/^Get-ChildItem\s*\|\s*head\s+(?:-n\s*)?(\d+)/, (_, n) => `Get-ChildItem | Select-Object -First ${n}`);
+  result = result.replace(/^ls\s*\|\s*head\s+(?:-n\s*)?(\d+)/, (_, n) => `Get-ChildItem | Select-Object -First ${n}`);
+  
+  // ls | wc -> Get-ChildItem | Measure-Object
+  result = result.replace(/\|\s*wc\s+-l\b/, " | Measure-Object -Line | Select-Object -ExpandProperty Lines");
+  result = result.replace(/\|\s*wc\b/, " | Measure-Object");
+  
+  // cat | grep -> Select-String
+  result = result.replace(/^Get-Content\s+(\S+)\s*\|\s*grep\s+(-i)?\s+['"]?(\S+?)['"]?\s*$/, (_, file, ci, pattern) => {
+    const caseF = ci ? " -CaseSensitive:$false" : "";
+    return `Select-String -Path "${file.replace(/\//g, "\\")}" -Pattern "${pattern}"${caseF}`;
+  });
+  
+  result = result.replace(/^cat\s+(\S+)\s*\|\s*grep\s+(-i)?\s+['"]?(\S+?)['"]?\s*$/, (_, file, ci, pattern) => {
+    const caseF = ci ? " -CaseSensitive:$false" : "";
+    return `Select-String -Path "${file.replace(/\//g, "\\")}" -Pattern "${pattern}"${caseF}`;
+  });
+  
+  // | grep -> | Where-Object
+  result = result.replace(/\|\s*grep\s+(-i)?\s+['"]?(.+?)['"]?\s*$/g, (_, ci, pattern) => {
+    const caseF = ci ? " -CaseSensitive:$false" : "";
+    return ` | Where-Object { $_ -match "${pattern}"${caseF} }`;
+  });
+  
+  // | head
+  result = result.replace(/\|\s*head\s+(?:-n\s*)?(\d+)/g, " | Select-Object -First $1");
+  
+  // | tail
+  result = result.replace(/\|\s*tail\s+(?:-n\s*)?(\d+)/g, " | Select-Object -Last $1");
+  
+  // | sort
+  result = result.replace(/\|\s*sort\b/g, " | Sort-Object");
+  
+  // | uniq
+  result = result.replace(/\|\s*uniq\b/g, " | Select-Object -Unique");
+  
+  // === Environment variables ===
+  
+  result = result.replace(/\$([A-Z_][A-Z0-9_]{1,10})(?![a-zA-Z0-9_])/g, (m, v) => {
+    const known = ["HOME", "USER", "PATH", "PWD", "SHELL", "TERM", "USERNAME", "COMPUTERNAME", "USERPROFILE", "TEMP", "TMP"];
+    return known.includes(v) ? `$env:${v}` : m;
+  });
+  
+  result = result.replace(/\$\{(\w+)\}/g, (_, v) => `$env:${v}`);
+  
+  return result;
+}

package/run-bg.ps1

@@ -0,0 +1,41 @@
+#!/usr/bin/env pwsh
+# Generic background command runner
+# Usage: pwsh -File ./run-bg.ps1 "npm run serve"
+# Usage: pwsh -File ./run-bg.ps1 "node server.js --port 3000"
+
+param(
+    [Parameter(Mandatory=$false, Position=0)]
+    [string]$Command = "npm run serve"
+)
+
+$ErrorActionPreference = "Stop"
+
+# Parse the command
+$parts = $Command -split '\s+'
+$exe = $parts[0]
+$args = $parts[1..($parts.Length - 1)]
+
+# Set working directory to script location
+$workDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+if (-not $workDir) {
+    $workDir = $PWD.Path
+}
+
+Write-Host "Running in background:" -ForegroundColor Cyan
+Write-Host "  Command: $Command" -ForegroundColor Gray
+Write-Host "  Directory: $workDir" -ForegroundColor Gray
+Write-Host ""
+
+# Start in new window
+$proc = Start-Process -FilePath $exe -ArgumentList $args -PassThru -WindowStyle Normal -WorkingDirectory $workDir
+
+Write-Host "PID: $($proc.Id)" -ForegroundColor Green
+Write-Host "Press Ctrl+C to stop" -ForegroundColor Yellow
+
+try {
+    $proc.WaitForExit()
+} catch {
+    Write-Host ""
+    Write-Host "Stopping..." -ForegroundColor Yellow
+    Stop-Process -Id $proc.Id -Force -ErrorAction SilentlyContinue
+}