ralph.ps1

#!/usr/bin/env pwsh
#requires -Version 5.1

[CmdletBinding()]
param(
    [Parameter(Mandatory=$false)]
    [string]$Prompt,

    [Parameter(Mandatory=$false)]
    [string]$Prd,

    [Parameter(Mandatory=$false)]
    [string]$Skill,

    [Parameter(Mandatory=$false)]
    [ValidateSet('safe', 'dev', 'locked')]
    [string]$AllowProfile,

    [Parameter(Mandatory=$false)]
    [string[]]$AllowTools = @(),

    [Parameter(Mandatory=$false)]
    [string[]]$DenyTools = @(),

    [Parameter(Mandatory=$false, Position=0)]
    [int]$Iterations,

    [Parameter(Mandatory=$false)]
    [switch]$Help
)

$ErrorActionPreference = 'Stop'
$RALPH_VERSION = "1.1.0"

$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path

function Show-Usage {
    @"
Usage:
  ralph.ps1 -Prompt <file> [-Prd <file>] [-Skill <a[,b,...]>] [-AllowProfile <safe|dev|locked>] [-AllowTools <toolSpec> ...] [-DenyTools <toolSpec> ...] <iterations>
Options:
  -Prompt <file>             Load prompt text from file (required).
  -Prd <file>                Optionally attach a PRD JSON file.
  -Skill <a[,b,...]>         Prepend one or more skills from skills/<name>/SKILL.md (comma-separated).
  -AllowProfile <name>       Tool permission profile: safe | dev | locked.
  -AllowTools <toolSpec>     Allow a specific tool (repeatable). Example: -AllowTools write
                             Use quotes if the spec includes spaces: -AllowTools 'shell(git push)'
  -DenyTools <toolSpec>      Deny a specific tool (repeatable). Example: -DenyTools 'shell(rm)'
  -Help                      Show this help.
Notes:
  - You must pass -AllowProfile or at least one -AllowTools.
  
Examples:
  ralph.ps1 -Prompt prompts/default.txt -AllowProfile safe 5
  ralph.ps1 -Prompt prompts/default.txt -Prd plans/prd.json -Skill wp-plugin-development -AllowProfile dev 10
"@
}

if ($Help) {
    Show-Usage
    exit 0
}

if (-not $Prompt) {
    Write-Error "Error: -Prompt is required"
    Show-Usage
    exit 1
}

if ($Iterations -le 0) {
    Write-Error "Error: <iterations> must be a positive integer"
    Show-Usage
    exit 1
}

if (-not (Test-Path $Prompt -PathType Leaf)) {
    Write-Error "Error: prompt file not readable: $Prompt"
    exit 1
}

if ($Prd -and -not (Test-Path $Prd -PathType Leaf)) {
    Write-Error "Error: PRD file not readable: $Prd"
    exit 1
}

$ProgressFile = "activity.txt"
if (-not (Test-Path $ProgressFile -PathType Leaf)) {
    Write-Error "Error: progress file not readable: $ProgressFile"
    exit 1
}

# Parse skills
$SkillsList = @()
if ($Skill) {
    $SkillsList = $Skill -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
}

# Validate tool permissions
if (-not $AllowProfile -and $AllowTools.Count -eq 0) {
    Write-Error "Error: you must specify -AllowProfile or at least one -AllowTools"
    Show-Usage
    exit 1
}

# Build copilot tool arguments
$CopilotToolArgs = @()

# Always deny dangerous commands
$CopilotToolArgs += '--deny-tool', 'shell(rm)'
$CopilotToolArgs += '--deny-tool', 'shell(git push)'

if ($AllowTools.Count -eq 0 -and $AllowProfile) {
    switch ($AllowProfile) {
        'dev' {
            $CopilotToolArgs += '--allow-all-tools'
            $CopilotToolArgs += '--allow-tool', 'write'
            $CopilotToolArgs += '--allow-tool', 'shell(pnpm:*)'
            $CopilotToolArgs += '--allow-tool', 'shell(git:*)'
        }
        'safe' {
            $CopilotToolArgs += '--allow-tool', 'write'
            $CopilotToolArgs += '--allow-tool', 'shell(pnpm:*)'
            $CopilotToolArgs += '--allow-tool', 'shell(git:*)'
        }
        'locked' {
            $CopilotToolArgs += '--allow-tool', 'write'
        }
        default {
            Write-Error "Error: unknown -AllowProfile: $AllowProfile"
            Show-Usage
            exit 1
        }
    }
}

foreach ($tool in $AllowTools) {
    $CopilotToolArgs += '--allow-tool', $tool
}

foreach ($tool in $DenyTools) {
    $CopilotToolArgs += '--deny-tool', $tool
}

# Use MODEL environment variable if set, otherwise let copilot use its default
$Model = $env:MODEL

for ($i = 1; $i -le $Iterations; $i++) {
    Write-Host "`nIteration $i"
    Write-Host "------------------------------------"

    # Create temporary context file
    $ContextFile = Join-Path $env:TEMP "ralph_context_$([System.Guid]::NewGuid()).txt"
    $ContextContent = New-Object System.Text.StringBuilder

    [void]$ContextContent.AppendLine("# Context")
    [void]$ContextContent.AppendLine()

    if ($SkillsList.Count -gt 0) {
        [void]$ContextContent.AppendLine("## Skills")
        foreach ($skillName in $SkillsList) {
            if (-not $skillName) { continue }

            $SkillFile = "skills/$skillName/SKILL.md"
            if (-not (Test-Path $SkillFile -PathType Leaf)) {
                Write-Error "Error: skill not found/readable: $SkillFile"
                exit 1
            }

            [void]$ContextContent.AppendLine()
            [void]$ContextContent.AppendLine("### $skillName")
            [void]$ContextContent.AppendLine()
            [void]$ContextContent.Append((Get-Content $SkillFile -Raw))
        }
        [void]$ContextContent.AppendLine()
    }

    if ($Prd) {
        [void]$ContextContent.AppendLine("## PRD ($Prd)")
        [void]$ContextContent.Append((Get-Content $Prd -Raw))
        [void]$ContextContent.AppendLine()
    }

    [void]$ContextContent.AppendLine("## activity.txt")
    [void]$ContextContent.Append((Get-Content $ProgressFile -Raw))
    [void]$ContextContent.AppendLine()

    Set-Content -Path $ContextFile -Value $ContextContent.ToString() -NoNewline -Force

    # Create combined prompt file
    $CombinedPromptFile = Join-Path $env:TEMP "ralph_prompt_$([System.Guid]::NewGuid()).txt"
    $CombinedContent = New-Object System.Text.StringBuilder

    [void]$CombinedContent.Append((Get-Content $ContextFile -Raw))
    [void]$CombinedContent.AppendLine()
    [void]$CombinedContent.AppendLine("# Prompt")
    [void]$CombinedContent.AppendLine()
    [void]$CombinedContent.Append((Get-Content $Prompt -Raw))
    [void]$CombinedContent.AppendLine()

    Set-Content -Path $CombinedPromptFile -Value $CombinedContent.ToString() -NoNewline -Force

    # Run copilot command
    $CopilotArgs = @(
        '--add-dir', $PWD.Path
        '--no-color'
        '--stream', 'off'
        '--silent'
        '-p', "@$CombinedPromptFile Follow the attached prompt."
    )

    if ($Model) {
        $CopilotArgs += '--model', $Model
    }

    $CopilotArgs += $CopilotToolArgs

    try {
        $Result = & copilot @CopilotArgs 2>&1 | Out-String
        $Status = $LASTEXITCODE
    }
    catch {
        $Result = $_.Exception.Message
        $Status = 1
    }

    # Clean up temp files
    Remove-Item $ContextFile -Force -ErrorAction SilentlyContinue
    Remove-Item $CombinedPromptFile -Force -ErrorAction SilentlyContinue

    Write-Host $Result

    if ($Status -ne 0) {
        Write-Host "Copilot exited with status $Status; continuing to next iteration."
        continue
    }

    if ($Result -match '<promise>COMPLETE</promise>') {
        Write-Host "PRD complete, exiting."
        # Optional: notify using tt if available
        if (Get-Command tt -ErrorAction SilentlyContinue) {
            & tt notify "PRD complete after $i iterations"
        }
        exit 0
    }
}

Write-Host "Finished $Iterations iterations without receiving the completion signal."