Enable automatic PDF Presenter release updates
Config Central CI Config Central failed CI.
Beffroi/config-central/pipeline/head There was a failure building this commit Details

This commit is contained in:
Dandaedre 2026-11-20 08:48:29 +01:00
parent a7a84db872
commit f9993c9c03
5 changed files with 39 additions and 16 deletions

View File

@ -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

View File

@ -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).

View File

@ -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

View File

@ -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 `<DataRoot>/apps/<source>/<id>`, 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

View File

@ -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" },