@activate-core/test-forge 0.18.4 → 0.18.5

package/dist/core/run-generate.js

@@ -508,6 +508,12 @@ export async function runGenerate(docsDir, useAI = true, force = false, only, ar
     // the counter reset and the stubs behind; redo such a journey once, as soon
     // as the AI is answering — the stubs are all it costs.
     const stubbed = new Set();
+    // Areas whose test framework is not installed. A Playwright spec MUST import
+    // "@playwright/test"; without it every generated file is refused by the
+    // dependency gate and becomes a deferred stub. That is an environment
+    // problem, not something to discover thirteen times over a night, so the
+    // area is skipped with the install command and no AI is called at all.
+    const blockedAreas = new Map();
     for (let i = 0; i < files.length; i++) {
         const file = files[i];
         // Redo the journey BEFORE this one: it degraded into stubs while the AI
@@ -592,6 +598,19 @@ export async function runGenerate(docsDir, useAI = true, force = false, only, ar
         // AI can't fall back to an uninstalled convention (e.g. supertest).
         const allowedModules = installedModules(testDir);
         const transport = transportHint(testDir, framework);
+        // Playwright is the one framework whose import is mandatory in every spec
+        // (jest's describe/it/expect are ambient, so a jest area generates fine
+        // either way). If it is missing, stop before spending a single AI call.
+        if (framework === 'playwright' && !allowedModules.has('@playwright/test')) {
+            const blocked = blockedAreas.get(journey.area) ?? {
+                pkg: '@playwright/test',
+                dir: areaDir,
+                count: 0,
+            };
+            blocked.count += 1;
+            blockedAreas.set(journey.area, blocked);
+            continue;
+        }
         // F10 — selector grounding (Playwright areas only): the real test-hooks
         // in this area's components, so a generated UI test can't invent one.
         let knownSelectors;
@@ -818,6 +837,21 @@ export async function runGenerate(docsDir, useAI = true, force = false, only, ar
             warnings: warnings.length ? warnings : undefined,
         });
     }
+    for (const [area, b] of blockedAreas) {
+        results.push({
+            journeyName: `${b.count} ${area} journey(s) not attempted — ${b.pkg} is not installed`,
+            testDir: '',
+            testFiles: [],
+            seedPath: '',
+            status: 'skipped',
+            seedStatus: 'none',
+            warnings: [
+                `every ${area} spec must import ${b.pkg}, so without it the dependency gate ` +
+                    `refuses each generated file and leaves a deferred stub — hours of AI calls for nothing. ` +
+                    `Install it, then re-run: npm i -D ${b.pkg} && npx playwright install`,
+            ],
+        });
+    }
     if (notAttempted > 0 && aiUnavailable) {
         // One line, not one per journey: the operator needs the reason and the
         // count, then to re-run once the CLI is back.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@activate-core/test-forge",
-  "version": "0.18.4",
+  "version": "0.18.5",
   "description": "AI-powered QA automation. Scans a project, drafts journey docs, and generates seeded Jest/Playwright tests. Works in any project, with any AI CLI.",
   "type": "module",
   "bin": {