Document Deckstride software updates
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-11-21 12:33:07 +01:00
parent 73c4505780
commit 75cb036c7c
3 changed files with 37 additions and 28 deletions

View File

@ -57,6 +57,11 @@ user, and run:
cc update-software
```
`cc software-update` is an equivalent alias. The command shows an elapsed
spinner while its refreshed snapshot updates software. Redirected output gets a
single plain status line, and `-Json` remains machine-readable without progress
text.
This command updates Config Central and the software selected by the machine
manifest without deploying any configs. It runs operations in this order:
@ -82,27 +87,25 @@ an item failure, reports reboot requirements, and never restarts Windows. Close
a running portable application before updating it. The working version remains
available until its replacement is fully activated, then older versions are removed.
The desktop profile installs PDF Presenter and PPTX Reporter as verified portable
packages and creates per-user Start menu shortcuts under Config Central. PDF
Presenter is also registered as a per-user PDF handler, with a separate document
The desktop profile installs Deckstride and PPTX Reporter as verified portable
packages and creates per-user Start menu shortcuts under Config Central.
Deckstride is also registered as a per-user PDF handler, with a separate document
icon based on its turquoise presentation mark. After the first
`cc update-software` or full apply, open its Windows Default Apps page:
```powershell
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.pdf-presenter'
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.deckstride'
```
Select PDF Presenter for `.pdf`. On older Windows builds that open the general
Select Deckstride for `.pdf`. On older Windows builds that open the general
Default Apps page, right-click a PDF, choose **Open with → Choose another app**,
select **PDF Presenter**, and enable **Always**. Windows requires this one-time
select **Deckstride**, and enable **Always**. Windows requires this one-time
user confirmation and Config Central preserves that choice across updates.
PDF Presenter is being renamed to
[Deckstride](https://proxy.dandaedre.com/gitea/idle-org/Deckstride). The existing
PDF Presenter release remains pinned until the first Deckstride Windows release
is available and verified. The prepared migration will install Deckstride first,
then remove the managed PDF Presenter files, Start menu shortcut and old handler
registration. Windows will require one new Default Apps selection for Deckstride.
The first Deckstride update installs and verifies
[Deckstride 0.1.96](https://proxy.dandaedre.com/gitea/idle-org/Deckstride/releases/tag/v0.1.96)
before removing the managed PDF Presenter files, Start menu shortcut and old
handler registration.
Like `cc sync`, `update-software` refuses to fetch while the checkout contains
uncommitted or untracked files. It does not reset or overwrite those edits.

View File

@ -181,6 +181,7 @@ 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 # refresh cc, then update declared software
cc software-update # alias for update-software
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
@ -331,7 +332,7 @@ terminal open with the outcome in `$LASTEXITCODE`.
## Portable package updates
The desktop profile includes PDF Presenter 0.1.91 and PPTX Reporter 0.2.0 for
The desktop profile includes Deckstride 0.1.96 and PPTX Reporter 0.2.0 for
Windows x64 from their published portable releases. Their exact ZIP hashes and
executable paths were checked against each release's SHA256SUMS and artifact
manifest. The Windows binaries are unsigned; native Windows acceptance remains
@ -342,17 +343,21 @@ 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 installed software, close PDF Presenter and PPTX Reporter and run:
To update installed software, close Deckstride and PPTX Reporter and run:
```powershell
cc update-software
```
`cc software-update` runs the same command. In an interactive terminal the
outer command shows an elapsed spinner while the refreshed snapshot works.
Redirected output gets one plain start line; `-Json` suppresses progress output.
The command fetches the configured repository branch and continues from an
immutable snapshot of that commit, so the current run uses the latest Config
Central code and policy. It then checks the Gitea releases API for opted-in
portable packages and asks WinGet to apply each declared package's policy by
exact ID. PDF Presenter follows the newest eligible preview or stable release.
exact ID. Deckstride follows the newest eligible stable release.
Unmanaged WinGet applications are left alone. 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. Both tools
@ -375,38 +380,35 @@ To review and advance the deterministic repository pin:
contacting the release API or downloading it.
Default files live under
`%LOCALAPPDATA%\ConfigCentral\apps\idle-org\pdf-presenter`. `launch.ps1` is the
`%LOCALAPPDATA%\ConfigCentral\apps\idle-org\deckstride`. `launch.ps1` is the
stable terminal launcher; the Start menu shortcut under `Config Central\idle-org`
targets `pdf-presenter.exe` directly and uses its embedded icon. `current.json`
targets `deckstride.exe` directly and uses its embedded icon. `current.json`
records the active version and hashes. A successful update removes older managed
version directories. The working version remains active when download,
verification, or setup fails. Removing the profile entry does not uninstall anything.
The package also declares `displayName`, `fileAssociations`, and a dedicated
`fileAssociationIcon`, which register PDF Presenter per user as a `.pdf` handler
`fileAssociationIcon`, which register Deckstride per user as a `.pdf` handler
with Windows Default Apps. Config Central copies the icon into the stable package
root so Explorer does not depend on a versioned executable. The open command
passes the selected PDF directly to the active executable. Windows requires the
user to confirm the protected default-app choice. After applying the package,
open its settings page and select PDF Presenter for `.pdf`:
open its settings page and select Deckstride for `.pdf`:
```powershell
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.pdf-presenter'
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.deckstride'
```
Updates repair the registration to point at the new verified executable without
rewriting the user's default-app preference.
PDF Presenter is being renamed to Deckstride and moved to
`idle-org/Deckstride`. The current 0.1.91 pin remains active until a Deckstride
release with verified Windows assets is available. That release declaration will
use Deckstride's new portable identity and a `replaces` entry for
`idle-org/pdf-presenter`. On the first successful update, Config Central will
activate Deckstride before removing PDF Presenter's managed files, shortcut and
Deckstride's declaration includes a `replaces` entry for
`idle-org/pdf-presenter`. On the first successful update, Config Central
activates Deckstride before removing PDF Presenter's managed files, shortcut and
old `.pdf` registration. If the old installation was locally modified or cannot
be removed, Deckstride stays installed and cleanup is retried later. Select
Deckstride once in Windows Default Apps afterward because Windows does not allow
software to transfer the protected `.pdf` default choice to a renamed handler.
Deckstride once in Windows Default Apps because Windows does not allow software
to transfer the protected `.pdf` default choice to a renamed handler.
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

View File

@ -46,6 +46,7 @@ cc plan [-Machine NAME] [-ConfigsOnly] [-Json]
cc apply [-Machine NAME] [-ConfigsOnly] [-ForceConfigs] [-Json]
cc sync [-Machine NAME] [-ConfigsOnly] [-ForceConfigs] [-Json]
cc update-software [-Machine NAME] [-Json]
cc software-update [-Machine NAME] [-Json]
cc status [-Machine NAME] [-Json]
cc restore -Config NAME [-Machine NAME] [-Json]
cc schedule [-Machine NAME]
@ -65,6 +66,9 @@ according to its normal policy and exact ID. It never performs an unbounded
prevent independent package operations. When the snapshot run finishes, the
installed checkout advances to the same revision only when Git can fast-forward
it without discarding local work.
`software-update` is a CLI alias normalized to the same command and result name.
Interactive software updates show elapsed activity feedback; redirected human
output uses one plain status line and JSON output contains no progress text.
`schedule` registers a limited, interactive-user task at logon. Scheduled runs
always use `sync -ConfigsOnly`; package installation and upgrades remain manual