explorbot 0.1.10 → 0.1.12

package/dist/src/ai/navigator.js

@@ -8,8 +8,9 @@ import { HooksRunner } from "../utils/hooks-runner.js";
 import { createDebug, pluralize, tag } from '../utils/logger.js';
 import { loop, pause } from '../utils/loop.js';
 import { RulesLoader } from "../utils/rules-loader.js";
+import { extractStatePath } from '../utils/url-matcher.js';
 import { Researcher } from "./researcher.js";
-import { actionRule, locatorRule } from './rules.js';
+import { actionRule, locatorRule, unexpectedPopupRule } from './rules.js';
 import { isInteractive } from './task-agent.js';
 import { createAgentTools } from "./tools.js";
 const debugLog = createDebug('explorbot:navigator');
@@ -131,11 +132,10 @@ class Navigator {
       </hint>`;
         }
         if (!actionResult.isInsideIframe) {
-            const toc = this.experienceTracker.getExperienceTableOfContents(actionResult);
-            if (toc.length > 0) {
-                const totalSections = toc.reduce((sum, entry) => sum + entry.sections.length, 0);
-                tag('substep').log(`Found ${toc.length} experience ${pluralize(toc.length, 'file')} (${totalSections} sections) for: ${actionResult.url}`);
-                experience = renderExperienceToc(toc);
+            const successful = this.experienceTracker.getSuccessfulExperience(actionResult);
+            if (successful.length > 0) {
+                tag('substep').log(`Found ${successful.length} experience ${pluralize(successful.length, 'file')} for: ${actionResult.url}`);
+                experience = `<experience>\nPast successful recipes recorded from prior runs for this page. Prefer these solutions first if they match the goal.\n\n${successful.join('\n\n')}\n</experience>`;
             }
         }
         const prompt = dedent `
@@ -163,6 +163,8 @@ class Navigator {
 
       ${actionRule}
 
+      ${unexpectedPopupRule}
+
       ${RulesLoader.loadRules('navigator', ['multiple-locator', 'output'], actionResult.url || '').replace('{{maxAttempts}}', String(this.MAX_ATTEMPTS))}
 
       ${experience}
@@ -171,11 +173,13 @@ class Navigator {
     `;
         const conversation = this.provider.startConversation(this.systemPrompt, 'navigator');
         conversation.addUserText(prompt);
-        const tools = this.buildExperienceTools();
+        const tools = undefined;
         let codeBlocks = [];
         let htmlContextAdded = false;
         let codeBlockIndex = 0;
         let totalAttempts = 0;
+        const progressBlocks = [];
+        const batchFailures = [];
         let resolved = false;
         await loop(async ({ stop }) => {
             if (codeBlocks.length === 0) {
@@ -194,43 +198,90 @@ class Navigator {
             }
             const codeBlock = codeBlocks[codeBlockIndex];
             if (!codeBlock) {
+                if (batchFailures.length === 0 && htmlContextAdded) {
+                    stop();
+                    return;
+                }
+                tag('substep').log('Feeding failures back to AI for a new batch...');
+                let contextMsg = 'Previous solutions did not work. Analyze the failures and try DIFFERENT strategies (not syntactic variants of the same locator).\n\n';
+                if (batchFailures.length > 0) {
+                    const lines = batchFailures.map((f) => `- \`${f.code.split('\n')[0]}\` → ${f.error}`).join('\n');
+                    contextMsg += `<previous_failures>\n${lines}\n</previous_failures>\n\n`;
+                }
                 if (!htmlContextAdded) {
                     htmlContextAdded = true;
-                    tag('substep').log('Adding HTML context for better resolution...');
-                    conversation.addUserText(dedent `
-              Previous solutions did not work. Here is the full HTML context:
-
-              <page_html>
-              ${await actionResult.combinedHtml()}
-              </page_html>
-
-              Please suggest new solutions based on this additional context.
-            `);
-                    codeBlocks = [];
-                    return;
+                    contextMsg += `Full HTML context:\n\n<page_html>\n${await actionResult.combinedHtml()}\n</page_html>\n\n`;
                 }
-                stop();
+                contextMsg += 'Propose new solutions. If errors mention "intercepts pointer events" or timeouts on visible elements, an overlay is blocking — dismiss it first (Escape, click outside, Close button) before retrying the original action.';
+                conversation.addUserText(contextMsg);
+                codeBlocks = [];
+                batchFailures.length = 0;
                 return;
             }
             codeBlockIndex++;
             totalAttempts++;
             await this.explorer.switchToMainFrame();
+            const prevHash = action.actionResult?.getStateHash() ?? actionResult.getStateHash();
             debugLog(`Attempting resolution: ${codeBlock}`);
-            resolved = await action.attempt(codeBlock, message);
+            const attemptOk = await action.attempt(codeBlock, message);
+            const page = action.playwrightHelper?.page;
+            if (page) {
+                try {
+                    await page.waitForLoadState('load', { timeout: 5000 });
+                }
+                catch {
+                    // Navigation did not reach 'load' state within timeout; continue and verify URL
+                }
+            }
+            if (!attemptOk) {
+                const raw = action.lastError?.message || 'attempt failed';
+                const firstMeaningful = raw.split('\n').find((l) => l.trim() && !l.trim().startsWith('at ')) || raw;
+                const shortErr = firstMeaningful.replace(/\s+/g, ' ').trim().slice(0, 220);
+                batchFailures.push({ code: codeBlock, error: shortErr });
+            }
             if (expectedUrl) {
-                await action.getActor().wait(2);
-                const freshState = await action.capturePageState();
-                if (normalizeUrl(freshState.url || '') === normalizeUrl(expectedUrl)) {
-                    resolved = true;
+                if (page) {
+                    try {
+                        await page.waitForURL((url) => normalizeUrl(url.pathname) === normalizeUrl(expectedUrl), { timeout: 5000 });
+                    }
+                    catch {
+                        // URL did not transition to expectedUrl within timeout
+                    }
                 }
-                else if (resolved) {
+                const freshState = await action.capturePageState();
+                const urlMatches = normalizeUrl(freshState.url || '') === normalizeUrl(expectedUrl);
+                const stateChanged = freshState.getStateHash() !== actionResult.getStateHash();
+                resolved = urlMatches && stateChanged;
+                if (!resolved && attemptOk) {
                     tag('warning').log(`URL verification failed: expected ${expectedUrl}, got ${freshState.url}`);
-                    resolved = false;
+                }
+                if (freshState.getStateHash() !== prevHash && (attemptOk || urlMatches)) {
+                    progressBlocks.push(codeBlock);
                 }
             }
+            else {
+                resolved = attemptOk;
+                if (attemptOk)
+                    progressBlocks.push(codeBlock);
+            }
             if (resolved) {
                 tag('success').log('Navigation resolved successfully');
-                this.experienceTracker.writeAction(actionResult, { title: message, code: codeBlock });
+                let scenario = message.split('\n')[0];
+                if (expectedUrl) {
+                    const fromPath = extractStatePath(actionResult.url || '');
+                    const toPath = extractStatePath(expectedUrl);
+                    scenario = `reach ${toPath} from ${fromPath}`;
+                }
+                const recipe = progressBlocks
+                    .join('\n')
+                    .split('\n')
+                    .filter((line) => !/^\s*I\.amOnPage\s*\(/.test(line))
+                    .join('\n')
+                    .trim();
+                if (recipe) {
+                    const body = `## FLOW: ${scenario}\n\n* ${scenario}\n\n\`\`\`js\n${recipe}\n\`\`\`\n\n---\n`;
+                    this.experienceTracker.writeFlow(actionResult, body);
+                }
                 stop();
                 return;
             }
@@ -455,6 +506,7 @@ class Navigator {
         const tools = this.buildExperienceTools();
         let codeBlocks = [];
         const successfulCodes = [];
+        const assertionSteps = [];
         const action = this.explorer.createAction();
         await loop(async ({ stop, iteration }) => {
             if (codeBlocks.length === 0) {
@@ -479,6 +531,7 @@ class Navigator {
             if (verified) {
                 tag('success').log('Verification passed');
                 successfulCodes.push(codeBlock);
+                assertionSteps.push(...action.assertionSteps);
             }
         }, {
             maxAttempts: this.MAX_ATTEMPTS,
@@ -493,7 +546,7 @@ class Navigator {
         const verified = totalAttempted <= 1 ? successfulCodes.length > 0 : successfulCodes.length > totalAttempted / 2;
         actionResult.addVerification(message, verified);
         this.explorer.getStateManager().updateState(actionResult);
-        return { verified, successfulCodes, totalAttempted };
+        return { verified, successfulCodes, assertionSteps, totalAttempted };
     }
 }
 export { Navigator };

package/dist/src/ai/pilot.js

@@ -6,6 +6,7 @@ import { ConfigParser } from "../config.js";
 import { renderExperienceToc } from "../experience-tracker.js";
 import { TestResult } from "../test-plan.js";
 import { collectInteractiveNodes, detectFocusArea, extractFocusedElement } from "../utils/aria.js";
+import { ErrorPageError } from "../utils/error-page.js";
 import { createDebug, tag } from "../utils/logger.js";
 const debugLog = createDebug('explorbot:pilot');
 import { truncateJson } from "../utils/strings.js";
@@ -42,22 +43,27 @@ export class Pilot {
             return null;
         return this.conversation.getLastMessage() || null;
     }
-    async reviewStop(task, currentState, testerConversation) {
-        return this.reviewDecision('stop', task, currentState, testerConversation);
+    async reviewStop(task, currentState, testerConversation, navigator) {
+        return this.reviewDecision('stop', task, currentState, testerConversation, navigator);
     }
-    async reviewFinish(task, currentState, testerConversation) {
-        return this.reviewDecision('finish', task, currentState, testerConversation);
+    async reviewFinish(task, currentState, testerConversation, navigator) {
+        return this.reviewDecision('finish', task, currentState, testerConversation, navigator);
     }
-    async reviewCompletion(task, currentState, testerConversation) {
+    async reviewCompletion(task, currentState, testerConversation, navigator) {
         const verdictType = task.hasAchievedAny() ? 'finish' : 'stop';
-        return this.reviewDecision(verdictType, task, currentState, testerConversation);
+        return this.reviewDecision(verdictType, task, currentState, testerConversation, navigator);
     }
-    async finalReview(task, currentState, testerConversation) {
+    async finalReview(task, currentState, testerConversation, navigator) {
         if (task.hasFinished)
             return false;
-        return this.reviewCompletion(task, currentState, testerConversation);
+        return this.reviewCompletion(task, currentState, testerConversation, navigator);
     }
-    async reviewDecision(type, task, currentState, testerConversation) {
+    async reviewReset(task, currentState, reason, testerConversation) {
+        return this.reviewResetDecision(task, currentState, reason, testerConversation);
+    }
+    async reviewDecision(type, task, currentState, testerConversation, navigator) {
+        if (task.hasFinished)
+            return false;
         tag('substep').log(`Pilot reviewing ${type} verdict...`);
         const sessionLog = this.formatSessionLog(testerConversation);
         const stateContext = this.buildStateContext(currentState);
@@ -79,6 +85,10 @@ export class Pilot {
             decision: z.enum(['pass', 'fail', 'continue', 'skipped']).describe('pass = test succeeded, fail = test failed, continue = tester should keep going, skipped = scenario is irrelevant OR systematic execution failures prevented testing'),
             reason: z.string().describe('What happened and why (1-2 sentences). Do NOT repeat the decision status (e.g. "scenario goal achieved/not achieved") — just explain the evidence. For continue: explain why rejected and suggest alternatives.'),
             guidance: z.string().nullable().describe('Required for "continue": specific actionable instruction for the tester — what exactly to verify, retry differently, or complete next. Be concrete.'),
+            requestVerification: z
+                .string()
+                .nullable()
+                .describe('REQUIRED whenever decision is "pass" — provide a specific assertion that proves the scenario goal on the current page (e.g., "New test suite \\"Foo\\" is visible in the suites list"). The system runs it and bakes the resulting assertion into the generated test file; without it the test file has no verifiable expect(). Also use when evidence is insufficient before deciding pass/fail. Leave null for "continue", "fail", or "skipped".'),
         });
         const userContent = dedent `
       Tester wants to ${type} the test.
@@ -106,6 +116,12 @@ export class Pilot {
       - "continue" if tester hasn't completed the scenario goal yet — even if milestones were checked
       - If evidence is mixed, but final state indicates goal completion, choose "pass"
       - If evidence is mixed and final state is unclear, prefer "continue" over "fail"
+
+      When deciding "pass", you MUST also set requestVerification to a CodeceptJS assertion that
+      proves the scenario goal on the current page. Choose the strongest single evidence (a unique
+      element/text that exists ONLY because the scenario succeeded). The assertion is executed and
+      then converted into the spec file's expect() — without it the generated test has nothing to
+      assert and is worthless.
     `;
         const messages = [
             {
@@ -124,6 +140,30 @@ export class Pilot {
                 task.finish(TestResult.FAILED);
                 return false;
             }
+            if (result.requestVerification && navigator) {
+                tag('substep').log(`Pilot requesting verification: ${result.requestVerification}`);
+                try {
+                    const verifyResult = await navigator.verifyState(result.requestVerification, currentState);
+                    if (verifyResult.verified) {
+                        if (verifyResult.assertionSteps?.length) {
+                            this.explorer.getPlaywrightRecorder().recordVerification(verifyResult.assertionSteps);
+                        }
+                        tag('substep').log(`Pilot verified: ${result.requestVerification}`);
+                    }
+                    else {
+                        tag('substep').log(`Pilot verification failed: ${result.requestVerification}`);
+                        if (result.decision === 'pass') {
+                            const flipMessage = `Verification "${result.requestVerification}" did not match the page. Adjust approach and re-verify before finishing.`;
+                            result.decision = 'continue';
+                            result.reason = flipMessage;
+                            result.guidance = result.guidance ?? flipMessage;
+                        }
+                    }
+                }
+                catch (verifyErr) {
+                    tag('warning').log(`Pilot verification errored: ${verifyErr.message}`);
+                }
+            }
             tag('info').log(`Pilot: ${result.decision} — ${result.reason}`);
             task.summary = result.reason;
             if (result.decision === 'pass') {
@@ -152,6 +192,131 @@ export class Pilot {
             return false;
         }
     }
+    async reviewResetDecision(task, currentState, reason, testerConversation) {
+        if (task.hasFinished)
+            return false;
+        tag('substep').log(`Pilot reviewing reset (count=${task.resetCount})...`);
+        const sessionLog = this.formatSessionLog(testerConversation);
+        const stateContext = this.buildStateContext(currentState);
+        const notes = task.notesToString() || 'No notes recorded.';
+        const schema = z.object({
+            decision: z.enum(['allow', 'fail', 'continue', 'skipped']).describe('allow = reset proceeds, fail = test failed (stop looping), continue = veto reset, tester should act on current page instead, skipped = scenario is irrelevant or cannot be executed'),
+            reason: z.string().describe('What evidence justifies this decision (1-2 sentences). Do not restate the decision.'),
+            guidance: z.string().nullable().describe('Required for "continue": concrete instruction for what the tester should do instead of resetting (e.g. which tool to call, what to verify).'),
+        });
+        const userContent = dedent `
+      Tester requested reset. Previous reset count: ${task.resetCount - 1}.
+
+      Reason given by tester: ${reason || '(none)'}
+
+      <state>
+      ${stateContext}
+      </state>
+
+      ${this.formatExpectations(task)}
+
+      <notes>
+      ${notes}
+      </notes>
+
+      <session_log>
+      ${sessionLog || 'No actions recorded'}
+      </session_log>
+
+      Decide:
+      - "allow" — the reset is legitimate (navigation dead-end, wrong page, irrecoverable error on current page).
+      - "continue" — veto the reset; something on the current page can still be used to progress or verify. Provide guidance.
+      - "fail" — reset-looping: tester has already reset and the underlying obstacle will not change. Stop the test as failed.
+      - "skipped" — the scenario is inapplicable to this application or cannot be executed here.
+    `;
+        const messages = [
+            {
+                role: 'system',
+                content: this.buildResetSystemPrompt(task),
+            },
+            { role: 'user', content: userContent },
+        ];
+        try {
+            const response = await this.provider.generateObject(messages, schema, this.provider.getAgenticModel('pilot'), {
+                agentName: 'pilot',
+                experimental_telemetry: { functionId: 'pilot.reviewReset' },
+            });
+            const result = response?.object;
+            if (!result) {
+                return true;
+            }
+            tag('info').log(`Pilot reset verdict: ${result.decision} — ${result.reason}`);
+            if (result.decision === 'allow') {
+                tag('substep').log(`Pilot allowed reset: ${result.reason}`);
+                return true;
+            }
+            if (result.decision === 'fail') {
+                task.addNote(`Pilot: reset refused — ${result.reason}`, TestResult.FAILED);
+                task.finish(TestResult.FAILED);
+                return false;
+            }
+            if (result.decision === 'skipped') {
+                task.addNote(`Pilot: skipped — ${result.reason}`, TestResult.SKIPPED);
+                task.finish(TestResult.SKIPPED);
+                return false;
+            }
+            tag('substep').log(`Pilot vetoed reset: ${result.reason}`);
+            const guidanceText = result.guidance ? `\n\nWhat to do instead: ${result.guidance}` : '';
+            testerConversation.addUserText(`Pilot vetoed reset: ${result.reason}${guidanceText}`);
+            return false;
+        }
+        catch (error) {
+            tag('warning').log(`Pilot reset review failed: ${error.message}`);
+            return true;
+        }
+    }
+    buildResetSystemPrompt(task) {
+        return dedent `
+      You are Pilot — the supervisor that decides whether a reset is legitimate.
+      Tester wants to reset (navigate back to the start URL and discard progress).
+
+      SCENARIO: ${task.scenario}
+
+      Reset is DESTRUCTIVE. It abandons all work done in this iteration. In stateful apps, any
+      side effects (records created, forms submitted) persist on the server — resetting does not
+      undo them. Unnecessary resets create duplicate data and loop forever.
+
+      LEGITIMATE RESET (decide "allow"):
+      - The current page is unrelated to the scenario and no path leads back.
+      - Navigation is stuck in an error state with no recoverable action.
+      - The tester arrived on a page that cannot host the scenario at all.
+
+      ILLEGITIMATE RESET (decide "continue"):
+      - The previous action already succeeded (URL changed to a success/detail page, record visible,
+        confirmation shown) and tester wants to redo it because an assertion did not match.
+        The work is done — verify, record, or finish instead of restarting.
+      - A single expectation / milestone does not match app reality but the scenario goal may still
+        have been achieved. Do not redo — instruct the tester to verify the actual outcome.
+      - Tester wants to "try again with different input" after a form was submitted. Submitting
+        again creates a duplicate; guide toward editing the existing record or accepting the state.
+
+      RESET-LOOP (decide "fail"):
+      - resetCount >= 2 and the previous resets did not change the underlying situation.
+      - The same flow has been attempted twice with the same failure mode.
+      - Repeating the reset cannot produce new information.
+
+      SCENARIO INAPPLICABLE (decide "skipped"):
+      - The feature the scenario targets does not exist on this app, or prerequisites cannot be met.
+
+      PRIORITY:
+      1) Evidence of successful side effects in session_log (URL transition, new record visible).
+         If present, almost never allow the reset — the work is done.
+      2) resetCount. Each prior reset raises the bar for allowing another.
+      3) Tester's stated reason. Weigh it against the observed evidence, do not trust it blindly.
+
+      GUIDANCE FIELD (required when decision is "continue"):
+      Give a specific next action on the current page: which tool to call, what to verify, or how to
+      record the outcome. Do not suggest repeating actions that already succeeded.
+
+      EXPECTED RESULTS (milestones, not the goal):
+      ${task.expected.map((e) => `- ${e}`).join('\n')}
+    `;
+    }
     buildVerdictSystemPrompt(type, task) {
         return dedent `
       You are Pilot — the final decision maker for test pass/fail.
@@ -248,8 +413,12 @@ export class Pilot {
         the elements needed for the scenario. The page summary does not list every element.
         Prefer interacting with the current page over navigating away.
 
+        If you load a recipe via learn_experience, do NOT rewrite its code in your plan — the
+        raw recipe is forwarded to Tester automatically. Reference it by step ("apply recipe
+        steps 1–3, then…") and call out anywhere your scenario diverges from it.
+
         Be concise and specific. Tester will follow your plan.
-      `, 'pilot.planTest', { tools: true, maxToolRoundtrips: 3, task });
+      `, 'pilot.planTest', { tools: true, planningOnly: true, maxToolRoundtrips: 3, task });
     }
     async reviewNewPage(task, currentState) {
         if (!this.conversation)
@@ -329,7 +498,10 @@ export class Pilot {
             }
         }
         this.conversation.addUserText(finalUserText);
-        let tools = opts.tools ? this.agentTools : undefined;
+        let tools;
+        if (opts.tools) {
+            tools = opts.planningOnly ? this.pickPlanningTools() : this.agentTools;
+        }
         if (opts.tools && opts.task) {
             tools = { ...tools, ...this.buildPreconditionTool(opts.task) };
         }
@@ -338,7 +510,20 @@ export class Pilot {
             agentName: 'pilot',
             experimental_telemetry: { functionId },
         });
-        return result?.response?.text || '';
+        const text = result?.response?.text || '';
+        const learned = (result?.toolExecutions || []).filter((e) => e.toolName === 'learn_experience' && e.output?.content).map((e) => e.output.content);
+        if (learned.length === 0)
+            return text;
+        return dedent `
+      ${text}
+
+      <applied_experience>
+      Recipes from prior successful runs that Pilot judged relevant. Locators worked then; the page may have changed since.
+      Treat code blocks below as a starting hypothesis. If a locator misses, fall back to ARIA/UI-map.
+
+      ${learned.join('\n\n')}
+      </applied_experience>
+    `;
     }
     getExperienceToc() {
         if (!this.experienceTracker)
@@ -350,6 +535,25 @@ export class Pilot {
         const toc = this.experienceTracker.getExperienceTableOfContents(actionResult);
         return renderExperienceToc(toc);
     }
+    pickPlanningTools() {
+        const { see, context, verify, research, getVisitedStates, xpathCheck, learn_experience } = this.agentTools ?? {};
+        const planning = {};
+        if (see)
+            planning.see = see;
+        if (context)
+            planning.context = context;
+        if (verify)
+            planning.verify = verify;
+        if (research)
+            planning.research = research;
+        if (getVisitedStates)
+            planning.getVisitedStates = getVisitedStates;
+        if (xpathCheck)
+            planning.xpathCheck = xpathCheck;
+        if (learn_experience)
+            planning.learn_experience = learn_experience;
+        return planning;
+    }
     buildPreconditionTool(task) {
         return {
             precondition: tool({
@@ -483,7 +687,15 @@ export class Pilot {
             }
         }
         if (text.includes('ATTACH_UI_MAP')) {
-            const uiMap = await this.researcher.research(currentState);
+            let uiMap = '';
+            try {
+                uiMap = await this.researcher.research(currentState);
+            }
+            catch (err) {
+                if (!(err instanceof ErrorPageError))
+                    throw err;
+                tag('warning').log(`Pilot UI map skipped: ${err.message}`);
+            }
             if (uiMap) {
                 parts.push(dedent `
           <page_ui_map>
@@ -635,6 +847,13 @@ export class Pilot {
       - If the goal was achieved by a previous action (SUCCESS in recent_actions with confirming ariaDiff): instruct Tester to verify() the result and finish(). Do NOT repeat the same action.
       - If Tester keeps re-opening the same panel and re-submitting the same data — STOP. The action was already completed.
 
+      Action-goal alignment — classify every recent successful action:
+      - GOAL-ADVANCING: creates, edits, removes, submits, or verifies the scenario's subject data (the object the scenario actually changes).
+      - VIEW-ONLY: toggles layout, filters, tabs, segment controls, sort orders, collapse/expand — changes which data is shown without modifying it.
+      - A single VIEW-ONLY action is legitimate when needed to reveal a target element for the next GOAL-ADVANCING action.
+      - A run of two or more consecutive successful VIEW-ONLY actions with no interleaved GOAL-ADVANCING action is thrashing — Tester is exploring UI instead of executing the scenario. Redirect Tester to the specific mutation or verification the scenario requires.
+      - VIEW-ONLY actions also tend to produce large page diffs with many htmlParts; if you see that pattern repeatedly in recent_actions, treat it as evidence of thrashing.
+
       Navigation awareness — always compare current page url to START URL:
       - subpage navigation (deeper path from START URL) — OK, scenario may need sub-pages
       - outer-page navigation (parent/sibling path from START URL) — SUSPICIOUS. The scenario target is on the START page. Do NOT rationalize leaving it. Instruct Tester to back() or reset().

package/dist/src/ai/planner.js

@@ -400,6 +400,34 @@ export class Planner extends PlannerBase {
             const allTests = this.currentPlan.getAllTests();
             const titleListing = allTests.map((t) => `- "${t.scenario}" [${t.result || 'pending'}]`).join('\n');
             const compactContext = planToCompactAiContext(this.currentPlan);
+            let planningStrategy;
+            if (feature) {
+                planningStrategy = dedent `
+          <planning_strategy>
+          Stay strictly inside the "${feature}" feature area. Do NOT switch to a different, unrelated feature even if it has no coverage.
+          Propose ${this.MIN_TASKS}-${this.MAX_TASKS} additional scenarios for "${feature}" that are not already in the tested list.
+          Use the <approach> above to decide which new angles to explore — different controls, inputs, states, outcome categories, or combinations — all within "${feature}".
+          Return an empty scenarios array only when no genuinely new scenario for "${feature}" remains.
+          </planning_strategy>
+        `;
+            }
+            else {
+                let extendedResearchHint = '';
+                if (mdq(plannerResearch).query('section("Extended Research")').count() > 0) {
+                    extendedResearchHint = 'IMPORTANT: The research contains "Extended Research" sections with dropdowns, modals, and panels. Prioritize testing features from Extended Research that have no coverage yet.';
+                }
+                planningStrategy = dedent `
+          <planning_strategy>
+          Find a feature area in the research that has NO or minimal test coverage.
+          Pick that ONE feature and propose ${this.MIN_TASKS}-${this.MAX_TASKS} tests for it.
+          ${extendedResearchHint}
+
+          Follow the <approach> described above when proposing tests for this feature.
+
+          If ALL features across ALL research sections are covered, return empty scenarios array.
+          </planning_strategy>
+        `;
+            }
             conversation.addUserText(dedent `
         CRITICAL: This plan already has tests.
 
@@ -419,15 +447,7 @@ export class Planner extends PlannerBase {
         ${compactContext}
         </tested_scenarios>
 
-        <planning_strategy>
-        Find a feature area in the research that has NO or minimal test coverage.
-        Pick that ONE feature and propose ${this.MIN_TASKS}-${this.MAX_TASKS} tests for it.
-        ${mdq(plannerResearch).query('section("Extended Research")').count() > 0 ? 'IMPORTANT: The research contains "Extended Research" sections with dropdowns, modals, and panels. Prioritize testing features from Extended Research that have no coverage yet.' : ''}
-
-        Follow the <approach> described above when proposing tests for this feature.
-
-        If ALL features across ALL research sections are covered, return empty scenarios array.
-        </planning_strategy>
+        ${planningStrategy}
 
         <context_from_previous_tests>
         During testing, the following pages were visited: