svharness 0.14.13 → 0.14.17

package/templates/codechat/Start-CodeChat.ps1

@@ -0,0 +1,359 @@
+# Standalone CodeChat launcher (no Node / svharness required).
+# UTF-8 BOM required for PS 5.1 when menu labels contain non-ASCII.
+param(
+  [ValidateSet('Start', 'InstallMenu', 'UninstallMenu', 'Status')]
+  [string]$Action = 'Start',
+  [string]$WorkDir = (Get-Location).Path,
+  [switch]$NoSyncEnv,
+  [switch]$NoSkipPermissions
+)
+
+$ErrorActionPreference = 'Stop'
+
+$script:MenuLabel = '在此启动 CodeChat CLI'
+$script:MenuKeyBg = 'HKCU:\Software\Classes\Directory\Background\shell\CodeChatStandaloneAgent'
+$script:MenuKeyDir = 'HKCU:\Software\Classes\Directory\shell\CodeChatStandaloneAgent'
+$script:SvharnessMenuKeyBg = 'HKCU:\Software\Classes\Directory\Background\shell\SvharnessLaunchCodeChatAgent'
+$script:SvharnessMenuKeyDir = 'HKCU:\Software\Classes\Directory\shell\SvharnessLaunchCodeChatAgent'
+$script:StandaloneDir = Join-Path $env:LOCALAPPDATA 'codechat-standalone'
+$script:InstalledScript = Join-Path $script:StandaloneDir 'Start-CodeChat.ps1'
+$script:InstalledIcon = Join-Path $script:StandaloneDir 'codechat-agent.ico'
+$script:RunnerEnvVar = 'CODECHAT_CLI_RUNNER'
+
+function Test-RunnerPath {
+  param([string]$Path)
+  if (-not $Path) { return $false }
+  try {
+    $null = Get-Item -LiteralPath $Path -ErrorAction Stop
+    return $true
+  } catch {
+    return $false
+  }
+}
+
+function Get-IdeVersionArray {
+  param(
+    [string]$InstallDirName,
+    [string]$DirPrefix
+  )
+  if (-not $InstallDirName.StartsWith($DirPrefix)) {
+    return @(0)
+  }
+  $rest = $InstallDirName.Substring($DirPrefix.Length)
+  if ($rest -match '^(\d+)(?:\.(\d+))?(?:\.(\d+))?') {
+    $parts = @()
+    if ($matches[1]) { $parts += [int]$matches[1] }
+    if ($matches[2]) { $parts += [int]$matches[2] }
+    if ($matches[3]) { $parts += [int]$matches[3] }
+    return $parts
+  }
+  return @(0)
+}
+
+function Compare-VersionArraysDesc {
+  param(
+    [int[]]$A,
+    [int[]]$B
+  )
+  $len = [Math]::Max($A.Count, $B.Count)
+  for ($i = 0; $i -lt $len; $i++) {
+    $av = if ($i -lt $A.Count) { $A[$i] } else { 0 }
+    $bv = if ($i -lt $B.Count) { $B[$i] } else { 0 }
+    if ($av -ne $bv) {
+      return $bv - $av
+    }
+  }
+  return 0
+}
+
+function Get-IdeScanRoots {
+  $roaming = if ($env:APPDATA) { $env:APPDATA } else { Join-Path $HOME 'AppData\Roaming' }
+  return @(
+    @{ Root = Join-Path $roaming 'Google'; DirPrefix = 'AndroidStudio'; LabelPrefix = 'Android Studio' },
+    @{ Root = Join-Path $roaming 'JetBrains'; DirPrefix = 'IntelliJIdea'; LabelPrefix = 'IntelliJ IDEA' },
+    @{ Root = Join-Path $roaming 'JetBrains'; DirPrefix = 'IdeaIC'; LabelPrefix = 'IntelliJ IDEA Community' }
+  )
+}
+
+function Find-CodeChatRunner {
+  $standalone = Join-Path $HOME '.codechat\cli_app\run.bat'
+
+  if ($env:CODECHAT_CLI_RUNNER) {
+    $envRunner = $env:CODECHAT_CLI_RUNNER.Trim()
+    if (-not (Test-RunnerPath -Path $envRunner)) {
+      throw "$($script:RunnerEnvVar) is not accessible: $envRunner"
+    }
+    return [PSCustomObject]@{
+      Runner = (Resolve-Path -LiteralPath $envRunner).Path
+      Source = 'env'
+      Label  = $script:RunnerEnvVar
+    }
+  }
+
+  if (Test-RunnerPath -Path $standalone) {
+    return [PSCustomObject]@{
+      Runner = (Resolve-Path -LiteralPath $standalone).Path
+      Source = 'standalone'
+      Label  = $null
+    }
+  }
+
+  $candidates = @()
+  foreach ($scan in Get-IdeScanRoots) {
+    if (-not (Test-Path -LiteralPath $scan.Root)) { continue }
+    Get-ChildItem -LiteralPath $scan.Root -Directory -ErrorAction SilentlyContinue |
+      Where-Object { $_.Name -like ($scan.DirPrefix + '*') } |
+      ForEach-Object {
+        $runner = Join-Path $_.FullName 'plugins\CodeChat\cli\run.bat'
+        if (-not (Test-RunnerPath -Path $runner)) { return }
+        $mtime = 0
+        try { $mtime = (Get-Item -LiteralPath $runner).LastWriteTimeUtc.Ticks } catch {}
+        $verPart = $_.Name.Substring($scan.DirPrefix.Length)
+        $label = if ($verPart) { "$($scan.LabelPrefix) $verPart" } else { $scan.LabelPrefix }
+        $candidates += [PSCustomObject]@{
+          Runner = (Resolve-Path -LiteralPath $runner).Path
+          Source = 'ide-plugin'
+          Label  = $label
+          Version = Get-IdeVersionArray -InstallDirName $_.Name -DirPrefix $scan.DirPrefix
+          Mtime = $mtime
+        }
+      }
+  }
+
+  if ($candidates.Count -eq 0) {
+    $lines = @(
+      'CodeChat CLI (run.bat) not found. Tried:',
+      "  1. env $script:RunnerEnvVar (not set)",
+      "  2. standalone $standalone",
+      '  3. IDE plugin scan:'
+    )
+    foreach ($scan in Get-IdeScanRoots) {
+      $lines += "     $(Join-Path $scan.Root ($scan.DirPrefix + '*\plugins\CodeChat\cli\run.bat'))"
+    }
+    $lines += ''
+    $lines += "Install CodeChat CLI or IDE plugin, or set $script:RunnerEnvVar."
+    throw ($lines -join [Environment]::NewLine)
+  }
+
+  $best = $null
+  foreach ($c in $candidates) {
+    if (-not $best) {
+      $best = $c
+      continue
+    }
+    $vc = Compare-VersionArraysDesc -A $c.Version -B $best.Version
+    if ($vc -lt 0) {
+      $best = $c
+      continue
+    }
+    if ($vc -eq 0 -and $c.Mtime -gt $best.Mtime) {
+      $best = $c
+    }
+  }
+
+  return [PSCustomObject]@{
+    Runner = $best.Runner
+    Source = $best.Source
+    Label  = $best.Label
+  }
+}
+
+function Sync-ProjectEnv {
+  param(
+    [string]$ProjectRoot,
+    [switch]$SkipSync
+  )
+  $projectEnv = Join-Path $ProjectRoot '.claude\.env'
+  $userEnv = Join-Path $HOME '.claude\.env'
+
+  if (-not $SkipSync -and (Test-Path -LiteralPath $projectEnv)) {
+    $userDir = Split-Path -Parent $userEnv
+    if (-not (Test-Path -LiteralPath $userDir)) {
+      New-Item -ItemType Directory -Force -Path $userDir | Out-Null
+    }
+    Copy-Item -LiteralPath $projectEnv -Destination $userEnv -Force
+    Write-Host "[info] synced project env -> $userEnv (project file unchanged)"
+    return $userEnv
+  }
+
+  if (Test-Path -LiteralPath $userEnv) {
+    return $userEnv
+  }
+
+  throw "No env file. Create $projectEnv or $userEnv"
+}
+
+function Initialize-ConsoleUtf8 {
+  try { chcp 65001 | Out-Null } catch {}
+  [Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
+  [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+  $script:OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+}
+
+function Invoke-CodeChatStart {
+  param(
+    [string]$TargetWorkDir,
+    [switch]$SkipEnvSync,
+    [switch]$SkipPermissions
+  )
+
+  Initialize-ConsoleUtf8
+
+  $resolvedWorkDir = (Resolve-Path -LiteralPath $TargetWorkDir).Path
+  $envFile = Sync-ProjectEnv -ProjectRoot $resolvedWorkDir -SkipSync:$SkipEnvSync
+  $resolved = Find-CodeChatRunner
+
+  $sourceLog = $resolved.Source
+  if ($resolved.Label) {
+    $sourceLog = "$sourceLog`: $($resolved.Label)"
+  }
+
+  Write-Host "CodeChat CLI: $($resolved.Runner) ($sourceLog)"
+  Write-Host "workdir: $resolvedWorkDir"
+  Write-Host "env: $envFile"
+
+  $args = @(
+    "--env-file=`"$envFile`"",
+    "--cwd=`"$resolvedWorkDir`""
+  )
+  if (-not $SkipPermissions) {
+    $args += '--dangerously-skip-permissions'
+  }
+
+  & $resolved.Runner @args
+  exit $LASTEXITCODE
+}
+
+function Get-WtExecutable {
+  try {
+    $where = (& where.exe wt 2>$null | Select-Object -First 1)
+    if ($where -and (Test-RunnerPath -Path $where)) {
+      return $where.Trim()
+    }
+  } catch {}
+
+  $localWt = Join-Path $env:LOCALAPPDATA 'Microsoft\WindowsApps\wt.exe'
+  if (Test-RunnerPath -Path $localWt) {
+    return $localWt
+  }
+  return $null
+}
+
+function Copy-OptionalIcon {
+  param([string]$SourceScriptPath)
+  $candidates = @(
+    (Join-Path (Split-Path -Parent $SourceScriptPath) 'codechat-agent.ico'),
+    (Join-Path (Split-Path -Parent $SourceScriptPath) '..\assets\codechat-agent.ico'),
+    (Join-Path (Split-Path -Parent $SourceScriptPath) '..\..\assets\codechat-agent.ico')
+  )
+  foreach ($icon in $candidates) {
+    try {
+      $resolved = Resolve-Path -LiteralPath $icon -ErrorAction Stop
+      Copy-Item -LiteralPath $resolved.Path -Destination $script:InstalledIcon -Force
+      return $true
+    } catch {}
+  }
+  return $false
+}
+
+function Register-ExplorerMenu {
+  param(
+    [string]$MenuKey,
+    [string]$Command,
+    [string]$IconPath
+  )
+  New-Item -Path $MenuKey -Force | Out-Null
+  Set-ItemProperty -Path $MenuKey -Name '(default)' -Value $script:MenuLabel
+  if ($IconPath -and (Test-Path -LiteralPath $IconPath)) {
+    Set-ItemProperty -Path $MenuKey -Name 'Icon' -Value "$IconPath,0"
+  }
+  New-Item -Path "$MenuKey\command" -Force | Out-Null
+  Set-ItemProperty -Path "$MenuKey\command" -Name '(default)' -Value $Command
+}
+
+function Install-CodeChatContextMenu {
+  $sourceScript = $PSCommandPath
+  if (-not (Test-Path -LiteralPath $sourceScript)) {
+    throw "Cannot resolve script path: $sourceScript"
+  }
+
+  # Avoid duplicate menu entries: overwrite svharness menu if present.
+  foreach ($key in @($script:SvharnessMenuKeyBg, $script:SvharnessMenuKeyDir, $script:MenuKeyBg, $script:MenuKeyDir)) {
+    if (Test-Path -LiteralPath $key) {
+      try { Remove-Item -LiteralPath $key -Recurse -Force } catch {}
+    }
+  }
+
+  if (-not (Test-Path -LiteralPath $script:StandaloneDir)) {
+    New-Item -ItemType Directory -Force -Path $script:StandaloneDir | Out-Null
+  }
+
+  Copy-Item -LiteralPath $sourceScript -Destination $script:InstalledScript -Force
+  $hasIcon = Copy-OptionalIcon -SourceScriptPath $sourceScript
+
+  $psArgs = "-NoExit -NoProfile -ExecutionPolicy Bypass -File `"$($script:InstalledScript)`" -Action Start -WorkDir"
+  $wt = Get-WtExecutable
+
+  function Build-MenuCommand {
+    param([string]$DirPlaceholder)
+    $fullPs = "$psArgs `"$DirPlaceholder`""
+    if ($wt) {
+      return "`"$wt`" -d $DirPlaceholder --title CodeChat -- powershell.exe $fullPs"
+    }
+    return "powershell.exe $fullPs"
+  }
+
+  Register-ExplorerMenu -MenuKey $script:MenuKeyBg -Command (Build-MenuCommand -DirPlaceholder '"%V"') -IconPath $(if ($hasIcon) { $script:InstalledIcon } else { $null })
+  Register-ExplorerMenu -MenuKey $script:MenuKeyDir -Command (Build-MenuCommand -DirPlaceholder '"%1"') -IconPath $(if ($hasIcon) { $script:InstalledIcon } else { $null })
+
+  Write-Host "[ok]   Context menu registered: $($script:MenuLabel)"
+  Write-Host "[info] script: $($script:InstalledScript)"
+  if ($wt) {
+    Write-Host "[info] terminal: Windows Terminal"
+  }
+}
+
+function Uninstall-CodeChatContextMenu {
+  foreach ($key in @($script:MenuKeyBg, $script:MenuKeyDir)) {
+    if (Test-Path -LiteralPath $key) {
+      Remove-Item -LiteralPath $key -Recurse -Force
+    }
+  }
+  if (Test-Path -LiteralPath $script:StandaloneDir) {
+    Remove-Item -LiteralPath $script:StandaloneDir -Recurse -Force
+  }
+  Write-Host '[ok]   Standalone context menu removed (svharness menu unchanged)'
+}
+
+function Show-CodeChatStatus {
+  Write-Host '>> Standalone CodeChat launcher status'
+  Write-Host "  installed script: $(if (Test-Path -LiteralPath $script:InstalledScript) { $script:InstalledScript } else { '(not installed)' })"
+  Write-Host "  background menu:  $(if (Test-Path -LiteralPath $script:MenuKeyBg) { 'yes' } else { 'no' })"
+  Write-Host "  directory menu:   $(if (Test-Path -LiteralPath $script:MenuKeyDir) { 'yes' } else { 'no' })"
+
+  try {
+    $runner = Find-CodeChatRunner
+    $label = if ($runner.Label) { "$($runner.Source): $($runner.Label)" } else { $runner.Source }
+    Write-Host "  runner:           $($runner.Runner) ($label)"
+  } catch {
+    Write-Host "  runner:           (not found)"
+  }
+
+  $userEnv = Join-Path $HOME '.claude\.env'
+  Write-Host "  user env:         $(if (Test-Path -LiteralPath $userEnv) { $userEnv } else { '(missing)' })"
+}
+
+switch ($Action) {
+  'Start' {
+    Invoke-CodeChatStart -TargetWorkDir $WorkDir -SkipEnvSync:$NoSyncEnv -SkipPermissions:$NoSkipPermissions
+  }
+  'InstallMenu' {
+    Install-CodeChatContextMenu
+  }
+  'UninstallMenu' {
+    Uninstall-CodeChatContextMenu
+  }
+  'Status' {
+    Show-CodeChatStatus
+  }
+}

package/templates/svharness.config.example.yaml

@@ -55,3 +55,10 @@ convert:
   output: ./my-app-harness
   type: requirements
   yes: true
+
+# wiki：对任意代码工程目录生成 baseline wiki（独立于 harness 生命周期）
+wiki:
+  wikiSource: .
+  output: ./wiki
+  generateWiki: false
+  wikiLang: zh