Skip to content

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.

Merge remote-tracking branch 'origin/main' into fix/triage-709-20260923

review6f3a47da180e
diff --cc CONTRIBUTING.md
index 1d28afd8e,a2fd848e4..b148379dc
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@@ -56,15 -56,14 +56,23 @@@ handler needs something only Electron h
**injected dep** whose absence is a documented degrade — see `registerTranscriptIpc` /
`registerContextEnsureIpc` — rather than a reason to keep the whole handler in `src/main`.
+Context-link maps authorize reads. Publish changes to edges, linked metadata, and background
+projects independently of canvas geometry updates; a debounce reset by every node render can
+starve publication indefinitely. Only merge projects owned by the same core, and use the rendered
+canvas's project epoch during tab switches. Core must revoke removed links before asynchronous
+transcript discovery or debug-file writes finish; an older write must never restore that access.
+Coalesce renderer updates before building the workspace map, without resetting the scheduled task.
+Intermediate publications retain resolved transcript paths only for unchanged identities; changing
+a session/account/location/hook path or removing the target invalidates that cache immediately.
+
+ 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.
+ Update preparation must keep saved canvas nodes: exit programs normally, quit, then have the user
+ verify and stop any remaining host. Never recommend **End session** (it deletes nodes). Cold agent
+ resume depends on supported, saved conversation history; it does not preserve running tasks.
+ See `docs/windows-session-host.md` for the user-controlled preparation/recovery steps and limits.
+
## Three surfaces
A feature is not done until you have decided how it behaves on each — even if the decision is "not