dsh-multi-root-explorer

LIMITATIONS

Known limitations

- **Automated tests are contract tests, not live acceptance.** They use mocks and never touch your real sessions. Named-but-unsent sessions across a fresh Host process, native visibility right after uninstall, and popover placement at unusual zoom levels still need checking on your build. Do not force-close a running profile to test persistence. - **Promoting a drop into a reference uses an undocumented interface.** The editor inserts `text/plain` as plain text, and a reference chip can only be minted by the input pipeline when a completion candidate is picked, so the plugin asks that pipeline for the pick its own gesture would have made, after the text has landed. Every step is feature-detected, and a step that no longer matches leaves the readable reference text in place — the drag's original behaviour. **A DSH upgrade that renames those internals silently disables the promotion**; `lib/client.js` marks the exact fields it depends on with an `ADAPTATION POINT` comment so adapting is quick. - **Selecting a folder costs one Host read.** The resource tree is paginated and lazy, while selecting a parent has to cover all of its children, so a click reads that directory's own level from the Host on demand (paging to the end) rather than trusting what happens to be expanded. A very large directory makes that one click slower. - **Menus need the Popover API.** On a browser without it, the plugin degrades to an explicit error notice instead of showing a misplaced menu. - **Source changes are not a running Host.** Editing files in this repository does not update a live DSH process; host routes require a restart.