codeloop-mcp-server 0.1.49 → 0.1.50

package/dist/auth/critical_floors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"critical_floors.d.ts","sourceRoot":"","sources":["../../src/auth/critical_floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAmB1C,CAAC"}
+{"version":3,"file":"critical_floors.d.ts","sourceRoot":"","sources":["../../src/auth/critical_floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAwB1C,CAAC"}

package/dist/auth/critical_floors.js

@@ -56,5 +56,9 @@ export const CRITICAL_FLOORS = [
         min_version: "0.1.49",
         reason: "Cross-stack desktop-app coverage + coord-DPI fixes — pre-0.1.49 builds skipped desktopAppMode for Electron / Tauri / React Native / Flutter desktop projects (silent IDE capture recurred), didn't scale agent-supplied screenshot coords or apply Windows DPI factors (clicks missed by 2× on high-DPI displays), missed MSIX / Store-installed desktop apps and custom .NET <OutputPath> values (codeloop_launch_app returned 'no .exe found'), only classified one specific pngjs error as a skip (truncated IDAT / bad CRC / malformed IHDR still dragged the gate to 0%), surfaced coordinate_clicks_without_intent as a soft warning AFTER the gate failed instead of a hard step-7 PENDING blocker BEFORE gate_check, and lacked codeloop_self_test for pre-flight validation against any project's stack",
     },
+    {
+        min_version: "0.1.50",
+        reason: "WPF / desktop final-mile fixes — pre-0.1.50 builds returned `(undefined, undefined)` when codeloop_interact was called with `text` / `role` / `automation_id` selectors instead of raw x/y on Windows desktop targets (every WPF tab/list-item click missed because the runner had no UIA tree walker for selectors), accepted weak cross-run design_compare matches and scored unrelated screens at 0% (e.g. `10-led-bom_*` paired with `led-design-bom-add-component`), wrote screenshot artifacts under the user's HOME folder when project_dir was omitted on Cursor-launched MCP servers, returned empty arrays from codeloop_discover_screens for desktop projects (designs/desktop/*.png never surfaced), classified MSB3027 / MSB3021 file-locked build errors as `issue_unclassified` (agents looped on the same locked-EXE forever), lacked `codeloop doctor --prune-artifacts` to clean up old corrupt-PNG runs, and surfaced bare 'App window not found' errors with no candidates / next_step diagnostic when the priority ladder exhausted",
+    },
 ];
 //# sourceMappingURL=critical_floors.js.map

package/dist/auth/critical_floors.js.map

@@ -1 +1 @@
-{"version":3,"file":"critical_floors.js","sourceRoot":"","sources":["../../src/auth/critical_floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EACJ,ufAAuf;KAC1f;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,4hBAA4hB;KACriB;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,yvBAAyvB;KAClwB;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EACJ,kxBAAkxB;KACrxB;CACF,CAAC"}
+{"version":3,"file":"critical_floors.js","sourceRoot":"","sources":["../../src/auth/critical_floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EACJ,ufAAuf;KAC1f;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,4hBAA4hB;KACriB;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,yvBAAyvB;KAClwB;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EACJ,kxBAAkxB;KACrxB;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,MAAM,EACJ,0/BAA0/B;KAC7/B;CACF,CAAC"}

package/dist/index.js

@@ -26,6 +26,7 @@ import { applyUpdate, applyUpdateInputSchema, } from "./tools/apply_update.js";
 import { trackUsage } from "./auth/usage_tracker.js";
 import { isLocalMode } from "./auth/local_mode.js";
 import { discoverProjectDir } from "./project-discovery.js";
+import { resolveProjectDirPath } from "./runners/resolve_project_dir.js";
 function readImageAsBase64(path) {
     if (!existsSync(path))
         return null;
@@ -61,6 +62,18 @@ function mimeForPath(path) {
 //     when the server's auto-discovered fallback is uninitialized.
 const discovery = discoverProjectDir();
 const projectDir = discovery.projectDir;
+// 0.1.50 H4 — single helper that applies the project_dir precedence
+// ladder (explicit > workspace_root > active recording > env > walked_up
+// > default). Used by every capture / interact / record / replay / etc
+// handler so we can't drift back to the Photometry-DB regression where
+// missing project_dir wrote artifacts to the user's HOME folder.
+function resolveCwd(params) {
+    return resolveProjectDirPath({
+        project_dir: params.project_dir,
+        workspace_root: params.workspace_root,
+        default_dir: projectDir,
+    });
+}
 if (discovery.source !== "cwd" && discovery.source !== "env") {
     console.error(`[CodeLoop] Auto-discovered project at: ${projectDir} (via ${discovery.source} search)`);
 }
@@ -456,7 +469,7 @@ Returns: structured report with pass/fail counts, artifact paths, and next-step
     project_dir: z.string().optional().describe("Absolute path to the project root. Defaults to CODELOOP_PROJECT_DIR env var or auto-discovered project directory. MUST be an actual project folder — passing the user's home directory is rejected. If your IDE launches the MCP server from the wrong cwd (common on Windows where Cursor uses C:\\Users\\<name> as cwd), set CODELOOP_PROJECT_DIR or pass this param explicitly."),
     workspace_root: z.string().optional().describe("[Alias for project_dir] Same semantics; accepted because many agents reach for this conventional name. Pass either `project_dir` OR `workspace_root` — they're equivalent."),
 }, async (params) => {
-    const cwd = (params.project_dir || params.workspace_root || projectDir);
+    const cwd = resolveCwd(params);
     const explicitDir = params.project_dir || params.workspace_root;
     const cfg = explicitDir ? loadConfig(explicitDir) : config;
     const result = await withAuth(async () => {
@@ -544,11 +557,11 @@ Returns: categorized issues with severity, evidence, root cause, and actionable
             run_id: params.run_id,
             focus_files: params.focus_files,
         };
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const output = await runDiagnose(input, config, cwd);
         await trackUsage(apiKey, "verification_run");
         return output;
-    }, { tool: "codeloop_diagnose", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_diagnose", cwd: resolveCwd(params), input: params });
     // Auto-fix-loop directive. Diagnose is only useful when it leads
     // to a fix + re-verify, not when it leads to a long deliberation
     // over which repair to do first. The repair_tasks array in the
@@ -612,7 +625,7 @@ Returns: pass/fail for each gate, overall confidence score, and recommendation.`
             spec_path: params.spec_path,
             acceptance_path: params.acceptance_path,
         };
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const output = await runGateCheck(input, config, cwd);
         // Persist gate_result and confidence to meta.json
         try {
@@ -632,7 +645,7 @@ Returns: pass/fail for each gate, overall confidence score, and recommendation.`
         catch { /* best-effort persistence */ }
         await trackUsage(apiKey, "verification_run");
         return output;
-    }, { tool: "codeloop_gate_check", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_gate_check", cwd: resolveCwd(params), input: params });
     const resultJson = JSON.stringify(result, null, 2);
     const gateResult = result;
     if (gateResult.recommendation === "continue_fixing") {
@@ -690,11 +703,11 @@ Returns: pass/fail for each gate, overall confidence score, and recommendation.`
             "INCOMPLETE CRUD ARC is NEVER a reason to stop — call codeloop_plan_user_journey, follow the returned per-entity script, re-record, THEN re-gate.",
         ].join("\n");
         return {
-            content: withInitHint([{ type: "text", text: resultJson + loopDirective }], (params.project_dir || params.workspace_root || projectDir)),
+            content: withInitHint([{ type: "text", text: resultJson + loopDirective }], resolveCwd(params)),
         };
     }
     return {
-        content: withInitHint([{ type: "text", text: resultJson }], (params.project_dir || params.workspace_root || projectDir)),
+        content: withInitHint([{ type: "text", text: resultJson }], resolveCwd(params)),
     };
 });
 // ── Vision Tools (agent-delegated: returns images for AI agent analysis) ──
@@ -721,11 +734,11 @@ Returns: deterministic diff results + screenshot images for visual analysis.`, {
             ux_checklist_path: params.ux_checklist_path,
             viewport_sizes: params.viewport_sizes,
         };
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const result = await runVisualReview(input, config, cwd);
         await trackUsage(apiKey, "visual_review");
         return result;
-    }, { tool: "codeloop_visual_review", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_visual_review", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -806,11 +819,11 @@ Returns: per-screen pixel diff scores + worst-failing reference, actual, and dif
             designs_dir: params.designs_dir,
             run_id: params.run_id,
         };
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const result = await runDesignCompare(input, config, cwd);
         await trackUsage(apiKey, "visual_review");
         return result;
-    }, { tool: "codeloop_design_compare", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_design_compare", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -1125,7 +1138,7 @@ Returns: extracted key frames as images + expected flow description + app logs f
 }, async (params) => {
     const authResult = await withAuth(async () => {
         const { runInteractionReplay } = await import("./tools/interaction_replay.js");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const output = await runInteractionReplay({
             video_path: params.video_path,
             run_id: params.run_id,
@@ -1133,7 +1146,7 @@ Returns: extracted key frames as images + expected flow description + app logs f
         }, config, cwd);
         await trackUsage(apiKey, "visual_review");
         return output;
-    }, { tool: "codeloop_interaction_replay", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_interaction_replay", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -1242,7 +1255,7 @@ Returns: confirmation + the captured image as an MCP ImageContent block so you c
     const authResult = await withAuth(async () => {
         const { captureScreenshot } = await import("./runners/screenshot.js");
         const { createRunDir, getRunDir, getArtifactsBaseDir } = await import("./evidence/artifacts.js");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         let screenshotsDir;
         if (params.run_id) {
             const base = getArtifactsBaseDir(cwd);
@@ -1290,7 +1303,7 @@ Returns: confirmation + the captured image as an MCP ImageContent block so you c
         }
         await trackUsage(apiKey, "visual_review");
         return { ...result, windowBounds };
-    }, { tool: "codeloop_capture_screenshot", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_capture_screenshot", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -1336,8 +1349,8 @@ Returns: list of discovered screens with routes, navigation triggers, confidence
 }, async (params) => {
     const result = await withAuth(async () => {
         const { discoverScreens } = await import("./tools/discover_screens.js");
-        return discoverScreens((params.project_dir || params.workspace_root || projectDir), params.platform);
-    }, { tool: "codeloop_discover_screens", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+        return discoverScreens(resolveCwd(params), params.platform);
+    }, { tool: "codeloop_discover_screens", cwd: resolveCwd(params), input: params });
     return {
         content: withInitHint([{ type: "text", text: JSON.stringify(result, null, 2) }]),
     };
@@ -1371,8 +1384,8 @@ selects, datagrids, upload_areas, ai_features, forms }, ai_features_detected, sc
 }, async (params) => {
     const result = await withAuth(async () => {
         const { discoverInteractions } = await import("./tools/discover_interactions.js");
-        return discoverInteractions((params.project_dir || params.workspace_root || projectDir), params.platform);
-    }, { tool: "codeloop_discover_interactions", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+        return discoverInteractions(resolveCwd(params), params.platform);
+    }, { tool: "codeloop_discover_interactions", cwd: resolveCwd(params), input: params });
     return {
         content: withInitHint([{ type: "text", text: JSON.stringify(result, null, 2) }]),
     };
@@ -1414,8 +1427,8 @@ ai_substantive_prompts, upload_actions, datagrid_edits }, advice, discovered_int
 }, async (params) => {
     const result = await withAuth(async () => {
         const { planUserJourney } = await import("./tools/plan_user_journey.js");
-        return planUserJourney((params.project_dir || params.workspace_root || projectDir), params.platform, params.top_n);
-    }, { tool: "codeloop_plan_user_journey", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+        return planUserJourney(resolveCwd(params), params.platform, params.top_n);
+    }, { tool: "codeloop_plan_user_journey", cwd: resolveCwd(params), input: params });
     // Auto-fix loop directive. The plan is ONLY useful if the agent
     // now drives it via a recording session — otherwise it's a
     // detailed document that gets read and then deliberated over.
@@ -1457,7 +1470,7 @@ After recording, call codeloop_interaction_replay to extract frames and analyze
     const authResult = await withAuth(async () => {
         const { recordVideo } = await import("./runners/video_recorder.js");
         const { createRunDir, getRunDir, getArtifactsBaseDir } = await import("./evidence/artifacts.js");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         let videosDir;
         if (params.run_id) {
             const base = getArtifactsBaseDir(cwd);
@@ -1470,7 +1483,7 @@ After recording, call codeloop_interaction_replay to extract frames and analyze
         const result = await recordVideo(videosDir, params.duration_seconds, params.app_name);
         await trackUsage(apiKey, "visual_review");
         return result;
-    }, { tool: "codeloop_record_interaction", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_record_interaction", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -1499,7 +1512,7 @@ init for .NET/Xcode/Android projects via detect-target-app).`, {
     const authResult = await withAuth(async () => {
         const wm = await import("./runners/window_manager.js");
         const { loadConfig } = await import("./config.js");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const cfg = loadConfig(cwd);
         const appName = params.app_name || cfg.evidence?.target_app;
         if (!appName) {
@@ -1510,7 +1523,7 @@ init for .NET/Xcode/Android projects via detect-target-app).`, {
         }
         const r = await wm.launchDesktopApp(appName, cwd);
         return { app_name: appName, ...r };
-    }, { tool: "codeloop_launch_app", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_launch_app", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -1558,7 +1571,7 @@ App logs (stdout, logcat, simctl log) are automatically captured alongside the v
         const { createRunDir, getRunDir, getArtifactsBaseDir } = await import("./evidence/artifacts.js");
         const { detectTargetType } = await import("./runners/platform_detect.js");
         const { loadConfig } = await import("./config.js");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         let videosDir;
         if (params.run_id) {
             const base = getArtifactsBaseDir(cwd);
@@ -1620,7 +1633,7 @@ App logs (stdout, logcat, simctl log) are automatically captured alongside the v
         }
         await trackUsage(apiKey, "visual_review");
         return result;
-    }, { tool: "codeloop_start_recording", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_start_recording", cwd: resolveCwd(params), input: params });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {
         return { content: [{ type: "text", text: JSON.stringify(authResult, null, 2) }] };
     }
@@ -1703,7 +1716,7 @@ The agent MUST then write the report to docs/DEVELOPMENT_LOG.md and present it t
     const result = await withAuth(async () => {
         const { listRuns, loadRunMeta, getArtifactsBaseDir, getRunDir } = await import("./evidence/artifacts.js");
         const { readdirSync, existsSync } = await import("fs");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const baseDir = getArtifactsBaseDir(cwd);
         const runs = listRuns(baseDir);
         const runSummaries = [];
@@ -1848,7 +1861,7 @@ The agent MUST then write the report to docs/DEVELOPMENT_LOG.md and present it t
         };
         await trackUsage(apiKey, "verification_run");
         return report;
-    }, { tool: "codeloop_generate_dev_report", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_generate_dev_report", cwd: resolveCwd(params), input: params });
     if (typeof result === "object" && result !== null && "error" in result) {
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
@@ -1970,7 +1983,7 @@ Returns: checklist of completed and pending verification steps.`, {
         const { listRuns, loadRunMeta, getArtifactsBaseDir, getRunDir } = await import("./evidence/artifacts.js");
         const { detectPlatform } = await import("./tools/verify.js");
         const { detectDesktopUI } = await import("./tools/desktop_detection.js");
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const platform = detectPlatform(cwd);
         // UI detection includes desktop .NET / native: WPF, WinForms, MAUI,
         // Avalonia, WinUI, UWP. Without this, every WPF/.NET 8 / MAUI / Avalonia
@@ -2174,7 +2187,7 @@ Returns: checklist of completed and pending verification steps.`, {
                 ? "All CodeLoop verification steps are complete. You may proceed."
                 : `WARNING: ${pendingSteps.length} step(s) still pending. DO NOT declare this task complete. DO NOT ask the user what to do next. Complete the pending steps below, then call codeloop_gate_check. If gate returns continue_fixing, loop back and fix without asking.\n${pendingSteps.map(s => `  - ${s.step}: ${s.detail}`).join("\n")}`,
         };
-    }, { tool: "codeloop_check_workflow", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_check_workflow", cwd: resolveCwd(params), input: params });
     return {
         content: withInitHint([{ type: "text", text: JSON.stringify(result, null, 2) }]),
     };
@@ -2214,11 +2227,13 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
     y: z.number().optional().describe("Y coordinate for click/scroll/drag/swipe"),
     x2: z.number().optional().describe("End X for drag_drop/swipe"),
     y2: z.number().optional().describe("End Y for drag_drop/swipe"),
-    text: z.string().optional().describe("Text for type/type_and_submit/type_and_tab/fill"),
+    text: z.string().optional().describe("Text for type/type_and_submit/type_and_tab/fill. 0.1.50+: ALSO accepted on click/double_click/right_click/hover with no x/y on Windows desktop targets — walks the UIA tree to find the first element whose Name property matches (exact, then substring) and clicks its centre. Closes the Photometry-DB E2E 8 regression where `{ action: \"click\", text: \"Luminaire Photometric Data\" }` produced `click at (undefined, undefined)`."),
     key: z.string().optional().describe("Key name for keystroke: enter, tab, escape, backspace, delete, etc."),
     keys: z.string().optional().describe("Key combo for hotkey: cmd+s, ctrl+enter, cmd+shift+z, etc."),
     selector: z.string().optional().describe("CSS selector (browser) or automation ID (Windows)"),
     selector2: z.string().optional().describe("Second selector for drag target"),
+    automation_id: z.string().optional().describe("[Windows desktop] UIA AutomationId of the target element. 0.1.50+: when supplied for click/double_click/right_click/hover with no x/y, CodeLoop walks the UIA tree and resolves the element's screen coords automatically (DPI-aware, window-origin-aware), then clicks at the centre. Most stable selector for WPF/WinUI/UWP — prefer this over `text` whenever the control exposes one."),
+    role: z.string().optional().describe("[Windows desktop] UIA ControlType programmatic name (e.g. `ControlType.Button`, `ControlType.TabItem`). 0.1.50+: when supplied for click/double_click/right_click/hover with no x/y, walks the UIA tree and clicks the FIRST element of that ControlType. Use as a last resort when neither AutomationId nor Name is specific enough."),
     url: z.string().optional().describe("URL for navigate_url or deep_link"),
     direction: z.enum(["up", "down", "left", "right"]).optional().describe("Scroll/swipe direction"),
     amount: z.number().optional().describe("Scroll amount or other numeric value"),
@@ -2264,7 +2279,7 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
         const bi = await import("./runners/browser_interaction.js");
         const vr = await import("./runners/video_recorder.js");
         // Auto-detect target_type when omitted
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         let tt = params.target_type;
         if (!tt) {
             const recordingTarget = vr.getActiveRecordingTargetType();
@@ -2329,6 +2344,39 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
                 }
             }
         }
+        // 0.1.50 H1 — when an agent passes `text` / `role` /
+        // `automation_id` (no x/y) to a desktop click-family action,
+        // walk the UIA tree to resolve the centre of the matching
+        // element. The resolved (x, y) is screen-absolute so it
+        // bypasses translateXY (which is for agent-supplied coords).
+        const resolveDesktopSelector = async () => {
+            if (tt !== "desktop" || process.platform !== "win32")
+                return null;
+            if (params.x != null && params.y != null)
+                return null;
+            const appName = params.app_name || vr.getActiveRecordingAppName();
+            if (!appName)
+                return null;
+            const hasSelector = (params.automation_id && params.automation_id.length > 0) ||
+                (params.text && params.text.length > 0) ||
+                (params.role && params.role.length > 0);
+            if (!hasSelector)
+                return null;
+            try {
+                const { resolveSelectorToXY } = await import("./runners/uia_resolver.js");
+                const r = await resolveSelectorToXY({
+                    appName,
+                    automationId: params.automation_id,
+                    text: params.text,
+                    role: params.role,
+                });
+                if (r.found && r.x != null && r.y != null) {
+                    return { x: r.x, y: r.y, foundBy: r.foundBy ?? "unknown" };
+                }
+            }
+            catch { /* best-effort */ }
+            return null;
+        };
         // Helper used by every coordinate-driven desktop action below.
         // Photometry-DB E2E 8 + 0.1.49 hardening: handles four modes
         // (auto / window / screen / screenshot) plus an optional DPI
@@ -2407,7 +2455,16 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
                     const t = translateXY(params.x, params.y);
                     success = await wm.clickAtPosition(t.x, t.y);
                 }
-                detail = `click at ${params.selector || `(${params.x},${params.y})`}`;
+                else {
+                    // 0.1.50 H1 — UIA selector fallback for click without coords.
+                    const resolved = await resolveDesktopSelector();
+                    if (resolved) {
+                        success = await wm.clickAtPosition(resolved.x, resolved.y);
+                        detail = `click at ${resolved.foundBy}=${params.automation_id || params.text || params.role} → (${resolved.x},${resolved.y})`;
+                        break;
+                    }
+                }
+                detail = `click at ${params.selector || params.automation_id || params.text || params.role || `(${params.x},${params.y})`}`;
                 break;
             case "double_click":
                 if (tt === "browser" && params.selector) {
@@ -2417,7 +2474,15 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
                     const t = translateXY(params.x, params.y);
                     success = await wm.doubleClickAtPosition(t.x, t.y);
                 }
-                detail = `double_click at ${params.selector || `(${params.x},${params.y})`}`;
+                else {
+                    const resolved = await resolveDesktopSelector();
+                    if (resolved) {
+                        success = await wm.doubleClickAtPosition(resolved.x, resolved.y);
+                        detail = `double_click at ${resolved.foundBy}=${params.automation_id || params.text || params.role} → (${resolved.x},${resolved.y})`;
+                        break;
+                    }
+                }
+                detail = `double_click at ${params.selector || params.automation_id || params.text || params.role || `(${params.x},${params.y})`}`;
                 break;
             case "right_click":
                 if (tt === "browser" && params.selector) {
@@ -2427,7 +2492,15 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
                     const t = translateXY(params.x, params.y);
                     success = await wm.rightClickAtPosition(t.x, t.y);
                 }
-                detail = `right_click at ${params.selector || `(${params.x},${params.y})`}`;
+                else {
+                    const resolved = await resolveDesktopSelector();
+                    if (resolved) {
+                        success = await wm.rightClickAtPosition(resolved.x, resolved.y);
+                        detail = `right_click at ${resolved.foundBy}=${params.automation_id || params.text || params.role} → (${resolved.x},${resolved.y})`;
+                        break;
+                    }
+                }
+                detail = `right_click at ${params.selector || params.automation_id || params.text || params.role || `(${params.x},${params.y})`}`;
                 break;
             case "hover":
                 if (tt === "browser" && params.selector) {
@@ -2437,7 +2510,15 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
                     const t = translateXY(params.x, params.y);
                     success = await wm.hoverAtPosition(t.x, t.y);
                 }
-                detail = `hover at ${params.selector || `(${params.x},${params.y})`}`;
+                else {
+                    const resolved = await resolveDesktopSelector();
+                    if (resolved) {
+                        success = await wm.hoverAtPosition(resolved.x, resolved.y);
+                        detail = `hover at ${resolved.foundBy}=${params.automation_id || params.text || params.role} → (${resolved.x},${resolved.y})`;
+                        break;
+                    }
+                }
+                detail = `hover at ${params.selector || params.automation_id || params.text || params.role || `(${params.x},${params.y})`}`;
                 break;
             case "type":
                 if (tt === "browser" && params.selector && params.text) {
@@ -2782,7 +2863,7 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
             case "maestro_flow":
                 if (params.maestro_steps) {
                     const mg = await import("./runners/maestro_generator.js");
-                    const cwd = (params.project_dir || params.workspace_root || projectDir);
+                    const cwd = resolveCwd(params);
                     const genResult = await mg.generateMaestroFlow(params.maestro_steps, cwd);
                     if ("error" in genResult) {
                         return { success: false, action, detail: genResult.error };
@@ -3098,7 +3179,7 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
         }
         catch { /* best-effort logging */ }
         return { success, action, detail };
-    }, { tool: "codeloop_interact", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_interact", cwd: resolveCwd(params), input: params });
     return {
         content: withInitHint([{ type: "text", text: JSON.stringify(result, null, 2) }]),
     };
@@ -3120,7 +3201,7 @@ project. After it completes, proceed directly with \`codeloop_verify\`.`, {
     workspace_root: z.string().optional().describe("[Alias for project_dir] Same semantics; accepted because many agents reach for this conventional name. Pass either `project_dir` OR `workspace_root` — they're equivalent."),
     project_type: z.enum(["flutter", "web", "mobile", "xcode", "android", "dotnet", "node", "auto"]).default("auto").describe("Project type. Use 'auto' to detect automatically."),
 }, async (params) => {
-    const cwd = (params.project_dir || params.workspace_root || projectDir);
+    const cwd = resolveCwd(params);
     const result = await (async () => {
         const { runInitProject } = await import("./tools/init-project.js");
         const output = await runInitProject({
@@ -3146,7 +3227,7 @@ Returns: counts for attempted / succeeded / requeued events and the queue locati
     project_dir: z.string().optional().describe("Absolute path to the project root. Defaults to CODELOOP_PROJECT_DIR env var or auto-discovered project directory. MUST be an actual project folder — passing the user's home directory is rejected. If your IDE launches the MCP server from the wrong cwd (common on Windows where Cursor uses C:\\Users\\<name> as cwd), set CODELOOP_PROJECT_DIR or pass this param explicitly."),
     workspace_root: z.string().optional().describe("[Alias for project_dir] Same semantics; accepted because many agents reach for this conventional name. Pass either `project_dir` OR `workspace_root` — they're equivalent."),
 }, async (params) => {
-    const cwd = (params.project_dir || params.workspace_root || projectDir);
+    const cwd = resolveCwd(params);
     const { flushPersistedUsage } = await import("./auth/usage_tracker.js");
     const result = await flushPersistedUsage(cwd);
     return {
@@ -3257,10 +3338,10 @@ Idempotent and free — safe to call as the first step of every new chat.`, {
     workspace_root: z.string().optional().describe("[Alias for project_dir] Same semantics."),
 }, async (params) => {
     const result = await withAuth(async () => {
-        const cwd = (params.project_dir || params.workspace_root || projectDir);
+        const cwd = resolveCwd(params);
         const { runSelfTest } = await import("./tools/self_test.js");
         return runSelfTest(cwd);
-    }, { tool: "codeloop_self_test", cwd: (params.project_dir || params.workspace_root || projectDir), input: params });
+    }, { tool: "codeloop_self_test", cwd: resolveCwd(params), input: params });
     if (typeof result === "object" && result !== null && "error" in result) {
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
@@ -3295,7 +3376,7 @@ Returns: status, current/latest versions, critical reasons, commands_to_run, aut
         return applyUpdate({ auto_respawn: params.auto_respawn });
     }, {
         tool: "codeloop_apply_update",
-        cwd: params.project_dir || params.workspace_root || projectDir,
+        cwd: resolveCwd(params),
         input: params,
     });
     if (typeof authResult === "object" && authResult !== null && "error" in authResult) {