Update scripts to keep SOUL.md idempotent. Add release upgrade framework.

install.ps1

@@ -8,16 +8,96 @@ $ErrorActionPreference = "Stop"
 
 $SourceDir = $PSScriptRoot
 $TargetDir = if ($env:MOSAIC_HOME) { $env:MOSAIC_HOME } else { Join-Path $env:USERPROFILE ".config\mosaic" }
+$InstallMode = if ($env:MOSAIC_INSTALL_MODE) { $env:MOSAIC_INSTALL_MODE.ToLowerInvariant() } else { "prompt" } # prompt|keep|overwrite
+$PreservePaths = @("SOUL.md", "memory")
 
 function Write-Ok   { param([string]$Msg) Write-Host "  ✓ " -ForegroundColor Green -NoNewline; Write-Host $Msg }
 function Write-Warn { param([string]$Msg) Write-Host "  ⚠ " -ForegroundColor Yellow -NoNewline; Write-Host $Msg }
 function Write-Fail { param([string]$Msg) Write-Host "  ✗ " -ForegroundColor Red -NoNewline; Write-Host $Msg }
 function Write-Step { param([string]$Msg) Write-Host ""; Write-Host $Msg -ForegroundColor White -BackgroundColor DarkGray }
 
+function Test-ExistingInstall {
+    if (-not (Test-Path $TargetDir)) { return $false }
+    return (Test-Path (Join-Path $TargetDir "bin\mosaic")) -or (Test-Path (Join-Path $TargetDir "AGENTS.md")) -or (Test-Path (Join-Path $TargetDir "SOUL.md"))
+}
+
+function Select-InstallMode {
+    switch ($InstallMode) {
+        "prompt" { }
+        "keep" { return }
+        "overwrite" { return }
+        default {
+            Write-Fail "Invalid MOSAIC_INSTALL_MODE '$InstallMode'. Use: prompt, keep, overwrite."
+            exit 1
+        }
+    }
+
+    if (-not (Test-ExistingInstall)) {
+        $script:InstallMode = "overwrite"
+        return
+    }
+
+    if (-not [Environment]::UserInteractive) {
+        Write-Warn "Existing install detected without interactive input; defaulting to keep local files."
+        $script:InstallMode = "keep"
+        return
+    }
+
+    Write-Host ""
+    Write-Host "Existing Mosaic install detected at: $TargetDir"
+    Write-Host "Choose reinstall mode:"
+    Write-Host "  1) keep      Keep local files (SOUL.md, memory/) while updating framework"
+    Write-Host "  2) overwrite Replace everything in $TargetDir"
+    Write-Host "  3) cancel    Abort install"
+    $selection = Read-Host "Selection [1/2/3] (default: 1)"
+
+    $normalizedSelection = if ($null -eq $selection) { "" } else { $selection.ToLowerInvariant() }
+    switch ($normalizedSelection) {
+        "" { $script:InstallMode = "keep" }
+        "1" { $script:InstallMode = "keep" }
+        "k" { $script:InstallMode = "keep" }
+        "keep" { $script:InstallMode = "keep" }
+        "2" { $script:InstallMode = "overwrite" }
+        "o" { $script:InstallMode = "overwrite" }
+        "overwrite" { $script:InstallMode = "overwrite" }
+        "3" { Write-Fail "Install cancelled."; exit 1 }
+        "c" { Write-Fail "Install cancelled."; exit 1 }
+        "cancel" { Write-Fail "Install cancelled."; exit 1 }
+        default {
+            Write-Warn "Unrecognized selection '$selection'; defaulting to keep."
+            $script:InstallMode = "keep"
+        }
+    }
+}
+
 # ── Install framework ────────────────────────────────────────
 Write-Step " Installing Mosaic framework "
 
 if (-not (Test-Path $TargetDir)) { New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null }
+Select-InstallMode
+
+if ($InstallMode -eq "keep") {
+    Write-Ok "Install mode: keep local SOUL.md/memory while updating framework"
+}
+else {
+    Write-Ok "Install mode: overwrite existing files"
+}
+
+$preserveTmp = $null
+if ($InstallMode -eq "keep") {
+    $preserveTmp = Join-Path ([System.IO.Path]::GetTempPath()) ("mosaic-preserve-" + [Guid]::NewGuid().ToString("N"))
+    New-Item -ItemType Directory -Path $preserveTmp -Force | Out-Null
+    foreach ($relPath in $PreservePaths) {
+        $src = Join-Path $TargetDir $relPath
+        if (Test-Path $src) {
+            $dstParent = Join-Path $preserveTmp (Split-Path $relPath -Parent)
+            if (-not [string]::IsNullOrEmpty($dstParent) -and -not (Test-Path $dstParent)) {
+                New-Item -ItemType Directory -Path $dstParent -Force | Out-Null
+            }
+            Copy-Item $src (Join-Path $preserveTmp $relPath) -Recurse -Force
+        }
+    }
+}
 
 Get-ChildItem $TargetDir -Exclude ".git" | Remove-Item -Recurse -Force
 Get-ChildItem $SourceDir -Exclude ".git" | ForEach-Object {
@@ -30,6 +110,24 @@ Get-ChildItem $SourceDir -Exclude ".git" | ForEach-Object {
     }
 }
 
+if ($InstallMode -eq "keep" -and $null -ne $preserveTmp) {
+    foreach ($relPath in $PreservePaths) {
+        $src = Join-Path $preserveTmp $relPath
+        if (Test-Path $src) {
+            $dst = Join-Path $TargetDir $relPath
+            if (Test-Path $dst) {
+                Remove-Item $dst -Recurse -Force
+            }
+            $dstParent = Split-Path $dst -Parent
+            if (-not (Test-Path $dstParent)) {
+                New-Item -ItemType Directory -Path $dstParent -Force | Out-Null
+            }
+            Copy-Item $src $dst -Recurse -Force
+        }
+    }
+    Remove-Item -Path $preserveTmp -Recurse -Force -ErrorAction SilentlyContinue
+}
+
 Write-Ok "Framework installed to $TargetDir"
 
 # ── Post-install tasks ───────────────────────────────────────