codex-to-im 0.1.0

package/scripts/supervisor-macos.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+# macOS supervisor — launchd-based process management.
+# Sourced by daemon.sh; expects CTI_HOME, SKILL_DIR, PID_FILE, STATUS_FILE, LOG_FILE.
+
+LAUNCHD_LABEL="com.claude-to-im.bridge"
+PLIST_DIR="$HOME/Library/LaunchAgents"
+PLIST_FILE="$PLIST_DIR/$LAUNCHD_LABEL.plist"
+
+# ── launchd helpers ──
+
+# Collect env vars that should be forwarded into the plist.
+# We honour clean_env() logic by reading *after* clean_env runs.
+build_env_dict() {
+  local indent="            "
+  local dict=""
+
+  # Always forward basics
+  for var in HOME PATH USER SHELL LANG TMPDIR; do
+    local val="${!var:-}"
+    [ -z "$val" ] && continue
+    dict+="${indent}<key>${var}</key>\n${indent}<string>${val}</string>\n"
+  done
+
+  # Forward CTI_* vars
+  while IFS='=' read -r name val; do
+    case "$name" in CTI_*)
+      dict+="${indent}<key>${name}</key>\n${indent}<string>${val}</string>\n"
+      ;; esac
+  done < <(env)
+
+  # Forward runtime-specific API keys
+  local runtime
+  runtime=$(grep "^CTI_RUNTIME=" "$CTI_HOME/config.env" 2>/dev/null | head -1 | cut -d= -f2- | tr -d "'" | tr -d '"' || true)
+  runtime="${runtime:-claude}"
+
+  case "$runtime" in
+    codex|auto)
+      for var in OPENAI_API_KEY CODEX_API_KEY CTI_CODEX_API_KEY CTI_CODEX_BASE_URL; do
+        local val="${!var:-}"
+        [ -z "$val" ] && continue
+        dict+="${indent}<key>${var}</key>\n${indent}<string>${val}</string>\n"
+      done
+      ;;
+  esac
+  case "$runtime" in
+    claude|auto)
+      # Auto-forward all ANTHROPIC_* env vars (sourced from config.env by daemon.sh).
+      # Third-party API providers need these to reach the CLI subprocess.
+      while IFS='=' read -r name val; do
+        case "$name" in ANTHROPIC_*)
+          dict+="${indent}<key>${name}</key>\n${indent}<string>${val}</string>\n"
+          ;; esac
+      done < <(env)
+      ;;
+  esac
+
+  echo -e "$dict"
+}
+
+generate_plist() {
+  local node_path
+  node_path=$(command -v node)
+
+  mkdir -p "$PLIST_DIR"
+  local env_dict
+  env_dict=$(build_env_dict)
+
+  cat > "$PLIST_FILE" <<PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${LAUNCHD_LABEL}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>${node_path}</string>
+        <string>${SKILL_DIR}/dist/daemon.mjs</string>
+    </array>
+
+    <key>WorkingDirectory</key>
+    <string>${SKILL_DIR}</string>
+
+    <key>StandardOutPath</key>
+    <string>${LOG_FILE}</string>
+    <key>StandardErrorPath</key>
+    <string>${LOG_FILE}</string>
+
+    <key>RunAtLoad</key>
+    <false/>
+
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+    </dict>
+
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+${env_dict}    </dict>
+</dict>
+</plist>
+PLIST
+}
+
+# ── Public interface (called by daemon.sh) ──
+
+supervisor_start() {
+  launchctl bootout "gui/$(id -u)/$LAUNCHD_LABEL" 2>/dev/null || true
+  generate_plist
+  launchctl bootstrap "gui/$(id -u)" "$PLIST_FILE"
+  launchctl kickstart -k "gui/$(id -u)/$LAUNCHD_LABEL"
+}
+
+supervisor_stop() {
+  launchctl bootout "gui/$(id -u)/$LAUNCHD_LABEL" 2>/dev/null || true
+  rm -f "$PID_FILE"
+}
+
+supervisor_is_managed() {
+  launchctl print "gui/$(id -u)/$LAUNCHD_LABEL" &>/dev/null
+}
+
+supervisor_status_extra() {
+  if supervisor_is_managed; then
+    echo "Bridge is registered with launchd ($LAUNCHD_LABEL)"
+    # Extract PID from launchctl as the authoritative source
+    local lc_pid
+    lc_pid=$(launchctl print "gui/$(id -u)/$LAUNCHD_LABEL" 2>/dev/null | grep -m1 'pid = ' | sed 's/.*pid = //' | tr -d ' ')
+    if [ -n "$lc_pid" ] && [ "$lc_pid" != "0" ] && [ "$lc_pid" != "-" ]; then
+      echo "launchd reports PID: $lc_pid"
+    fi
+  fi
+}
+
+# Override: on macOS, check launchctl first, then fall back to PID file
+supervisor_is_running() {
+  # Primary: launchctl knows the process
+  if supervisor_is_managed; then
+    local lc_pid
+    lc_pid=$(launchctl print "gui/$(id -u)/$LAUNCHD_LABEL" 2>/dev/null | grep -m1 'pid = ' | sed 's/.*pid = //' | tr -d ' ')
+    if [ -n "$lc_pid" ] && [ "$lc_pid" != "0" ] && [ "$lc_pid" != "-" ]; then
+      return 0
+    fi
+  fi
+  # Fallback: PID file
+  local pid
+  pid=$(read_pid)
+  pid_alive "$pid"
+}

package/scripts/supervisor-windows.ps1

@@ -0,0 +1,481 @@
+<#
+.SYNOPSIS
+  Windows daemon manager for claude-to-im bridge.
+
+.DESCRIPTION
+  Manages the bridge process on Windows.
+  Preferred: WinSW or NSSM wrapping as a Windows Service.
+  Fallback:  Start-Process with hidden window + PID tracking.
+
+  Usage:
+    powershell -File scripts\daemon.ps1 start
+    powershell -File scripts\daemon.ps1 stop
+    powershell -File scripts\daemon.ps1 status
+    powershell -File scripts\daemon.ps1 logs [N]
+    powershell -File scripts\daemon.ps1 install-service   # WinSW/NSSM setup
+    powershell -File scripts\daemon.ps1 uninstall-service
+#>
+
+param(
+    [Parameter(Position=0)]
+    [ValidateSet('start','stop','status','logs','install-service','uninstall-service','help')]
+    [string]$Command = 'help',
+
+    [Parameter(Position=1)]
+    [int]$LogLines = 50
+)
+
+$ErrorActionPreference = 'Stop'
+
+# ── Paths ──
+$CtiHome    = if ($env:CTI_HOME) { $env:CTI_HOME } else { Join-Path $env:USERPROFILE '.claude-to-im' }
+$SkillDir   = Split-Path -Parent (Split-Path -Parent $PSCommandPath)
+$RuntimeDir = Join-Path $CtiHome 'runtime'
+$PidFile    = Join-Path $RuntimeDir 'bridge.pid'
+$StatusFile = Join-Path $RuntimeDir 'status.json'
+$LogFile    = Join-Path (Join-Path $CtiHome 'logs') 'bridge.log'
+$ErrLogFile = Join-Path (Join-Path $CtiHome 'logs') 'bridge.stderr.log'
+$DaemonMjs  = Join-Path (Join-Path $SkillDir 'dist') 'daemon.mjs'
+$ConfigFile = Join-Path $CtiHome 'config.env'
+
+$ServiceName = 'ClaudeToIMBridge'
+
+# ── Helpers ──
+
+function Ensure-Dirs {
+    @('data','logs','runtime','data/messages') | ForEach-Object {
+        $dir = Join-Path $CtiHome $_
+        if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Path $dir -Force | Out-Null }
+    }
+}
+
+function Ensure-Built {
+    if (-not (Test-Path $DaemonMjs)) {
+        Write-Host "Building daemon bundle..."
+        Push-Location $SkillDir
+        npm run build
+        Pop-Location
+    } else {
+        $srcFiles = Get-ChildItem -Path (Join-Path $SkillDir 'src') -Filter '*.ts' -Recurse
+        $bundleTime = (Get-Item $DaemonMjs).LastWriteTime
+        $stale = $srcFiles | Where-Object { $_.LastWriteTime -gt $bundleTime } | Select-Object -First 1
+        if ($stale) {
+            Write-Host "Rebuilding daemon bundle (source changed)..."
+            Push-Location $SkillDir
+            npm run build
+            Pop-Location
+        }
+    }
+}
+
+function Get-ConfigEnvironment {
+    $configEnv = @{}
+    if (-not (Test-Path $ConfigFile)) {
+        return $configEnv
+    }
+
+    foreach ($line in Get-Content $ConfigFile) {
+        $trimmed = $line.Trim()
+        if (-not $trimmed -or $trimmed.StartsWith('#')) { continue }
+        $eqIndex = $trimmed.IndexOf('=')
+        if ($eqIndex -lt 1) { continue }
+
+        $name = $trimmed.Substring(0, $eqIndex).Trim()
+        $value = $trimmed.Substring($eqIndex + 1).Trim()
+        if (
+            ($value.StartsWith('"') -and $value.EndsWith('"')) -or
+            ($value.StartsWith("'") -and $value.EndsWith("'"))
+        ) {
+            $value = $value.Substring(1, $value.Length - 2)
+        }
+        $configEnv[$name] = $value
+    }
+
+    return $configEnv
+}
+
+function Read-Pid {
+    if (Test-Path $PidFile) { return (Get-Content $PidFile -Raw).Trim() }
+    return $null
+}
+
+function Test-PidAlive {
+    param([string]$ProcessId)
+    if (-not $ProcessId) { return $false }
+    try { $null = Get-Process -Id ([int]$ProcessId) -ErrorAction Stop; return $true }
+    catch { return $false }
+}
+
+function Test-StatusRunning {
+    if (-not (Test-Path $StatusFile)) { return $false }
+    $json = Get-Content $StatusFile -Raw | ConvertFrom-Json
+    return $json.running -eq $true
+}
+
+function Show-LastExitReason {
+    if (Test-Path $StatusFile) {
+        $json = Get-Content $StatusFile -Raw | ConvertFrom-Json
+        if ($json.lastExitReason) {
+            Write-Host "Last exit reason: $($json.lastExitReason)"
+        }
+    }
+}
+
+function Show-FailureHelp {
+    Write-Host ""
+    Write-Host "Recent logs:"
+    if (Test-Path $LogFile) {
+        Get-Content $LogFile -Tail 20
+    } else {
+        Write-Host "  (no log file)"
+    }
+    if (Test-Path $ErrLogFile) {
+        Write-Host ""
+        Write-Host "Recent stderr:"
+        Get-Content $ErrLogFile -Tail 20
+    }
+    Write-Host ""
+    Write-Host "Next steps:"
+    Write-Host "  1. Run diagnostics:  powershell -File `"$SkillDir\scripts\doctor.ps1`""
+    Write-Host "  2. Check full logs:  powershell -File `"$SkillDir\scripts\daemon.ps1`" logs 100"
+    Write-Host "  3. Rebuild bundle:   cd `"$SkillDir`"; npm run build"
+}
+
+function Get-NodePath {
+    $nodePath = (Get-Command node -ErrorAction SilentlyContinue).Source
+    if (-not $nodePath) {
+        Write-Error "Node.js not found in PATH. Install Node.js >= 20."
+        exit 1
+    }
+    return $nodePath
+}
+
+# ── WinSW / NSSM detection ──
+
+function Find-ServiceManager {
+    # Prefer WinSW, then NSSM
+    $winsw = Get-Command 'WinSW.exe' -ErrorAction SilentlyContinue
+    if ($winsw) { return @{ type = 'winsw'; path = $winsw.Source } }
+
+    $nssm = Get-Command 'nssm.exe' -ErrorAction SilentlyContinue
+    if ($nssm) { return @{ type = 'nssm'; path = $nssm.Source } }
+
+    return $null
+}
+
+function Install-WinSWService {
+    param([string]$WinSWPath)
+    $nodePath = Get-NodePath
+    $xmlPath = Join-Path $SkillDir "$ServiceName.xml"
+    $configEnv = Get-ConfigEnvironment
+
+    # Run as current user so the service can access ~/.claude-to-im and Codex login state
+    $currentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
+    Write-Host "Service will run as: $currentUser"
+    $cred = Get-Credential -UserName $currentUser -Message "Enter password for '$currentUser' (required for Windows Service logon)"
+    $plainPwd = $cred.GetNetworkCredential().Password
+
+    # Generate WinSW config XML
+    $xml = @"
+<service>
+  <id>$ServiceName</id>
+  <name>Claude-to-IM Bridge</name>
+  <description>Claude-to-IM bridge daemon</description>
+  <executable>$nodePath</executable>
+  <arguments>$DaemonMjs</arguments>
+  <workingdirectory>$SkillDir</workingdirectory>
+  <serviceaccount>
+    <username>$currentUser</username>
+    <password>$([System.Security.SecurityElement]::Escape($plainPwd))</password>
+    <allowservicelogon>true</allowservicelogon>
+  </serviceaccount>
+  <env name="USERPROFILE" value="$env:USERPROFILE"/>
+  <env name="APPDATA" value="$env:APPDATA"/>
+  <env name="LOCALAPPDATA" value="$env:LOCALAPPDATA"/>
+  <env name="PATH" value="$env:PATH"/>
+  <env name="CTI_HOME" value="$CtiHome"/>
+  <logpath>$(Join-Path $CtiHome 'logs')</logpath>
+  <log mode="append">
+    <logfile>bridge-service.log</logfile>
+  </log>
+  <onfailure action="restart" delay="10 sec"/>
+  <onfailure action="restart" delay="30 sec"/>
+  <onfailure action="none"/>
+</service>
+"@
+
+    $extraEnvXml = ($configEnv.GetEnumerator() | ForEach-Object {
+        '  <env name="{0}" value="{1}"/>' -f $_.Key, [System.Security.SecurityElement]::Escape($_.Value)
+    }) -join "`r`n"
+    if ($extraEnvXml) {
+        $xml = $xml -replace '  <logpath>', "$extraEnvXml`r`n  <logpath>"
+    }
+
+    $xml | Set-Content -Path $xmlPath -Encoding UTF8
+
+    # Copy WinSW next to the XML with matching name
+    $winswCopy = Join-Path $SkillDir "$ServiceName.exe"
+    Copy-Item $WinSWPath $winswCopy -Force
+
+    & $winswCopy install
+    Write-Host "Service '$ServiceName' installed via WinSW."
+    Write-Host "  Service account: $currentUser"
+    Write-Host "Start with:  & `"$winswCopy`" start"
+    Write-Host "Or:          sc.exe start $ServiceName"
+}
+
+function Install-NSSMService {
+    param([string]$NSSMPath)
+    $nodePath = Get-NodePath
+    $configEnv = Get-ConfigEnvironment
+
+    # Run as current user so the service can access ~/.claude-to-im and Codex login state
+    $currentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
+    Write-Host "Service will run as: $currentUser"
+    $cred = Get-Credential -UserName $currentUser -Message "Enter password for '$currentUser' (required for Windows Service logon)"
+    $plainPwd = $cred.GetNetworkCredential().Password
+
+    & $NSSMPath install $ServiceName $nodePath $DaemonMjs
+    & $NSSMPath set $ServiceName AppDirectory $SkillDir
+    & $NSSMPath set $ServiceName ObjectName $currentUser $plainPwd
+    & $NSSMPath set $ServiceName AppStdout $LogFile
+    & $NSSMPath set $ServiceName AppStderr $LogFile
+    & $NSSMPath set $ServiceName AppStdoutCreationDisposition 4
+    & $NSSMPath set $ServiceName AppStderrCreationDisposition 4
+    & $NSSMPath set $ServiceName Description "Claude-to-IM bridge daemon"
+    & $NSSMPath set $ServiceName AppRestartDelay 10000
+    $envArgs = @(
+        "USERPROFILE=$env:USERPROFILE",
+        "APPDATA=$env:APPDATA",
+        "LOCALAPPDATA=$env:LOCALAPPDATA",
+        "CTI_HOME=$CtiHome"
+    )
+    foreach ($entry in $configEnv.GetEnumerator()) {
+        $envArgs += "$($entry.Key)=$($entry.Value)"
+    }
+    & $NSSMPath set $ServiceName AppEnvironmentExtra @envArgs
+
+    Write-Host "Service '$ServiceName' installed via NSSM."
+    Write-Host "  Service account: $currentUser"
+    Write-Host "Start with:  nssm start $ServiceName"
+    Write-Host "Or:          sc.exe start $ServiceName"
+}
+
+# ── Fallback: Start-Process (no service manager) ──
+
+function Start-Fallback {
+    $nodePath = Get-NodePath
+    $configEnv = Get-ConfigEnvironment
+
+    # Clean env
+    $envClone = [System.Collections.Hashtable]::new()
+    foreach ($key in [System.Environment]::GetEnvironmentVariables().Keys) {
+        $envClone[$key] = [System.Environment]::GetEnvironmentVariable($key)
+    }
+    # Remove CLAUDECODE
+    [System.Environment]::SetEnvironmentVariable('CLAUDECODE', $null)
+    [System.Environment]::SetEnvironmentVariable('CTI_HOME', $CtiHome, 'Process')
+
+    foreach ($entry in $configEnv.GetEnumerator()) {
+        [System.Environment]::SetEnvironmentVariable($entry.Key, $entry.Value, 'Process')
+    }
+
+    try {
+        $proc = Start-Process -FilePath $nodePath `
+            -ArgumentList $DaemonMjs `
+            -WorkingDirectory $SkillDir `
+            -WindowStyle Hidden `
+            -RedirectStandardOutput $LogFile `
+            -RedirectStandardError $ErrLogFile `
+            -PassThru
+    } finally {
+        foreach ($key in $envClone.Keys) {
+            [System.Environment]::SetEnvironmentVariable($key, $envClone[$key], 'Process')
+        }
+        foreach ($entry in $configEnv.GetEnumerator()) {
+            if (-not $envClone.ContainsKey($entry.Key)) {
+                [System.Environment]::SetEnvironmentVariable($entry.Key, $null, 'Process')
+            }
+        }
+        if (-not $envClone.ContainsKey('CTI_HOME')) {
+            [System.Environment]::SetEnvironmentVariable('CTI_HOME', $null, 'Process')
+        }
+    }
+
+    # Write initial PID (main.ts will overwrite with real PID)
+    Set-Content -Path $PidFile -Value $proc.Id
+    return $proc.Id
+}
+
+# ── Commands ──
+
+switch ($Command) {
+    'start' {
+        Ensure-Dirs
+        Ensure-Built
+
+        $existingPid = Read-Pid
+        if ($existingPid -and (Test-PidAlive $existingPid)) {
+            Write-Host "Bridge already running (PID: $existingPid)"
+            if (Test-Path $StatusFile) { Get-Content $StatusFile -Raw }
+            exit 1
+        }
+
+        # Check if registered as Windows Service
+        $svc = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
+        if ($svc) {
+            Write-Host "Starting bridge via Windows Service..."
+            Start-Service -Name $ServiceName
+            Start-Sleep -Seconds 3
+
+            $newPid = Read-Pid
+            if ($newPid -and (Test-PidAlive $newPid) -and (Test-StatusRunning)) {
+                Write-Host "Bridge started (PID: $newPid, managed by Windows Service)"
+                if (Test-Path $StatusFile) { Get-Content $StatusFile -Raw }
+            } else {
+                Write-Host "Failed to start bridge via service."
+                Show-LastExitReason
+                Show-FailureHelp
+                exit 1
+            }
+        } else {
+            Write-Host "Starting bridge (background process)..."
+            $bridgePid = Start-Fallback
+            Start-Sleep -Seconds 3
+
+            $newPid = Read-Pid
+            if ($newPid -and (Test-PidAlive $newPid) -and (Test-StatusRunning)) {
+                Write-Host "Bridge started (PID: $newPid)"
+                if (Test-Path $StatusFile) { Get-Content $StatusFile -Raw }
+            } else {
+                Write-Host "Failed to start bridge."
+                if (-not $newPid -or -not (Test-PidAlive $newPid)) {
+                    Write-Host "  Process exited immediately."
+                }
+                Show-LastExitReason
+                Show-FailureHelp
+                exit 1
+            }
+        }
+    }
+
+    'stop' {
+        $svc = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
+        if ($svc -and $svc.Status -eq 'Running') {
+            Write-Host "Stopping bridge via Windows Service..."
+            Stop-Service -Name $ServiceName -Force
+            Write-Host "Bridge stopped"
+            if (Test-Path $PidFile) { Remove-Item $PidFile -Force }
+        } else {
+            $bridgePid = Read-Pid
+            if (-not $bridgePid) { Write-Host "No bridge running"; exit 0 }
+            if (Test-PidAlive $bridgePid) {
+                Stop-Process -Id ([int]$bridgePid) -Force
+                Write-Host "Bridge stopped"
+            } else {
+                Write-Host "Bridge was not running (stale PID file)"
+            }
+            if (Test-Path $PidFile) { Remove-Item $PidFile -Force }
+        }
+    }
+
+    'status' {
+        $bridgePid = Read-Pid
+
+        # Check Windows Service
+        $svc = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
+        if ($svc) {
+            Write-Host "Windows Service '$ServiceName': $($svc.Status)"
+        }
+
+        if ($bridgePid -and (Test-PidAlive $bridgePid)) {
+            Write-Host "Bridge process is running (PID: $bridgePid)"
+            if (Test-StatusRunning) {
+                Write-Host "Bridge status: running"
+            } else {
+                Write-Host "Bridge status: process alive but status.json not reporting running"
+            }
+            if (Test-Path $StatusFile) { Get-Content $StatusFile -Raw }
+        } else {
+            Write-Host "Bridge is not running"
+            if (Test-Path $PidFile) { Remove-Item $PidFile -Force }
+            Show-LastExitReason
+        }
+    }
+
+    'logs' {
+        if (Test-Path $LogFile) {
+            Get-Content $LogFile -Tail $LogLines | ForEach-Object {
+                $_ -replace '(token|secret|password)(["'']?\s*[:=]\s*["'']?)[^\s"]+', '$1$2*****'
+            }
+        } else {
+            Write-Host "No log file found at $LogFile"
+        }
+        if (Test-Path $ErrLogFile) {
+            Write-Host ""
+            Write-Host "stderr:"
+            Get-Content $ErrLogFile -Tail $LogLines
+        }
+    }
+
+    'install-service' {
+        Ensure-Dirs
+        Ensure-Built
+
+        $mgr = Find-ServiceManager
+        if (-not $mgr) {
+            Write-Host "No service manager found. Install one of:"
+            Write-Host "  WinSW:  https://github.com/winsw/winsw/releases"
+            Write-Host "  NSSM:   https://nssm.cc/download"
+            Write-Host ""
+            Write-Host "After installing, add it to PATH and re-run:"
+            Write-Host "  powershell -File `"$PSCommandPath`" install-service"
+            exit 1
+        }
+
+        switch ($mgr.type) {
+            'winsw' { Install-WinSWService -WinSWPath $mgr.path }
+            'nssm'  { Install-NSSMService  -NSSMPath  $mgr.path }
+        }
+    }
+
+    'uninstall-service' {
+        $svc = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
+        if (-not $svc) {
+            Write-Host "Service '$ServiceName' is not installed."
+            exit 0
+        }
+
+        if ($svc.Status -eq 'Running') {
+            Stop-Service -Name $ServiceName -Force
+        }
+
+        $mgr = Find-ServiceManager
+        if ($mgr -and $mgr.type -eq 'nssm') {
+            & $mgr.path remove $ServiceName confirm
+        } else {
+            # WinSW or generic
+            $winswExe = Join-Path $SkillDir "$ServiceName.exe"
+            if (Test-Path $winswExe) {
+                & $winswExe uninstall
+                Remove-Item $winswExe -Force -ErrorAction SilentlyContinue
+                Remove-Item (Join-Path $SkillDir "$ServiceName.xml") -Force -ErrorAction SilentlyContinue
+            } else {
+                sc.exe delete $ServiceName
+            }
+        }
+        Write-Host "Service '$ServiceName' uninstalled."
+    }
+
+    'help' {
+        Write-Host "Usage: daemon.ps1 {start|stop|status|logs [N]|install-service|uninstall-service}"
+        Write-Host ""
+        Write-Host "Commands:"
+        Write-Host "  start             Start the bridge daemon"
+        Write-Host "  stop              Stop the bridge daemon"
+        Write-Host "  status            Show bridge status"
+        Write-Host "  logs [N]          Show last N log lines (default 50)"
+        Write-Host "  install-service   Install as Windows Service (requires WinSW or NSSM)"
+        Write-Host "  uninstall-service Remove the Windows Service"
+    }
+}