@activate-core/test-forge 0.9.6 → 0.10.0

package/dist/core/ai-generator.js

@@ -121,9 +121,16 @@ export function buildPrompt(journey, map, testPath, focus, harnessPath) {
             ].join('\n')
             : [
                 `Because this is a web journey, write Playwright tests that drive`,
-                `the UI. Use placeholder selectors with a TODO comment where the`,
-                `real page structure is unknown — do not invent selectors as if`,
-                `they are real.`,
+                `the UI. FIRST find the REAL selectors: with your read-only tools,`,
+                `locate and READ this page's actual React/Vue components (grep the`,
+                `webapp source for the route, page name, and on-screen text, then`,
+                `open those component files). Use the selectors that genuinely`,
+                `exist there — data-testid/data-cy, input name/id, aria-role,`,
+                `label text, or button text — via Playwright locators`,
+                `(getByRole/getByLabel/getByTestId/getByText). Only leave a`,
+                `"// TODO: confirm selector" when the element truly cannot be`,
+                `found in the component source; do NOT default everything to a`,
+                `TODO. Never invent a selector as if it were real.`,
                 `CRITICAL Playwright API: import { test, expect } from`,
                 `'@playwright/test'. There is NO test.todo / it.* / describe.skip`,
                 `in Playwright — using them throws at collection and breaks the`,

package/dist/core/run-generate.js

@@ -187,6 +187,36 @@ export async function runHarness(only) {
     }
     return written;
 }
+const PLAN_DIR = '.testforge/plans';
+/**
+ * Get a journey's file plan, cached by doc hash. Caching the plan keeps
+ * the file slugs STABLE across runs, so per-file resume (skip-existing)
+ * actually matches — and it saves the planner AI call on a resume. When
+ * the doc changes, the hash changes and we re-plan.
+ */
+function loadOrPlan(journey, docHash) {
+    const p = join(PLAN_DIR, `${journey.area}__${journey.id}.json`);
+    if (existsSync(p)) {
+        try {
+            const cached = JSON.parse(readFileSync(p, 'utf-8'));
+            if (cached.hash === docHash && Array.isArray(cached.files) && cached.files.length) {
+                return cached.files;
+            }
+        }
+        catch {
+            // corrupt plan cache — re-plan
+        }
+    }
+    const files = planSuite(journey);
+    try {
+        mkdirSync(PLAN_DIR, { recursive: true });
+        writeFileSync(p, JSON.stringify({ hash: docHash, files }, null, 2), 'utf-8');
+    }
+    catch {
+        // best-effort cache
+    }
+    return files;
+}
 /** Does this doc file / journey match a --journey selector? */
 function matchesJourney(file, journeyId, sel) {
     const norm = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, '-');
@@ -301,7 +331,7 @@ export async function runGenerate(docsDir, useAI = true, force = false, only, ar
         // 1. Plan the suite (deep mode), then generate one focused file per
         //    concern. In basic mode there is no AI planner — one file only.
         const planned = useAI
-            ? planSuite(journey)
+            ? loadOrPlan(journey, hash)
             : [{ slug: journey.id, title: journey.name, covers: '' }];
         // Generate all focused files CONCURRENTLY (bounded pool). Each AI
         // call is independent, so a 15-file journey finishes in ~4 waves
@@ -312,6 +342,20 @@ export async function runGenerate(docsDir, useAI = true, force = false, only, ar
             // folder already namespaces it, so the slug alone is enough.
             const base = flat ? `${journey.id}-${pf.slug}` : pf.slug;
             const filePath = join(testDir, `${base}${ext}`);
+            // PER-FILE RESUME: if this file already exists and parses, keep it
+            // — don't spend tokens regenerating it. So a journey interrupted
+            // midway resumes from exactly the files it hadn't written yet.
+            // (--force ignores this and regenerates.)
+            if (!force && existsSync(filePath)) {
+                try {
+                    if (isSyntaxValid(readFileSync(filePath, 'utf-8'), ext)) {
+                        return { slug: pf.slug, path: filePath, status: 'ai' };
+                    }
+                }
+                catch {
+                    // unreadable — fall through and regenerate
+                }
+            }
             let content;
             let status;
             if (useAI) {
@@ -331,14 +375,17 @@ export async function runGenerate(docsDir, useAI = true, force = false, only, ar
                 content = built.content;
                 status = 'basic';
             }
-            return { slug: pf.slug, path: filePath, content, status };
+            // Write IMMEDIATELY (not batched at the end of the journey), so an
+            // interruption preserves every file generated so far.
+            mkdirSync(dirname(filePath), { recursive: true });
+            writeFileSync(filePath, content, 'utf-8');
+            return { slug: pf.slug, path: filePath, status };
         });
-        const testFiles = [];
-        for (const g of generated) {
-            mkdirSync(dirname(g.path), { recursive: true });
-            writeFileSync(g.path, g.content, 'utf-8');
-            testFiles.push({ slug: g.slug, path: g.path, status: g.status });
-        }
+        const testFiles = generated.map((g) => ({
+            slug: g.slug,
+            path: g.path,
+            status: g.status,
+        }));
         const anyAI = testFiles.some((t) => t.status === 'ai');
         const anyBasic = testFiles.some((t) => t.status === 'basic');
         const status = anyAI || !anyBasic ? 'ai' : 'basic';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@activate-core/test-forge",
-  "version": "0.9.6",
+  "version": "0.10.0",
   "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": {