Files
freno-dev/marketing/drafts/remote-ssh/rationale.md
Michael Freno 4e412ede8e site: restore scoped one-click remote setup
[gpt-6.1-sol] A blanket restriction on remote claims hid the working setup flow for Tailscale and authorized known hosts and left the opening grid unbalanced. Restore the host-labelled session card and setup demo, and make the copy safeguards reflect the supported scope rather than deny the feature.

Tests: 4 restoration checks fail without the fix; 38 Nook tests pass; bun run build; Playwright at 1440/768/375px in both themes

NOOK-1038
2026-11-09 10:40:19 -05:00

1.5 KiB

Remote setup marketing decision

[gpt-6.1-sol] NOOK-1038 supersedes the blanket hold. Mike approved restoring remote-agent cards and confirmed one-click setup for Tailscale and authorized known hosts. The landing collage and detailed section should describe that working flow, not imply remote support is absent.

Why it was removed

[gpt-6.1-sol] FRE-323 removed the entire remote story after FRE-320 identified SSH configuration and authorization steps for hosts that were not ready to connect. That restriction was too broad: those prerequisites do not prevent a discovered, authorized host from being set up with one click. The historical unqualified copy remains in copy.md so the change in scope is explicit.

Current evidence and scope

[gpt-6.1-sol] RemoteHostCatalog.discover reads SSH config and Tailscale peers. RemoteHostsController.setUp binds the bridge and calls RemoteMirror.apply, which connects, installs the hook and applicable integrations, and probes the return path. The existing RemoteHostsControllerLiveTests.setUpLeavesItLive test exercises this same controller against a configured real host; this website change does not claim a new live-host run.

[gpt-6.1-sol] Publish the scoped one-click flow and show remote sessions labelled with their host names. Do not replace it with a “manual setup only” disclaimer. Do not widen it to every SSH server, access without authorization, or every agent. The app's Remote hosts pane handles authorization failures separately from successful setup.