wndrks

AGENTS.md

@@ -0,0 +1,32 @@
+# Repository Instructions
+
+## MSIX publish after user approval
+
+When the user says a completed change is approved and asks to publish, deploy,
+patch, or update the MSIX, use the automated NAS publish script instead of
+manually editing package versions or copying files.
+
+Normal approved publish command:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\tools\msix\Publish-MsixToNas.ps1 -Configuration Release -IncrementPackageRevision
+```
+
+Prerequisites:
+
+- `NAS_USER` must be set to the NAS account with write access to `/volume1/web/msix`.
+- `NAS_SSH_KEY` should point to the SSH private key for that NAS account.
+- The signing certificate thumbprint must remain
+  `E691A33C64DF20A204FFD4F096B9C3EB4B95709C`.
+
+The script will:
+
+1. Read `Tornado3_2026Election/Package.appxmanifest`.
+2. Increment the fourth package version part.
+3. Build and sign the MSIX package.
+4. Rewrite App Installer URLs to the public NAS path.
+5. Upload the files to the NAS over SSH/SCP.
+6. Verify the public URLs after upload.
+
+Do not run this publish command unless the user has explicitly approved
+publishing or deployment.