Repository navigation
Description
Backlog and execution order: #58.
Priority: P1 · Updated 2026-10-26. Installation delivery umbrella, coordinated with #17.
Implemented
- Sole executable
spn/spn.exe; centralized naming and no old-name alias (Prepare spn beta with persistent sessions and verified release drafts #21). - Single-file self-contained bundles with embedded docs/licenses and validated format-2 manifests (Add single-file bundles and per-user installation with optional PATH #22).
- Per-user install/preview/status, optional user PATH, conflict detection and owned uninstall (Add single-file bundles and per-user installation with optional PATH #22).
- Native Windows/Linux/macOS install/PATH/update/rollback tests, spaces/Unicode and new-terminal execution after deleting source Downloads (Add single-file bundles and per-user installation with optional PATH #22).
- Stable absolute installed executable defaults for new hooks/host; credentials/configuration/IPC identities preserved.
- Published beta.1 and beta.2; maintainer reports beta.2 local retest looks good (2026-10-26).
- Persistent application preferences and Home output/host context (Persist defaults and improve Home and form recovery #24; newer than published beta.2).
Remaining delivery
- Add previewable repair of managed integration executable paths #30 — Reviewable repair of existing managed hooks: show old/new paths, backups, ownership/edit checks, no duplicates or trust changes (P1).
- Guide first-run installation, output setup and first state delivery #31 — First-run installed/portable journey, optional PATH, pairing/output setup and stable installation before hook registration (P1).
- Add explicit user-data cleanup choices to managed uninstall #56 — Explicit optional settings/profile/cache/credential removal choices; current uninstall retains data by default (P2).
- Release acceptance and updater hardening #10 — Remaining release/native architecture/public-updater acceptance and data-preservation hardening.
- Record the existing user's complete stop/install/hook-repair/restart/phone-link-preservation journey after Add previewable repair of managed integration executable paths #30/Guide first-run installation, output setup and first state delivery #31; retain remaining actual Windows Terminal acceptance in Terminal accessibility and scripting acceptance #7.
Constraints
The product and namespace remain SidePulse.NET. Do not reset protected links, configuration paths, provider ownership filenames or IPC identity merely to rename the executable. No old-command compatibility shim is required.
Use only current-user installation/PATH by default, preserve unrelated PATH/profile entries, and keep portable mode supported. Hooks reference the stable absolute executable, not transient extraction/staging/Downloads paths. Moving a portable executable requires explicit repair.
Repair must preserve unrelated provider settings, exact backups and manual edits. Stop the host cleanly when binaries/paths change and expose recoverable partial failures. Never delete arbitrary Downloads or user files.
Beta.1 uses format-1 directory packages; its updater cannot install format 2. The documented beta.1-to-beta.2 transition is manual using the new executable. Format-2 releases retain manifests, ownership/hash checks, startup probes and rollback. Binary uninstall retains settings/credentials/user files unless a future separately selected cleanup explicitly removes owned data.
Evidence: #21, #22, #24 and their native CI. Full criteria are coordinated by #17; a published beta and native CI are not a complete physical hardware/provider acceptance matrix.
Activity
[-]Rename the CLI to spn and support optional per-user PATH installation[/-][+]Installation and hook migration: finish first-run and repair[/+]