raptor-aios 0.1.0

package/scripts/powershell/common.ps1

@@ -0,0 +1,328 @@
+# common.ps1 — Shared utility functions for Raptor I/O scripts (PowerShell port).
+#
+# Spec Kit ref: E04 — "Scripts deliberadamente 'burros' cuja única função é
+# resolver paths, manipular filesystem e devolver JSON estável."
+#
+# Contract:
+#   - stdout: JSON only (when -Json is used)
+#   - stderr: human-readable messages (Write-Error)
+#   - exit codes: 0=success, 1=validation error, 2=I/O error
+#
+# Usage: dot-source from other scripts:
+#   . "$PSScriptRoot/common.ps1"
+
+$ErrorActionPreference = 'Stop'
+
+# ---------------------------------------------------------------------------
+# Constants
+# ---------------------------------------------------------------------------
+$script:RAPTOR_DIR        = ".raptor"
+$script:FEATURE_JSON      = ".raptor/feature.json"
+$script:INIT_OPTIONS_JSON = ".raptor/init-options.json"
+$script:EXTENSIONS_YML    = ".raptor/extensions.yml"
+$script:CONSTITUTION_PATH = ".raptor/memory/constitution.md"
+$script:MANIFEST_JSON     = ".raptor/raptor.manifest.json"
+$script:SPECS_DIR         = "specs"
+
+# ---------------------------------------------------------------------------
+# Has-Git — Is git available and are we in a repo?
+# ---------------------------------------------------------------------------
+function Has-Git {
+  if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    return $false
+  }
+  try {
+    git rev-parse --git-dir 2>$null | Out-Null
+    return $LASTEXITCODE -eq 0
+  } catch {
+    return $false
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Get-RepoRoot — Walk up to find .git or return cwd
+# ---------------------------------------------------------------------------
+function Get-RepoRoot {
+  $dir = (Get-Location).Path
+  while ($dir -and $dir -ne [System.IO.Path]::GetPathRoot($dir)) {
+    if (Test-Path (Join-Path $dir ".git")) {
+      return $dir
+    }
+    $parent = Split-Path -Parent $dir
+    if ($parent -eq $dir) { break }
+    $dir = $parent
+  }
+  return (Get-Location).Path
+}
+
+# ---------------------------------------------------------------------------
+# Get-CurrentBranch — Current git branch or empty string
+# ---------------------------------------------------------------------------
+function Get-CurrentBranch {
+  if (Has-Git) {
+    try {
+      $branch = git rev-parse --abbrev-ref HEAD 2>$null
+      if ($LASTEXITCODE -eq 0) { return $branch.Trim() }
+    } catch { }
+  }
+  return ""
+}
+
+# ---------------------------------------------------------------------------
+# ConvertTo-JsonEscape — Escape a string for safe JSON embedding
+# ---------------------------------------------------------------------------
+function ConvertTo-JsonEscape {
+  param([string]$Value)
+  if ($null -eq $Value) { return "" }
+  $s = $Value
+  $s = $s -replace '\\', '\\\\'
+  $s = $s -replace '"',  '\"'
+  $s = $s -replace "`n", '\n'
+  $s = $s -replace "`r", '\r'
+  $s = $s -replace "`t", '\t'
+  return $s
+}
+
+# ---------------------------------------------------------------------------
+# Get-JsonValue — Read a key from a JSON file
+# ---------------------------------------------------------------------------
+function Get-JsonValue {
+  param(
+    [string]$File,
+    [string]$Key
+  )
+  if (-not (Test-Path $File)) { return "" }
+  try {
+    $content = Get-Content $File -Raw | ConvertFrom-Json
+    $val = $content.$Key
+    if ($null -eq $val) { return "" }
+    return [string]$val
+  } catch {
+    return ""
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Find-FeatureDirByPrefix — Find specs/ dir matching branch prefix
+# ---------------------------------------------------------------------------
+function Find-FeatureDirByPrefix {
+  param(
+    [string]$RepoRoot,
+    [string]$Branch
+  )
+  $specsPath = Join-Path $RepoRoot "specs"
+  if (-not (Test-Path $specsPath)) { return "" }
+
+  if ($Branch -match '^(\d+)') {
+    $prefix = $matches[1]
+    $candidate = Get-ChildItem -Path $specsPath -Directory -Filter "$prefix-*" -ErrorAction SilentlyContinue | Select-Object -First 1
+    if ($candidate) {
+      return "specs/$($candidate.Name)"
+    }
+  }
+  return ""
+}
+
+# ---------------------------------------------------------------------------
+# Get-FeaturePaths — Resolve the active feature directory.
+#
+# Resolution order (Spec Kit E06):
+#   1. env RAPTOR_FEATURE_DIRECTORY
+#   2. .raptor/feature.json (feature_directory field)
+#   3. Fallback by branch prefix
+#
+# Returns hashtable: @{ FEATURE_DIR; FEATURE_NAME; SPECS_DIR }
+# ---------------------------------------------------------------------------
+function Get-FeaturePaths {
+  $repoRoot = Get-RepoRoot
+  $featureDir = ""
+
+  # 1. Environment variable
+  if ($env:RAPTOR_FEATURE_DIRECTORY) {
+    $featureDir = $env:RAPTOR_FEATURE_DIRECTORY
+    Write-Error -ErrorAction Continue -Message "[raptor] Using RAPTOR_FEATURE_DIRECTORY=$featureDir"
+  }
+
+  # 2. feature.json
+  if (-not $featureDir) {
+    $featureJsonPath = Join-Path $repoRoot $script:FEATURE_JSON
+    if (Test-Path $featureJsonPath) {
+      $featureDir = Get-JsonValue -File $featureJsonPath -Key 'feature_directory'
+      if ($featureDir) {
+        Write-Error -ErrorAction Continue -Message "[raptor] Using feature.json: $featureDir"
+      }
+    }
+  }
+
+  # 3. Fallback by branch prefix
+  if (-not $featureDir -and (Has-Git)) {
+    $branch = Get-CurrentBranch
+    if ($branch) {
+      $featureDir = Find-FeatureDirByPrefix -RepoRoot $repoRoot -Branch $branch
+      if ($featureDir) {
+        Write-Error -ErrorAction Continue -Message "[raptor] Resolved from branch prefix: $featureDir"
+      }
+    }
+  }
+
+  if (-not $featureDir) {
+    Write-Error -ErrorAction Continue -Message "[raptor] ERROR: Cannot resolve feature directory."
+    Write-Error -ErrorAction Continue -Message "[raptor]   Set RAPTOR_FEATURE_DIRECTORY, create .raptor/feature.json,"
+    Write-Error -ErrorAction Continue -Message "[raptor]   or switch to a feature branch."
+    throw "Cannot resolve feature directory"
+  }
+
+  if (-not [System.IO.Path]::IsPathRooted($featureDir)) {
+    $featureDir = Join-Path $repoRoot $featureDir
+  }
+
+  return @{
+    FEATURE_DIR  = $featureDir
+    FEATURE_NAME = (Split-Path -Leaf $featureDir)
+    SPECS_DIR    = (Join-Path $repoRoot "specs")
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Test-FeatureBranch — Validate branch name format
+# ---------------------------------------------------------------------------
+function Test-FeatureBranch {
+  param([string]$Branch = (Get-CurrentBranch))
+
+  if (-not $Branch) { return $false }
+
+  if ($Branch -match '^[0-9]+-[a-z][a-z0-9-]*$') { return $true }
+  if ($Branch -match '^[0-9]{8}-[0-9]{6}-[a-z][a-z0-9-]*$') { return $true }
+
+  return $false
+}
+
+# ---------------------------------------------------------------------------
+# Resolve-Template — Priority stack resolution for templates (E14)
+#
+# Order:
+#   1. .raptor/templates/overrides/<name>.md
+#   2. .raptor/presets/<id>/templates/<name>.md
+#   3. .raptor/extensions/<id>/templates/<name>.md
+#   4. .raptor/templates/<name>.md (core fallback)
+# ---------------------------------------------------------------------------
+function Resolve-Template {
+  param([string]$Name)
+
+  $repoRoot = Get-RepoRoot
+
+  # 1. Project override
+  $override = Join-Path $repoRoot "$($script:RAPTOR_DIR)/templates/overrides/$Name"
+  if (Test-Path $override) { return $override }
+
+  # 2. Presets (by registry priority)
+  $presetsDir = Join-Path $repoRoot "$($script:RAPTOR_DIR)/presets"
+  $registry = Join-Path $presetsDir ".registry"
+  if (Test-Path $registry) {
+    try {
+      $entries = Get-Content $registry -Raw | ConvertFrom-Json
+      $entries = $entries | Sort-Object priority
+      foreach ($e in $entries) {
+        $candidate = Join-Path $presetsDir "$($e.id)/templates/$Name"
+        if (Test-Path $candidate) { return $candidate }
+      }
+    } catch { }
+  }
+
+  # 3. Extensions
+  $extDir = Join-Path $repoRoot "$($script:RAPTOR_DIR)/extensions"
+  if (Test-Path $extDir) {
+    Get-ChildItem -Path $extDir -Directory -ErrorAction SilentlyContinue | ForEach-Object {
+      $candidate = Join-Path $_.FullName "templates/$Name"
+      if (Test-Path $candidate) { return $candidate }
+    }
+  }
+
+  # 4. Core fallback
+  $core = Join-Path $repoRoot "$($script:RAPTOR_DIR)/templates/$Name"
+  if (Test-Path $core) { return $core }
+
+  Write-Error -ErrorAction Continue -Message "[raptor] WARNING: Template '$Name' not found in any layer."
+  return ""
+}
+
+# ---------------------------------------------------------------------------
+# Get-NextFeatureNumber — Calculate next sequential number
+# ---------------------------------------------------------------------------
+function Get-NextFeatureNumber {
+  $repoRoot = Get-RepoRoot
+  $max = 0
+
+  $specsPath = Join-Path $repoRoot "specs"
+  if (Test-Path $specsPath) {
+    Get-ChildItem -Path $specsPath -Directory -ErrorAction SilentlyContinue | ForEach-Object {
+      if ($_.Name -match '^([0-9]+)') {
+        $num = [int]$matches[1]
+        if ($num -gt $max) { $max = $num }
+      }
+    }
+  }
+
+  if (Has-Git) {
+    try {
+      $localBranches = git branch 2>$null
+      foreach ($b in $localBranches) {
+        $clean = $b -replace '^[\* ]+', ''
+        if ($clean -match '^([0-9]+)') {
+          $num = [int]$matches[1]
+          if ($num -gt $max) { $max = $num }
+        }
+      }
+      $remoteBranches = git branch -r 2>$null
+      foreach ($b in $remoteBranches) {
+        $clean = $b -replace '.*/', ''
+        if ($clean -match '^([0-9]+)') {
+          $num = [int]$matches[1]
+          if ($num -gt $max) { $max = $num }
+        }
+      }
+    } catch { }
+  }
+
+  return ($max + 1)
+}
+
+# ---------------------------------------------------------------------------
+# Format-FeatureNumber — Pad a number with leading zeros (auto-expands at 1000)
+# ---------------------------------------------------------------------------
+function Format-FeatureNumber {
+  param(
+    [int]$Number,
+    [int]$Width = 3
+  )
+  if ($Number -ge 1000 -and $Width -lt 4) { $Width = 4 }
+  return ('{0:D' + $Width + '}') -f $Number
+}
+
+# ---------------------------------------------------------------------------
+# ConvertTo-RaptorJson — Build a JSON object from key/value pairs
+# Usage: ConvertTo-RaptorJson @{ KEY1='val1'; KEY2='val2' }
+# ---------------------------------------------------------------------------
+function ConvertTo-RaptorJson {
+  param([hashtable]$Data)
+
+  $parts = @()
+  foreach ($k in $Data.Keys) {
+    $key = ConvertTo-JsonEscape -Value $k
+    $val = ConvertTo-JsonEscape -Value ([string]$Data[$k])
+    $parts += '"' + $key + '":"' + $val + '"'
+  }
+  return '{' + ($parts -join ',') + '}'
+}
+
+# ---------------------------------------------------------------------------
+# Stop-WithError — Print error to stderr and exit
+# ---------------------------------------------------------------------------
+function Stop-WithError {
+  param(
+    [string]$Message,
+    [int]$Code = 1
+  )
+  Write-Error -ErrorAction Continue -Message "[raptor] ERROR: $Message"
+  exit $Code
+}

package/scripts/powershell/create-new-feature.ps1

@@ -0,0 +1,138 @@
+# create-new-feature.ps1 — Create a new feature branch and spec directory.
+#
+# Spec Kit ref: E04 (PowerShell parity port).
+#
+# Args:
+#   -Json                   Output JSON to stdout (default: human-readable)
+#   -DryRun                 Show what would be done without doing it
+#   -AllowExistingBranch    Allow reuse of an existing branch
+#   -ShortName <name>       Feature short name (kebab-case, 2-4 words) [REQUIRED]
+#   -Number <N>             Force a specific feature number
+#   -Timestamp              Use timestamp-based prefix instead of sequential
+
+[CmdletBinding()]
+param(
+  [switch]$Json,
+  [switch]$DryRun,
+  [switch]$AllowExistingBranch,
+  [Parameter(Mandatory=$true)]
+  [string]$ShortName,
+  [int]$Number = 0,
+  [switch]$Timestamp
+)
+
+$ErrorActionPreference = 'Stop'
+
+. (Join-Path $PSScriptRoot 'common.ps1')
+
+# ---------------------------------------------------------------------------
+# Validate
+# ---------------------------------------------------------------------------
+if (-not ($ShortName -match '^[a-z][a-z0-9-]*$')) {
+  Stop-WithError -Message "Invalid short-name '$ShortName': must be lowercase kebab-case (e.g., 'user-auth', 'payment-flow')" -Code 1
+}
+
+# ---------------------------------------------------------------------------
+# Resolve repo root and read options
+# ---------------------------------------------------------------------------
+$repoRoot = Get-RepoRoot
+Set-Location $repoRoot
+
+$useTimestamp = $Timestamp.IsPresent
+
+if (-not $useTimestamp) {
+  $initOptionsPath = Join-Path $repoRoot $script:INIT_OPTIONS_JSON
+  if (Test-Path $initOptionsPath) {
+    $numbering = Get-JsonValue -File $initOptionsPath -Key 'branch_numbering'
+    if ($numbering -eq 'timestamp') {
+      $useTimestamp = $true
+    }
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Calculate prefix
+# ---------------------------------------------------------------------------
+if ($useTimestamp) {
+  $prefix = (Get-Date -Format 'yyyyMMdd-HHmmss')
+} else {
+  if ($Number -gt 0) {
+    $num = $Number
+  } else {
+    $num = Get-NextFeatureNumber
+  }
+  $prefix = Format-FeatureNumber -Number $num
+}
+
+$branchName = "$prefix-$ShortName"
+$featureDir = "specs/$branchName"
+
+# ---------------------------------------------------------------------------
+# Check existing
+# ---------------------------------------------------------------------------
+if ((Test-Path $featureDir) -and (-not $AllowExistingBranch)) {
+  Stop-WithError -Message "Feature directory already exists: $featureDir (use -AllowExistingBranch to reuse)" -Code 1
+}
+
+if (Has-Git) {
+  $existing = git branch --list $branchName 2>$null
+  if ($existing -and (-not $AllowExistingBranch)) {
+    Stop-WithError -Message "Branch already exists: $branchName (use -AllowExistingBranch to reuse)" -Code 1
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Execute
+# ---------------------------------------------------------------------------
+$hasGitRepo = "false"
+
+if ($DryRun) {
+  Write-Error -ErrorAction Continue -Message "[raptor] DRY RUN — would create:"
+  Write-Error -ErrorAction Continue -Message "  Branch: $branchName"
+  Write-Error -ErrorAction Continue -Message "  Directory: $featureDir"
+} else {
+  New-Item -ItemType Directory -Path $featureDir -Force | Out-Null
+  Write-Error -ErrorAction Continue -Message "[raptor] Created directory: $featureDir"
+
+  if (Has-Git) {
+    $hasGitRepo = "true"
+    $existing = git branch --list $branchName 2>$null
+    if (-not $existing) {
+      git checkout -b $branchName 2>$null | Out-Null
+      if ($LASTEXITCODE -eq 0) {
+        Write-Error -ErrorAction Continue -Message "[raptor] Created and switched to branch: $branchName"
+      } else {
+        Write-Error -ErrorAction Continue -Message "[raptor] WARNING: Could not create branch $branchName (git error)"
+      }
+    } elseif ($AllowExistingBranch) {
+      git checkout $branchName 2>$null | Out-Null
+      Write-Error -ErrorAction Continue -Message "[raptor] Switched to existing branch: $branchName"
+    }
+  }
+
+  if (Test-Path $script:RAPTOR_DIR) {
+    @{ feature_directory = $featureDir } |
+      ConvertTo-Json |
+      Set-Content -Path $script:FEATURE_JSON -Encoding utf8
+    Write-Error -ErrorAction Continue -Message "[raptor] Updated $($script:FEATURE_JSON)"
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Output
+# ---------------------------------------------------------------------------
+if ($Json) {
+  $payload = [ordered]@{
+    BRANCH_NAME = $branchName
+    FEATURE_NUM = $prefix
+    FEATURE_DIR = $featureDir
+    PREFIX      = $prefix
+    HAS_GIT     = $hasGitRepo
+    DRY_RUN     = ([string]$DryRun.IsPresent).ToLower()
+  }
+  Write-Output (ConvertTo-RaptorJson -Data $payload)
+} else {
+  Write-Output "Feature: $branchName"
+  Write-Output "Directory: $featureDir"
+  Write-Output "Prefix: $prefix"
+}

package/scripts/powershell/setup-plan.ps1

@@ -0,0 +1,96 @@
+# setup-plan.ps1 — Prepare plan artifacts for a feature (PowerShell parity port).
+#
+# Spec Kit ref: E04
+#
+# Output JSON (-Json):
+#   { "FEATURE_SPEC": "...", "IMPL_PLAN": "...", "SPECS_DIR": "...",
+#     "BRANCH": "...", "HAS_GIT": "..." }
+
+[CmdletBinding()]
+param(
+  [switch]$Json
+)
+
+$ErrorActionPreference = 'Stop'
+
+. (Join-Path $PSScriptRoot 'common.ps1')
+
+# ---------------------------------------------------------------------------
+# Resolve feature paths
+# ---------------------------------------------------------------------------
+try {
+  $paths = Get-FeaturePaths
+} catch {
+  Stop-WithError -Message "Cannot resolve feature paths" -Code 1
+}
+
+$featureDir = $paths.FEATURE_DIR
+$specsDir   = $paths.SPECS_DIR
+$repoRoot   = Get-RepoRoot
+$branch     = Get-CurrentBranch
+$hasGitRepo = if (Has-Git) { "true" } else { "false" }
+
+# ---------------------------------------------------------------------------
+# Validate spec exists
+# ---------------------------------------------------------------------------
+$featureSpec = Join-Path $featureDir 'spec.md'
+if (-not (Test-Path $featureSpec)) {
+  Stop-WithError -Message "spec.md not found at $featureSpec. Run /rpt.specify first." -Code 1
+}
+
+# ---------------------------------------------------------------------------
+# Copy plan template if plan doesn't exist
+# ---------------------------------------------------------------------------
+$implPlan = Join-Path $featureDir 'plan.md'
+if (-not (Test-Path $implPlan)) {
+  $templatePath = Resolve-Template -Name 'plan-template.md'
+  if ($templatePath -and (Test-Path $templatePath)) {
+    Copy-Item -Path $templatePath -Destination $implPlan
+    Write-Error -ErrorAction Continue -Message "[raptor] Copied plan template from: $templatePath"
+  } else {
+    @"
+# Implementation Plan
+
+## Context & Constraints
+
+[NEEDS CLARIFICATION]
+
+## Architecture Overview
+
+[NEEDS CLARIFICATION]
+
+## Constitution Check
+
+### Initial Check (pre-design)
+
+| Principle | Status | Notes |
+|-----------|--------|-------|
+
+### Post-Design Check (after Phase 1)
+
+| Principle | Status | Notes |
+|-----------|--------|-------|
+"@ | Set-Content -Path $implPlan -Encoding utf8
+    Write-Error -ErrorAction Continue -Message "[raptor] Created minimal plan.md (no template found)"
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Output
+# ---------------------------------------------------------------------------
+if ($Json) {
+  $payload = [ordered]@{
+    FEATURE_SPEC = $featureSpec
+    IMPL_PLAN    = $implPlan
+    SPECS_DIR    = $specsDir
+    BRANCH       = $branch
+    HAS_GIT      = $hasGitRepo
+  }
+  Write-Output (ConvertTo-RaptorJson -Data $payload)
+} else {
+  Write-Output "Feature spec: $featureSpec"
+  Write-Output "Plan: $implPlan"
+  Write-Output "Specs dir: $specsDir"
+  Write-Output "Branch: $branch"
+  Write-Output "Git: $hasGitRepo"
+}