From 75cb036c7cda78afc32645940c506b2ddc871d9a Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sat, 21 Nov 2026 12:33:07 +0100 Subject: [PATCH] Document Deckstride software updates --- README.md | 27 +++++++++++++++------------ docs/advanced_commands.md | 34 ++++++++++++++++++---------------- docs/manifest-contract.md | 4 ++++ 3 files changed, 37 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 9195884..702174a 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/docs/advanced_commands.md b/docs/advanced_commands.md index 2defacb..770af4a 100644 --- a/docs/advanced_commands.md +++ b/docs/advanced_commands.md @@ -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 diff --git a/docs/manifest-contract.md b/docs/manifest-contract.md index 9f9bac9..043fa0d 100644 --- a/docs/manifest-contract.md +++ b/docs/manifest-contract.md @@ -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