From f9993c9c03e34114f1ff1492ae4e4100dab07988 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Fri, 20 Nov 2026 08:48:29 +0100 Subject: [PATCH] Enable automatic PDF Presenter release updates --- README.md | 7 ++++--- TASKS.md | 2 +- docs/advanced_commands.md | 29 +++++++++++++++++++++++------ docs/manifest-contract.md | 10 +++++----- profiles/desktop-apps.json | 7 ++++++- 5 files changed, 39 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index da899fe..99be337 100644 --- a/README.md +++ b/README.md @@ -27,9 +27,10 @@ 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 +Start → Config Central → idle-org. Close it, then run `cc update-software` to +check for a newer upstream preview and update all declared software. Downloads +are verified against the release checksum. The config-only update below skips +software. See [portable package updates](docs/advanced_commands.md#portable-package-updates). ## 2. Use update for routine config changes diff --git a/TASKS.md b/TASKS.md index ae10992..d7188f7 100644 --- a/TASKS.md +++ b/TASKS.md @@ -157,4 +157,4 @@ open until it is run on disposable machines with the required account setups. - [x] Implement portable ZIP planning, verified staging, launchers and recovery with Linux Pester tests; keep Windows acceptance below open. - [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. -- [ ] Add `update-software` with checksum-verified Gitea release discovery and package-only execution. +- [x] Add `update-software` with checksum-verified Gitea release discovery and package-only execution; validate against the live PDF Presenter feed and run the Linux suite (155 passed, 5 Windows-only skips). diff --git a/docs/advanced_commands.md b/docs/advanced_commands.md index 68b788b..2bde318 100644 --- a/docs/advanced_commands.md +++ b/docs/advanced_commands.md @@ -180,6 +180,7 @@ populating those declarations. cc plan # show intended work; change nothing cc apply # apply the current checkout cc sync # fetch and apply an immutable remote snapshot +cc update-software # update declared software; skip all configs cc status # show drift and the last run cc sync -ConfigsOnly # fetch and deploy configs; do not call WinGet cc apply -ForceConfigs # back up local edits, then replace them @@ -341,16 +342,32 @@ 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: +To update installed software, close PDF Presenter and run: + +```powershell +cc update-software +``` + +The command asks WinGet to apply each package's declared policy and checks the +Gitea releases API for opted-in portable packages. PDF Presenter follows the +newest eligible preview or stable release. Configs are not planned or changed. +Each release lookup resolves one exact ZIP, reads its exact entry from +`SHA256SUMS`, and verifies the downloaded archive before activation. A lookup or +checksum failure is reported for that package while independent packages +continue. The command uses the current checkout; use `cc sync` first when you +also need newer repository policy. + +To review and advance the deterministic repository pin: 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. + `profiles/desktop-apps.json`. Use the version-specific download URL. These + fields remain the reviewed fallback used by `apply` and `sync`; only the + explicit `update-software` command follows the configured release channel. +3. Commit and push the change. `cc sync` applies that pin on each desktop. Use + `cc apply` for an updated local checkout; `cc plan` previews the pin without + contacting the release API or downloading it. Default files live under `%LOCALAPPDATA%\ConfigCentral\apps\idle-org\pdf-presenter`. `launch.ps1` is the diff --git a/docs/manifest-contract.md b/docs/manifest-contract.md index 480f005..f932abb 100644 --- a/docs/manifest-contract.md +++ b/docs/manifest-contract.md @@ -84,7 +84,7 @@ Enabled portable entries require `version` (numeric dotted version), `url` (HTTPS ZIP), `sha256` (64 hex digits), `executable` (relative forward-slash path inside the ZIP ending in .exe), and `update: "pinned"` or `"install-only"`. Only user scope and Windows x64 are supported initially. No installer commands, -script hooks, automatic release discovery, or elevation are supported. +script hooks, or elevation are supported. Installations live under `/apps//`, normally under `%LOCALAPPDATA%/ConfigCentral`. Each successful install has its own version @@ -104,10 +104,10 @@ installs. A newer installed version is left alone with a warning. Changing the archive hash without changing its version is rejected. Removing the manifest entry does not remove files or shortcuts. Config-only runs skip these packages. -To update, review a release, verify its archive against the publisher's checksum, -and commit its version, exact URL, SHA-256 and executable path together. The next -full sync applies that version. Pinning a preview release is explicit consent to -that release, not permission to follow future prereleases automatically. +To update the deterministic pin, review a release, verify its archive against the +publisher's checksum, and commit its version, exact URL, SHA-256 and executable +path together. The next full sync applies that version. A release channel only +affects the explicit `update-software` command. Portable packages can opt into release discovery for `update-software` with `releaseApi`, `releaseChannel`, `assetTemplate`, `executableTemplate`, and an diff --git a/profiles/desktop-apps.json b/profiles/desktop-apps.json index a2f6f47..e00aabc 100644 --- a/profiles/desktop-apps.json +++ b/profiles/desktop-apps.json @@ -13,7 +13,12 @@ "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" + "executable": "pdf-presenter-portable-x86_64-pc-windows-gnu-v0.1.33/pdf-presenter.exe", + "releaseApi": "https://proxy.dandaedre.com/gitea/api/v1/repos/idle-org/pdf-presenter/releases", + "releaseChannel": "prerelease", + "assetTemplate": "pdf-presenter-portable-x86_64-pc-windows-gnu-v{version}.zip", + "executableTemplate": "pdf-presenter-portable-x86_64-pc-windows-gnu-v{version}/pdf-presenter.exe", + "checksumAsset": "SHA256SUMS" }, { "id": "clsid2.mpc-hc", "source": "winget", "scope": "machine", "update": "latest" }, { "id": "XnSoft.XnViewMP", "source": "winget", "scope": "machine", "update": "latest" },