donobu 5.60.2 → 5.60.3

package/dist/cli/donobu-cli.js

@@ -1378,12 +1378,16 @@ async function attemptAutoHealRun(params) {
             envOverrides.DONOBU_PAGE_AI_CLEAR_CACHE_FILES =
                 JSON.stringify(clearCacheFiles);
         }
-        // The rerun plan drives the collection-time gate in the test wrapper:
-        // only the heal targets (and their declared `describe.serial` siblings)
-        // execute; every other collected test statically skips. Declared
-        // dependency projects still run in full — Playwright's semantics.
+        // The rerun plan drives the runtime gate in the test fixture: within the
+        // gated projects, only the heal targets (and their declared
+        // `describe.serial` siblings) execute. Projects outside the gate —
+        // declared dependencies of target projects, teardown projects — run in
+        // full, exactly as Playwright schedules them.
         const healPlanPath = path.join(staging.rootDir, 'heal-rerun-plan.json');
-        await fs_1.promises.writeFile(healPlanPath, JSON.stringify({ targets: healTargets }), 'utf8');
+        await fs_1.promises.writeFile(healPlanPath, JSON.stringify({
+            targets: healTargets,
+            gatedProjects: (0, healRerunGate_1.computeGatedProjects)(healTargets.map((target) => target.projectName), params.initialReport?.metadata?.projectDependencies),
+        }), 'utf8');
         envOverrides.DONOBU_AUTO_HEAL_PLAN_PATH = healPlanPath;
         Logger_1.appLogger.info(`Auto-heal: re-running ${healTargets.length} targeted test(s) from ${evaluation.eligiblePlans.length} treatment plan(s)...`);
         const healJsonReportPath = path.join(staging.playwrightOutputDir, PLAYWRIGHT_JSON_REPORT_FILENAME);
@@ -2178,8 +2182,10 @@ async function runHealCommand(cliArgs) {
     applyJsonReportEnv(envOverrides, playwrightOutputDir);
     // Downstream hooks check this flag to avoid recursive auto-heal loops.
     envOverrides.DONOBU_AUTO_HEAL_ACTIVE = '1';
-    // Same collection-time gating as the automatic rerun: only the plan's test
-    // (plus declared `describe.serial` siblings) executes.
+    // Same runtime gating as the automatic rerun: only the plan's test (plus
+    // declared `describe.serial` siblings) executes within its own project;
+    // dependency projects run in full. Without an initial report there is no
+    // dependency graph, so the gate scopes to just the target's project.
     const healPlanPath = path.join(os.tmpdir(), `donobu-heal-rerun-plan-${Date.now()}.json`);
     await fs_1.promises.writeFile(healPlanPath, JSON.stringify({
         targets: [
@@ -2189,6 +2195,7 @@ async function runHealCommand(cliArgs) {
                 projectName: persisted.failure.testCase.projectName,
             },
         ],
+        gatedProjects: (0, healRerunGate_1.computeGatedProjects)([persisted.failure.testCase.projectName], undefined),
     }), 'utf8');
     envOverrides.DONOBU_AUTO_HEAL_PLAN_PATH = healPlanPath;
     Logger_1.appLogger.info(`Re-running Playwright using treatment plan at ${parsed.planPath}...`);

package/dist/esm/cli/donobu-cli.js

@@ -1378,12 +1378,16 @@ async function attemptAutoHealRun(params) {
             envOverrides.DONOBU_PAGE_AI_CLEAR_CACHE_FILES =
                 JSON.stringify(clearCacheFiles);
         }
-        // The rerun plan drives the collection-time gate in the test wrapper:
-        // only the heal targets (and their declared `describe.serial` siblings)
-        // execute; every other collected test statically skips. Declared
-        // dependency projects still run in full — Playwright's semantics.
+        // The rerun plan drives the runtime gate in the test fixture: within the
+        // gated projects, only the heal targets (and their declared
+        // `describe.serial` siblings) execute. Projects outside the gate —
+        // declared dependencies of target projects, teardown projects — run in
+        // full, exactly as Playwright schedules them.
         const healPlanPath = path.join(staging.rootDir, 'heal-rerun-plan.json');
-        await fs_1.promises.writeFile(healPlanPath, JSON.stringify({ targets: healTargets }), 'utf8');
+        await fs_1.promises.writeFile(healPlanPath, JSON.stringify({
+            targets: healTargets,
+            gatedProjects: (0, healRerunGate_1.computeGatedProjects)(healTargets.map((target) => target.projectName), params.initialReport?.metadata?.projectDependencies),
+        }), 'utf8');
         envOverrides.DONOBU_AUTO_HEAL_PLAN_PATH = healPlanPath;
         Logger_1.appLogger.info(`Auto-heal: re-running ${healTargets.length} targeted test(s) from ${evaluation.eligiblePlans.length} treatment plan(s)...`);
         const healJsonReportPath = path.join(staging.playwrightOutputDir, PLAYWRIGHT_JSON_REPORT_FILENAME);
@@ -2178,8 +2182,10 @@ async function runHealCommand(cliArgs) {
     applyJsonReportEnv(envOverrides, playwrightOutputDir);
     // Downstream hooks check this flag to avoid recursive auto-heal loops.
     envOverrides.DONOBU_AUTO_HEAL_ACTIVE = '1';
-    // Same collection-time gating as the automatic rerun: only the plan's test
-    // (plus declared `describe.serial` siblings) executes.
+    // Same runtime gating as the automatic rerun: only the plan's test (plus
+    // declared `describe.serial` siblings) executes within its own project;
+    // dependency projects run in full. Without an initial report there is no
+    // dependency graph, so the gate scopes to just the target's project.
     const healPlanPath = path.join(os.tmpdir(), `donobu-heal-rerun-plan-${Date.now()}.json`);
     await fs_1.promises.writeFile(healPlanPath, JSON.stringify({
         targets: [
@@ -2189,6 +2195,7 @@ async function runHealCommand(cliArgs) {
                 projectName: persisted.failure.testCase.projectName,
             },
         ],
+        gatedProjects: (0, healRerunGate_1.computeGatedProjects)([persisted.failure.testCase.projectName], undefined),
     }), 'utf8');
     envOverrides.DONOBU_AUTO_HEAL_PLAN_PATH = healPlanPath;
     Logger_1.appLogger.info(`Re-running Playwright using treatment plan at ${parsed.planPath}...`);

package/dist/esm/lib/test/healRerunGate.d.ts

@@ -44,10 +44,25 @@ export interface HealRerunPlan {
         title: string;
         projectName?: string;
     }>;
+    /**
+     * Projects the gate applies to. Tests in any other project — declared
+     * dependency projects (auth/setup), teardown projects — run untouched,
+     * exactly as Playwright schedules them. Computed by the orchestrator via
+     * `computeGatedProjects`; when absent, the gate falls back to the targets'
+     * own project names.
+     */
+    gatedProjects?: string[];
 }
 /** Targets indexed by absolute spec path for O(1) per-test decisions. */
 export type HealRerunPlanIndex = Map<string, Set<string>>;
 export declare function buildPlanIndex(plan: HealRerunPlan): HealRerunPlanIndex;
+/**
+ * The projects the rerun gate should apply to: the heal targets' own
+ * projects, minus any project that is a declared (transitive) dependency of
+ * another target project — the dependency declaration wins, and that project
+ * runs in full.
+ */
+export declare function computeGatedProjects(targetProjects: Array<string | undefined>, projectDependencies: Record<string, string[]> | undefined): string[];
 /**
  * Pure decision: should the test in `file` with `title` actually execute
  * during the heal rerun? The plan is fully explicit — serial companions were
@@ -76,8 +91,10 @@ export declare function expandTargetsWithSerialCompanions(targets: HealRerunPlan
 export declare function resetHealRerunPlanCacheForTesting(): void;
 /**
  * Called from the Donobu auto fixture before any browser fixture initializes.
- * Outside heal reruns this is a no-op. During a rerun, tests outside the plan
- * are annotated and skipped on the spot — no context, no page, no cost.
+ * Outside heal reruns this is a no-op. During a rerun, tests in gated
+ * projects that are outside the plan are annotated and skipped on the spot —
+ * no context, no page, no cost. Tests in ungated projects (declared
+ * dependencies of the targets, teardown projects) always run.
  */
 export declare function maybeSkipForHealRerun(testInfo: TestInfo, options?: {
     planPath?: string;

package/dist/esm/lib/test/healRerunGate.js

@@ -41,6 +41,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildPlanIndex = buildPlanIndex;
+exports.computeGatedProjects = computeGatedProjects;
 exports.shouldRunDuringHealRerun = shouldRunDuringHealRerun;
 exports.expandTargetsWithSerialCompanions = expandTargetsWithSerialCompanions;
 exports.resetHealRerunPlanCacheForTesting = resetHealRerunPlanCacheForTesting;
@@ -64,6 +65,32 @@ function buildPlanIndex(plan) {
     }
     return index;
 }
+/**
+ * The projects the rerun gate should apply to: the heal targets' own
+ * projects, minus any project that is a declared (transitive) dependency of
+ * another target project — the dependency declaration wins, and that project
+ * runs in full.
+ */
+function computeGatedProjects(targetProjects, projectDependencies) {
+    const targets = [
+        ...new Set(targetProjects.filter((name) => Boolean(name))),
+    ];
+    if (!projectDependencies) {
+        return targets;
+    }
+    // Every project reachable through any target's declared dependency chain.
+    const reachable = new Set();
+    const visit = (name) => {
+        for (const dependency of projectDependencies[name] ?? []) {
+            if (!reachable.has(dependency)) {
+                reachable.add(dependency);
+                visit(dependency);
+            }
+        }
+    };
+    targets.forEach(visit);
+    return targets.filter((name) => !reachable.has(name));
+}
 /**
  * Pure decision: should the test in `file` with `title` actually execute
  * during the heal rerun? The plan is fully explicit — serial companions were
@@ -133,44 +160,59 @@ function expandTargetsWithSerialCompanions(targets, initialReport) {
     }
     return expanded;
 }
-let cachedPlanIndex;
-function getPlanIndex(planPathOverride) {
-    if (planPathOverride === undefined && cachedPlanIndex !== undefined) {
-        return cachedPlanIndex;
+let cachedPlan;
+function loadPlan(planPathOverride) {
+    if (planPathOverride === undefined && cachedPlan !== undefined) {
+        return cachedPlan;
     }
     const planPath = planPathOverride ?? envVars_1.env.data.DONOBU_AUTO_HEAL_PLAN_PATH;
-    let index = null;
+    let loaded = null;
     if (planPath) {
         try {
             const raw = fs_1.default.readFileSync(planPath, 'utf8');
-            index = buildPlanIndex(JSON.parse(raw));
+            const plan = JSON.parse(raw);
+            loaded = {
+                index: buildPlanIndex(plan),
+                gatedProjects: new Set(plan.gatedProjects ??
+                    // Older plans carry no project list — gate the targets' own
+                    // projects, leaving everything else (dependencies) untouched.
+                    plan.targets
+                        ?.map((target) => target.projectName)
+                        .filter((name) => Boolean(name)) ??
+                    []),
+            };
         }
         catch (error) {
             Logger_1.appLogger.warn(`Auto-heal rerun plan at ${planPath} could not be read; running all collected tests.`, error);
-            index = null;
+            loaded = null;
         }
     }
     if (planPathOverride === undefined) {
-        cachedPlanIndex = index;
+        cachedPlan = loaded;
     }
-    return index;
+    return loaded;
 }
 /** Test-only: reset the memoized plan so each test can load its own. */
 function resetHealRerunPlanCacheForTesting() {
-    cachedPlanIndex = undefined;
+    cachedPlan = undefined;
 }
 /**
  * Called from the Donobu auto fixture before any browser fixture initializes.
- * Outside heal reruns this is a no-op. During a rerun, tests outside the plan
- * are annotated and skipped on the spot — no context, no page, no cost.
+ * Outside heal reruns this is a no-op. During a rerun, tests in gated
+ * projects that are outside the plan are annotated and skipped on the spot —
+ * no context, no page, no cost. Tests in ungated projects (declared
+ * dependencies of the targets, teardown projects) always run.
  */
 function maybeSkipForHealRerun(testInfo, options) {
-    const index = getPlanIndex(options?.planPath);
-    if (!index) {
+    const plan = loadPlan(options?.planPath);
+    if (!plan) {
+        return;
+    }
+    if (!plan.gatedProjects.has(testInfo.project.name)) {
         return;
     }
     const shouldRun = shouldRunDuringHealRerun({
-        index,
+        index: plan.index,
         file: testInfo.file,
         title: testInfo.title,
     });

package/dist/esm/managers/DonobuStack.d.ts

@@ -43,25 +43,25 @@ export type DonobuStack = {
  *       environment variables.
  */
 export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, envPersistenceVolatile?: EnvPersistenceVolatile, environ?: import("env-struct").Env<{
-    BASE64_GPT_CONFIG: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    BROWSERBASE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    BROWSERBASE_PROJECT_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_API_BASE_URL: import("zod/v4").ZodDefault<import("zod/v4").ZodString>;
-    ANTHROPIC_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    ANTHROPIC_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    GOOGLE_GENERATIVE_AI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OLLAMA_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OLLAMA_API_URL: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OPENAI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OPENAI_API_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    PERSISTENCE_PRIORITY: import("zod/v4").ZodDefault<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
-    AWS_BEDROCK_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    AWS_ACCESS_KEY_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    AWS_SECRET_ACCESS_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_PERSISTENCE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_UPLOADS_OWNED_BY_PARENT: import("zod/v4").ZodOptional<import("zod/v4").ZodCodec<import("zod/v4").ZodString, import("zod/v4").ZodBoolean>>;
+    BASE64_GPT_CONFIG: import("zod").ZodOptional<import("zod").ZodString>;
+    BROWSERBASE_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    BROWSERBASE_PROJECT_ID: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_API_BASE_URL: import("zod").ZodDefault<import("zod").ZodString>;
+    ANTHROPIC_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    ANTHROPIC_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    GOOGLE_GENERATIVE_AI_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    OLLAMA_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    OLLAMA_API_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    OPENAI_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    OPENAI_API_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    PERSISTENCE_PRIORITY: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    AWS_BEDROCK_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    AWS_ACCESS_KEY_ID: import("zod").ZodOptional<import("zod").ZodString>;
+    AWS_SECRET_ACCESS_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_PERSISTENCE_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_UPLOADS_OWNED_BY_PARENT: import("zod").ZodOptional<import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodBoolean>>;
 }, {
     BASE64_GPT_CONFIG?: string | undefined;
     BROWSERBASE_API_KEY?: string | undefined;

package/dist/esm/reporter/buildReport.js

@@ -41,6 +41,27 @@ function buildDonobuReport(resultsByTest, rootDir) {
         }
         byTitle.get(test.title).push(test);
     }
+    // Declared project dependency graph (`FullProject.dependencies`), keyed by
+    // project name. The auto-heal orchestrator uses it to keep the rerun gate
+    // away from projects that are declared dependencies of heal targets — those
+    // must run in full, exactly as Playwright schedules them.
+    const projectDependencies = {};
+    for (const test of resultsByTest.keys()) {
+        try {
+            let suite = test.parent;
+            while (suite && suite.type !== 'project') {
+                suite = suite.parent;
+            }
+            const project = suite?.project();
+            if (project?.name && !(project.name in projectDependencies)) {
+                projectDependencies[project.name] = [...(project.dependencies ?? [])];
+            }
+        }
+        catch {
+            // Reporter shape drift — omit the entry; the orchestrator degrades to
+            // gating only the heal targets' own projects.
+        }
+    }
     const suites = [];
     for (const [file, titleMap] of byFile) {
         const specs = [];
@@ -116,7 +137,7 @@ function buildDonobuReport(resultsByTest, rootDir) {
         }
         suites.push({ file, specs });
     }
-    return { suites, metadata: {} };
+    return { suites, metadata: { projectDependencies } };
 }
 /**
  * Whether any enclosing suite is in serial mode (`test.describe.serial` or

package/dist/esm/reporter/model.d.ts

@@ -57,6 +57,13 @@ export interface DonobuReportMetadata {
     /** True on reports that are the result of merging an initial + heal run. */
     donobuMergedReport?: boolean;
     mergedAtIso?: string;
+    /**
+     * Declared Playwright project dependency graph (`FullProject.dependencies`)
+     * keyed by project name, recorded by the reporter. The auto-heal
+     * orchestrator uses it to exclude declared dependencies of heal targets
+     * from the rerun gate — they must run in full.
+     */
+    projectDependencies?: Record<string, string[]>;
     sources?: {
         initial?: string | null;
         autoHeal?: string | null;

package/dist/esm/utils/BrowserUtils.d.ts

@@ -71,10 +71,10 @@ export declare class BrowserUtils {
      * @throws {InvalidParamValueException} When an invalid browser type is specified.
      */
     static create(browserConfig: BrowserConfig, videoDir?: string, storageState?: BrowserStorageState, environ?: import("env-struct").Env<{
-        BROWSERBASE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-        PROXY_SERVER: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-        PROXY_USERNAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-        PROXY_PASSWORD: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+        BROWSERBASE_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+        PROXY_SERVER: import("zod").ZodOptional<import("zod").ZodString>;
+        PROXY_USERNAME: import("zod").ZodOptional<import("zod").ZodString>;
+        PROXY_PASSWORD: import("zod").ZodOptional<import("zod").ZodString>;
     }, {
         BROWSERBASE_API_KEY?: string | undefined;
         PROXY_SERVER?: string | undefined;

package/dist/lib/test/healRerunGate.d.ts

@@ -44,10 +44,25 @@ export interface HealRerunPlan {
         title: string;
         projectName?: string;
     }>;
+    /**
+     * Projects the gate applies to. Tests in any other project — declared
+     * dependency projects (auth/setup), teardown projects — run untouched,
+     * exactly as Playwright schedules them. Computed by the orchestrator via
+     * `computeGatedProjects`; when absent, the gate falls back to the targets'
+     * own project names.
+     */
+    gatedProjects?: string[];
 }
 /** Targets indexed by absolute spec path for O(1) per-test decisions. */
 export type HealRerunPlanIndex = Map<string, Set<string>>;
 export declare function buildPlanIndex(plan: HealRerunPlan): HealRerunPlanIndex;
+/**
+ * The projects the rerun gate should apply to: the heal targets' own
+ * projects, minus any project that is a declared (transitive) dependency of
+ * another target project — the dependency declaration wins, and that project
+ * runs in full.
+ */
+export declare function computeGatedProjects(targetProjects: Array<string | undefined>, projectDependencies: Record<string, string[]> | undefined): string[];
 /**
  * Pure decision: should the test in `file` with `title` actually execute
  * during the heal rerun? The plan is fully explicit — serial companions were
@@ -76,8 +91,10 @@ export declare function expandTargetsWithSerialCompanions(targets: HealRerunPlan
 export declare function resetHealRerunPlanCacheForTesting(): void;
 /**
  * Called from the Donobu auto fixture before any browser fixture initializes.
- * Outside heal reruns this is a no-op. During a rerun, tests outside the plan
- * are annotated and skipped on the spot — no context, no page, no cost.
+ * Outside heal reruns this is a no-op. During a rerun, tests in gated
+ * projects that are outside the plan are annotated and skipped on the spot —
+ * no context, no page, no cost. Tests in ungated projects (declared
+ * dependencies of the targets, teardown projects) always run.
  */
 export declare function maybeSkipForHealRerun(testInfo: TestInfo, options?: {
     planPath?: string;

package/dist/lib/test/healRerunGate.js

@@ -41,6 +41,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildPlanIndex = buildPlanIndex;
+exports.computeGatedProjects = computeGatedProjects;
 exports.shouldRunDuringHealRerun = shouldRunDuringHealRerun;
 exports.expandTargetsWithSerialCompanions = expandTargetsWithSerialCompanions;
 exports.resetHealRerunPlanCacheForTesting = resetHealRerunPlanCacheForTesting;
@@ -64,6 +65,32 @@ function buildPlanIndex(plan) {
     }
     return index;
 }
+/**
+ * The projects the rerun gate should apply to: the heal targets' own
+ * projects, minus any project that is a declared (transitive) dependency of
+ * another target project — the dependency declaration wins, and that project
+ * runs in full.
+ */
+function computeGatedProjects(targetProjects, projectDependencies) {
+    const targets = [
+        ...new Set(targetProjects.filter((name) => Boolean(name))),
+    ];
+    if (!projectDependencies) {
+        return targets;
+    }
+    // Every project reachable through any target's declared dependency chain.
+    const reachable = new Set();
+    const visit = (name) => {
+        for (const dependency of projectDependencies[name] ?? []) {
+            if (!reachable.has(dependency)) {
+                reachable.add(dependency);
+                visit(dependency);
+            }
+        }
+    };
+    targets.forEach(visit);
+    return targets.filter((name) => !reachable.has(name));
+}
 /**
  * Pure decision: should the test in `file` with `title` actually execute
  * during the heal rerun? The plan is fully explicit — serial companions were
@@ -133,44 +160,59 @@ function expandTargetsWithSerialCompanions(targets, initialReport) {
     }
     return expanded;
 }
-let cachedPlanIndex;
-function getPlanIndex(planPathOverride) {
-    if (planPathOverride === undefined && cachedPlanIndex !== undefined) {
-        return cachedPlanIndex;
+let cachedPlan;
+function loadPlan(planPathOverride) {
+    if (planPathOverride === undefined && cachedPlan !== undefined) {
+        return cachedPlan;
     }
     const planPath = planPathOverride ?? envVars_1.env.data.DONOBU_AUTO_HEAL_PLAN_PATH;
-    let index = null;
+    let loaded = null;
     if (planPath) {
         try {
             const raw = fs_1.default.readFileSync(planPath, 'utf8');
-            index = buildPlanIndex(JSON.parse(raw));
+            const plan = JSON.parse(raw);
+            loaded = {
+                index: buildPlanIndex(plan),
+                gatedProjects: new Set(plan.gatedProjects ??
+                    // Older plans carry no project list — gate the targets' own
+                    // projects, leaving everything else (dependencies) untouched.
+                    plan.targets
+                        ?.map((target) => target.projectName)
+                        .filter((name) => Boolean(name)) ??
+                    []),
+            };
         }
         catch (error) {
             Logger_1.appLogger.warn(`Auto-heal rerun plan at ${planPath} could not be read; running all collected tests.`, error);
-            index = null;
+            loaded = null;
         }
     }
     if (planPathOverride === undefined) {
-        cachedPlanIndex = index;
+        cachedPlan = loaded;
     }
-    return index;
+    return loaded;
 }
 /** Test-only: reset the memoized plan so each test can load its own. */
 function resetHealRerunPlanCacheForTesting() {
-    cachedPlanIndex = undefined;
+    cachedPlan = undefined;
 }
 /**
  * Called from the Donobu auto fixture before any browser fixture initializes.
- * Outside heal reruns this is a no-op. During a rerun, tests outside the plan
- * are annotated and skipped on the spot — no context, no page, no cost.
+ * Outside heal reruns this is a no-op. During a rerun, tests in gated
+ * projects that are outside the plan are annotated and skipped on the spot —
+ * no context, no page, no cost. Tests in ungated projects (declared
+ * dependencies of the targets, teardown projects) always run.
  */
 function maybeSkipForHealRerun(testInfo, options) {
-    const index = getPlanIndex(options?.planPath);
-    if (!index) {
+    const plan = loadPlan(options?.planPath);
+    if (!plan) {
+        return;
+    }
+    if (!plan.gatedProjects.has(testInfo.project.name)) {
         return;
     }
     const shouldRun = shouldRunDuringHealRerun({
-        index,
+        index: plan.index,
         file: testInfo.file,
         title: testInfo.title,
     });

package/dist/managers/DonobuStack.d.ts

@@ -43,25 +43,25 @@ export type DonobuStack = {
  *       environment variables.
  */
 export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, envPersistenceVolatile?: EnvPersistenceVolatile, environ?: import("env-struct").Env<{
-    BASE64_GPT_CONFIG: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    BROWSERBASE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    BROWSERBASE_PROJECT_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_API_BASE_URL: import("zod/v4").ZodDefault<import("zod/v4").ZodString>;
-    ANTHROPIC_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    ANTHROPIC_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    GOOGLE_GENERATIVE_AI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OLLAMA_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OLLAMA_API_URL: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OPENAI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    OPENAI_API_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    PERSISTENCE_PRIORITY: import("zod/v4").ZodDefault<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
-    AWS_BEDROCK_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    AWS_ACCESS_KEY_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    AWS_SECRET_ACCESS_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_PERSISTENCE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DONOBU_UPLOADS_OWNED_BY_PARENT: import("zod/v4").ZodOptional<import("zod/v4").ZodCodec<import("zod/v4").ZodString, import("zod/v4").ZodBoolean>>;
+    BASE64_GPT_CONFIG: import("zod").ZodOptional<import("zod").ZodString>;
+    BROWSERBASE_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    BROWSERBASE_PROJECT_ID: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_API_BASE_URL: import("zod").ZodDefault<import("zod").ZodString>;
+    ANTHROPIC_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    ANTHROPIC_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    GOOGLE_GENERATIVE_AI_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    OLLAMA_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    OLLAMA_API_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    OPENAI_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    OPENAI_API_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    PERSISTENCE_PRIORITY: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    AWS_BEDROCK_MODEL_NAME: import("zod").ZodOptional<import("zod").ZodString>;
+    AWS_ACCESS_KEY_ID: import("zod").ZodOptional<import("zod").ZodString>;
+    AWS_SECRET_ACCESS_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_PERSISTENCE_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    DONOBU_UPLOADS_OWNED_BY_PARENT: import("zod").ZodOptional<import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodBoolean>>;
 }, {
     BASE64_GPT_CONFIG?: string | undefined;
     BROWSERBASE_API_KEY?: string | undefined;

package/dist/reporter/buildReport.js

@@ -41,6 +41,27 @@ function buildDonobuReport(resultsByTest, rootDir) {
         }
         byTitle.get(test.title).push(test);
     }
+    // Declared project dependency graph (`FullProject.dependencies`), keyed by
+    // project name. The auto-heal orchestrator uses it to keep the rerun gate
+    // away from projects that are declared dependencies of heal targets — those
+    // must run in full, exactly as Playwright schedules them.
+    const projectDependencies = {};
+    for (const test of resultsByTest.keys()) {
+        try {
+            let suite = test.parent;
+            while (suite && suite.type !== 'project') {
+                suite = suite.parent;
+            }
+            const project = suite?.project();
+            if (project?.name && !(project.name in projectDependencies)) {
+                projectDependencies[project.name] = [...(project.dependencies ?? [])];
+            }
+        }
+        catch {
+            // Reporter shape drift — omit the entry; the orchestrator degrades to
+            // gating only the heal targets' own projects.
+        }
+    }
     const suites = [];
     for (const [file, titleMap] of byFile) {
         const specs = [];
@@ -116,7 +137,7 @@ function buildDonobuReport(resultsByTest, rootDir) {
         }
         suites.push({ file, specs });
     }
-    return { suites, metadata: {} };
+    return { suites, metadata: { projectDependencies } };
 }
 /**
  * Whether any enclosing suite is in serial mode (`test.describe.serial` or

package/dist/reporter/model.d.ts

@@ -57,6 +57,13 @@ export interface DonobuReportMetadata {
     /** True on reports that are the result of merging an initial + heal run. */
     donobuMergedReport?: boolean;
     mergedAtIso?: string;
+    /**
+     * Declared Playwright project dependency graph (`FullProject.dependencies`)
+     * keyed by project name, recorded by the reporter. The auto-heal
+     * orchestrator uses it to exclude declared dependencies of heal targets
+     * from the rerun gate — they must run in full.
+     */
+    projectDependencies?: Record<string, string[]>;
     sources?: {
         initial?: string | null;
         autoHeal?: string | null;

package/dist/utils/BrowserUtils.d.ts

@@ -71,10 +71,10 @@ export declare class BrowserUtils {
      * @throws {InvalidParamValueException} When an invalid browser type is specified.
      */
     static create(browserConfig: BrowserConfig, videoDir?: string, storageState?: BrowserStorageState, environ?: import("env-struct").Env<{
-        BROWSERBASE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-        PROXY_SERVER: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-        PROXY_USERNAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-        PROXY_PASSWORD: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+        BROWSERBASE_API_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+        PROXY_SERVER: import("zod").ZodOptional<import("zod").ZodString>;
+        PROXY_USERNAME: import("zod").ZodOptional<import("zod").ZodString>;
+        PROXY_PASSWORD: import("zod").ZodOptional<import("zod").ZodString>;
     }, {
         BROWSERBASE_API_KEY?: string | undefined;
         PROXY_SERVER?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "donobu",
-  "version": "5.60.2",
+  "version": "5.60.3",
   "description": "Create browser automations with an LLM agent and replay them as Playwright scripts.",
   "main": "dist/main.js",
   "module": "dist/esm/main.js",
@@ -46,7 +46,7 @@
   "license": "UNLICENSED",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@playwright/test": "^1.57.0",
+    "@playwright/test": "^1.60.0",
     "@types/better-sqlite3": "^7.6.13",
     "@types/express": "^5.0.6",
     "@types/node": "^22.10.5",
@@ -59,8 +59,8 @@
     "eslint-plugin-perfectionist": "^5.9.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "globals": "^16.0.0",
-    "playwright": "^1.57.0",
-    "playwright-core": "^1.57.0",
+    "playwright": "^1.60.0",
+    "playwright-core": "^1.60.0",
     "typescript-eslint": "^8.47.0",
     "vitest": "^4.0.17",
     "winston-transport": "^4.9.0"