ccqa 1.40.4 → 1.40.6

package/dist/bin/ccqa.mjs

@@ -1660,7 +1660,7 @@ async function invokeClaudeStreaming(options, onEvent) {
 					};
 					if (hasRefSelector(cmd)) return {
 						decision: "block",
-						reason: "@ref selectors (like @e14) are session-specific and change every run. They cannot be used in generated tests. Use one of the allowed selector formats instead: [aria-label='...'], text=..., [placeholder='...'], or [type='password']. Take a fresh snapshot and find the element's aria-label or visible text."
+						reason: "@ref selectors (like @e14) are session-specific and change every run. They cannot be used in generated tests. Use one of the allowed selector formats instead: [aria-label='...'], text=..., [placeholder='...'], or [type='password']. Take a fresh snapshot and find the element's aria-label or visible text. If an allowed selector already clicks the element but nothing happens, the element is clipped by an inner scroll container: `scrollintoview` it (addressed by a CSS selector, not `text=`) and click again — a @ref would not have fixed that either."
 					};
 					const bareTag = findPositionalBareTag(cmd);
 					if (bareTag !== null) return {
@@ -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
 
@@ -17826,6 +17829,7 @@ find nth <index> "<ALLOWED-css>" <action>
 5. For checkboxes: try \`check "text=Label"\` or \`check "[aria-label='Label']"\`.
 6. If repeated labels make every ALLOWED selector ambiguous → use the \`find\` subset above.
 7. Never guess. If a selector fails, take a fresh snapshot before retrying.
+8. **A click that reports success but changes nothing means the element sits outside the visible part of an inner scroll container** — the event dispatches, the app never reacts, and no error is printed. Run \`scrollintoview\` on the element and click again. Scroll to the element itself, addressed by a CSS selector (\`scrollintoview "button.primary-action"\`); \`scrollintoview "text=…"\` can land on a text node that leaves the control still clipped. Do not read this as a product bug or reach for a \`@ref\` — verify by checking that the DOM changed (e.g. \`get count\` on what the click should have produced).
 
 ### Special input types
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.40.4",
+  "version": "1.40.6",
   "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.4",
+  "version": "1.40.6",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {