139 lines
4.3 KiB
PowerShell
139 lines
4.3 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Create a new feature branch and spec directory.
|
|
.DESCRIPTION
|
|
PowerShell equivalent of .agents/scripts/bash/create-new-feature.sh
|
|
Creates a numbered feature branch and initializes the spec directory.
|
|
.PARAMETER Description
|
|
Natural language description of the feature.
|
|
.PARAMETER ShortName
|
|
Optional custom short name for the branch (2-4 words).
|
|
.PARAMETER Number
|
|
Optional manual branch number (overrides auto-detection).
|
|
.EXAMPLE
|
|
.\create-new-feature.ps1 -Description "Add user authentication" -ShortName "user-auth"
|
|
#>
|
|
param(
|
|
[Parameter(Mandatory = $true, Position = 0)]
|
|
[string]$Description,
|
|
|
|
[string]$ShortName,
|
|
[int]$Number = 0
|
|
)
|
|
|
|
$ErrorActionPreference = "Stop"
|
|
|
|
# Load common functions
|
|
. "$PSScriptRoot\common.ps1"
|
|
|
|
$repoRoot = Get-RepoRoot
|
|
$hasGit = Test-HasGit
|
|
$specsDir = Join-Path $repoRoot "specs"
|
|
if (-not (Test-Path $specsDir)) { New-Item -ItemType Directory -Path $specsDir | Out-Null }
|
|
|
|
# Stop words for smart branch name generation
|
|
$stopWords = @('i','a','an','the','to','for','of','in','on','at','by','with','from',
|
|
'is','are','was','were','be','been','being','have','has','had',
|
|
'do','does','did','will','would','should','could','can','may','might',
|
|
'must','shall','this','that','these','those','my','your','our','their',
|
|
'want','need','add','get','set')
|
|
|
|
function ConvertTo-BranchName {
|
|
param([string]$Text)
|
|
$Text.ToLower() -replace '[^a-z0-9]', '-' -replace '-+', '-' -replace '^-|-$', ''
|
|
}
|
|
|
|
function Get-SmartBranchName {
|
|
param([string]$Desc)
|
|
$words = ($Desc.ToLower() -replace '[^a-z0-9]', ' ').Split(' ', [StringSplitOptions]::RemoveEmptyEntries)
|
|
$meaningful = $words | Where-Object { $_ -notin $stopWords -and $_.Length -ge 3 } | Select-Object -First 3
|
|
if ($meaningful.Count -gt 0) { return ($meaningful -join '-') }
|
|
return ConvertTo-BranchName $Desc
|
|
}
|
|
|
|
function Get-HighestNumber {
|
|
param([string]$Dir)
|
|
$highest = 0
|
|
if (Test-Path $Dir) {
|
|
Get-ChildItem -Path $Dir -Directory | ForEach-Object {
|
|
if ($_.Name -match '^(\d+)-') {
|
|
$num = [int]$Matches[1]
|
|
if ($num -gt $highest) { $highest = $num }
|
|
}
|
|
}
|
|
}
|
|
return $highest
|
|
}
|
|
|
|
# Generate branch suffix
|
|
if ($ShortName) {
|
|
$branchSuffix = ConvertTo-BranchName $ShortName
|
|
} else {
|
|
$branchSuffix = Get-SmartBranchName $Description
|
|
}
|
|
|
|
# Determine branch number
|
|
if ($Number -gt 0) {
|
|
$branchNumber = $Number
|
|
} else {
|
|
$highestSpec = Get-HighestNumber $specsDir
|
|
$highestBranch = 0
|
|
if ($hasGit) {
|
|
try {
|
|
git fetch --all --prune 2>$null | Out-Null
|
|
$branches = git branch -a 2>$null
|
|
foreach ($b in $branches) {
|
|
$clean = $b.Trim('* ') -replace '^remotes/[^/]+/', ''
|
|
if ($clean -match '^(\d{3})-') {
|
|
$num = [int]$Matches[1]
|
|
if ($num -gt $highestBranch) { $highestBranch = $num }
|
|
}
|
|
}
|
|
} catch {}
|
|
}
|
|
$branchNumber = [Math]::Max($highestSpec, $highestBranch) + 1
|
|
}
|
|
|
|
$featureNum = "{0:D3}" -f $branchNumber
|
|
$branchName = "$featureNum-$branchSuffix"
|
|
|
|
# Truncate if exceeding GitHub's 244-byte limit
|
|
if ($branchName.Length -gt 244) {
|
|
$maxSuffix = 244 - 4 # 3 digits + 1 hyphen
|
|
$branchSuffix = $branchSuffix.Substring(0, $maxSuffix).TrimEnd('-')
|
|
Write-Warning "Branch name truncated to 244 bytes"
|
|
$branchName = "$featureNum-$branchSuffix"
|
|
}
|
|
|
|
# Create git branch
|
|
if ($hasGit) {
|
|
git checkout -b $branchName
|
|
} else {
|
|
Write-Warning "Git not detected; skipped branch creation for $branchName"
|
|
}
|
|
|
|
# Create feature directory and spec file
|
|
$featureDir = Join-Path $specsDir $branchName
|
|
New-Item -ItemType Directory -Path $featureDir -Force | Out-Null
|
|
|
|
$templateFile = Join-Path $repoRoot ".specify" "templates" "spec-template.md"
|
|
$specFile = Join-Path $featureDir "spec.md"
|
|
if (Test-Path $templateFile) {
|
|
Copy-Item $templateFile $specFile
|
|
} else {
|
|
New-Item -ItemType File -Path $specFile -Force | Out-Null
|
|
}
|
|
|
|
$env:SPECIFY_FEATURE = $branchName
|
|
|
|
# Output
|
|
[PSCustomObject]@{
|
|
BranchName = $branchName
|
|
SpecFile = $specFile
|
|
FeatureNum = $featureNum
|
|
}
|
|
|
|
Write-Host "BRANCH_NAME: $branchName"
|
|
Write-Host "SPEC_FILE: $specFile"
|
|
Write-Host "FEATURE_NUM: $featureNum"
|