jiangchang-platform-kit/tools/release.ps1

<#
.SYNOPSIS
  One-command release script for skill repos.

.DESCRIPTION
  - Optional auto-commit
  - Push current branch
  - Auto-increment semantic tag (vX.Y.Z)
  - Create & push tag
  - Fail fast on unsafe states

.EXAMPLES
  # Safe mode (recommended): requires clean working tree
  .\release.ps1

  # Auto commit tracked/untracked changes then release
  .\release.ps1 -AutoCommit -CommitMessage "chore: update skill config"

  # Dry run (show what would happen)
  .\release.ps1 -DryRun

  # Custom tag prefix
  .\release.ps1 -Prefix "v" -Message "正式发布"

.NOTES
  Requires: git, PowerShell 5+
#>

[CmdletBinding()]
param(
  [string]$Prefix = "v",
  [string]$Message = "正式发布",
  [switch]$AutoCommit,
  [switch]$RequireClean,
  [string]$CommitMessage,
  [switch]$DryRun
)

Set-StrictMode -Version Latest
$ErrorActionPreference = "Stop"

function Invoke-Git {
  param([Parameter(Mandatory = $true)][string]$Args)
  Write-Host ">> git $Args" -ForegroundColor DarkGray
  & cmd /c "git $Args"
  if ($LASTEXITCODE -ne 0) {
    throw "git command failed: git $Args"
  }
}


function Get-GitOutput {
  param([Parameter(Mandatory = $true)][string]$Args)
  $output = & cmd /c "git $Args" 2>$null
  if ($LASTEXITCODE -ne 0) {
    throw "git command failed: git $Args"
  }
  return @($output)
}

function Test-Repo {
  & git rev-parse --is-inside-work-tree *> $null
  return ($LASTEXITCODE -eq 0)
}

function Get-CurrentBranch {
  $b = (Get-GitOutput "branch --show-current" | Select-Object -First 1).Trim()
  return $b
}


function Get-StatusPorcelain {
  $lines = @(Get-GitOutput "status --porcelain")
  return $lines
}

function Parse-SemVerTag {
  param(
    [string]$Tag,
    [string]$TagPrefix
  )
  $escaped = [regex]::Escape($TagPrefix)
  $m = [regex]::Match($Tag, "^${escaped}(\d+)\.(\d+)\.(\d+)$")
  if (-not $m.Success) { return $null }

  return [pscustomobject]@{
    Raw   = $Tag
    Major = [int]$m.Groups[1].Value
    Minor = [int]$m.Groups[2].Value
    Patch = [int]$m.Groups[3].Value
  }
}

function Get-NextTag {
  param([string]$TagPrefix)

  $tags = Get-GitOutput "tag --list"
  $parsed = @()

  foreach ($t in $tags) {
    $t = $t.Trim()
    if (-not $t) { continue }
    $obj = Parse-SemVerTag -Tag $t -TagPrefix $TagPrefix
    if ($null -ne $obj) { $parsed += $obj }
  }

  if ($parsed.Count -eq 0) {
    return "${TagPrefix}1.0.1"
  }

  $latest = $parsed | Sort-Object Major, Minor, Patch | Select-Object -Last 1
  return "$TagPrefix$($latest.Major).$($latest.Minor).$([int]$latest.Patch + 1)"
}


function Ensure-CleanOrAutoCommit {
  param(
    [switch]$DoAutoCommit,
    [switch]$NeedClean,
    [switch]$IsDryRun,
    [string]$Msg
  )

  $status = @(Get-StatusPorcelain)
  if ($status.Length -eq 0) { return }

  if ($NeedClean) {
    Write-Host "Working tree is not clean and -RequireClean is enabled." -ForegroundColor Yellow
    & git status --short
    throw "Abort: dirty working tree."
  }

  # 默认一键发布：有改动就自动提交；也可用 -AutoCommit 显式开启
  $commitMsg = $Msg
  if ([string]::IsNullOrWhiteSpace($commitMsg)) {
    $commitMsg = "chore: auto release commit ($(Get-Date -Format 'yyyy-MM-dd HH:mm:ss'))"
  }

  if (-not $DoAutoCommit) {
    Write-Host "Detected uncommitted changes, auto-committing before release..." -ForegroundColor Yellow
  }

  if ($IsDryRun) {
    Write-Host "[DryRun] Would run: git add -A" -ForegroundColor Yellow
    Write-Host "[DryRun] Would run: git commit -m `"$commitMsg`"" -ForegroundColor Yellow
    return
  }

  Invoke-Git "add -A"
  Invoke-Git "commit -m `"$commitMsg`""
}


try {
  Write-Host "=== Release Script Start ===" -ForegroundColor Cyan

  if (-not (Test-Repo)) {
    throw "Current directory is not a git repository."
  }

  $branch = Get-CurrentBranch
  if ([string]::IsNullOrWhiteSpace($branch)) {
    throw "Unable to determine current branch."
  }

  if ($branch -notin @("main", "master")) {
    throw "Current branch is '$branch'. Release is only allowed from main/master."
  }

  Invoke-Git "fetch --tags --prune origin"

  Ensure-CleanOrAutoCommit -DoAutoCommit:$AutoCommit -NeedClean:$RequireClean -IsDryRun:$DryRun -Msg $CommitMessage

  $upstream = (& git rev-parse --abbrev-ref --symbolic-full-name "@{u}" 2>$null)
  $hasUpstream = ($LASTEXITCODE -eq 0)

  if ($DryRun) {
    if ($hasUpstream) {
      Write-Host "[DryRun] Would run: git push" -ForegroundColor Yellow
    } else {
      Write-Host "[DryRun] Would run: git push -u origin $branch" -ForegroundColor Yellow
    }
  } else {
    if ($hasUpstream) {
      Invoke-Git "push"
    } else {
      Invoke-Git "push -u origin $branch"
    }
  }

  $nextTag = Get-NextTag -TagPrefix $Prefix
  Write-Host "Next tag: $nextTag" -ForegroundColor Green

  $existing = @(Get-GitOutput "tag --list `"$nextTag`"")
  if ($existing.Length -gt 0) {
    throw "Tag already exists: $nextTag"
  }

  if ($DryRun) {
    Write-Host "[DryRun] Would run: git tag -a $nextTag -m `"$Message`"" -ForegroundColor Yellow
    Write-Host "[DryRun] Would run: git push origin $nextTag" -ForegroundColor Yellow
    Write-Host "=== DryRun Complete ===" -ForegroundColor Cyan
    exit 0
  }

  Invoke-Git "tag -a $nextTag -m `"$Message`""
  Invoke-Git "push origin $nextTag"

  Write-Host "Release success: $nextTag" -ForegroundColor Green
  Write-Host "=== Release Script Done ===" -ForegroundColor Cyan
  exit 0
}
catch {
  Write-Host "Release failed: $($_.Exception.Message)" -ForegroundColor Red
  exit 1
}