AGENTS.md@bridge git:20261017.7556edbA

Immutable. This exact content never changes and is served at /api/v1/blob/88242dc89c5e403f.

# bridge/ — the .NET 9 sidecar `unreal-mcp-bridge` (McpPlugin host; IPC ⇄ SignalR relay)

- `Unreal-MCP-Bridge.sln` — hand-authored, tracked solution (bridge + tests).
- `src/` — `com.IvanMurzak.Unreal.MCP.Bridge.csproj`; `Ipc/` (NDJSON protocol + messages), `Host/`
  (`SidecarHost`), `Sidecar/` (lifecycle), `Tools/` (manifest registrars, `ProxyTool`/`ProxyPrompt`/
  `ProxyResource`, surface sinks, `SkillGenerateTool`, `RqlBridge` — RQL text → plan, results → agent text),
  `AgentConfig/`, `Auth/`.
- `tests/` — xUnit; one `<Subject>Tests.cs` per area, shared fakes in `Fakes.cs`.

**Rules**
- Every `.cs` starts with the ASCII-art Apache-2.0 header (copy from a neighbour).
- NuGet pins `com.IvanMurzak.ReflectorNet` / `com.IvanMurzak.McpPlugin` / `com.IvanMurzak.Rql` move in lockstep with
  Godot-MCP and are bumped only by the upstream release flow — never here (owner-approved exceptions, e.g. the RQL
  adoption and McpPlugin 8.9.0, are recorded as `⚠ DEVIATION` entries in the csproj). The csproj is the live source
  for their values.

**Publish** (ARCHITECTURE §6 bundle model): self-contained single-file per RID, trimming OFF (reflection-heavy).
`bash bridge/publish.sh [Release <rid>] [--no-zip]` (all 4 RIDs by default: win-x64, linux-x64, osx-x64,
osx-arm64; PowerShell: `publish.ps1 [-Platforms <rid>...] [-NoZip]`). Output `bridge/publish/<rid>/` holds
one apphost, no `.pdb`/loose DLLs. Self-contained engages only when a RID is given, so plain
`dotnet build`/`test` yields `bin/<cfg>/net9.0/unreal-mcp-bridge.exe`, the path the live e2e
(`UNREAL_MCP_BRIDGE_PATH`) uses. Release stages signed slices into
`UnrealMCP/Source/ThirdParty/UnrealMcpBridge/<rid>/`.