fix(installer): resolve F-08 support deterministic cross-platform setup

Author: Aitomates

README.md

@@ -69,7 +69,15 @@ cd Promptimprover
 .\build_and_install.ps1
 ```
 
-Add `gemini-prompt-refiner` to your MCP client configuration. See the [Setup Guide](https://github.com/Coding-Autopilot-System/Promptimprover/wiki/Setup-Guide) for full configuration instructions.
+On Linux or macOS:
+
+```sh
+git clone https://github.com/Coding-Autopilot-System/Promptimprover.git
+cd Promptimprover
+./build_and_install.sh
+```
+
+Both installers perform a deterministic dependency install, run the full test suite, build the package, install it globally, and verify the `gemini-prompt-refiner` command. Add that command to your MCP client configuration. See the [Setup Guide](https://github.com/Coding-Autopilot-System/Promptimprover/wiki/Setup-Guide) for full configuration instructions.
 
 ## License
 

build_and_install.ps1

@@ -1,12 +1,21 @@
-Write-Host "Starting Universal Build & Install..." -ForegroundColor Cyan
+[CmdletBinding()]
+param()
 
-cd universal-refiner
-npm install
-npm run build
-npm install -g .
+$ErrorActionPreference = 'Stop'
+$packageDir = Join-Path $PSScriptRoot 'universal-refiner'
 
-$package = Get-Content .\package.json | ConvertFrom-Json
-$version = $package.version
+Write-Host 'Validating and installing Universal Refiner...' -ForegroundColor Cyan
+Push-Location $packageDir
+try {
+    npm ci --no-fund
+    npm test
+    npm run build
+    npm install --global . --no-fund
 
-Write-Host "Prompt Refiner v$version installed globally as 'gemini-prompt-refiner'" -ForegroundColor Green
-Write-Host "Use 'gemini-prompt-refiner' command in your MCP configurations." -ForegroundColor Yellow
+    $package = Get-Content .\package.json -Raw | ConvertFrom-Json
+    $command = Get-Command gemini-prompt-refiner -ErrorAction Stop
+    Write-Host "Prompt Refiner v$($package.version) installed: $($command.Source)" -ForegroundColor Green
+}
+finally {
+    Pop-Location
+}

build_and_install.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+PACKAGE_DIR="$SCRIPT_DIR/universal-refiner"
+
+printf '%s\n' 'Validating and installing Universal Refiner...'
+cd "$PACKAGE_DIR"
+npm ci --no-fund
+npm test
+npm run build
+npm install --global . --no-fund
+
+command -v gemini-prompt-refiner >/dev/null 2>&1
+VERSION=$(node -p "require('./package.json').version")
+printf 'Prompt Refiner v%s installed: %s\n' "$VERSION" "$(command -v gemini-prompt-refiner)"