public/Invoke-Wtw.ps1
|
function Convert-WtwArgsToSplat { <# .SYNOPSIS Parse CLI arguments into a PowerShell splatting hashtable. .DESCRIPTION Converts --kebab-case flags to PascalCase parameter names and determines whether each flag is a switch or a key-value pair by peeking at the next argument. Returns a hashtable with Splat (named params) and Positional (remaining args) keys. .PARAMETER ArgList Raw argument array from the CLI invocation. .EXAMPLE Convert-WtwArgsToSplat @('myTask', '--dry-run', '--repo', 'app') Returns @{ Splat = @{ DryRun = [switch]::Present; Repo = 'app' }; Positional = @('myTask') } #> param([object[]] $ArgList) $splat = [ordered]@{} $positional = @() $i = 0 while ($i -lt $ArgList.Count) { $arg = "$($ArgList[$i])" # Translate --kebab-case to PascalCase if ($arg -match '^--([a-z][a-z0-9-]*)$') { $parts = $Matches[1] -split '-' $arg = '-' + (($parts | ForEach-Object { $_.Substring(0,1).ToUpper() + $_.Substring(1) }) -join '') } if ($arg -match '^-(\w+)$') { $paramName = $Matches[1] # Peek at next arg to decide switch vs value if (($i + 1) -lt $ArgList.Count -and "$($ArgList[$i + 1])" -notmatch '^-') { $splat[$paramName] = $ArgList[$i + 1] $i += 2 } else { $splat[$paramName] = [switch]::Present $i++ } } else { $positional += $arg $i++ } } # Add positional args as numbered keys won't work — return them separately return @{ Splat = $splat; Positional = $positional } } function Invoke-Wtw { <# .SYNOPSIS Main CLI dispatcher for wtw. .DESCRIPTION Routes subcommands (create, list, sync, clean, etc.) to their handler functions. Parses raw CLI arguments via Convert-WtwArgsToSplat and splats them to the target command. Does not use [CmdletBinding()] because it relies on automatic $args for flexible dispatch. .EXAMPLE wtw create auth --open Creates a worktree and workspace for "auth" and opens it in the editor. .EXAMPLE wtw sync --all --dry-run Preview-syncs all managed workspaces. #> $Command = $null $rawArgs = @() if ($args.Count -gt 0) { $Command = $args[0] } if ($args.Count -gt 1) { $rawArgs = $args[1..($args.Count - 1)] } if (-not $Command) { Write-Host '' Write-Host ' wtw - Git Worktree + Workspace Manager' -ForegroundColor Cyan Write-Host '' Write-Host ' Commands:' -ForegroundColor Yellow Write-Host ' init [aliases] Register current repo (--template <alias> to share settings)' Write-Host ' add [path] Add existing repo/worktree to registry' Write-Host ' create <task> Create worktree + workspace' Write-Host ' list [-d|--detailed] List registered worktrees' Write-Host ' go <name> Switch to worktree (cd + session init)' Write-Host ' open [name] Open workspace in editor (default: current)' Write-Host ' cursor [name] Open in Cursor (alias: cur)' Write-Host ' code [name] Open in VS Code (alias: co)' Write-Host ' antigravity [name] Open in Antigravity (alias: anti)' Write-Host ' windsurf [name] Open in Windsurf (alias: wind, ws)' Write-Host ' codium [name] Open in VSCodium (alias: vscodium)' Write-Host ' remove <task> Remove worktree + workspace' Write-Host ' workspace <name> Generate workspace file only (no git worktree)' Write-Host ' copy <name> Standalone copy of workspace from template' Write-Host ' color [name] [hex|random] Set workspace color (--no-sync to skip sync)' Write-Host ' sync [file|--all] Re-apply template to managed workspaces' Write-Host ' clean Clean stale AI worktrees' Write-Host ' install Install/update wtw globally (~/.wtw/module/)' Write-Host '' Write-Host ' Options:' -ForegroundColor Yellow Write-Host ' --help, -h Show this help' Write-Host '' return } $parsed = Convert-WtwArgsToSplat $rawArgs $splat = $parsed.Splat $pos = $parsed.Positional # --help / -h / help on any subcommand → show command-specific help if ($splat.Contains('Help') -or $splat.Contains('h') -or $pos -contains 'help') { Show-WtwCommandHelp $Command return } # Merge positional args into splat at position keys for commands that take them # Most commands take a single positional arg (task/name) # We handle this by manually adding positional params switch ($Command) { 'init' { if ($pos.Count -gt 0) { $splat['Alias'] = $pos[0] }; Initialize-WtwConfig @splat } 'add' { if ($pos.Count -gt 0) { $splat['Path'] = $pos[0] }; Add-WtwEntry @splat } 'create' { if ($pos.Count -gt 0) { $splat['Task'] = $pos[0] }; New-WtwWorktree @splat } 'list' { if ($pos.Count -gt 0) { $splat['Repo'] = $pos[0] }; Get-WtwList @splat } 'ls' { if ($pos.Count -gt 0) { $splat['Repo'] = $pos[0] }; Get-WtwList @splat } 'go' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; Enter-WtwWorktree @splat } 'open' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; Open-WtwWorkspace @splat } 'remove' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; Remove-WtwWorktree @splat } 'rm' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; Remove-WtwWorktree @splat } 'workspace' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; New-WtwWorkspace @splat } 'ws' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; New-WtwWorkspace @splat } 'copy' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; Copy-WtwWorkspace @splat } 'sync' { if ($pos.Count -gt 0) { $splat['Target'] = $pos[0] }; Sync-WtwWorkspace @splat } 'color' { if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] }; if ($pos.Count -gt 1) { $splat['Color'] = $pos[1] }; Set-WtwColor @splat } 'clean' { Invoke-WtwClean @splat } 'install' { Install-Wtw @splat } 'update' { Install-Wtw @splat } 'help' { Invoke-Wtw } # Internal commands for shell integration (zsh/bash wrappers call these) '__resolve' { # Output: path\tcolor\ttitle\tstartup_script # Used by wtw.zsh/wtw.bash — must be clean stdout (no Write-Host noise) # Redirect stream 6 (Information/Write-Host) to $null to suppress fuzzy match messages if ($pos.Count -eq 0) { Write-Error "Usage: wtw __resolve <name>"; return } $target = & { Resolve-WtwTarget $pos[0] } 6>$null if (-not $target) { exit 1 } $p = if ($target.WorktreeEntry) { $target.WorktreeEntry.path } else { $target.RepoEntry.mainPath } $c = if ($target.WorktreeEntry) { $target.WorktreeEntry.color } else { (Get-WtwColors).assignments."$($target.RepoName)/main" } $t = if ($target.TaskName) { "$($target.RepoName)/$($target.TaskName)" } else { $target.RepoName } $s = $target.RepoEntry.sessionScript ?? '' Write-Output "${p}`t${c}`t${t}`t${s}" } '__aliases' { # Output shell alias definitions: one per line as "alias_name\tpath\tcolor\ttitle\tstartup_script" $registry = Get-WtwRegistry $colors = Get-WtwColors foreach ($repoName in $registry.repos.PSObject.Properties.Name) { $repo = $registry.repos.$repoName $aliases = Get-WtwRepoAliases $repo $ss = $repo.sessionScript ?? '' $mainColor = $colors.assignments."$repoName/main" ?? '' foreach ($a in $aliases) { Write-Output "${a}`t$($repo.mainPath)`t${mainColor}`t${repoName}`t${ss}" } if ($repo.worktrees) { foreach ($taskName in $repo.worktrees.PSObject.Properties.Name) { $wt = $repo.worktrees.$taskName $wtColor = $wt.color ?? '' $wtTitle = "$repoName/$taskName" foreach ($a in $aliases) { Write-Output "${a}-${taskName}`t$($wt.path)`t${wtColor}`t${wtTitle}`t${ss}" } } } } } default { # Check if command is an editor shortcut (cursor, cur, code, co, anti, etc.) $resolvedEditor = Resolve-WtwEditorCommand $Command if ($resolvedEditor) { $splat['Editor'] = $resolvedEditor if ($pos.Count -gt 0) { $splat['Name'] = $pos[0] } Open-WtwWorkspace @splat } else { # Fallback: treat unknown command as "go <name>" Enter-WtwWorktree -Name $Command } } } } |