Skip to content

Installation and hook migration: finish first-run and repair #18

Open

Description

@Anheledir

Backlog and execution order: #58.

Priority: P1 · Updated 2026-10-26. Installation delivery umbrella, coordinated with #17.

Implemented

Remaining delivery

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

  1. added
    enhancementNew feature or request
    P1Next delivery: usability, installation and release blockers
    on Oct 24, 2026
  2. changed the title [-]Rename the CLI to spn and support optional per-user PATH installation[/-] [+]Installation and hook migration: finish first-run and repair[/+] on Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1Next delivery: usability, installation and release blockersenhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions