dsh-plugin-coop-with-vs/visualstudio-extension/README.md

# DSH Open File Bridge for Visual Studio

This VSIX supports Visual Studio 2022 (17.x) and Visual Studio 2026 (18.x). It is a background-loaded `AsyncPackage`. Each Visual Studio process enumerates its own `IVsRunningDocumentTable`, listens for RDT changes, and publishes one protocol-v1 snapshot. This avoids the ambiguity and integrity-level failures of attaching externally through EnvDTE/ROT.

Only absolute, existing local files are published. Dirty state is read through `IVsPersistDocData`; source buffers are never copied.

## Build and test

Use a Visual Studio Developer PowerShell or a machine with the Visual Studio extension workload:

```powershell
dotnet restore CoopWithDsh.sln
dotnet test CoopWithDsh.sln -c Release
dotnet build Prophet.CoopWithDsh\Prophet.CoopWithDsh.csproj -c Release
```

Install the generated `.vsix` from the Release output, restart Visual Studio, then type `@` in DSH. The snapshot heartbeats every 15 seconds and is removed on normal package/process shutdown.