explorbot 0.1.32-beta.1 → 0.2.0

package/dist/src/ai/fisherman-tools.js

@@ -136,7 +136,7 @@ function extractKeyFields(body, result = {}, depth = 0) {
         return result;
     }
     for (const [key, value] of Object.entries(body)) {
-        if (value === null || value === undefined)
+        if (value == null)
             continue;
         if (typeof value === 'object') {
             extractKeyFields(value, result, depth + 1);

package/dist/src/ai/fisherman.d.ts

@@ -18,7 +18,6 @@ export declare class Fisherman implements Agent {
     hasApiConfig: boolean;
     constructor(provider: Provider, apiClient: ApiClient, requestStore: RequestStore, specLoader: () => Promise<any | null>, baseEndpoint: string, cookieProvider: () => Promise<Record<string, string>>, configHeaders?: Record<string, string>, hasApiConfig?: boolean);
     isAvailable(): boolean;
-    getMode(): string;
     ensureReady(scopeUrl?: string): Promise<void>;
     getEndpointList(scopeUrl?: string): string;
     prepareData(instructions: string, scopeUrl?: string, sessionName?: string): Promise<FishermanResult>;

package/dist/src/ai/fisherman.js

@@ -34,9 +34,6 @@ export class Fisherman {
     isAvailable() {
         return this.mode !== 'disabled';
     }
-    getMode() {
-        return this.mode;
-    }
     async ensureReady(scopeUrl) {
         await this.detectMode(scopeUrl);
         this.spec ??= await this.specLoader();

package/dist/src/ai/historian/codeceptjs.d.ts

@@ -1,3 +1,4 @@
+import type { StateManager } from '../../state-manager.js';
 import type { Plan } from '../../test-plan.js';
 import type { Conversation } from '../conversation.js';
 import type { Constructor } from './mixin.js';
@@ -8,6 +9,7 @@ export interface CodeceptJSMethods {
 export declare function WithCodeceptJS<T extends Constructor>(Base: T): {
     new (...args: any[]): {
         savedFiles: Set<string>;
+        stateManager?: StateManager;
         toCode(conversation: Conversation, scenario: string): string;
         saveCodeceptPlanToFile(plan: Plan): string;
         getKnowledgeLines(url: string, indent?: string): string[];

package/dist/src/ai/historian/codeceptjs.js

@@ -2,7 +2,6 @@ import { mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { ActionResult } from "../../action-result.js";
 import { ConfigParser } from "../../config.js";
-import { KnowledgeTracker } from "../../knowledge-tracker.js";
 import { tag } from "../../utils/logger.js";
 import { relativeToCwd } from "../../utils/next-steps.js";
 import { safeFilename } from "../../utils/strings.js";
@@ -87,7 +86,9 @@ export function WithCodeceptJS(Base) {
             return filePath;
         }
         getKnowledgeLines(url, indent = '  ') {
-            const knowledgeTracker = new KnowledgeTracker();
+            const knowledgeTracker = this.stateManager?.getKnowledgeTracker();
+            if (!knowledgeTracker)
+                return [];
             const state = new ActionResult({ url });
             const { wait, waitForElement, code } = knowledgeTracker.getStateParameters(state, ['wait', 'waitForElement', 'code']);
             const lines = [];

package/dist/src/ai/historian/playwright.d.ts

@@ -1,3 +1,4 @@
+import type { StateManager } from '../../state-manager.js';
 import { type PlaywrightRecorder } from '../../playwright-recorder.js';
 import type { Plan } from '../../test-plan.js';
 import type { Conversation } from '../conversation.js';
@@ -13,6 +14,7 @@ export declare function WithPlaywright<T extends Constructor>(Base: T): {
             helper: any;
         } | undefined;
         savedFiles: Set<string>;
+        stateManager?: StateManager;
         toPlaywrightCode(conversation: Conversation, scenario: string): Promise<string>;
         savePlaywrightPlanToFile(plan: Plan): string;
         getPlaywrightKnowledgeLines(url: string, indent?: string): string[];

package/dist/src/ai/historian/playwright.js

@@ -2,7 +2,6 @@ import { mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { ActionResult } from "../../action-result.js";
 import { ConfigParser } from "../../config.js";
-import { KnowledgeTracker } from "../../knowledge-tracker.js";
 import { renderAssertion, renderCall } from "../../playwright-recorder.js";
 import { tag } from "../../utils/logger.js";
 import { relativeToCwd } from "../../utils/next-steps.js";
@@ -124,7 +123,9 @@ export function WithPlaywright(Base) {
             return filePath;
         }
         getPlaywrightKnowledgeLines(url, indent = '    ') {
-            const knowledgeTracker = new KnowledgeTracker();
+            const knowledgeTracker = this.stateManager?.getKnowledgeTracker();
+            if (!knowledgeTracker)
+                return [];
             const state = new ActionResult({ url });
             const { wait, waitForElement } = knowledgeTracker.getStateParameters(state, ['wait', 'waitForElement']);
             const lines = [];

package/dist/src/ai/historian/utils.d.ts

@@ -1,4 +1,3 @@
 import type { ToolExecution } from '../conversation.js';
-export { isNonReusableCode, stripComments } from '../../utils/step-analyzer.js';
 export declare function escapeString(str: string): string;
 export declare function getExecutionLabel(exec: ToolExecution, fallback?: string): string;

package/dist/src/ai/historian/utils.js

@@ -1,4 +1,3 @@
-export { isNonReusableCode, stripComments } from "../../utils/step-analyzer.js";
 export function escapeString(str) {
     return str.replace(/'/g, "\\'").replace(/\n/g, ' ');
 }

package/dist/src/ai/historian.d.ts

@@ -1,5 +1,5 @@
 import type { ExplorbotConfig } from '../config.js';
-import { ExperienceTracker } from '../experience-tracker.js';
+import type { ExperienceTracker } from '../experience-tracker.js';
 import type { PlaywrightRecorder } from '../playwright-recorder.js';
 import type { Reporter } from '../reporter.js';
 import type { StateManager } from '../state-manager.js';
@@ -9,7 +9,6 @@ import { type ExperienceMethods } from './historian/experience.js';
 import { type PlaywrightMethods } from './historian/playwright.js';
 import { type ScreencastMethods } from './historian/screencast.js';
 import type { Provider } from './provider.js';
-export { isNonReusableCode } from '../utils/step-analyzer.js';
 declare const HistorianBase: {
     new (...args: any[]): {
         config: ExplorbotConfig | undefined;
@@ -40,6 +39,7 @@ declare const HistorianBase: {
             helper: any;
         };
         savedFiles: Set<string>;
+        stateManager?: StateManager;
         toPlaywrightCode(conversation: import("./conversation.js").Conversation, scenario: string): Promise<string>;
         savePlaywrightPlanToFile(plan: Plan): string;
         getPlaywrightKnowledgeLines(url: string, indent?: string): string[];
@@ -47,6 +47,7 @@ declare const HistorianBase: {
 } & {
     new (...args: any[]): {
         savedFiles: Set<string>;
+        stateManager?: StateManager;
         toCode(conversation: import("./conversation.js").Conversation, scenario: string): string;
         saveCodeceptPlanToFile(plan: Plan): string;
         getKnowledgeLines(url: string, indent?: string): string[];
@@ -93,7 +94,7 @@ export declare class Historian extends HistorianBase {
         helper: any;
     } | undefined;
     savedFiles: Set<string>;
-    constructor(provider: Provider, experienceTracker?: ExperienceTracker, reporter?: Reporter, stateManager?: StateManager, config?: ExplorbotConfig, playwright?: {
+    constructor(provider: Provider, experienceTracker: ExperienceTracker, reporter?: Reporter, stateManager?: StateManager, config?: ExplorbotConfig, playwright?: {
         recorder: PlaywrightRecorder;
         helper: any;
     });
@@ -101,8 +102,8 @@ export declare class Historian extends HistorianBase {
     getSavedFiles(): string[];
     savePlanToFile(plan: Plan): string;
     rewriteScenarioInFile(filePath: string, healedSteps: Array<{
-        test: string;
         original: string;
         healed: string;
     }>): void;
 }
+export {};

package/dist/src/ai/historian.js

@@ -1,18 +1,16 @@
 import { readFileSync, writeFileSync } from 'node:fs';
-import { ExperienceTracker } from "../experience-tracker.js";
 import { tag } from "../utils/logger.js";
 import { relativeToCwd } from "../utils/next-steps.js";
 import { WithCodeceptJS } from "./historian/codeceptjs.js";
 import { WithExperience } from "./historian/experience.js";
 import { WithPlaywright } from "./historian/playwright.js";
 import { WithScreencast } from "./historian/screencast.js";
-export { isNonReusableCode } from "../utils/step-analyzer.js";
 const HistorianBase = WithScreencast(WithPlaywright(WithCodeceptJS(WithExperience(Object))));
 export class Historian extends HistorianBase {
     constructor(provider, experienceTracker, reporter, stateManager, config, playwright) {
         super();
         this.provider = provider;
-        this.experienceTracker = experienceTracker || new ExperienceTracker();
+        this.experienceTracker = experienceTracker;
         this.reporter = reporter;
         this.stateManager = stateManager;
         this.config = config;
@@ -32,8 +30,6 @@ export class Historian extends HistorianBase {
     rewriteScenarioInFile(filePath, healedSteps) {
         let content = readFileSync(filePath, 'utf-8');
         for (const step of healedSteps) {
-            if (!content.includes(step.original))
-                continue;
             content = content.replace(step.original, step.healed);
         }
         writeFileSync(filePath, content);

package/dist/src/ai/navigator.d.ts

@@ -1,16 +1,14 @@
 import { ActionResult } from '../action-result.js';
 import type Action from '../action.js';
-import { ExperienceTracker } from '../experience-tracker.js';
+import type { ExperienceTracker } from '../experience-tracker.js';
 import Explorer from '../explorer.js';
-import { KnowledgeTracker } from '../knowledge-tracker.js';
+import type { KnowledgeTracker } from '../knowledge-tracker.js';
 import { HooksRunner } from '../utils/hooks-runner.js';
 import type { Agent } from './agent.js';
-import { ExperienceCompactor } from './experience-compactor.js';
 import type { Provider } from './provider.js';
 declare class Navigator implements Agent {
     emoji: string;
     provider: Provider;
-    experienceCompactor: ExperienceCompactor;
     knowledgeTracker: KnowledgeTracker;
     experienceTracker: ExperienceTracker;
     hooksRunner: HooksRunner;
@@ -18,7 +16,7 @@ declare class Navigator implements Agent {
     systemPrompt: string;
     freeSailSystemPrompt: string;
     explorer: Explorer;
-    constructor(explorer: Explorer, provider: Provider, experienceCompactor: ExperienceCompactor, experienceTracker?: ExperienceTracker);
+    constructor(explorer: Explorer, provider: Provider);
     get verifyAttempts(): number;
     get verifyTimeout(): number;
     getBaseOrigin(): string | null;

package/dist/src/ai/navigator.js

@@ -2,8 +2,6 @@ import { tool } from 'ai';
 import dedent from 'dedent';
 import { z } from 'zod';
 import { ActionResult } from '../action-result.js';
-import { ExperienceTracker, renderExperienceToc } from '../experience-tracker.js';
-import { KnowledgeTracker } from '../knowledge-tracker.js';
 import { normalizeUrl } from '../state-manager.js';
 import { extractCodeBlocks } from '../utils/code-extractor.js';
 import { HooksRunner } from "../utils/hooks-runner.js";
@@ -14,12 +12,11 @@ import { extractStatePath } from '../utils/url-matcher.js';
 import { Researcher } from "./researcher.js";
 import { actionRule, locatorRule, unexpectedPopupRule } from './rules.js';
 import { isInteractive } from './task-agent.js';
-import { createAgentTools } from "./tools.js";
+import { createLearnExperienceTool } from "./tools.js";
 const debugLog = createDebug('explorbot:navigator');
 class Navigator {
     emoji = '🧭';
     provider;
-    experienceCompactor;
     knowledgeTracker;
     experienceTracker;
     hooksRunner;
@@ -62,12 +59,11 @@ class Navigator {
   </rules>
   `;
     explorer;
-    constructor(explorer, provider, experienceCompactor, experienceTracker) {
+    constructor(explorer, provider) {
         this.provider = provider;
         this.explorer = explorer;
-        this.experienceCompactor = experienceCompactor;
-        this.knowledgeTracker = new KnowledgeTracker();
-        this.experienceTracker = experienceTracker || new ExperienceTracker();
+        this.knowledgeTracker = explorer.getKnowledgeTracker();
+        this.experienceTracker = explorer.getStateManager().getExperienceTracker();
         this.hooksRunner = new HooksRunner(explorer, explorer.getConfig());
     }
     get verifyAttempts() {
@@ -171,17 +167,8 @@ class Navigator {
         debugLog('Resolution message:', message);
         const action = opts?.action ?? this.explorer.createAction();
         const expectedUrl = opts?.expectedUrl;
-        let knowledge = '';
+        const knowledge = this.knowledgeTracker.renderRelevantKnowledge(actionResult);
         let experience = '';
-        const relevantKnowledge = this.knowledgeTracker.getRelevantKnowledge(actionResult);
-        if (relevantKnowledge.length > 0) {
-            const knowledgeContent = relevantKnowledge.map((k) => k.content).join('\n\n');
-            knowledge = `
-      <hint>
-      Here is relevant knowledge for this page:
-      ${knowledgeContent}
-      </hint>`;
-        }
         if (!actionResult.isInsideIframe) {
             const successful = this.experienceTracker.getSuccessfulExperience(actionResult);
             if (successful.length > 0) {
@@ -362,7 +349,6 @@ class Navigator {
                     if (freshState.getStateHash() !== prevHash) {
                         try {
                             const diff = await freshState.diff(prevActionResult);
-                            await diff.calculate();
                             ariaChanges = diff.ariaChanged;
                         }
                         catch (err) {
@@ -446,21 +432,14 @@ class Navigator {
         return resolved;
     }
     buildExperienceTools() {
+        if (!this.experienceTracker)
+            return undefined;
         const stateManager = this.explorer.getStateManager();
         const getState = () => {
             const s = stateManager.getCurrentState();
             return s ? ActionResult.fromState(s) : null;
         };
-        const { learnExperience } = createAgentTools({
-            explorer: this.explorer,
-            researcher: null,
-            navigator: this,
-            experienceTracker: this.experienceTracker,
-            getState,
-        });
-        if (!learnExperience)
-            return undefined;
-        return { learnExperience };
+        return { learnExperience: createLearnExperienceTool({ getExperienceTracker: () => this.experienceTracker, getState }) };
     }
     async freeSail(opts, actionResult) {
         const stateManager = this.explorer.getStateManager();
@@ -579,24 +558,10 @@ class Navigator {
             tag('operation').log(`Reusing cached verification: ${cachedVerification ? 'PASS' : 'FAIL'}`);
             return { verified: cachedVerification, successfulCodes: [], assertionSteps: [], totalAttempted: 0 };
         }
-        let knowledge = '';
+        const knowledge = this.knowledgeTracker.renderRelevantKnowledge(actionResult);
         let experience = '';
-        const relevantKnowledge = this.knowledgeTracker.getRelevantKnowledge(actionResult);
-        if (relevantKnowledge.length > 0) {
-            const knowledgeContent = relevantKnowledge.map((k) => k.content).join('\n\n');
-            knowledge = `
-      <hint>
-      Here is relevant knowledge for this page:
-      ${knowledgeContent}
-      </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('operation').log(`Found ${toc.length} experience ${pluralize(toc.length, 'file')} (${totalSections} sections) for: ${actionResult.url}`);
-                experience = renderExperienceToc(toc);
-            }
+            experience = this.experienceTracker.renderExperienceTocFor(actionResult);
         }
         const priorVerifications = Object.entries(actionResult.verifications ?? {});
         let verificationContext = '';
@@ -685,7 +650,7 @@ class Navigator {
                     return;
                 }
                 await this.explorer.switchToMainFrame();
-                const verified = await action.attempt(codeBlock, message, false);
+                const verified = await action.attempt(codeBlock, message);
                 if (verified) {
                     tag('success').log('Verification passed');
                     successfulCodes.push(codeBlock);

package/dist/src/ai/pilot.d.ts

@@ -1,5 +1,4 @@
 import { ActionResult } from '../action-result.js';
-import { type ExperienceTracker } from '../experience-tracker.js';
 import type Explorer from '../explorer.js';
 import { type Test } from '../test-plan.js';
 import type { Agent } from './agent.js';
@@ -16,8 +15,7 @@ export declare class Pilot implements Agent {
     researcher: Researcher;
     explorer: Explorer;
     fisherman: Fisherman | null;
-    experienceTracker: ExperienceTracker | null;
-    constructor(provider: Provider, agentTools: any, researcher: Researcher, explorer: Explorer, experienceTracker?: ExperienceTracker);
+    constructor(provider: Provider, agentTools: any, researcher: Researcher, explorer: Explorer);
     setFisherman(fisherman: Fisherman): void;
     get stepsToReview(): number;
     reset(): void;

package/dist/src/ai/pilot.js

@@ -3,7 +3,6 @@ import dedent from 'dedent';
 import { z } from 'zod';
 import { ActionResult } from "../action-result.js";
 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";
@@ -22,13 +21,11 @@ export class Pilot {
     researcher;
     explorer;
     fisherman = null;
-    experienceTracker;
-    constructor(provider, agentTools, researcher, explorer, experienceTracker) {
+    constructor(provider, agentTools, researcher, explorer) {
         this.provider = provider;
         this.agentTools = agentTools;
         this.researcher = researcher;
         this.explorer = explorer;
-        this.experienceTracker = experienceTracker || null;
     }
     setFisherman(fisherman) {
         this.fisherman = fisherman;
@@ -90,7 +87,7 @@ export class Pilot {
             requestVerification: z
                 .string()
                 .nullable()
-                .describe('REQUIRED whenever decision is "pass" — a one-sentence natural-language claim about the current page that, if true, proves the scenario goal (e.g., "New test suite \\"Foo\\" is visible in the suites list"). NOT code: do not write I.*, expect(), .then(), grabTitle, or any JavaScript. Navigator translates the claim into CodeceptJS assertions and runs them; passing assertions are saved to the generated test file. Also use when evidence is insufficient before deciding pass/fail. Leave null for "continue", "fail", or "skipped".'),
+                .describe('REQUIRED whenever decision is "pass" — a one-sentence natural-language claim about the current page that, if true, proves the scenario goal (e.g., "New item \\"Foo\\" is visible in the items list"). NOT code: do not write I.*, expect(), .then(), grabTitle, or any JavaScript. Navigator translates the claim into CodeceptJS assertions and runs them; passing assertions are saved to the generated test file. 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.
@@ -124,7 +121,7 @@ export class Pilot {
       - Mixed evidence + final state shows success → pass. Mixed + final state unclear → continue with guidance.
 
       When deciding "pass", you MUST also set requestVerification to a one-sentence natural-language
-      claim about the current page (e.g., "New test suite Foo is visible in the suites list"). NOT
+      claim about the current page (e.g., "New item Foo is visible in the items list"). NOT
       code — do not write I.*, expect(), .then(), or any JavaScript. Choose the strongest single
       piece of evidence (a unique element/text that exists ONLY because the scenario succeeded).
       Navigator translates the claim into CodeceptJS assertions; without it the generated test has
@@ -379,10 +376,6 @@ export class Pilot {
 
         FIRST: Decide if precondition() is needed.
 
-        ${capabilityGroundingRule}
-
-        ${dataProtectionRules}
-
         Call precondition() WHEN:
         - The scenario edits/deletes/modifies an item, and you want a DISPOSABLE item to act on safely
         - The scenario needs specific data clearly NOT on the current page (e.g., items with specific statuses for filtering)
@@ -525,14 +518,10 @@ export class Pilot {
     `;
     }
     getExperienceToc() {
-        if (!this.experienceTracker)
-            return '';
         const state = this.explorer.getStateManager().getCurrentState();
         if (!state)
             return '';
-        const actionResult = ActionResult.fromState(state);
-        const toc = this.experienceTracker.getExperienceTableOfContents(actionResult);
-        return renderExperienceToc(toc);
+        return this.explorer.getStateManager().getExperienceTracker().renderExperienceTocFor(ActionResult.fromState(state));
     }
     pickPlanningTools() {
         const { see, context, verify, research, getVisitedStates, xpathCheck, learnExperience, askUser } = this.agentTools ?? {};
@@ -957,8 +946,8 @@ export class Pilot {
 
       ${dataProtectionRules}
 
-      Describe WHAT to create, not what exists. RIGHT: precondition("1 test"). WRONG:
-      precondition("1 test suite named Updated Suite with existing tests"). Keep descriptions short.
+      Describe WHAT to create, not what exists. RIGHT: precondition("1 post"). WRONG:
+      precondition("1 post named Updated Post with existing comments"). Keep descriptions short.
 
       Response format:
       PROGRESS: <1 sentence assessment>

package/dist/src/ai/planner.d.ts

@@ -1,5 +1,5 @@
 import { ActionResult } from '../action-result.js';
-import { ExperienceTracker } from '../experience-tracker.js';
+import type { ExperienceTracker } from '../experience-tracker.js';
 import type Explorer from '../explorer.js';
 import type { StateManager } from '../state-manager.js';
 import { Suite } from '../suite.js';
@@ -8,7 +8,7 @@ import type { Agent } from './agent.js';
 import { Conversation } from './conversation.js';
 import type { Fisherman } from './fisherman.js';
 import type { Provider } from './provider.js';
-import { Researcher } from './researcher.js';
+import { type Researcher } from './researcher.js';
 declare const PlannerBase: {
     new (...args: any[]): {
         currentPlan: Plan | null;
@@ -58,7 +58,7 @@ export declare class Planner extends PlannerBase implements Agent {
     lastSuite: Suite | null;
     researcher: Researcher;
     fisherman: Fisherman | null;
-    constructor(explorer: Explorer, provider: Provider);
+    constructor(explorer: Explorer, provider: Provider, researcher: Researcher);
     setFisherman(fisherman: Fisherman): void;
     get sectionOrder(): string[];
     getDefaultStartUrl(state: {

package/dist/src/ai/planner.js

@@ -3,7 +3,6 @@ import { z } from 'zod';
 import { ActionResult } from "../action-result.js";
 import { setActivity } from "../activity.js";
 import { ConfigParser } from "../config.js";
-import { ExperienceTracker } from "../experience-tracker.js";
 import { Observability } from "../observability.js";
 import { Stats } from "../stats.js";
 import { Suite } from "../suite.js";
@@ -16,7 +15,7 @@ import { Conversation } from "./conversation.js";
 import { WithSessionDedup } from "./planner/session-dedup.js";
 import { getActiveStyle } from "./planner/styles.js";
 import { WithSubPages, getPlannedByStateHash, getRegisteredPlan, registerPlan } from "./planner/subpages.js";
-import { POSSIBLE_SECTIONS, Researcher } from "./researcher.js";
+import { POSSIBLE_SECTIONS } from "./researcher.js";
 import { findSimilarStateHash } from "./researcher/cache.js";
 import { hasFocusedSection } from "./researcher/focus.js";
 import { capabilityGroundingRule, dataProtectionRules, fileUploadRule } from "./rules.js";
@@ -50,13 +49,13 @@ export class Planner extends PlannerBase {
     lastSuite = null;
     researcher;
     fisherman = null;
-    constructor(explorer, provider) {
+    constructor(explorer, provider, researcher) {
         super();
         this.explorer = explorer;
         this.provider = provider;
-        this.researcher = new Researcher(explorer, provider);
+        this.researcher = researcher;
         this.stateManager = explorer.getStateManager();
-        this.experienceTracker = new ExperienceTracker();
+        this.experienceTracker = explorer.getStateManager().getExperienceTracker();
     }
     setFisherman(fisherman) {
         this.fisherman = fisherman;
@@ -81,7 +80,7 @@ export class Planner extends PlannerBase {
     You are ISTQB certified senior manual QA planning exploratory testing session of a web application.
     Each test scenario must complete a meaningful user workflow — not just open a UI element and verify it exists.
     Bad: "Open the Help panel" — just opens something.
-    Good: "Create a new suite and verify it appears in the list" — completes a business action.
+    Good: "Create a new post and verify it appears in the list" — completes a business action.
     </role>
     <task>
       List possible testing scenarios for the web page.
@@ -149,6 +148,7 @@ export class Planner extends PlannerBase {
         const tags = ['planner'];
         if (style)
             tags.push(style);
+        const existingTestScenarios = this.getExistingTestFileScenarios(state.url);
         const result = await Observability.run(`planner: ${state.url}`, { tags, sessionId: state.url }, async () => {
             const actionResult = ActionResult.fromState(state);
             const conversation = await this.buildConversation(actionResult, style, parentPlan, feature);
@@ -182,7 +182,6 @@ export class Planner extends PlannerBase {
             if (parentPlan)
                 this.currentPlan.parentPlan = parentPlan;
             const allPreviousScenarios = this.getPreviousSessionScenarios();
-            const existingTestScenarios = this.getExistingTestFileScenarios(state.url);
             for (const s of existingTestScenarios)
                 allPreviousScenarios.add(s);
             for (const t of tests) {
@@ -232,6 +231,7 @@ export class Planner extends PlannerBase {
         return added;
     }
     getExistingTestFileScenarios(currentUrl) {
+        this.lastSuite = null;
         if (!currentUrl)
             return new Set();
         try {
@@ -244,27 +244,37 @@ export class Planner extends PlannerBase {
         }
     }
     cleanExperienceFlows(text) {
-        const seenTitles = new Set();
         let result = text;
-        for (const section of [...mdq(text).query('section2').each(), ...mdq(text).query('section3').each()]) {
-            const heading = section.query('heading').text().trim();
-            const body = mdq(section.text())
-                .query('heading')
-                .replace('')
-                .replace(/^---\s*$/gm, '')
-                .trim();
-            if (!body || seenTitles.has(heading)) {
-                result = result.replace(section.text(), '');
-                continue;
-            }
-            seenTitles.add(heading);
-            const blockquotes = section.query('blockquote').each();
-            if (blockquotes.length <= 10)
-                continue;
-            for (const bq of blockquotes.slice(10)) {
-                result = result.replace(bq.text(), '');
-            }
-            result = result.replace(section.text().trim(), `${section.text().trim()}\n> ... and ${blockquotes.length - 10} more discoveries`);
+        const seenTitles = new Set();
+        for (const selector of ['section2', 'section3']) {
+            result = mdq(result)
+                .query(selector)
+                .replaceEach((section) => {
+                const heading = section.query('heading').text().trim();
+                const withoutHeadings = mdq(section.text()).query('heading').replace('');
+                const body = mdq(withoutHeadings).query('hr').replace('').trim();
+                if (body && !seenTitles.has(heading)) {
+                    seenTitles.add(heading);
+                    return section.text();
+                }
+                return '';
+            });
+        }
+        const trimmedTitles = new Set();
+        for (const selector of ['section2', 'section3']) {
+            result = mdq(result)
+                .query(selector)
+                .replaceEach((section) => {
+                const heading = section.query('heading').text().trim();
+                if (trimmedTitles.has(heading))
+                    return section.text();
+                const count = section.query('blockquote').count();
+                if (count <= 10)
+                    return section.text();
+                const kept = mdq(section.text()).query('blockquote[10:]').replace('');
+                trimmedTitles.add(heading);
+                return `${kept.trimEnd()}\n> ... and ${count - 10} more discoveries\n`;
+            });
         }
         return result.trim() || null;
     }
@@ -298,6 +308,7 @@ export class Planner extends PlannerBase {
       If there are subpages (pages with same URL path) plan testing of those subpages as well
       If you plan to test CRUD operations, plan them in correct order: create, read, update.
       Do not invent specific route names, success messages, validation texts, badge counts, or welcome messages unless they are visible in research, visited pages, or prior observed flows.
+      When validation placement or wording was not observed, require feedback associated with the invalid input without inventing a specific location or message.
       If exact wording is unknown, describe the expected result generically, for example "an authentication error is shown" or "the user stays on the login page" instead of guessing the literal text.
       If exact redirect destination is unknown, describe the destination by visible page identity, for example "the dashboard page opens" or "the current workspace home page opens" instead of inventing a URL slug.
       Only propose scenarios whose prerequisites are evident from page research, visited pages, or API data preparation context.
@@ -337,17 +348,18 @@ export class Planner extends PlannerBase {
             deep: true,
         });
         let plannerResearch = mdq(research).query('code').replace('');
-        for (const table of mdq(plannerResearch).query('table').each()) {
-            const rawTable = table.text();
+        plannerResearch = mdq(plannerResearch)
+            .query('table')
+            .replaceEach((table) => {
             const rows = table.toJson();
             if (rows.length === 0 || !rows[0].Element)
-                continue;
+                return table.text();
             const elementWithType = rows.map((r) => ({
                 Element: r.Element,
                 Type: r.Type || '',
             }));
-            plannerResearch = plannerResearch.replace(rawTable, jsonToTable(elementWithType, ['Element', 'Type']));
-        }
+            return jsonToTable(elementWithType, ['Element', 'Type']);
+        });
         const hasFocusedOverlay = hasFocusedSection(plannerResearch);
         const focusNote = hasFocusedOverlay ? "IMPORTANT: One section is marked as **Focused** — this is the user's current focus area. Concentrate testing on the Focused section FIRST — test all interactions inside it before planning tests for the rest of the page." : '';
         const featureFilter = feature ? `FOCUS FILTER: Only propose scenarios using elements relevant to "${feature}". Ignore all other elements.` : '';
@@ -525,17 +537,17 @@ export class Planner extends PlannerBase {
 
          STEPS - actionable commands:
          - Each step should be a specific action to perform
-         - Good: "Click Create Suite button", "Enter 'My New Suite' as suite name", "Click Save button"
-         - Good: "Click Star icon on 'Template API Testing' suite"
+         - Good: "Click Create Post button", "Enter 'My New Post' as post title", "Click Save button"
+         - Good: "Click Star icon on 'Quarterly Report' item"
          - Bad: "Open the dropdown menu" (opening is not a goal, it's a means)
          - Bad: "Verify modal appears" (verification belongs in expected outcomes, not steps)
          - Steps should form a complete workflow, not stop at opening a UI element
          - NEVER split a workflow across two tests. One test = one complete action + its verification
 
          EXPECTED OUTCOMES - verifiable results:
-         - Good: "New suite 'My New Suite' appears in the suite list"
-         - Good: "Suite appears under Starred filter tab"
-         - Good: "Success message 'Suite created' is displayed"
+         - Good: "New post 'My New Post' appears in the posts list"
+         - Good: "Item appears under Starred filter tab"
+         - Good: "Success message 'Post created' is displayed"
          - Good when wording is unknown: "An authentication error is displayed"
          - Good when route is unknown: "The workspace home page is displayed"
          - Bad: "Modal is displayed" (just verifying existence, no business value)