@nguyenphp/antigravity-marketing 1.0.18 → 1.0.20

package/templates/.agent/skills/minimax-docx/scripts/setup.ps1

@@ -0,0 +1,274 @@
+# minimax-docx Environment Setup & Initialization Script (Windows PowerShell)
+# Supports: Windows 10/11, Windows Server 2019+
+# License: MIT
+#Requires -Version 5.1
+
+param(
+    [switch]$Minimal,
+    [switch]$SkipVerify,
+    [switch]$Help
+)
+
+$ErrorActionPreference = "Stop"
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectDir = Split-Path -Parent $ScriptDir
+$DotnetDir = Join-Path $ScriptDir "dotnet"
+$LogFile = Join-Path $ProjectDir ".setup.log"
+
+# --- Output Helpers ---
+function Log   { Write-Host "[OK]    $args" -ForegroundColor Green }
+function Warn  { Write-Host "[WARN]  $args" -ForegroundColor Yellow }
+function Fail  { Write-Host "[FAIL]  $args" -ForegroundColor Red }
+function Info  { Write-Host "[INFO]  $args" -ForegroundColor Cyan }
+function Step  { Write-Host "`n=== $args ===" -ForegroundColor Blue }
+
+if ($Help) {
+    Write-Host @"
+Usage: setup.ps1 [options]
+  -Minimal       Only install critical dependencies (skip pandoc, soffice, fonts)
+  -SkipVerify    Skip the verification test at the end
+  -Help          Show this help
+"@
+    exit 0
+}
+
+Write-Host "============================================"
+Write-Host "  minimax-docx Setup & Initialization (Windows)"
+Write-Host "  $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
+Write-Host "============================================"
+
+"" | Set-Content $LogFile
+
+# --- Detect Package Manager ---
+$HasWinget = $null -ne (Get-Command winget -ErrorAction SilentlyContinue)
+$HasChoco  = $null -ne (Get-Command choco -ErrorAction SilentlyContinue)
+$HasScoop  = $null -ne (Get-Command scoop -ErrorAction SilentlyContinue)
+
+if ($HasWinget)     { Info "Package manager: winget" }
+elseif ($HasChoco)  { Info "Package manager: chocolatey" }
+elseif ($HasScoop)  { Info "Package manager: scoop" }
+else                { Warn "No package manager found (winget/choco/scoop). Manual install may be needed." }
+
+# --- .NET SDK ---
+Step "Checking .NET SDK"
+
+$dotnetCmd = Get-Command dotnet -ErrorAction SilentlyContinue
+if ($dotnetCmd) {
+    $dotnetVer = & dotnet --version 2>$null
+    $majorVer = [int]($dotnetVer -split '\.')[0]
+    if ($majorVer -ge 8) {
+        Log "dotnet $dotnetVer already installed (>= 8.0 OK)"
+    } else {
+        Warn "dotnet $dotnetVer found but < 8.0, upgrading..."
+        $dotnetCmd = $null
+    }
+}
+
+if (-not $dotnetCmd -or $majorVer -lt 8) {
+    Info "Installing .NET SDK..."
+    if ($HasWinget) {
+        winget install Microsoft.DotNet.SDK.8 --accept-source-agreements --accept-package-agreements 2>>$LogFile
+    } elseif ($HasChoco) {
+        choco install dotnet-sdk -y 2>>$LogFile
+    } elseif ($HasScoop) {
+        scoop install dotnet-sdk 2>>$LogFile
+    } else {
+        Fail "Cannot auto-install .NET SDK. Download from: https://dotnet.microsoft.com/download"
+        Fail "After installing, restart PowerShell and re-run this script."
+        exit 1
+    }
+
+    # Refresh PATH
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+
+    if (Get-Command dotnet -ErrorAction SilentlyContinue) {
+        Log "dotnet $(dotnet --version) installed"
+    } else {
+        Fail "dotnet installation failed. Restart PowerShell and retry, or install manually."
+        exit 1
+    }
+}
+
+# --- Pandoc (Optional) ---
+if (-not $Minimal) {
+    Step "Checking pandoc (optional: content preview)"
+
+    if (Get-Command pandoc -ErrorAction SilentlyContinue) {
+        $pandocVer = (pandoc --version | Select-Object -First 1) -replace '.*?(\d+\.\d+(\.\d+)?)', '$1'
+        Log "pandoc $pandocVer already installed"
+    } else {
+        Info "Installing pandoc..."
+        if ($HasWinget)    { winget install JohnMacFarlane.Pandoc --accept-source-agreements 2>>$LogFile }
+        elseif ($HasChoco) { choco install pandoc -y 2>>$LogFile }
+        elseif ($HasScoop) { scoop install pandoc 2>>$LogFile }
+        else               { Warn "Install pandoc manually: https://pandoc.org/installing.html" }
+
+        $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+
+        if (Get-Command pandoc -ErrorAction SilentlyContinue) {
+            Log "pandoc installed"
+        } else {
+            Warn "pandoc not found after install (optional, will degrade gracefully)"
+        }
+    }
+}
+
+# --- LibreOffice (Optional) ---
+if (-not $Minimal) {
+    Step "Checking LibreOffice/soffice (optional: .doc conversion)"
+
+    $sofficeFound = $false
+
+    # Check common Windows install paths
+    $sofficePaths = @(
+        "C:\Program Files\LibreOffice\program\soffice.exe",
+        "C:\Program Files (x86)\LibreOffice\program\soffice.exe",
+        "${env:LOCALAPPDATA}\Programs\LibreOffice\program\soffice.exe"
+    )
+
+    if (Get-Command soffice -ErrorAction SilentlyContinue) {
+        Log "soffice found in PATH"
+        $sofficeFound = $true
+    } else {
+        foreach ($p in $sofficePaths) {
+            if (Test-Path $p) {
+                Log "soffice found at: $p"
+                Info "Tip: Add to PATH: `$env:Path += ';$(Split-Path $p)'"
+                $sofficeFound = $true
+                break
+            }
+        }
+    }
+
+    if (-not $sofficeFound) {
+        Info "Installing LibreOffice (this may take a while)..."
+        if ($HasWinget)    { winget install TheDocumentFoundation.LibreOffice --accept-source-agreements 2>>$LogFile }
+        elseif ($HasChoco) { choco install libreoffice-fresh -y 2>>$LogFile }
+        else               { Warn "Install LibreOffice manually: https://www.libreoffice.org/download/" }
+    }
+}
+
+# --- NuGet Configuration ---
+Step "Checking NuGet configuration"
+
+$nugetSources = & dotnet nuget list source 2>$null
+if ($nugetSources -match "nuget.org") {
+    Log "nuget.org source is configured"
+} else {
+    Warn "nuget.org not in sources. Adding..."
+    & dotnet nuget add source "https://api.nuget.org/v3/index.json" --name "nuget.org" 2>>$LogFile
+}
+
+# --- Encoding Check ---
+Step "Checking console encoding"
+
+$currentEncoding = [Console]::OutputEncoding.EncodingName
+if ($currentEncoding -match "UTF-8|Unicode") {
+    Log "Console encoding: $currentEncoding (UTF-8 compatible)"
+} else {
+    Warn "Console encoding: $currentEncoding (may cause issues with CJK text)"
+    Info "To fix: [Console]::OutputEncoding = [System.Text.Encoding]::UTF8"
+    Info "Or set system-wide: Settings > Time & Language > Language > Administrative > Change system locale > Beta: UTF-8"
+    # Apply for this session
+    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    Log "Set UTF-8 encoding for this session"
+}
+
+# --- Font Check ---
+if (-not $Minimal) {
+    Step "Checking fonts"
+
+    $fonts = [System.Drawing.FontFamily]::Families 2>$null
+    if ($fonts) {
+        $fontNames = $fonts | ForEach-Object { $_.Name }
+        $hasCalibri = $fontNames -contains "Calibri"
+        $hasTimes = $fontNames -contains "Times New Roman"
+        $hasCJK = ($fontNames | Where-Object { $_ -match "SimSun|Microsoft YaHei|MS Mincho|Malgun Gothic" }).Count -gt 0
+
+        if ($hasCalibri)   { Log "Western fonts: Calibri found" }       else { Warn "Calibri not found (install Microsoft Office or fonts)" }
+        if ($hasTimes)     { Log "Western fonts: Times New Roman found" } else { Warn "Times New Roman not found" }
+        if ($hasCJK)       { Log "CJK fonts: available" }               else { Warn "CJK fonts not found (install language packs for Chinese/Japanese/Korean)" }
+    } else {
+        Info "Cannot enumerate fonts (System.Drawing not loaded). Skipping font check."
+    }
+}
+
+# --- Build Project ---
+Step "Building minimax-docx .NET project"
+
+if (-not (Test-Path $DotnetDir)) {
+    Fail "Dotnet project directory not found: $DotnetDir"
+    exit 1
+}
+
+Push-Location $DotnetDir
+
+Info "Restoring NuGet packages..."
+$restoreResult = & dotnet restore --verbosity quiet 2>&1
+if ($LASTEXITCODE -ne 0) {
+    Fail "NuGet restore failed:"
+    $restoreResult | ForEach-Object { Fail "  $_" }
+    Fail "Common causes:"
+    Fail "  - No internet (NuGet needs to download packages)"
+    Fail "  - Corporate proxy/firewall blocking nuget.org"
+    Fail "  - Insufficient disk space"
+    Fail "Try: dotnet restore --verbosity detailed"
+    Pop-Location
+    exit 1
+}
+Log "NuGet packages restored"
+
+Info "Building project..."
+$buildResult = & dotnet build --verbosity quiet --no-restore 2>&1
+if ($LASTEXITCODE -ne 0) {
+    Fail "Build failed:"
+    $buildResult | ForEach-Object { Fail "  $_" }
+    Pop-Location
+    exit 1
+}
+Log "Project built successfully"
+
+Pop-Location
+
+# --- Verification ---
+if (-not $SkipVerify) {
+    Step "Verification Test"
+
+    $testOutput = Join-Path $env:TEMP "minimax-docx-setup-test-$PID.docx"
+
+    Info "Creating a test document..."
+    Push-Location $DotnetDir
+    $testResult = & dotnet run --project MiniMaxAIDocx.Cli -- create --type report --output $testOutput --title "Setup Test" 2>&1
+    $testExitCode = $LASTEXITCODE
+    Pop-Location
+
+    if ($testExitCode -eq 0 -and (Test-Path $testOutput)) {
+        Log "Test document created: $testOutput"
+
+        if (Get-Command pandoc -ErrorAction SilentlyContinue) {
+            $preview = & pandoc -f docx -t plain $testOutput 2>$null | Select-Object -First 3
+            if ($preview) { Log "Preview working: `"$($preview -join ' ')`"" }
+        }
+
+        Remove-Item $testOutput -Force
+        Log "Test passed - minimax-docx is ready to use!"
+    } else {
+        Fail "Test document creation failed. Output:"
+        $testResult | ForEach-Object { Fail "  $_" }
+    }
+}
+
+# --- Summary ---
+Step "Setup Complete"
+
+Write-Host ""
+Write-Host "  Environment: Windows $([System.Environment]::OSVersion.Version)"
+Write-Host "  .NET SDK:    $(dotnet --version 2>$null)"
+$pandocInfo = if (Get-Command pandoc -ErrorAction SilentlyContinue) { pandoc --version | Select-Object -First 1 } else { "not installed (optional)" }
+Write-Host "  pandoc:      $pandocInfo"
+Write-Host "  Project:     $DotnetDir"
+Write-Host ""
+Write-Host "  Usage:"
+Write-Host "    dotnet run --project $DotnetDir\MiniMaxAIDocx.Cli -- create --type report --output my_report.docx"
+Write-Host ""
+Write-Host "  Log file: $LogFile"