Draft Studio Avalonia agent wiring

Policies that keep the org coherent

dotnetgovernancenovolis

name: DraftStudio Agent Wire overview: "Wire Draft Studio to the existing Avalonia agent protocol (LocalIpc ui. + MCP sidecar) the same way StudioChromeLab does: env-gated AgentHost attach, draft. AgentIds on chrome/tools/viewport/command bar, PackageReferences, and a short smoke path—no Draft-specific RPC this pass." todos:

id: draft-packages

content: Add Agent/Agent.Protocol/MessagePack PackageReferences to DraftStudio + Directory.Packages.props versions status: completed

id: draft-attach

content: Wire AgentHost.TryAttachFromEnvironment in DraftStudio App.cs status: completed

id: draft-agentids

content: Tag MainWindow toolbar/viewport/commandBar/entities/inspector/status with draft.* AgentIds status: completed

id: draft-smoke-validate

content: Add AGENT-SMOKE.md; ProjectRef build + verify-nuget-only status: completed isProject: false

Scope (locked)

Generic `ui.*` only — reuse existing `Novolis.Avalonia.Agent` + Cursor MCP `AvaloniaAgentMcp`. No draft.dispatch / domain LocalIpc methods (still out of scope per the agent protocol plan).

Agents drive Draft Studio by: UiTree → UiClick/UiType on tagged controls → UiScreenshot, and/or typing CAD DSL into draft.commandBar (same path as the human command bar).

flowchart LR
  mcp[AvaloniaAgentMcp]
  ipc[LocalIpc]
  host[AgentHost_in_DraftStudio]
  ui[draft_star_controls]
  mcp --> ipc --> host --> ui

Changes

1. Package refs — `DraftStudio.csproj` + `Directory.Packages.props`

Add central versions (mirror dogfooding lab):

Novolis.Avalonia.Agent 2026.1.*
Novolis.Avalonia.Agent.Protocol 2026.1.*

On the app (same ProjectRef transitive fix as StudioChromeLab):

PackageReference for Agent, Agent.Protocol, and MessagePack (already versioned in apps props)

Build consumers with -p:NovolisUseProjectReferences=true until GPR publishes the new packages.

2. Attach host — `App.cs`

Mirror `StudioChromeLab/App.cs`:

var window = Program.ApplicationHost.Services.GetRequiredService<MainWindow>();
desktop.MainWindow = window;
s_agentHost = AgentHost.TryAttachFromEnvironment(window);

Env gate: NOVOLIS_AVALONIA_AGENT=1.

3. Tag controls — `MainWindow.cs`

Extend local Btn(...) to accept an agent id and call AgentProperties.SetId(button, id, AgentRoleNames.Button).

Stable ids:

Id	Control
`draft.tool.save` / `.select` / `.line` / `.circle` / `.rect` / `.spline` / `.box` / `.delete`	toolbar tools
`draft.undo` / `draft.redo`	Undo / Redo
`draft.fit` / `draft.view.draft` / `draft.view.model` / `draft.export.phys`	remaining toolbar
`draft.toolbar`	toolbar `StackPanel`
`draft.viewport`	`_draftViewport`
`draft.viewport.model`	`_raylibHost`
`draft.commandBar`	`_commandBar`
`draft.entities`	`_entityList` (`ListBox` role)
`draft.inspector`	`_inspector`
`draft.status` / `draft.flash`	`chrome.StatusLine` / `chrome.FlashLine`

4. Smoke doc

Add `novolis-apps/src/DraftStudio/AGENT-SMOKE.md`: build with ProjectRef → run with NOVOLIS_AVALONIA_AGENT=1 → MCP UiHello / UiTree (expect draft.tool.line) / UiClick(draft.tool.line) / type into draft.commandBar / UiScreenshot.

5. Validate

dotnet build novolis-apps/src/DraftStudio -p:NovolisUseProjectReferences=true
pwsh -File novolis-governance/scripts/verify-nuget-only.ps1

No platform map regen needed (no new packable projects).

Out of scope

Draft-specific MCP tools / LocalIpc methods
Sins Captain Bridge wiring
Changing AvaloniaAgentMcp (already registered)