ccqa 1.40.3 → 1.40.5

package/dist/bin/ccqa.mjs

@@ -15204,25 +15204,26 @@ function actionToLine(action) {
 		return `// [warn] replay-unstable: dropped over-assertion (${action.assert ?? "assert"} ${sel}) — selector not present on replay`;
 	}
 	const locator = action.locator ? locatorToPlaywright(action.locator, action.index) : null;
+	const subject = locator !== null && action.index === void 0 ? `${locator}.first()` : locator;
 	switch (action.action) {
 		case "navigate": return `await page.goto(${jExpr(action.value ?? "")});`;
-		case "click": return locator ? `await ${locator}.click();` : droppedActionMarker(action);
-		case "dblclick": return locator ? `await ${locator}.dblclick();` : droppedActionMarker(action);
+		case "click": return subject ? `await ${subject}.click();` : droppedActionMarker(action);
+		case "dblclick": return subject ? `await ${subject}.dblclick();` : droppedActionMarker(action);
 		case "fill":
-		case "type": return locator ? `await ${locator}.fill(${jExpr(action.value ?? "")});` : droppedActionMarker(action);
-		case "press": return locator ? `await ${locator}.press(${jExpr(action.value ?? "")});` : `await page.keyboard.press(${jExpr(action.value ?? "")});`;
-		case "check": return locator ? `await ${locator}.check();` : droppedActionMarker(action);
-		case "uncheck": return locator ? `await ${locator}.uncheck();` : droppedActionMarker(action);
-		case "select": return locator ? `await ${locator}.selectOption(${jExpr(action.value ?? "")});` : droppedActionMarker(action);
-		case "hover": return locator ? `await ${locator}.hover();` : droppedActionMarker(action);
-		case "focus": return locator ? `await ${locator}.focus();` : droppedActionMarker(action);
+		case "type": return subject ? `await ${subject}.fill(${jExpr(action.value ?? "")});` : droppedActionMarker(action);
+		case "press": return subject ? `await ${subject}.press(${jExpr(action.value ?? "")});` : `await page.keyboard.press(${jExpr(action.value ?? "")});`;
+		case "check": return subject ? `await ${subject}.check();` : droppedActionMarker(action);
+		case "uncheck": return subject ? `await ${subject}.uncheck();` : droppedActionMarker(action);
+		case "select": return subject ? `await ${subject}.selectOption(${jExpr(action.value ?? "")});` : droppedActionMarker(action);
+		case "hover": return subject ? `await ${subject}.hover();` : droppedActionMarker(action);
+		case "focus": return subject ? `await ${subject}.focus();` : droppedActionMarker(action);
 		case "drag":
-			if (!locator || !action.target) return droppedActionMarker(action);
-			return `await ${locator}.dragTo(${locatorToPlaywright(action.target)});`;
+			if (!subject || !action.target) return droppedActionMarker(action);
+			return `await ${subject}.dragTo(${locatorToPlaywright(action.target)}.first());`;
 		case "upload": {
 			const files = action.files ?? [];
-			if (!locator || files.length === 0) return droppedActionMarker(action);
-			return `await ${locator}.setInputFiles([${files.map(jExpr).join(", ")}]);`;
+			if (!subject || files.length === 0) return droppedActionMarker(action);
+			return `await ${subject}.setInputFiles([${files.map(jExpr).join(", ")}]);`;
 		}
 		case "scroll": return scrollToLine(action);
 		case "wait": return waitToLine(action, locator);
@@ -17808,12 +17809,14 @@ find nth <index> "<ALLOWED-css>" <action>
 3. \`find last\` is reliable only when the layout guarantees "the target is the bottom-most match" (e.g. the most-recently-sent chat message). Be explicit in the AB_ACTION label.
 4. Argument order is \`<value> <action> [flags]\` — flags after the action. Putting \`--name\` / \`--exact\` before the action makes agent-browser fail with "Unknown subaction".
 5. \`--name "<n>"\` is **role-only**. Never pass it to \`find text\`, \`find label\`, etc.
-6. \`find\` includes its own wait; do not chain a \`wait\` before it.
+6. \`--name\` matches by substring. Add \`--exact\` whenever the name you read from the snapshot is the element's whole accessible name — without it a short name such as "Log in" also matches "Log in with Google" and "Log in with SSO", and the recording silently pins the first of them.
+7. \`find\` includes its own wait; do not chain a \`wait\` before it.
 
 **Examples:**
 
 - ✓ \`find last "[data-testid='reply-link']" click\` — specific attribute + layout-guaranteed last match
 - ✓ \`find role button click --name "Submit"\` — role + accessible name (flags after action)
+- ✓ \`find role button click --name "Log in" --exact\` — short name needs \`--exact\`, or "Log in with SSO" matches too
 - ✗ \`find role button --name "Submit" click\` — wrong order
 - ✗ \`find last "button" click\` — bare tag
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.40.3",
+  "version": "1.40.5",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.40.3",
+  "version": "1.40.5",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {