blastproof 0.16.0 → 0.17.0

package/README.md

@@ -77,6 +77,8 @@ Three questions. The first one decides most cases.
 
 **A hard requirement, not a preference.** blastproof finds elements the way a screen reader does — by role, by label, by visible text. That is what removes selectors and survives redesigns. The cost is that there is deliberately no CSS or XPath fallback, so anything the accessibility tree cannot describe cannot be driven at all.
 
+The name is matched **exactly first**, then by substring if nothing matches exactly — so a control named `Add` is found even when `Add New` sits above it. When several controls answer to the same name, the first one on the page wins. Give each control an accessible name no other control on the page shares; a page that cannot offer one cannot be driven unambiguously, and no matching rule fixes that.
+
 | works | cannot be driven |
 | --- | --- |
 | `<button>Add to cart</button>` | a `<div>` with a click handler |

package/dist/cli.js

@@ -424,13 +424,18 @@ function describeTarget(target) {
 async function resolveTarget(page, target, resolveTimeoutMs = 2e3) {
   const candidates = [];
   if (target.role) {
+    if (target.name) {
+      candidates.push(page.getByRole(target.role, { name: target.name, exact: true }));
+    }
     candidates.push(page.getByRole(target.role, target.name ? { name: target.name } : {}));
   }
   if (target.name) {
+    candidates.push(page.getByLabel(target.name, { exact: true }));
     candidates.push(page.getByLabel(target.name));
   }
   const text = target.text ?? target.name;
   if (text) {
+    candidates.push(page.getByText(text, { exact: true }));
     candidates.push(page.getByText(text));
   }
   for (const candidate of candidates) {
@@ -2952,13 +2957,11 @@ async function planCommand(options) {
           written.push(path10.relative(options.cwd, file));
           console.log(`  wrote ${path10.relative(options.cwd, file)}`);
         } catch (error) {
-          if (error instanceof PlannerError) {
-            generated.pop();
-            failed.push({ route, reason: error.message });
-            console.log(`  X failed: ${error.message}`);
-            continue;
-          }
-          throw error;
+          generated.pop();
+          const reason = error instanceof Error ? error.message : String(error);
+          failed.push({ route, reason });
+          console.log(`  X failed: ${reason}`);
+          continue;
         }
       } else {
         console.log(`
@@ -3079,7 +3082,7 @@ function parsePositiveNumber(flag) {
   };
 }
 var program = new Command();
-program.name("blastproof").description("Open-source AI testing agent: plain-English YAML tests executed agentically on a real browser.").version("0.16.0");
+program.name("blastproof").description("Open-source AI testing agent: plain-English YAML tests executed agentically on a real browser.").version("0.17.0");
 program.command("init").description("Scaffold .blastproof/ (config, tests, sample tests) in the current directory").action(async () => {
   try {
     const result = await initProject(process.cwd());