<# .SYNOPSIS Sync upstream, build the static site, commit, and push to Hugging Face. .DESCRIPTION The one command to run after updating DocEditorPlayground: .\scripts\deploy.ps1 It re-mirrors app/ from the local upstream checkout, builds the static export into the repository root, commits with the upstream version and commit in the message, and pushes to the Hugging Face Space remote. The Space serves files directly with no build step of its own, so what you push is exactly what visitors get. .PARAMETER UpstreamPath Local DocEditorPlayground checkout. Defaults to C:\dev\DocEditorPlayground. .PARAMETER Message Commit message. Defaults to "chore: sync doceditorplayground v @ ". .PARAMETER Remote Git remote to push to. Defaults to 'hf' (the Hugging Face Space). .PARAMETER AlsoPushOrigin Additionally push to 'origin' (the GitHub mirror of this deployment repo). .PARAMETER SkipSync Do not re-mirror app/; build and deploy what is already there. .PARAMETER SkipBuild Do not rebuild; commit and push the static output already at the repo root. .PARAMETER AllowDirty Pass through to sync-upstream.ps1: allow a dirty upstream working tree. .PARAMETER Clean Pass through to build-static.ps1: discard .build first, including node_modules. .PARAMETER DryRun Sync and build, show what would be committed, but do not commit or push. .EXAMPLE .\scripts\deploy.ps1 .EXAMPLE .\scripts\deploy.ps1 -Message "feat: add markdown export" -AlsoPushOrigin #> [CmdletBinding()] param( [string] $UpstreamPath = 'C:\dev\DocEditorPlayground', [string] $Message, [string] $Remote = 'hf', [switch] $AlsoPushOrigin, [switch] $SkipSync, [switch] $SkipBuild, [switch] $AllowDirty, [switch] $Clean, [switch] $DryRun ) $ErrorActionPreference = 'Stop' $repoRoot = Split-Path -Parent $PSScriptRoot if (-not $SkipSync) { $syncArgs = @{ UpstreamPath = $UpstreamPath } if ($AllowDirty) { $syncArgs['AllowDirty'] = $true } & (Join-Path $PSScriptRoot 'sync-upstream.ps1') @syncArgs Write-Host '' } if (-not $SkipBuild) { $buildArgs = @{} if ($Clean) { $buildArgs['Clean'] = $true } & (Join-Path $PSScriptRoot 'build-static.ps1') @buildArgs Write-Host '' } Push-Location $repoRoot try { # Verify the target remote exists before doing anything that needs undoing. $remotes = & git remote if ($remotes -notcontains $Remote) { $missingRemoteMessage = @" Git remote '$Remote' is not configured. Create the Space at https://huggingface.co/new-space (choose the Static SDK, Blank template), then wire it up: git remote add $Remote https://huggingface.co/spaces// See DEPLOY.md for the full first-time setup. "@ # A dry run only reports, so a missing remote is a warning there and a # hard stop for a real deploy. if ($DryRun) { Write-Warning $missingRemoteMessage } else { throw $missingRemoteMessage } } $changes = & git status --porcelain if ([string]::IsNullOrWhiteSpace(($changes -join ''))) { Write-Host 'Nothing to deploy - working tree is clean.' -ForegroundColor Yellow return } if (-not $Message) { $upstreamJsonPath = Join-Path $repoRoot 'UPSTREAM.json' if (Test-Path -LiteralPath $upstreamJsonPath) { $u = Get-Content -LiteralPath $upstreamJsonPath -Raw | ConvertFrom-Json $short = if ($u.commit.Length -ge 7) { $u.commit.Substring(0, 7) } else { $u.commit } $Message = "chore: sync doceditorplayground v$($u.appVersion) @ $short" } else { $Message = 'chore: sync doceditorplayground' } } if ($DryRun) { Write-Host '--- dry run, nothing committed or pushed ---' -ForegroundColor Yellow Write-Host "Would commit: $Message" Write-Host "Would push to: $Remote$(if ($AlsoPushOrigin) { ' and origin' })" Write-Host '' # Summarize rather than list: a rebuild touches hundreds of hashed chunks. $changed = (& git status --porcelain).Count Write-Host "$changed path(s) changed. Summary by top-level entry:" & git status --porcelain | ForEach-Object { ($_.Substring(3) -split '[/\\]')[0].Trim('"') } | Group-Object | Sort-Object -Property Count -Descending | ForEach-Object { Write-Host (" {0,5} {1}" -f $_.Count, $_.Name) } return } & git add -A if ($LASTEXITCODE -ne 0) { throw 'git add failed' } & git commit -m $Message if ($LASTEXITCODE -ne 0) { throw 'git commit failed' } $branch = (& git rev-parse --abbrev-ref HEAD).Trim() Write-Host '' Write-Host "Pushing $branch -> $Remote" -ForegroundColor Cyan & git push $Remote $branch if ($LASTEXITCODE -ne 0) { throw "Push to '$Remote' failed. If the Space has commits this repo lacks, run: git pull --rebase $Remote $branch" } if ($AlsoPushOrigin) { Write-Host "Pushing $branch -> origin" -ForegroundColor Cyan & git push origin $branch if ($LASTEXITCODE -ne 0) { throw 'Push to origin failed.' } } Write-Host '' Write-Host 'Deployed. A Static Space serves files directly, so the update is live' -ForegroundColor Green Write-Host 'as soon as the push lands - no build wait.' -ForegroundColor Green } finally { Pop-Location }