Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agent/workflows/cross_repo_contract_change.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ breaking a sibling/consumer repo or letting docs drift.

- Any change to a public API path/field, a DB column a consumer reads, a shared type, or a
user-facing label that another repo depends on.
- **WinGuiMcp ↔ DxO PhotoLab:** follow [`docs/cross-project/DXO_BOUNDARIES_CONSTITUTION.md`](../../docs/cross-project/DXO_BOUNDARIES_CONSTITUTION.md) (owner: generic tools in `win-gui-mcp`, `dxo_*` in `D:\Projects\dxo-photolab-mcp`).
- **WinGuiMcp ↔ DxO PhotoLab:** follow [`docs/cross-project/DXO_BOUNDARIES_CONSTITUTION.md`](../../docs/cross-project/DXO_BOUNDARIES_CONSTITUTION.md) (owner: generic tools in `win-gui-mcp`, `dxo_*` in `<projects-root>\dxo-photolab-mcp`).

## Principle

Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
1 change: 0 additions & 1 deletion .codex/config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,3 @@
[mcp_servers."win-gui-mcp"]
command = "dotnet"
args = ["run", "--project", "src/WinGuiMcp/WinGuiMcp.csproj", "--no-build"]
cwd = "D:\\Projects\\win-gui-mcp"
1 change: 0 additions & 1 deletion .mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@
"src/WinGuiMcp/WinGuiMcp.csproj",
"--no-build"
],
"cwd": "D:\\Projects\\win-gui-mcp",
"type": "stdio"
}
}
Expand Down
2 changes: 1 addition & 1 deletion docs/CANONICAL_SOURCES.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Authority map for AI agents and implementers. When docs disagree, the files list
| Commands, build, MCP setup | [`../AGENTS.md`](../AGENTS.md) | Overrides generic guidance for this repo |
| Infra inventory | [`../.agent/AGENT_INFRA_INVENTORY.md`](../.agent/AGENT_INFRA_INVENTORY.md) | Paths to rules, commands, skills |
| Safety guardrails | [`../.agent/SAFETY.md`](../.agent/SAFETY.md) | Windows automation behavior |
| WinGuiMcp ↔ DxO PhotoLab sibling repo | [`cross-project/DXO_BOUNDARIES_CONSTITUTION.md`](cross-project/DXO_BOUNDARIES_CONSTITUTION.md), [`cross-project/LINKS.json`](cross-project/LINKS.json) | Tool namespaces, ownership, MCP keys; PhotoLab SPEC in `D:\Projects\dxo-photolab-mcp\docs\photolab-automation\` |
| WinGuiMcp ↔ DxO PhotoLab sibling repo | [`cross-project/DXO_BOUNDARIES_CONSTITUTION.md`](cross-project/DXO_BOUNDARIES_CONSTITUTION.md), [`cross-project/LINKS.json`](cross-project/LINKS.json) | Tool namespaces, ownership, MCP keys; PhotoLab SPEC in `<projects-root>\dxo-photolab-mcp\docs\photolab-automation\` |
| Generic automation guides | [`guides/README.md`](guides/README.md) | Patterns and multi-server integration (non-schema) |

## Non-normative (background only)
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Read [errors.md](errors.md) and [security.md](security.md) alongside `tools.md`
| [security.md](security.md) | UIPI, elevation, deployment warnings |
| [requirements/README.md](requirements/README.md) | Technical requirements index (traceability; does not override schemas) |
| [guides/README.md](guides/README.md) | Generic desktop automation patterns and sibling MCP integration |
| [dxo-photolab/README.md](dxo-photolab/README.md) | Redirect to canonical PhotoLab docs in `D:\Projects\dxo-photolab-mcp\docs\photolab-automation\` |
| [dxo-photolab/README.md](dxo-photolab/README.md) | Redirect to canonical PhotoLab docs in `<projects-root>\dxo-photolab-mcp\docs\photolab-automation\` |
| [cross-project/DXO_BOUNDARIES_CONSTITUTION.md](cross-project/DXO_BOUNDARIES_CONSTITUTION.md) | Normative boundaries vs sibling `dxo-photolab-mcp` |
| [cross-project/LINKS.json](cross-project/LINKS.json) | Machine-readable cross-repo paths and MCP server keys |

Expand Down
24 changes: 12 additions & 12 deletions docs/cross-project/DXO_BOUNDARIES_CONSTITUTION.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Cross-project constitution: WinGuiMcp ↔ DxO PhotoLab

**Status:** Normative for agents working across both repositories.
**Parties:** [`win-gui-mcp`](https://github.com/synthet/win-gui-mcp) (generic Windows desktop MCP) and [`dxo-photolab-mcp`](https://github.com/synthet/dxo-photolab-mcp) (local checkout `D:\Projects\dxo-photolab-mcp`; DxO PhotoLab workflow + domain MCP).
**Sibling copy:** [`D:\Projects\dxo-photolab-mcp\docs\win-gui-mcp-boundaries.md`](file:///D:/Projects/dxo-photolab-mcp/docs/win-gui-mcp-boundaries.md) (obligations from the PhotoLab MCP repo).
**Parties:** [`win-gui-mcp`](https://github.com/synthet/win-gui-mcp) (generic Windows desktop MCP) and [`dxo-photolab-mcp`](https://github.com/synthet/dxo-photolab-mcp) (local checkout `<projects-root>\dxo-photolab-mcp`; DxO PhotoLab workflow + domain MCP).
**Sibling copy:** [`<projects-root>\dxo-photolab-mcp\docs\win-gui-mcp-boundaries.md`](../../../dxo-photolab-mcp/docs/win-gui-mcp-boundaries.md) (obligations from the PhotoLab MCP repo).

---

Expand All @@ -20,13 +20,13 @@ Both projects automate **DxO PhotoLab 10** on Windows, but they solve different
|--------|-----------------|---------|
| **Mission** | Playwright-style **generic** Windows UI automation (UIA3, refs, Phase 1 tools) for any desktop app | **PhotoLab-specific** workflow automation: launch, sidecars, presets, exports (MCP + scripts) |
| **MCP server** | `win-gui-mcp` — stdio, `dotnet run` / published host | `dxo-photolab` — `DxoMcpServer.exe`, domain tools only |
| **Tool names** | Only names in [`tools.md`](../tools.md) (`snapshot`, `click`, `set_value`, …) | Only `dxo_*` tools documented in [`mcp-server-guide.md`](file:///D:/Projects/dxo-photolab-mcp/docs/mcp-server-guide.md) |
| **Normative DxO product spec** | Stub + link: [`docs/dxo-photolab/README.md`](../dxo-photolab/README.md) → **canonical in dxo-photolab-mcp** | [`docs/photolab-automation/SPEC.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/SPEC.md) |
| **Implementation plan (UIA)** | Gate tests in `tests/WinGuiMcp.Tests/`; generic guides in [`docs/guides/`](../guides/README.md) | [`docs/photolab-automation/PLAN.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/PLAN.md) |
| **Tool names** | Only names in [`tools.md`](../tools.md) (`snapshot`, `click`, `set_value`, …) | Only `dxo_*` tools documented in [`mcp-server-guide.md`](../../../dxo-photolab-mcp/docs/mcp-server-guide.md) |
| **Normative DxO product spec** | Stub + link: [`docs/dxo-photolab/README.md`](../dxo-photolab/README.md) → **canonical in dxo-photolab-mcp** | [`docs/photolab-automation/SPEC.md`](../../../dxo-photolab-mcp/docs/photolab-automation/SPEC.md) |
| **Implementation plan (UIA)** | Gate tests in `tests/WinGuiMcp.Tests/`; generic guides in [`docs/guides/`](../guides/README.md) | [`docs/photolab-automation/PLAN.md`](../../../dxo-photolab-mcp/docs/photolab-automation/PLAN.md) |
| **Sidecar / file I/O** | OS waits in `wait_for` (`file-stable`, `process-exists`) — [`tools.md`](../tools.md) | **Owner** of `dxo_*` sidecar tools and `scripts/` |
| **UI recipes (PhotoLab)** | [`docs/guides/integrating-sibling-mcp-servers.md`](../guides/integrating-sibling-mcp-servers.md) | [`docs/gui-automation-win-gui-mcp.md`](file:///D:/Projects/dxo-photolab-mcp/docs/gui-automation-win-gui-mcp.md) |
| **UI recipes (PhotoLab)** | [`docs/guides/integrating-sibling-mcp-servers.md`](../guides/integrating-sibling-mcp-servers.md) | [`docs/gui-automation-win-gui-mcp.md`](../../../dxo-photolab-mcp/docs/gui-automation-win-gui-mcp.md) |
| **Reverse engineering** | — | Not stored in either public GitHub repo. Merged product notes: `dxo-photolab-mcp/docs/photolab-automation/RESEARCH.md`. |
| **Cross-links** | [`LINKS.json`](LINKS.json) | [`cross-project-LINKS.json`](file:///D:/Projects/dxo-photolab-mcp/docs/cross-project-LINKS.json) |
| **Cross-links** | [`LINKS.json`](LINKS.json) | [`cross-project-LINKS.json`](../../../dxo-photolab-mcp/docs/cross-project-LINKS.json) |

---

Expand Down Expand Up @@ -81,7 +81,7 @@ Both **MUST** follow [`.agent/SAFETY.md`](../../.agent/SAFETY.md) (win-gui-mcp).

- Fork or vendor `WinGuiMcp` source as a substitute for the generic MCP server.
- Invent generic tool names (`snapshot`, `find_element`, …) that duplicate [`tools.md`](../tools.md).
- Publish UIA gate acceptance criteria without aligning with [`docs/photolab-automation/SPEC.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/SPEC.md) scenarios.
- Publish UIA gate acceptance criteria without aligning with [`docs/photolab-automation/SPEC.md`](../../../dxo-photolab-mcp/docs/photolab-automation/SPEC.md) scenarios.

---

Expand All @@ -92,9 +92,9 @@ When documents disagree:
| Question | Wins |
|----------|------|
| Generic MCP tool shape / errors | `win-gui-mcp` → [`tools.md`](../tools.md), [`errors.md`](../errors.md) |
| PhotoLab functional requirements (UIA acceptance) | `dxo` → [`docs/photolab-automation/SPEC.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/SPEC.md) |
| PhotoLab “what is officially supported” / legal posture | `dxo` → [`docs/synthesis.md`](file:///D:/Projects/dxo-photolab-mcp/docs/synthesis.md) |
| `dxo_*` tool arguments & behavior | `dxo` → [`docs/mcp-server-guide.md`](file:///D:/Projects/dxo-photolab-mcp/docs/mcp-server-guide.md) + `Program.cs` |
| PhotoLab functional requirements (UIA acceptance) | `dxo` → [`docs/photolab-automation/SPEC.md`](../../../dxo-photolab-mcp/docs/photolab-automation/SPEC.md) |
| PhotoLab “what is officially supported” / legal posture | `dxo` → [`docs/synthesis.md`](../../../dxo-photolab-mcp/docs/synthesis.md) |
| `dxo_*` tool arguments & behavior | `dxo` → [`docs/mcp-server-guide.md`](../../../dxo-photolab-mcp/docs/mcp-server-guide.md) + `Program.cs` |
| Cross-repo process | This file |

**Research markdown** (Downloads exports, long RE reports) is **input only** until merged into the authority files above.
Expand All @@ -121,7 +121,7 @@ Register **two** servers (names are convention; paths are machine-local):
| Server key | Command | Repo |
|------------|---------|------|
| `win-gui-mcp` | `dotnet run --project …/WinGuiMcp.csproj` | win-gui-mcp |
| `dxo-photolab` | `D:\Projects\dxo-photolab-mcp\bin\mcp\DxoMcpServer.exe` | dxo-photolab-mcp |
| `dxo-photolab` | `<projects-root>\dxo-photolab-mcp\bin\mcp\DxoMcpServer.exe` | dxo-photolab-mcp |

Agents should declare which server they call in logs and prompts. Never assume a single server exposes both `snapshot` and `dxo_tweak_sliders`.

Expand Down
4 changes: 2 additions & 2 deletions docs/cross-project/LIGHTROOM_BOUNDARIES_CONSTITUTION.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Cross-project constitution: WinGuiMcp ↔ lightroom-mcp (Lightroom Desktop)

**Status:** Normative for agents working across both repositories. Modelled on [DXO_BOUNDARIES_CONSTITUTION.md](DXO_BOUNDARIES_CONSTITUTION.md).
**Parties:** `win-gui-mcp` (generic Windows UIA MCP and `WinGuiMcp.Core`) and `lightroom-mcp` (local checkout `D:\Projects\lightroom-mcp`: an Adobe **Lightroom Desktop (cloud)** domain server).
**Not a party:** `lightroom-classic-mcp` (`D:\Projects\lightroom-classic-mcp`) automates **Lightroom Classic** through a Lua plug-in. It is a different product and a different repo.
**Parties:** `win-gui-mcp` (generic Windows UIA MCP and `WinGuiMcp.Core`) and `lightroom-mcp` (local checkout `<projects-root>\lightroom-mcp`: an Adobe **Lightroom Desktop (cloud)** domain server).
**Not a party:** `lightroom-classic-mcp` (`<projects-root>\lightroom-classic-mcp`) automates **Lightroom Classic** through a Lua plug-in. It is a different product and a different repo.

## 1. Charters

Expand Down
2 changes: 1 addition & 1 deletion docs/cross-project/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ Normative boundaries between this repository and sibling automation projects.
| [**DXO_BOUNDARIES_CONSTITUTION.md**](DXO_BOUNDARIES_CONSTITUTION.md) | Charters, layer model, tool namespaces, safety, and change rules for **win-gui-mcp** ↔ **`dxo-photolab-mcp`** |
| [**LINKS.json**](LINKS.json) | Machine-readable paths, MCP server keys, doc redirects (mirrored in `dxo-photolab-mcp/docs/cross-project-LINKS.json`) |

When automating DxO PhotoLab, read the constitution before adding tools or specs in either repo. PhotoLab **product** docs: `D:\Projects\dxo-photolab-mcp\docs\photolab-automation\`.
When automating DxO PhotoLab, read the constitution before adding tools or specs in either repo. PhotoLab **product** docs: `<projects-root>\dxo-photolab-mcp\docs\photolab-automation\`.
12 changes: 6 additions & 6 deletions docs/dxo-photolab/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@

| Document | Location |
|----------|----------|
| Index | [`D:\Projects\dxo-photolab-mcp\docs\photolab-automation\README.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/README.md) |
| SPEC | [`D:\Projects\dxo-photolab-mcp\docs\photolab-automation\SPEC.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/SPEC.md) |
| PLAN | [`D:\Projects\dxo-photolab-mcp\docs\photolab-automation\PLAN.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/PLAN.md) |
| Controls reference | [`D:\Projects\dxo-photolab-mcp\docs\photolab-automation\CONTROLS_REFERENCE.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/CONTROLS_REFERENCE.md) |
| Research | [`D:\Projects\dxo-photolab-mcp\docs\photolab-automation\RESEARCH.md`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/RESEARCH.md) |
| Index | [`<projects-root>\dxo-photolab-mcp\docs\photolab-automation\README.md`](../../../dxo-photolab-mcp/docs/photolab-automation/README.md) |
| SPEC | [`<projects-root>\dxo-photolab-mcp\docs\photolab-automation\SPEC.md`](../../../dxo-photolab-mcp/docs/photolab-automation/SPEC.md) |
| PLAN | [`<projects-root>\dxo-photolab-mcp\docs\photolab-automation\PLAN.md`](../../../dxo-photolab-mcp/docs/photolab-automation/PLAN.md) |
| Controls reference | [`<projects-root>\dxo-photolab-mcp\docs\photolab-automation\CONTROLS_REFERENCE.md`](../../../dxo-photolab-mcp/docs/photolab-automation/CONTROLS_REFERENCE.md) |
| Research | [`<projects-root>\dxo-photolab-mcp\docs\photolab-automation\RESEARCH.md`](../../../dxo-photolab-mcp/docs/photolab-automation/RESEARCH.md) |

**Cross-repo rules:** [`../cross-project/DXO_BOUNDARIES_CONSTITUTION.md`](../cross-project/DXO_BOUNDARIES_CONSTITUTION.md)
**Link registry:** [`../cross-project/LINKS.json`](../cross-project/LINKS.json)

WinGuiMcp implements **generic** UIA tools only; PhotoLab UI recipes that call those tools are in [`D:\Projects\dxo-photolab-mcp\docs\gui-automation-win-gui-mcp.md`](file:///D:/Projects/dxo-photolab-mcp/docs/gui-automation-win-gui-mcp.md).
WinGuiMcp implements **generic** UIA tools only; PhotoLab UI recipes that call those tools are in [`<projects-root>\dxo-photolab-mcp\docs\gui-automation-win-gui-mcp.md`](../../../dxo-photolab-mcp/docs/gui-automation-win-gui-mcp.md).

This folder is a **stub** so old links under `docs/dxo-photolab/` keep working.
2 changes: 1 addition & 1 deletion docs/guides/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ Practical patterns for agents and integrators. Normative tool contracts remain i
| [desktop-automation-patterns.md](desktop-automation-patterns.md) | Launch, focus, UIA vs file/process waits, export monitoring (generic Windows) |
| [integrating-sibling-mcp-servers.md](integrating-sibling-mcp-servers.md) | Multiple MCP servers on one desktop (e.g. generic UIA + domain adapter) |

Domain-specific PhotoLab specs live in the sibling repo: [`D:\Projects\dxo-photolab-mcp\docs\photolab-automation\`](file:///D:/Projects/dxo-photolab-mcp/docs/photolab-automation/).
Domain-specific PhotoLab specs live in the sibling repo: [`<projects-root>\dxo-photolab-mcp\docs\photolab-automation\`](../../../dxo-photolab-mcp/docs/photolab-automation/).
4 changes: 2 additions & 2 deletions docs/guides/integrating-sibling-mcp-servers.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,11 @@ WinGuiMcp is intentionally **generic**. Domain adapters (separate executables, s

Machine-readable link registry: [`cross-project/LINKS.json`](../cross-project/LINKS.json).

PhotoLab UI recipes using WinGuiMcp: [`D:\Projects\dxo-photolab-mcp\docs\gui-automation-win-gui-mcp.md`](file:///D:/Projects/dxo-photolab-mcp/docs/gui-automation-win-gui-mcp.md).
PhotoLab UI recipes using WinGuiMcp: [`<projects-root>\dxo-photolab-mcp\docs\gui-automation-win-gui-mcp.md`](../../../dxo-photolab-mcp/docs/gui-automation-win-gui-mcp.md).

## Client configuration sketch

See `D:\Projects\dxo-photolab-mcp\config\mcp.dual-server.example.json` for a two-server template.
See `<projects-root>\dxo-photolab-mcp\config\mcp.dual-server.example.json` for a two-server template.

## Orchestration

Expand Down
Loading