From c30d94d4cd58efff75f993267bbd30e0d00d44e1 Mon Sep 17 00:00:00 2001
From: flamerged <34665379+flamerged@users.noreply.github.com>
Date: Sat, 2 May 2026 01:25:39 +0200
Subject: [PATCH] docs: extend roadmap with context-aware routing + audit
 follow-ups
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds 8 user-facing items surfaced by the latest review. Internal
refactor items (monitor.ts split, mutable-state encapsulation,
graceful-shutdown void-no-catch, etc.) live in project memory rather
than the README — those are housekeeping, not user direction.

The biggest item (context-aware clipboard routing on macOS) is hoisted
to the top of the list since it's the actual UX north star;
pause/resume from v0.8.0 is the short-term workaround.

chore-tier — `docs:` doesn't trigger a release per .releaserc.json.
---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index 97fdb3b..cc8bd0e 100644
--- a/README.md
+++ b/README.md
@@ -176,6 +176,14 @@ You'd still need a server to receive uploads, and AI agents running over SSH don
 
 ## Roadmap
 
+- [ ] **Context-aware clipboard routing** (macOS first) — replace clipboard with the remote path only when the foreground app is a terminal-ish thing (Terminal/iTerm2/Warp/Ghostty/Zed/VS Code/etc.). For Slack/GitHub/iMessage screenshots the image bytes stay on the clipboard. `pause`/`resume` is the short-term workaround.
+- [ ] Retry on SSH failure with exponential backoff — currently a failed upload silently drops the screenshot
+- [ ] System notification on upload success / failure (`osascript -e 'display notification'` on macOS, `notify-send` on Linux) so the daemon's status is visible without tailing logs
+- [ ] `sshshot last` / `sshshot history` — show the most recent N uploads with timestamps + remote paths
+- [ ] `sshshot open` — open the most recent screenshot in the system image viewer
+- [ ] Optional `pngquant` / `optipng` compression passthrough before upload — 80–90 % size reduction for similar visual quality, big win on slow links
+- [ ] Configurable remote upload directory (currently hardcoded to `~/sshshot-screenshots/`); same for the `local` mode directory
+- [ ] mtime-vs-daemon-start gate so a Screenshot-named file copied into the watch dir (restored from backup, `cp`'d in, etc.) isn't mistakenly uploaded as a fresh screenshot
 - [ ] Record macOS demo gif (current `demo-windows.gif` is the upstream Windows/PowerShell flow)
 - [ ] Record Linux X11 / Wayland demo gif
 - [ ] Optional inline image paste (instead of path) for tools that accept multipart pastes — future ergonomic win