The folder sidecar was written as a whole document with no concurrency
control, and any read failure silently degraded to an empty document, so a
later edit could erase every workspace's folder configuration. Rework the
read/write path end to end:
- Agent side: expose a content revision, require If-Match on PUT, answer
409 with the current document, serialise read-compare-write, and fail the
GET loudly instead of serving an empty overlay. Unknown schema versions
are reported and never downgraded back to v1.
- Client: load/save report failure instead of fabricating an empty
document, edits go through one serial queue with optimistic update,
rollback on error, and reload on conflict. Editing is blocked while the
overlay cannot be read. Creating a workspace is compensated when the
follow-up save fails, so no orphan workspace is left behind.
- Paths: normalise NFC and lexically fold "." and "..", decide
absoluteness by spelling instead of process.platform, share one
implementation between core and host, and keep an existing root when a
member is re-registered at the same path.
- Remote folders: resolve the owner root from the SSH probe instead of the
"~" alias, and make "subfolder of this project" versus "register a new
cloud workspace" an explicit choice in the dialog.
- Stop shipping the client source map, which embedded the full TypeScript
sources in the published package.
- Track the SSH integration plan and cover the new behaviour with tests
(CAS, persistence, remote path parsing).
Verification: both tsconfigs typecheck clean, 288 tests pass, build
succeeds, and all three ad-hoc verifiers pass.
remote-ssh resolves a session's remote side by reading .remote-ssh.json at the session cwd and never walks up, so a session started in <mirror>/sub silently fell back to a local terminal. The folders route gained POST, which stamps the workspace's connection record into the new subfolder with remotePath adjusted to the matching remote directory; remote-ssh always excludes that file from sync. The client asks for the stamp right after adding such a folder.
@zhangfengshun/dsh-remote-ssh registers a remote workspace as an ordinary workspace whose directory is a local mirror of the remote root. The folder picker would have accepted any local directory for such a project, and sessions started there would never sync. The host now reports the mirror base alongside the overlay, the dialog swaps the picker for a relative-path field for mirror-backed projects, and joinSubpath refuses absolute input and .. escapes so a typo cannot leave the mirror.
A DSH workspace owns exactly one canonical directory, so the folder layer is a plugin-side overlay instead of a core change: \/workspace-groups.folders.json stores extra folders and the chosen root per workspace id (strict on write, tolerant on read). The tree gains a folder row only when a project actually has extras, and sessions are partitioned by their recorded cwd with the most specific folder winning. A folder row can start a session in its own directory through sessions.create({workspaceId, cwd}); the base folder keeps the platform gesture so repeated clicks reuse the blank session. Folders start expanded so attaching one never hides rows that were already visible.
The dashed ghost route, the grown stroke and the dot on every row read as a stray black line down the sidebar, and depth is already carried by the 16px indent step. FlowerBranch now measures rows as before but renders just the bloom on the active row (spinning while that session works); the stroke and dot CSS is gone. branch.ts keeps computing the full geometry and stays unit-tested, so the stem can come back without re-deriving it.
Tab strip: pinned block, drag reorder with cross-boundary pin flip, middle-click close, double-click tab rename (never rewrites the session), context menu (close / others / right / pin / rename), responsive overflow; persistence v2 keeps pinned+title and still reads v1.
Sidebar: per-group colour and icon (20 presets or 1-4 char glyph) plus pinning, stored in the manual overlay 'appearance' map with strict-write/tolerant-read validation; animated group folding with the flower-branch overlay suppressed while rows move.
Tests: pure-logic suites for tabs, appearance partition and overlay parsing; verified by tools/verify-tabs.mjs and tools/verify-appearance.mjs (vitest cannot spawn in this sandbox).