From c1138643894b7f14d86b7423406989934e69c8cb Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Fri, 20 Nov 2026 08:20:26 +0100 Subject: [PATCH] Add verified PDF Presenter portable release to desktop apps --- README.md | 7 ++++++ TASKS.md | 2 +- docs/advanced_commands.md | 45 ++++++++++++++++++++++++++++++++++++++ profiles/desktop-apps.json | 11 ++++++++++ tests/Manifest.Tests.ps1 | 6 ++++- 5 files changed, 69 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 366f2b4..da899fe 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,13 @@ add software to the install list, or when you need to repair setup. Requires Windows 10 1809 or newer, Windows 11, or Windows Server 2025, with internet access and support for WinGet. +The desktop profile also installs PDF Presenter as a verified portable package +on Windows x64, pinned to preview version 0.1.33. Launch `pdf-presenter` from +Start → Config Central → idle-org. Close it before running install or `cc sync` +to update software; the config-only update below skips it. Future PDF Presenter +updates require a reviewed version/checksum change in the profile. See +[portable package updates](docs/advanced_commands.md#portable-package-updates). + ## 2. Use update for routine config changes Close the applications whose settings you are updating, then paste into diff --git a/TASKS.md b/TASKS.md index 77edd8d..57ac554 100644 --- a/TASKS.md +++ b/TASKS.md @@ -155,5 +155,5 @@ open until it is run on disposable machines with the required account setups. - [x] Document portable package identity, pinning, storage and recovery semantics. - [x] Validate and resolve portable package declarations alongside WinGet (17 Linux Pester tests pass). - [x] Implement portable ZIP planning, verified staging, launchers and recovery with Linux Pester tests; keep Windows acceptance below open. -- [ ] Add the verified PDF Presenter release to the desktop profile and document updates. +- [x] Add the verified PDF Presenter 0.1.33 release to the desktop profile and document updates; validate archive/executable hashes and run the Linux suite (136 passed, 5 Windows-only skips). - [ ] Validate portable installation, Start menu launch and running-app handling on disposable Windows x64. diff --git a/docs/advanced_commands.md b/docs/advanced_commands.md index 56f663b..68b788b 100644 --- a/docs/advanced_commands.md +++ b/docs/advanced_commands.md @@ -327,3 +327,48 @@ actions. Redirected output and JSON remain plain. Set `$env:NO_COLOR = "1"` to disable colors in a terminal. Errors go to stderr; JSON errors stay structured. Runtime failures preserve nonzero status codes, and web commands leave the terminal open with the outcome in `$LASTEXITCODE`. + +## Portable package updates + +The desktop profile includes PDF Presenter 0.1.33 for Windows x64 from the +[upstream preview release](https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases/tag/v0.1.33). +Its ZIP and executable were checked against the published SHA256SUMS. Upstream +marks this release as a preview with unsigned Windows binaries; native Windows +acceptance remains pending here too. + +Portable packages use `provider: "portable"`, user scope and a version pinned in +Git. `source` is a namespace (here `idle-org`), not a WinGet source. They appear +alongside WinGet packages in `cc plan`, `cc status`, `cc apply` and full `cc sync`. +Config-only commands and the scheduled config sync leave software alone. + +To update PDF Presenter: + +1. Select and review an upstream release, download its Windows portable ZIP, + and compare `Get-FileHash -Algorithm SHA256` with its published SHA256SUMS. +2. Update `version`, `url`, `sha256` and `executable` together in + `profiles/desktop-apps.json`. Use the version-specific download URL. No release + discovery or automatic prerelease tracking occurs on clients. +3. Commit and push the change. On each desktop, close PDF Presenter and run + `cc sync` (or rerun the web installer). Use `cc apply` for an updated local + checkout; `cc plan` previews the selected version without downloading it. + +Default files live under +`%LOCALAPPDATA%\ConfigCentral\apps\idle-org\pdf-presenter`. `launch.ps1` is the +stable launcher; the Start menu shortcut is under `Config Central\idle-org`. +`current.json` records the active version and hashes. Older version directories +are retained, and removing the profile entry does not uninstall anything. + +On a failed download, checksum check or setup step, fix the reported cause and +retry. Missing managed files are repaired. Locally changed binaries or launchers +are conflicts: inspect and save those changes elsewhere, then remove the affected +file to let the next apply repair it. `-ForceConfigs` does not override portable +package conflicts. Never change the hash of an existing release to bypass a +checksum mismatch. Persistent application settings must live outside the version +directory; extra files in an older version are preserved but are not migrated. + +Linux Pester tests cover archive validation, hash verification, partial failure, +retry, version policies, conflict handling, launcher errors and elevation +rejection. Disposable Windows x64 acceptance still needs to verify first install, +Start menu launch, a no-change rerun, running-app refusal, and an upgrade with +settings preserved. Run the controller as the desktop user, not as a separate +administrator account. diff --git a/profiles/desktop-apps.json b/profiles/desktop-apps.json index 861cc8d..a2f6f47 100644 --- a/profiles/desktop-apps.json +++ b/profiles/desktop-apps.json @@ -4,6 +4,17 @@ "name": "desktop-apps", "description": "Desktop productivity, communication, creative, media, and file synchronization applications.", "packages": [ + { + "id": "pdf-presenter", + "provider": "portable", + "source": "idle-org", + "scope": "user", + "update": "pinned", + "version": "0.1.33", + "url": "https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases/download/v0.1.33/pdf-presenter-portable-x86_64-pc-windows-gnu-v0.1.33.zip", + "sha256": "78d6129e429448c0f0559a516c023ab5c4bc8e61137cb3390322796bef66382c", + "executable": "pdf-presenter-portable-x86_64-pc-windows-gnu-v0.1.33/pdf-presenter.exe" + }, { "id": "clsid2.mpc-hc", "source": "winget", "scope": "machine", "update": "latest" }, { "id": "XnSoft.XnViewMP", "source": "winget", "scope": "machine", "update": "latest" }, { "id": "Zoom.Zoom", "source": "winget", "scope": "machine", "update": "latest" }, diff --git a/tests/Manifest.Tests.ps1 b/tests/Manifest.Tests.ps1 index 6d32a98..fd9a756 100644 --- a/tests/Manifest.Tests.ps1 +++ b/tests/Manifest.Tests.ps1 @@ -5,7 +5,7 @@ BeforeAll { Describe 'Manifest resolution' { It 'resolves the checked-in example in profile order' { $result = Resolve-MachineManifest -RepositoryRoot "$PSScriptRoot/.." -Machine 'beffroi-laptop' - $result.packages.Count | Should -Be 14 + $result.packages.Count | Should -Be 15 $result.configs.Count | Should -Be 9 $result.packages[0].id | Should -Be 'Git.Git' $result.packages.id | Should -Contain 'XnSoft.XnViewMP' @@ -19,6 +19,10 @@ Describe 'Manifest resolution' { $result.packages.id | Should -Contain 'Waterfox.Waterfox' $result.packages.id | Should -Contain 'Meltytech.Shotcut' $result.packages.id | Should -Contain 'clsid2.mpc-hc' + $presenter = $result.packages | Where-Object id -eq 'pdf-presenter' + $presenter.provider | Should -Be 'portable' + $presenter.scope | Should -Be 'user' + $presenter.update | Should -Be 'pinned' $result.packages.id | Should -Not -Contain 'cpvalente.ontime' }