patchwork-os 0.2.0-beta.0 → 0.2.0-beta.10

package/scripts/start-all.ps1

@@ -0,0 +1,209 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Windows orchestrator for bridge + Claude + Patchwork dashboard.
+
+.DESCRIPTION
+    Cross-platform alternative to start-all.sh for native Windows (PowerShell/cmd).
+    Starts the bridge, waits for the lock file, launches Claude --ide, and
+    optionally starts the Patchwork dashboard dev server and opens it in the browser.
+
+    Run via npm:
+        npm run start:bridge          # bridge only (simplest)
+        npm run start-all:win         # full orchestrator (bridge + claude + dashboard)
+
+    Or directly:
+        pwsh -File scripts\start-all.ps1
+        pwsh -File scripts\start-all.ps1 --no-dashboard
+        pwsh -File scripts\start-all.ps1 --workspace C:\my\project --dashboard-port 3200
+
+.PARAMETER Workspace
+    Directory to open in Claude (default: current directory).
+
+.PARAMETER Full
+    Pass --full to the bridge, registering all ~95 tools including git/terminal/file ops.
+    Default is slim mode (27 IDE-exclusive tools).
+
+.PARAMETER NoDashboard
+    Skip starting the Patchwork dashboard.
+
+.PARAMETER DashboardPort
+    Port for the Next.js dashboard dev server (default: 3200).
+
+.PARAMETER BridgePort
+    Port for the bridge (default: auto-assigned via lock file).
+
+.PARAMETER Notify
+    ntfy.sh topic for push notifications (optional).
+#>
+[CmdletBinding()]
+param(
+    [string]$Workspace       = ".",
+    [switch]$Full,
+    [switch]$NoDashboard,
+    [int]   $DashboardPort   = 3200,
+    [int]   $BridgePort      = 0,
+    [string]$Notify          = ""
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+# ── Resolve paths ─────────────────────────────────────────────────────────────
+$ScriptDir   = Split-Path -Parent $MyInvocation.MyCommand.Path
+$BridgeDir   = Split-Path -Parent $ScriptDir
+$DashboardDir = Join-Path $BridgeDir "dashboard"
+
+try {
+    $Workspace = (Resolve-Path $Workspace).Path
+} catch {
+    Write-Error "Workspace directory not found: $Workspace"
+    exit 1
+}
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+function Write-Status($msg) { Write-Host "[orchestrator] $msg" -ForegroundColor Cyan }
+function Write-Ok($msg)     { Write-Host "[ok] $msg"           -ForegroundColor Green }
+function Write-Warn($msg)   { Write-Host "[warn] $msg"         -ForegroundColor Yellow }
+
+function Send-Notify($msg) {
+    if (-not $Notify) { return }
+    try {
+        Invoke-RestMethod -Uri "https://ntfy.sh/$Notify" -Method Post -Body $msg -TimeoutSec 5 | Out-Null
+    } catch { Write-Warn "ntfy notification failed: $_" }
+}
+
+# ── Track child processes for cleanup ─────────────────────────────────────────
+$Jobs = [System.Collections.Generic.List[System.Diagnostics.Process]]::new()
+
+function Stop-AllJobs {
+    foreach ($p in $Jobs) {
+        if (-not $p.HasExited) {
+            try { $p.Kill($true) } catch { }
+        }
+    }
+}
+
+# Clean up on Ctrl+C or exit
+$null = Register-EngineEvent -SourceIdentifier PowerShell.Exiting -Action { Stop-AllJobs }
+try { [Console]::TreatControlCAsInput = $false } catch { }
+
+# ── Build bridge args ─────────────────────────────────────────────────────────
+$BridgeArgs = @("--workspace", $Workspace)
+if ($BridgePort -gt 0) { $BridgeArgs += @("--port", $BridgePort) }
+if ($Full)             { $BridgeArgs += "--full" }
+
+# ── Start bridge ──────────────────────────────────────────────────────────────
+Write-Status "Starting bridge (workspace: $Workspace)..."
+
+$BridgeInfo = New-Object System.Diagnostics.ProcessStartInfo
+$BridgeInfo.UseShellExecute = $false
+# On Windows, npm global bins are .cmd wrappers — must invoke via cmd.exe.
+# Quote each argument so workspace paths with spaces (e.g. "C:\Users\Jane Doe\...") survive.
+$BridgeInfo.FileName  = "cmd.exe"
+$quotedArgs = $BridgeArgs | ForEach-Object { if ($_ -match '\s') { "`"$_`"" } else { $_ } }
+$BridgeInfo.Arguments = "/c claude-ide-bridge " + ($quotedArgs -join " ")
+
+$BridgeProc = [System.Diagnostics.Process]::Start($BridgeInfo)
+$Jobs.Add($BridgeProc)
+
+# ── Wait for lock file ────────────────────────────────────────────────────────
+Write-Status "Waiting for bridge lock file..."
+$ClaudeBase = if ($env:CLAUDE_CONFIG_DIR) { $env:CLAUDE_CONFIG_DIR } else { Join-Path $env:USERPROFILE ".claude" }
+$IdeDir  = Join-Path $ClaudeBase "ide"
+$Deadline = (Get-Date).AddSeconds(30)
+$LockFile = $null
+
+while ((Get-Date) -lt $Deadline) {
+    $locks = Get-ChildItem -Path $IdeDir -Filter "*.lock" -ErrorAction SilentlyContinue |
+             Where-Object { $_.LastWriteTime -gt (Get-Date).AddSeconds(-60) }
+    if ($locks) {
+        # Find the lock that matches our workspace
+        foreach ($lf in $locks) {
+            try {
+                $content = Get-Content $lf.FullName -Raw | ConvertFrom-Json
+                if ($content.isBridge -and
+                    ($content.workspace -replace '\\','/' ) -eq ($Workspace -replace '\\','/')) {
+                    $LockFile = $lf
+                    $DetectedPort = [int][System.IO.Path]::GetFileNameWithoutExtension($lf.Name)
+                    break
+                }
+            } catch { }
+        }
+        if ($LockFile) { break }
+    }
+    Start-Sleep -Milliseconds 200
+}
+
+if (-not $LockFile) {
+    Write-Error "Bridge lock file not written after 30s. Bridge may have failed to start."
+    Stop-AllJobs
+    exit 1
+}
+
+Write-Ok "Bridge ready on port $DetectedPort"
+Send-Notify "Bridge started on port $DetectedPort"
+
+# ── Start Claude --ide ────────────────────────────────────────────────────────
+Write-Status "Starting claude --ide..."
+$ClaudeInfo = New-Object System.Diagnostics.ProcessStartInfo
+$ClaudeInfo.FileName  = "cmd.exe"
+$ClaudeInfo.Arguments = "/c claude --ide"
+$ClaudeInfo.UseShellExecute = $false
+$ClaudeProc = [System.Diagnostics.Process]::Start($ClaudeInfo)
+$Jobs.Add($ClaudeProc)
+
+# ── Start dashboard ───────────────────────────────────────────────────────────
+$DashProc = $null
+if (-not $NoDashboard) {
+    if (-not (Test-Path (Join-Path $DashboardDir "node_modules"))) {
+        Write-Warn "dashboard/node_modules not found. Run 'npm ci' in the dashboard directory first, or pass -NoDashboard."
+    } else {
+        Write-Status "Starting dashboard on http://localhost:$DashboardPort ..."
+
+        $env:PATCHWORK_BRIDGE_PORT = $DetectedPort
+        $DashInfo = New-Object System.Diagnostics.ProcessStartInfo
+        $DashInfo.FileName         = "cmd.exe"
+        $DashInfo.Arguments        = "/c npx next dev -p $DashboardPort"
+        $DashInfo.WorkingDirectory = $DashboardDir
+        $DashInfo.UseShellExecute  = $false
+        $DashProc = [System.Diagnostics.Process]::Start($DashInfo)
+        $Jobs.Add($DashProc)
+
+        # Poll until Next.js answers, then open the browser
+        $DashUrl     = "http://localhost:$DashboardPort"
+        $DashDeadline = (Get-Date).AddSeconds(60)
+        $Opened = $false
+        while ((Get-Date) -lt $DashDeadline) {
+            try {
+                $r = Invoke-WebRequest -Uri $DashUrl -UseBasicParsing -TimeoutSec 1 -ErrorAction Stop
+                if ($r.StatusCode -lt 500) {
+                    Write-Ok "Dashboard ready — opening $DashUrl"
+                    Start-Process $DashUrl   # opens default browser on Windows
+                    $Opened = $true
+                    break
+                }
+            } catch { }
+            Start-Sleep -Milliseconds 1000
+        }
+        if (-not $Opened) {
+            Write-Warn "Dashboard did not respond within 60s — open $DashUrl manually."
+        }
+    }
+}
+
+# ── Wait ──────────────────────────────────────────────────────────────────────
+Write-Host ""
+Write-Ok "All processes started. Press Ctrl+C to stop."
+Write-Host "  Bridge PID : $($BridgeProc.Id)"
+Write-Host "  Claude PID : $($ClaudeProc.Id)"
+if ($DashProc) { Write-Host "  Dashboard  : http://localhost:$DashboardPort (PID $($DashProc.Id))" }
+Write-Host ""
+
+try {
+    # Block until the bridge exits (primary process)
+    $BridgeProc.WaitForExit()
+} finally {
+    Write-Status "Bridge exited — stopping all processes..."
+    Stop-AllJobs
+}

package/scripts/start-all.sh

@@ -52,9 +52,11 @@ IDE_NAME=""
 VPS=""
 FULL_MODE=""
 NO_DASHBOARD=""
+NO_TMUX=""
 DASHBOARD_PORT="3200"
+BRIDGE_PORT_FLAG=""
 AUTOMATION_POLICY=""
-CLAUDE_DRIVER="subprocess"
+DRIVER="subprocess"
 BRIDGE_READY_TIMEOUT="${BRIDGE_READY_TIMEOUT:-30}"
 LAST_CLAUDE_RESTART=0
 RESTART_COUNT=0
@@ -70,9 +72,11 @@ while [[ $# -gt 0 ]]; do
     --vps)               VPS="$2"; shift 2 ;;
     --full)              FULL_MODE="--full"; shift ;;
     --no-dashboard)      NO_DASHBOARD=1; shift ;;
+    --no-tmux)           NO_TMUX=1; shift ;;
     --dashboard-port)    DASHBOARD_PORT="$2"; shift 2 ;;
+    --bridge-port)       BRIDGE_PORT_FLAG="--port $2"; shift 2 ;;
     --automation-policy) AUTOMATION_POLICY="$2"; shift 2 ;;
-    --claude-driver)     CLAUDE_DRIVER="$2"; shift 2 ;;
+    --driver)            DRIVER="$2"; shift 2 ;;
     *)                   echo "Unknown option: $1" >&2; exit 1 ;;
   esac
 done
@@ -126,10 +130,12 @@ except Exception:
 done < <(ls ~/.claude/ide/*.lock 2>/dev/null)
 
 # --- Dependency checks ---
-command -v tmux >/dev/null 2>&1 || {
-  echo "Error: tmux is required. Install with: brew install tmux" >&2
-  exit 1
-}
+if [[ -z "$NO_TMUX" ]]; then
+  command -v tmux >/dev/null 2>&1 || {
+    echo "Error: tmux is required. Install with: brew install tmux (or pass --no-tmux for background mode)" >&2
+    exit 1
+  }
+fi
 command -v claude >/dev/null 2>&1 || {
   echo "Error: claude CLI not found on PATH." >&2
   exit 1
@@ -139,6 +145,56 @@ command -v node >/dev/null 2>&1 || {
   exit 1
 }
 
+# --- No-tmux background mode ---
+if [[ -n "$NO_TMUX" ]]; then
+  PIDS_DIR="$HOME/.patchwork/pids"
+  mkdir -p "$PIDS_DIR"
+
+  # Load credentials from ~/.patchwork/.env
+  if [[ -f "$HOME/.patchwork/.env" ]]; then
+    set -a; source "$HOME/.patchwork/.env"; set +a
+  fi
+
+  BRIDGE_DIR_ABS="$(cd "$BRIDGE_DIR" && pwd)"
+  BRIDGE_BIN="$BRIDGE_DIR_ABS/node_modules/.bin/claude-ide-bridge"
+  [[ -f "$BRIDGE_BIN" ]] || BRIDGE_BIN="claude-ide-bridge"
+
+  echo "=== Patchwork OS — background mode (--no-tmux) ==="
+
+  # Start bridge
+  echo "  Starting bridge..."
+  "$BRIDGE_BIN" ${FULL_MODE} ${BRIDGE_PORT_FLAG} \
+    ${AUTOMATION_POLICY:+--automation --automation-policy "$AUTOMATION_POLICY" --driver "$DRIVER"} \
+    >> "$HOME/.patchwork/bridge.log" 2>&1 &
+  echo $! > "$PIDS_DIR/bridge.pid"
+  echo "  Bridge PID: $! (log: ~/.patchwork/bridge.log)"
+
+  # Start dashboard if available
+  DASHBOARD_DIR="$BRIDGE_DIR_ABS/dashboard"
+  if [[ -z "$NO_DASHBOARD" ]] && [[ -d "$DASHBOARD_DIR" ]]; then
+    if [[ ! -d "$DASHBOARD_DIR/node_modules" ]]; then
+      echo "  Installing dashboard dependencies..."
+      npm install --prefer-offline --prefix "$DASHBOARD_DIR" || {
+        echo "Warning: dashboard npm install failed — skipping dashboard." >&2
+      }
+    fi
+    if [[ -d "$DASHBOARD_DIR/node_modules" ]]; then
+      (cd "$DASHBOARD_DIR" && \
+        DASHBOARD_PASSWORD="${DASHBOARD_PASSWORD:-}" \
+        DASHBOARD_SESSION_SECRET="${DASHBOARD_SESSION_SECRET:-}" \
+        npx next dev -p "$DASHBOARD_PORT" \
+        >> "$HOME/.patchwork/dashboard.log" 2>&1) &
+      echo $! > "$PIDS_DIR/dashboard.pid"
+      echo "  Dashboard PID: $! (log: ~/.patchwork/dashboard.log)"
+      echo "  Dashboard: http://localhost:${DASHBOARD_PORT}"
+    fi
+  fi
+
+  echo ""
+  echo "To stop: kill \$(cat ~/.patchwork/pids/bridge.pid) \$(cat ~/.patchwork/pids/dashboard.pid) 2>/dev/null"
+  exit 0
+fi
+
 # --- tmux session management ---
 if [[ -z "${TMUX:-}" ]]; then
   if tmux has-session -t "$SESSION" 2>/dev/null; then
@@ -147,7 +203,7 @@ if [[ -z "${TMUX:-}" ]]; then
   fi
   # Create session detached, re-run this script inside it, then attach
   tmux new-session -d -s "$SESSION" -x 200 -y 50
-  tmux send-keys -t "$SESSION" "\"$SCRIPT_PATH\" --workspace \"$WORKSPACE\"$([ -n "$NTFY_TOPIC" ] && echo " --notify \"$NTFY_TOPIC\"")$([ -n "$IDE_NAME" ] && echo " --ide \"$IDE_NAME\"")$([ -n "$VPS" ] && echo " --vps \"$VPS\"")$([ -n "$FULL_MODE" ] && echo " --full")" Enter
+  tmux send-keys -t "$SESSION" "\"$SCRIPT_PATH\" --workspace \"$WORKSPACE\"$([ -n "$NTFY_TOPIC" ] && echo " --notify \"$NTFY_TOPIC\"")$([ -n "$IDE_NAME" ] && echo " --ide \"$IDE_NAME\"")$([ -n "$VPS" ] && echo " --vps \"$VPS\"")$([ -n "$FULL_MODE" ] && echo " --full")$([ -n "$BRIDGE_PORT_FLAG" ] && echo " ${BRIDGE_PORT_FLAG/--port /--bridge-port }")" Enter
   exec tmux attach -t "$SESSION"
 fi
 
@@ -166,7 +222,7 @@ if [[ -z "$FULL_MODE" ]]; then
 fi
 if [[ -n "$AUTOMATION_POLICY" ]]; then
   echo ""
-  echo "  ⚡ Automation: enabled (driver: $CLAUDE_DRIVER)"
+  echo "  ⚡ Automation: enabled (driver: $DRIVER)"
   echo "     Policy: $AUTOMATION_POLICY"
 fi
 echo ""
@@ -205,7 +261,7 @@ if [[ -n "$IDE_NAME" ]]; then
 fi
 BRIDGE_AUTOMATION_FLAGS=""
 if [[ -n "$AUTOMATION_POLICY" ]]; then
-  BRIDGE_AUTOMATION_FLAGS="--automation --automation-policy $(printf '%q' "$AUTOMATION_POLICY") --claude-driver $(printf '%q' "$CLAUDE_DRIVER")"
+  BRIDGE_AUTOMATION_FLAGS="--automation --automation-policy $(printf '%q' "$AUTOMATION_POLICY") --driver $(printf '%q' "$DRIVER")"
 fi
 # Use compiled dist when src/ is absent (npm install), tsx during local development
 if [[ -f "$BRIDGE_DIR/src/index.ts" ]]; then
@@ -213,7 +269,7 @@ if [[ -f "$BRIDGE_DIR/src/index.ts" ]]; then
 else
   BRIDGE_BIN="node dist/index.js"
 fi
-BRIDGE_CMD="cd $(printf '%q' "$BRIDGE_DIR") && $BRIDGE_BIN --workspace $(printf '%q' "$WORKSPACE")${BRIDGE_IDE_FLAGS:+ $BRIDGE_IDE_FLAGS}${FULL_MODE:+ $FULL_MODE}${BRIDGE_AUTOMATION_FLAGS:+ $BRIDGE_AUTOMATION_FLAGS}"
+BRIDGE_CMD="cd $(printf '%q' "$BRIDGE_DIR") && $BRIDGE_BIN --workspace $(printf '%q' "$WORKSPACE")${BRIDGE_IDE_FLAGS:+ $BRIDGE_IDE_FLAGS}${FULL_MODE:+ $FULL_MODE}${BRIDGE_AUTOMATION_FLAGS:+ $BRIDGE_AUTOMATION_FLAGS}${BRIDGE_PORT_FLAG:+ $BRIDGE_PORT_FLAG}"
 # Derive a short display name for the Claude session from the workspace directory name.
 # This appears in Claude Code's session list, making multi-workspace tmux setups identifiable.
 WS_BASENAME=$(basename "$WORKSPACE")
@@ -379,22 +435,24 @@ tmux send-keys -t "${SESSION}:0.3" "$REMOTE_CMD" Enter
 # Pane 4: Dashboard (only if not --no-dashboard and dashboard dir exists)
 DASHBOARD_DIR="$BRIDGE_DIR/dashboard"
 if [[ -z "$NO_DASHBOARD" ]] && [[ -d "$DASHBOARD_DIR" ]]; then
-  # First-run guard: missing node_modules silently breaks `npm run dev` with
-  # an unhelpful error in pane 4. Surface a concrete remediation step in the
-  # orchestrator pane so the user knows what to do.
+  # Self-healing: install dashboard deps if node_modules is missing.
   if [[ ! -d "$DASHBOARD_DIR/node_modules" ]]; then
-    echo "" >&2
-    echo "Error: dashboard/node_modules not found." >&2
-    echo "Run: cd $(printf '%q' "$DASHBOARD_DIR") && npm install" >&2
-    echo "Then re-run start-all (or pass --no-dashboard to skip)." >&2
-    exit 1
+    echo "[orchestrator] Installing dashboard dependencies (first-time setup)..."
+    npm install --prefer-offline --prefix "$DASHBOARD_DIR" || {
+      echo "Error: dashboard npm install failed. Run manually: cd $(printf '%q' "$DASHBOARD_DIR") && npm install" >&2
+      exit 1
+    }
+  fi
+  # Load dashboard credentials from ~/.patchwork/.env so Next.js picks them up.
+  if [[ -f "$HOME/.patchwork/.env" ]]; then
+    set -a; source "$HOME/.patchwork/.env"; set +a
   fi
   BRIDGE_PORT=$(basename "$LOCK_FILE" .lock)
   # Call `next dev -p` directly. `npm run dev` hardcodes `-p 3200`, so
   # `--dashboard-port` previously only changed the printed URL while
   # Next.js stayed on 3200. Bypassing the npm script makes the flag
   # actually configure the dev server end-to-end.
-  DASHBOARD_CMD="cd $(printf '%q' "$DASHBOARD_DIR") && PATCHWORK_BRIDGE_PORT=${BRIDGE_PORT} npx next dev -p ${DASHBOARD_PORT}"
+  DASHBOARD_CMD="cd $(printf '%q' "$DASHBOARD_DIR") && PATCHWORK_BRIDGE_PORT=${BRIDGE_PORT} DASHBOARD_PASSWORD=$(printf '%q' "${DASHBOARD_PASSWORD:-}") DASHBOARD_SESSION_SECRET=$(printf '%q' "${DASHBOARD_SESSION_SECRET:-}") npx next dev -p ${DASHBOARD_PORT}"
   notify "Starting dashboard on http://localhost:${DASHBOARD_PORT}"
   tmux send-keys -t "${SESSION}:0.4" "$DASHBOARD_CMD" Enter
   # Poll the dashboard port until Next.js answers, then open the browser.

package/scripts/start-orchestrator.ps1

@@ -0,0 +1,158 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Windows orchestrator launcher — bridges multiple IDE windows simultaneously.
+
+.DESCRIPTION
+    Starts the meta-bridge that coordinates multiple IDE windows. Each IDE window
+    must already have the claude-ide-bridge extension running — this script
+    connects to them all via the orchestrator mode.
+
+    Run via npm:
+        npm run start-orchestrator:win
+
+    Or directly:
+        pwsh -File scripts\start-orchestrator.ps1
+        pwsh -File scripts\start-orchestrator.ps1 -Port 4746 -Verbose
+
+.PARAMETER Port
+    Orchestrator port (default: 4746).
+
+.PARAMETER Notify
+    ntfy.sh topic for push notifications (optional).
+
+.PARAMETER Verbose
+    Enable verbose orchestrator logging.
+#>
+[CmdletBinding()]
+param(
+    [int]   $Port    = 4746,
+    [string]$Notify  = "",
+    [switch]$VerboseLogging
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$ScriptDir  = Split-Path -Parent $MyInvocation.MyCommand.Path
+$BridgeDir  = Split-Path -Parent $ScriptDir
+
+function Write-Status($msg) { Write-Host "[orchestrator] $msg" -ForegroundColor Cyan }
+function Write-Ok($msg)     { Write-Host "[ok] $msg"           -ForegroundColor Green }
+function Write-Warn($msg)   { Write-Host "[warn] $msg"         -ForegroundColor Yellow }
+
+function Send-Notify($msg) {
+    if (-not $Notify) { return }
+    try {
+        Invoke-RestMethod -Uri "https://ntfy.sh/$Notify" -Method Post -Body $msg -TimeoutSec 5 | Out-Null
+    } catch { Write-Warn "ntfy notification failed: $_" }
+}
+
+$Jobs = [System.Collections.Generic.List[System.Diagnostics.Process]]::new()
+
+function Stop-AllJobs {
+    foreach ($p in $Jobs) {
+        if (-not $p.HasExited) { try { $p.Kill($true) } catch { } }
+    }
+}
+
+$null = Register-EngineEvent -SourceIdentifier PowerShell.Exiting -Action { Stop-AllJobs }
+
+# ── Dependency check ──────────────────────────────────────────────────────────
+$claudeFound = $false
+try {
+    $null = & where.exe claude 2>$null
+    $claudeFound = $true
+} catch { }
+
+if (-not $claudeFound) {
+    Write-Error "claude CLI not found on PATH. Install from https://docs.anthropic.com/en/docs/claude-code"
+    exit 1
+}
+
+# ── Build orchestrator args ───────────────────────────────────────────────────
+$orchArgs = @("orchestrator", "--port", $Port)
+if ($VerboseLogging) { $orchArgs += "--verbose" }
+
+# Use dist/ (npm install) or fallback message
+$distIndex = Join-Path $BridgeDir "dist\index.js"
+if (-not (Test-Path $distIndex)) {
+    Write-Error "dist/index.js not found. Run 'npm run build' first."
+    exit 1
+}
+
+# ── Start orchestrator bridge ─────────────────────────────────────────────────
+Write-Status "Starting orchestrator bridge on port $Port..."
+
+$orchInfo = New-Object System.Diagnostics.ProcessStartInfo
+$orchInfo.FileName         = "cmd.exe"
+$orchInfo.Arguments        = "/c node `"$distIndex`" " + ($orchArgs -join " ")
+$orchInfo.UseShellExecute  = $false
+$orchInfo.WorkingDirectory = $BridgeDir
+$orchProc = [System.Diagnostics.Process]::Start($orchInfo)
+$Jobs.Add($orchProc)
+
+# ── Wait for lock file ────────────────────────────────────────────────────────
+$ClaudeBase = if ($env:CLAUDE_CONFIG_DIR) { $env:CLAUDE_CONFIG_DIR } else { Join-Path $env:USERPROFILE ".claude" }
+$IdeDir   = Join-Path $ClaudeBase "ide"
+$LockFile = Join-Path $IdeDir "$Port.lock"
+$Deadline = (Get-Date).AddSeconds(20)
+
+Write-Status "Waiting for orchestrator lock file..."
+while ((Get-Date) -lt $Deadline -and -not (Test-Path $LockFile)) {
+    Start-Sleep -Milliseconds 200
+}
+
+if (-not (Test-Path $LockFile)) {
+    Write-Error "Orchestrator lock file not written after 20s. Bridge may have failed to start."
+    Stop-AllJobs
+    exit 1
+}
+
+try {
+    $lockContent = Get-Content $LockFile -Raw | ConvertFrom-Json
+    $token = $lockContent.authToken
+} catch {
+    $token = "(unknown)"
+}
+
+Write-Ok "Orchestrator ready on port $Port"
+Send-Notify "Orchestrator started on port $Port"
+
+# ── Start Claude --ide ────────────────────────────────────────────────────────
+Write-Status "Starting claude --ide (connects to orchestrator)..."
+
+$claudeEnv = [System.Collections.Generic.Dictionary[string,string]]::new()
+foreach ($entry in [System.Environment]::GetEnvironmentVariables().GetEnumerator()) {
+    $claudeEnv[$entry.Key] = $entry.Value
+}
+$claudeEnv["CLAUDE_CODE_IDE_SKIP_VALID_CHECK"] = "true"
+
+$claudeInfo = New-Object System.Diagnostics.ProcessStartInfo
+$claudeInfo.FileName         = "cmd.exe"
+$claudeInfo.Arguments        = "/c claude --ide"
+$claudeInfo.UseShellExecute  = $false
+foreach ($kv in $claudeEnv.GetEnumerator()) {
+    $claudeInfo.EnvironmentVariables[$kv.Key] = $kv.Value
+}
+$claudeProc = [System.Diagnostics.Process]::Start($claudeInfo)
+$Jobs.Add($claudeProc)
+
+# ── Summary ───────────────────────────────────────────────────────────────────
+Write-Host ""
+Write-Ok "Orchestrator running. Press Ctrl+C to stop all processes."
+Write-Host "  Orchestrator PID : $($orchProc.Id)"
+Write-Host "  Claude PID       : $($claudeProc.Id)"
+Write-Host "  Port             : $Port"
+Write-Host "  Token            : $($token.Substring(0, [Math]::Min(8, $token.Length)))..."
+Write-Host ""
+Write-Host "Each IDE window with the bridge extension running will be discovered"
+Write-Host "automatically. Type /ide in Claude Code to verify the connection."
+Write-Host ""
+
+try {
+    $orchProc.WaitForExit()
+} finally {
+    Write-Status "Orchestrator exited — stopping all processes..."
+    Stop-AllJobs
+}

package/scripts/start-remote.mjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform auto-restart wrapper for claude remote-control.
+ * Replaces start-remote.sh — works on Windows, macOS, and Linux without tmux.
+ *
+ * Usage:
+ *   node scripts/start-remote.mjs [--notify <ntfy-topic>]
+ *   npm run remote:node
+ *
+ * Controls:
+ *   Ctrl+C  — exit cleanly (no restart)
+ */
+
+import { spawn } from "node:child_process";
+
+const args = process.argv.slice(2);
+function flag(name) {
+  const i = args.indexOf(name);
+  return i !== -1 ? (args[i + 1] ?? null) : null;
+}
+
+const NTFY_TOPIC = flag("--notify") ?? "";
+const RESTART_BASE_MS = 5_000;
+const RESTART_MAX_MS = 300_000;
+const HEALTHY_MS = 60_000;
+const MAX_FAILURES = 50;
+const IS_WIN = process.platform === "win32";
+
+function ts() {
+  return new Date().toLocaleTimeString();
+}
+function log(msg) {
+  process.stdout.write(`[${ts()}] ${msg}\n`);
+}
+
+function notify(msg, priority = "default") {
+  if (!NTFY_TOPIC) return;
+  fetch(`https://ntfy.sh/${NTFY_TOPIC}`, {
+    method: "POST",
+    body: msg,
+    headers: { Title: "Claude Remote", Priority: priority },
+    signal: AbortSignal.timeout(10_000),
+  }).catch(() => {});
+}
+
+console.log("=== Remote Control auto-restart wrapper ===");
+console.log("  Ctrl+C to exit cleanly");
+if (NTFY_TOPIC) console.log(`  Push notifications: ntfy.sh/${NTFY_TOPIC}`);
+console.log("");
+
+let stopping = false;
+let delayMs = RESTART_BASE_MS;
+let failures = 0;
+let currentProc = null;
+
+process.on("SIGINT", () => {
+  stopping = true;
+  currentProc?.kill();
+});
+process.on("SIGTERM", () => {
+  stopping = true;
+  currentProc?.kill();
+});
+
+async function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+while (!stopping) {
+  const startMs = Date.now();
+
+  const exitCode = await new Promise((resolve) => {
+    currentProc = spawn(
+      IS_WIN ? "cmd.exe" : "claude",
+      IS_WIN
+        ? ["/c", "claude", "remote-control", "--spawn=session"]
+        : ["remote-control", "--spawn=session"],
+      { stdio: "inherit", shell: false },
+    );
+    currentProc.on("exit", (code) => resolve(code ?? 0));
+    currentProc.on("error", (err) => {
+      log(`Spawn error: ${err.message}`);
+      resolve(1);
+    });
+  });
+
+  currentProc = null;
+  if (stopping) break;
+
+  // Ctrl+C propagated from child exits with 130
+  if (exitCode === 130) {
+    log("Exited by user.");
+    break;
+  }
+
+  const elapsed = Date.now() - startMs;
+  if (elapsed >= HEALTHY_MS) {
+    failures = 0;
+    delayMs = RESTART_BASE_MS;
+  } else {
+    failures++;
+    delayMs = Math.min(
+      RESTART_BASE_MS * 2 ** Math.min(failures - 1, 6),
+      RESTART_MAX_MS,
+    );
+  }
+
+  if (failures >= MAX_FAILURES) {
+    log(`Too many consecutive failures (${MAX_FAILURES}). Giving up.`);
+    notify(`Circuit breaker: ${MAX_FAILURES} failures. Giving up.`, "high");
+    process.exit(1);
+  }
+
+  log(
+    `Remote control disconnected (exit ${exitCode}). Restarting in ${delayMs / 1000}s...`,
+  );
+  notify(
+    `Disconnected (exit ${exitCode}). Restarting in ${delayMs / 1000}s...`,
+  );
+
+  await sleep(delayMs);
+}

package/templates/automation-policies/recipe-authoring.json

@@ -1,6 +1,6 @@
 {
   "_comment": "recipe-authoring — runs preflight automatically when a .yaml recipe file is saved. Closes the authoring inner loop: edit → save → instant validation feedback via Claude task.",
-  "_usage": "Copy to automation-policy.json. Requires --automation --automation-policy <path> --claude-driver subprocess",
+  "_usage": "Copy to automation-policy.json. Requires --automation --automation-policy <path> --driver subprocess",
 
   "automationSystemPrompt": "Recipe lint bot. ≤10 lines. No preamble. List issues with file:line if available. End with 'Recipe OK' when clean.",
 

package/templates/automation-policies/security-first.json

@@ -1,6 +1,6 @@
 {
   "_comment": "security-first — monitors auth, payment, and API surface for vulnerabilities on every relevant change.",
-  "_usage": "Copy to automation-policy.json. Requires --automation --automation-policy <path> --claude-driver subprocess",
+  "_usage": "Copy to automation-policy.json. Requires --automation --automation-policy <path> --driver subprocess",
 
   "automationSystemPrompt": "Automation bot. Drop articles/filler. Fragments OK. Abbreviate: DB/auth/config/req/res/fn. X→Y arrows. ≤5 lines. No preamble. Call tools → report results only.",