chore: consolidate new foundation and archive v1 (#1495)

2026-09-07 12:32:57 -05:00
parent 9a5fbdbda7 5d27700026
commit 127a54fdff
3511 changed files with 727899 additions and 10 deletions
@@ -0,0 +1,124 @@
+# mosaic-sync-skills.ps1
+# Links the INSTALLED canonical skills into agent runtime skill directories.
+# Canonical skills ship inside the framework package and are installed into
+# ~/.config/mosaic/skills by the framework installer — there is no second
+# repository to clone. This script only maintains the runtime links.
+# Uses directory junctions (no elevation required) with fallback to copies.
+# PowerShell equivalent of mosaic-sync-skills (bash).
+$ErrorActionPreference = "Stop"
+
+param(
+    [switch]$LinkOnly,
+    [switch]$NoLink,
+    [switch]$Help
+)
+
+$MosaicHome = if ($env:MOSAIC_HOME) { $env:MOSAIC_HOME } else { Join-Path $env:USERPROFILE ".config\mosaic" }
+$MosaicSkillsDir = Join-Path $MosaicHome "skills"
+$MosaicLocalSkillsDir = Join-Path $MosaicHome "skills-local"
+
+if ($Help) {
+    Write-Host @"
+Usage: mosaic-sync-skills.ps1 [-LinkOnly] [-NoLink] [-Help]
+
+Link installed skills from ~/.config/mosaic/{skills,skills-local} into runtime
+skill directories using directory junctions. Canonical skills arrive with the
+framework installer; this script never clones or pulls a second repository.
+
+Options:
+  -LinkOnly     Accepted for compatibility; linking is now the whole job
+  -NoLink       Do nothing (kept for compatibility)
+  -Help         Show help
+"@
+    exit 0
+}
+
+if ($NoLink) {
+    Write-Host "[mosaic-skills] Nothing to do (-NoLink; canonical skills ship with the installer)"
+    exit 0
+}
+
+foreach ($d in @($MosaicHome, $MosaicSkillsDir, $MosaicLocalSkillsDir)) {
+    if (-not (Test-Path $d)) { New-Item -ItemType Directory -Path $d -Force | Out-Null }
+}
+
+if (-not (Test-Path $MosaicSkillsDir)) {
+    Write-Host "[mosaic-skills] Canonical skills dir missing: $MosaicSkillsDir" -ForegroundColor Red
+    exit 1
+}
+
+if ($NoLink) {
+    Write-Host "[mosaic-skills] Canonical sync completed (link update skipped)"
+    exit 0
+}
+
+function Link-SkillIntoTarget {
+    param([string]$SkillPath, [string]$TargetDir)
+
+    $name = Split-Path $SkillPath -Leaf
+    if ($name.StartsWith(".")) { return }
+
+    $linkPath = Join-Path $TargetDir $name
+
+    # Recreate only Mosaic-owned junctions/symlinks. Foreign reparse points are
+    # runtime-owned and must never be clobbered by install/upgrade auto-sync.
+    $existing = Get-Item $linkPath -Force -ErrorAction SilentlyContinue
+    if ($existing -and ($existing.Attributes -band [System.IO.FileAttributes]::ReparsePoint)) {
+        $rawTarget = @($existing.Target)[0]
+        $candidate = if ([System.IO.Path]::IsPathRooted($rawTarget)) {
+            $rawTarget
+        }
+        else {
+            Join-Path (Split-Path $linkPath -Parent) $rawTarget
+        }
+        $resolvedTarget = [System.IO.Path]::GetFullPath($candidate)
+        $canonicalRoot = [System.IO.Path]::GetFullPath($MosaicSkillsDir).TrimEnd('\') + '\'
+        $localRoot = [System.IO.Path]::GetFullPath($MosaicLocalSkillsDir).TrimEnd('\') + '\'
+        $owned = $resolvedTarget.StartsWith($canonicalRoot, [System.StringComparison]::OrdinalIgnoreCase) -or
+            $resolvedTarget.StartsWith($localRoot, [System.StringComparison]::OrdinalIgnoreCase)
+        if (-not $owned) {
+            Write-Host "[mosaic-skills] Preserve foreign runtime symlink: $linkPath"
+            return
+        }
+        Remove-Item $linkPath -Force
+    }
+    elseif ($existing) {
+        Write-Host "[mosaic-skills] Preserve existing runtime-specific entry: $linkPath"
+        return
+    }
+
+    # Try junction first, fall back to copy
+    try {
+        New-Item -ItemType Junction -Path $linkPath -Target $SkillPath -ErrorAction Stop | Out-Null
+    }
+    catch {
+        Write-Host "[mosaic-skills] Junction failed for $name, falling back to copy"
+        Copy-Item $SkillPath $linkPath -Recurse -Force
+    }
+}
+
+$linkTargets = @(
+    (Join-Path $env:USERPROFILE ".claude\skills"),
+    (Join-Path $env:USERPROFILE ".codex\skills"),
+    (Join-Path $env:USERPROFILE ".config\opencode\skills")
+)
+
+foreach ($target in $linkTargets) {
+    if (-not (Test-Path $target)) { New-Item -ItemType Directory -Path $target -Force | Out-Null }
+
+    # Link canonical skills
+    Get-ChildItem $MosaicSkillsDir -Directory | ForEach-Object {
+        Link-SkillIntoTarget $_.FullName $target
+    }
+
+    # Link local skills
+    if (Test-Path $MosaicLocalSkillsDir) {
+        Get-ChildItem $MosaicLocalSkillsDir -Directory | ForEach-Object {
+            Link-SkillIntoTarget $_.FullName $target
+        }
+    }
+
+    Write-Host "[mosaic-skills] Linked skills into: $target"
+}
+
+Write-Host "[mosaic-skills] Complete"