Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
docs(windows): document the passive update notice for the unsigned beta
review0d79e4088a22
diff --git a/CLAUDE.md b/CLAUDE.mdindex 640506558..3d49f566c 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -9150,11 +9150,17 @@ Squirrel was not adopted. Builds are **unsigned** (no Windows cert; electron-buisigning when no cert env is present; SmartScreen warns on install). Release wiring is`release.yml`'s `release-win` job: on every version tag it uploads the NSIS installer + zip asGitHub Release assets — **best-effort by design** (the `publish` promote gate does not wait on-it, so a Windows failure never strands the mac+linux release) and with **no update-feed leg**:-`dist:win` stamps `nodeTermUpdates=disabled`, so the shipped app's updater is cleanly off (no-latest.yml anywhere, no 404 polling; users update by downloading the next installer). Do not-add `*.yml`/`*.blockmap` to that job's upload globs — that IS the auto-update leg, and it waits-on signing. `bootstrap-windows.bat` (repo root) takes a fresh Windows+it, so a Windows failure never strands the mac+linux release) and with a **passive notice feed+only**: it builds `dist:win:release`, which stamps `nodeTermUpdates=manual` →+`updateDelivery` = `manual-install` (the marker wins over the platform), and uploads `latest.yml`+beside the installer + zip. The app checks the feed and shows the same "vX is available —+Download" card a Linux .deb gets; it never downloads, never installs on quit, and main refuses+`appRestartToUpdate` for any build that is not `self-install`/`dev` (`mayQuitAndInstall`), so+`quitAndInstall` cannot run on the unsigned beta whatever the renderer sends. Local `dist:win`+keeps `disabled` (never polls). Do not add `*.blockmap` (or a broad `*.yml`) to that job's+upload globs — differential downloads are the self-install leg, and it waits on signing; guarded+by `src/main/release-win-workflow.test.ts`. The nodeterm.dev/updates mirror serving `latest.yml`+lives outside this repo. `bootstrap-windows.bat` (repo root) takes a fresh Windowsmachine to a built checkout: it verifies Node ≥ 20 / VS Build Tools C++ / Python 3 with exactwinget hints (it never installs machine-wide tools itself, and the full bootstrap refuses to runelevated) and runs `npm ci`. Its `--check-vs-build-tools` mode is the narrow exception used by@@ -9236,9 +9242,9 @@ of a version). Rules a refactor must not undo:(protocol v1/v2 + `hello` features); an unsupported one is left running and reported(`SessionHostProtocolCompatibilityError`), never killed. ~250 MB of disk per staged version.-**Follow-ups, in order:** code signing, then Windows auto-update wiring (electron-updater NSIS leg-+ `latest.yml` on the nodeterm.dev feed — blocked on signing: an unsigned auto-update is a-downgrade in trust), and the fork's PE-identity polish (electron-builder leaves `OriginalFilename`+**Follow-ups, in order:** code signing, then Windows self-install (drop the `manual` marker from+`dist:win:release` and upload blockmaps — blocked on signing: an unsigned auto-update is a+downgrade in trust; the passive notice already ships), and the fork's PE-identity polish (electron-builder leaves `OriginalFilename`empty; the fork's`resedit`-based afterSign hook fixes it — cosmetic for NSIS, load-bearing only for Squirrel).diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex d258adf6a..19ad98089 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -85,6 +85,11 @@ Coalesce renderer updates before building the workspace map, without resetting tIntermediate publications retain resolved transcript paths only for unchanged identities; changinga session/account/location/hook path or removing the target invalidates that cache immediately.+Windows updates (unsigned beta): `release-win` builds `dist:win:release` (`nodeTermUpdates=manual`)+and uploads `latest.yml`, so the app shows a passive "new version — Download" card; it never+downloads or installs, and main refuses restart-to-update for any non-self-installing build.+Keep local `dist:win` on `disabled`, and never upload Windows `*.blockmap`s until signing lands.+Windows installer safety (#829): `build/installer.nsh` overrides NSIS's process-killing check.A running app or session host blocks install/uninstall, and a failed process query blocks too.Never restore automatic host termination: quitting the app preserves those live sessions.diff --git a/README.md b/README.mdindex 218cf58e7..47d70e483 100644--- a/README.md+++ b/README.md@@ -216,7 +216,7 @@ detects your platform. Everything is also listed at- **Windows (x64) — beta** — `nodeterm-Setup-<version>.exe` (per-user installer) or aportable `-win.zip`. Early support, so know what you are getting: the installer is**unsigned** (SmartScreen will ask — *More info → Run anyway*), **updates are manual**- for now (grab the next build from the same page), and **session continuity across+ for now (the app tells you when a new version is out and links the download), and **session continuity acrossrestarts is still landing** — Windows has no tmux, so the standalone session host thatreplaces it is being packaged in [#579](https://github.com/eneskirca/nodeterm/pull/579).Everything else — canvas, agents, kanban, hooks — is the same app. Please