@puddle-code/cli 0.0.13 → 0.0.14

package/CHANGELOG.md

@@ -7,14 +7,53 @@ Past releases: see docs/changelogs/.
 
 # Changelog
 
-## [0.0.13] — 2026-07-28
+## [0.0.14] — 2026-07-28
 
-### Changed
+### Added
 
-- Desktop (macOS): the native title bar is gone — the cockpit's own top bar (host, ⌘K field, settings, scratchpad, profile) doubles as a taller drag-region title bar with the traffic lights inlaid.
-- The window/tab title now names the project and the machine (host display-name customisation first, then hostname) instead of the literal "puddle".
-- Desktop: copyright credits Yiding Song (About panel / bundle metadata); the package is `@puddle-code/desktop`.
+- Desktop self-update, no code signing required: the app polls GitHub
+  releases, downloads and SHA256SUMS-verifies the new build into
+  `~/.puddle/cache/desktop/`, and offers a "Restart to update" banner; a
+  detached helper swaps the install after quit and relaunches (SPEC §10 —
+  the CLI-style alternative to Squirrel, which refuses unsigned bundles).
+  The helper strips `com.apple.quarantine` from the swapped bundle as
+  defence in depth, and a Linux AppImage updates in place at `$APPIMAGE`,
+  wherever the user keeps it.
+- `puddle upgrade` now names its subject: `puddle upgrade daemon [user@host]`
+  (the previous behaviour), `puddle upgrade cli` (npm under the hood), and
+  `puddle upgrade desktop` (the app's update pipeline, run while the app is
+  closed). `cli`/`desktop` refuse remote targets — only the daemon lives on
+  remote hosts.
 
 ### Fixed
 
-- Desktop (macOS): the app icon no longer sits on a white plate on macOS 26 — the icns now ships full-bleed artwork (`build/icon-mac.svg`) and the OS applies its own squircle mask; Linux keeps the self-rounded `icon.svg`.
+- Battery: the file explorer no longer pins a CPU core for as long as it is
+  mounted. Its query-cache subscription reacted to *observer* events — which
+  fire during React renders themselves — so every workspace window sat in a
+  permanent render → cache-event → re-render loop (the "Puddle is using
+  significant energy" report). The subscription now only reacts to query-state
+  events (data landing, cache add/remove). Measured on an idle workspace
+  (file tree + attached terminal): 83–112% CPU per window before, 0–1.2%
+  after; whole app now idles at ~1–2% of one core total, below macOS's
+  significant-energy threshold. Full write-up with methodology in
+  `docs/reports/2026-07-28-explorer-render-loop.md`.
+
+### Changed
+
+- `puddle start` and `puddle connect` are unified into
+  `puddle launch [local | user@host]` — no target means local, and every flag
+  from both verbs (`--port`, `--prefer-port`, `--remote-port`, `--no-browser`,
+  `--no-upgrade`, `--tarball`, `--foreground`) rides along. The old verbs
+  error with the exact replacement.
+- Desktop: new windows no longer default to local. Launching the app, ⌘N,
+  Window → New Window, and the macOS dock icon's right-click New Window all
+  open a host picker — "This machine" on top, then recent hosts, then
+  "Other SSH host…" — and nothing connects until you pick.
+- Desktop: recent hosts moved from the app's userData dir to
+  `~/.puddle/recent-hosts.json` (migrated automatically), so they survive
+  app updates and reinstalls.
+- Desktop (macOS): the merged title bar is a little slimmer (44 → 40px, traffic
+  lights re-centred), so the workspace chrome sits closer to the lights.
+
+- Light theme: exited/idle status dots are neutral grey instead of warm bark brown (matching the 2026-07-16 muted-text re-grey; dark theme was already grey).
+- Desktop (macOS): more breathing room between the traffic lights and the host name in the merged title bar.

package/README.md

@@ -6,7 +6,7 @@
 Puddle is an open-source, multi-account coding agent orchestrator with first-class SSH support and a lightweight GUI. With a single command,
 
 ```bash
-puddle connect <user>@<host>
+puddle launch <user>@<host>
 ```
 
 Puddle manages parallel agents anywhere you SSH into, insulates agents in dedicated worktrees, and keeps your agents alive across disconnects and restarts.
@@ -22,7 +22,7 @@ npm install -g @puddle-code/cli
 **To launch agents on a remote host:**
 
 ```sh
-puddle connect <user>@<host>
+puddle launch <user>@<host>
 ```
 
 This connects Puddle to the remote host over SSH, bootstrapping the Puddle daemon on first contact and enabling you to begin development.
@@ -32,7 +32,7 @@ Puddle works using your system `ssh`, so `~/.ssh/config`, agents, and jump hosts
 **For development on your own machine:**
 
 ```sh
-puddle start
+puddle launch
 ```
 
 This installs the Puddle daemon under `~/.puddle` and serves the GUI at `http://localhost:7433`.
@@ -106,7 +106,7 @@ systemctl --user disable --now puddled              # Linux (systemd user unit)
 kill "$(cat ~/.puddle/puddled.pid)"                 # nohup fallback (no supervisor)
 ```
 
-**Restore the production daemon.** When you're done testing, put the release build back over your dev one: stop the daemon (above), clear the installed binaries with `rm -rf ~/.puddle/bin` (your `~/.puddle` state — profiles, sessions, worktrees — is untouched), then run the production `puddle start`, which refetches the daemon from GitHub Releases. (Clearing `bin` is what forces the refetch: the installer skips a version whose files are already present, so a dev build sharing the release's version number would otherwise stay put.)
+**Restore the production daemon.** When you're done testing, put the release build back over your dev one: stop the daemon (above), clear the installed binaries with `rm -rf ~/.puddle/bin` (your `~/.puddle` state — profiles, sessions, worktrees — is untouched), then run the production `puddle launch`, which refetches the daemon from GitHub Releases. (Clearing `bin` is what forces the refetch: the installer skips a version whose files are already present, so a dev build sharing the release's version number would otherwise stay put.)
 
 **Uninstall.** Removing the CLI alone leaves the daemon installed and running — a full teardown stops the daemon, then removes its state, its service file, and the production CLI: