@scenetest/scenes 0.1.2 → 0.2.0

package/dist/prompt-generator.js

@@ -0,0 +1,517 @@
+/**
+ * LLM Prompt Generator for Team/Seed Data Creation
+ *
+ * Analyzes the user's project and generates context-rich prompts that can be
+ * fed to an LLM (Claude, GPT, etc.) to generate team configurations and
+ * corresponding seed data for scenetest.
+ *
+ * The generator scans for:
+ * - User/account models (TypeScript types, Prisma schema, etc.)
+ * - Database schemas
+ * - Existing seeds
+ * - Existing actor team files (scenetest/actors/)
+ * - Existing scene specs (scenetest/scenes/)
+ * - Auth-related files
+ */
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+/**
+ * Gather project context for prompt generation.
+ *
+ * Scans the project for relevant files that an LLM would need to understand
+ * the application's user model, data layer, and existing test setup.
+ */
+export async function gatherProjectContext(configPath) {
+    const cwd = process.cwd();
+    const projectName = path.basename(cwd);
+    // Try to load package.json
+    let packageJson;
+    const pkgPath = path.join(cwd, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try {
+            packageJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Find scenetest config (new location: scenetest/config.ts)
+    const configFile = await findFile(cwd, [
+        'scenetest/config.ts',
+        'scenetest/config.js',
+        'scenetest/config.mjs',
+    ]);
+    // Find existing actor team files (new location: scenetest/actors/)
+    const existingActors = await findFilesMatching(cwd, [
+        'scenetest/actors/*.ts',
+        'scenetest/actors/*.js',
+        'scenetest/actors/*.mjs',
+    ]);
+    // Find user models (common patterns)
+    const userModels = await findFilesMatching(cwd, [
+        '**/models/user*.ts',
+        '**/models/User*.ts',
+        '**/types/user*.ts',
+        '**/types/User*.ts',
+        '**/schema/user*.ts',
+        '**/schema/User*.ts',
+        '**/entities/user*.ts',
+        '**/entities/User*.ts',
+        '**/prisma/schema.prisma',
+        '**/drizzle/schema*.ts',
+        '**/db/schema*.ts',
+    ]);
+    // Find existing seeds
+    const existingSeeds = await findFilesMatching(cwd, [
+        '**/seeds/**/*.ts',
+        '**/seeds/**/*.js',
+        '**/seed/**/*.ts',
+        '**/seed/**/*.js',
+        '**/prisma/seed.ts',
+        '**/prisma/seed.js',
+        '**/db/seed*.ts',
+        '**/db/seed*.js',
+    ]);
+    // Find existing scenes (to understand what roles are used)
+    const existingScenes = await findFilesMatching(cwd, ['scenetest/scenes/**/*.spec.ts', 'scenetest/scenes/**/*.spec.md'], 5);
+    // Find auth-related files
+    const authPatterns = await findFilesMatching(cwd, [
+        '**/auth/**/*.ts',
+        '**/auth.ts',
+        '**/authentication*.ts',
+        '**/login*.ts',
+        '**/middleware/auth*.ts',
+    ]);
+    // Find database schema files
+    const dbSchema = await findFilesMatching(cwd, [
+        '**/prisma/schema.prisma',
+        '**/drizzle/schema*.ts',
+        '**/drizzle/*.ts',
+        '**/db/schema*.ts',
+        '**/schema.sql',
+        '**/migrations/*.sql',
+    ]);
+    return {
+        projectName,
+        packageJson,
+        userModels,
+        existingSeeds,
+        existingActors,
+        existingScenes,
+        authPatterns,
+        dbSchema,
+        configFile,
+    };
+}
+async function findFile(cwd, patterns) {
+    for (const pattern of patterns) {
+        const fullPath = path.join(cwd, pattern);
+        if (fs.existsSync(fullPath)) {
+            try {
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                return { path: pattern, content: truncateContent(content) };
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+    }
+    return null;
+}
+async function findFilesMatching(cwd, patterns, maxFiles = 10) {
+    const results = [];
+    const seen = new Set();
+    for (const pattern of patterns) {
+        if (results.length >= maxFiles)
+            break;
+        try {
+            const files = await glob(pattern, {
+                cwd,
+                ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**'],
+                absolute: false,
+            });
+            for (const file of files) {
+                if (results.length >= maxFiles)
+                    break;
+                if (seen.has(file))
+                    continue;
+                seen.add(file);
+                const fullPath = path.join(cwd, file);
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    results.push({ path: file, content: truncateContent(content) });
+                }
+                catch {
+                    // Ignore read errors
+                }
+            }
+        }
+        catch {
+            // Ignore glob errors
+        }
+    }
+    return results;
+}
+function truncateContent(content, maxLines = 150) {
+    const lines = content.split('\n');
+    if (lines.length <= maxLines)
+        return content;
+    return lines.slice(0, maxLines).join('\n') + `\n\n... (${lines.length - maxLines} more lines)`;
+}
+// ─── Prompt generators ──────────────────────────────────────────────────────
+/**
+ * Generate an LLM prompt for team/actor generation
+ */
+export function generateTeamsPrompt(ctx) {
+    const sections = [];
+    sections.push(`# Generate Scenetest Actor Teams
+
+I need help creating scenetest team configurations for my project.
+
+## Project: ${ctx.projectName}
+`);
+    if (ctx.packageJson) {
+        const deps = {
+            ...ctx.packageJson.dependencies,
+            ...ctx.packageJson.devDependencies,
+        };
+        const relevantDeps = Object.keys(deps).filter((d) => d.includes('prisma') ||
+            d.includes('drizzle') ||
+            d.includes('sequelize') ||
+            d.includes('typeorm') ||
+            d.includes('mongoose') ||
+            d.includes('auth') ||
+            d.includes('passport') ||
+            d.includes('next-auth') ||
+            d.includes('lucia') ||
+            d.includes('clerk'));
+        if (relevantDeps.length > 0) {
+            sections.push(`**Relevant dependencies:** ${relevantDeps.join(', ')}\n`);
+        }
+    }
+    if (ctx.userModels.length > 0) {
+        sections.push(`## User/Account Models\n`);
+        for (const model of ctx.userModels) {
+            sections.push(`### ${model.path}\n\`\`\`\n${model.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.dbSchema.length > 0) {
+        sections.push(`## Database Schema\n`);
+        for (const schema of ctx.dbSchema.slice(0, 3)) {
+            sections.push(`### ${schema.path}\n\`\`\`\n${schema.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.existingActors.length > 0) {
+        sections.push(`## Existing Actor Teams (for reference)\n`);
+        for (const actor of ctx.existingActors) {
+            sections.push(`### ${actor.path}\n\`\`\`typescript\n${actor.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.existingScenes.length > 0) {
+        sections.push(`## Existing Scenes (to understand what roles are used)\n`);
+        for (const scene of ctx.existingScenes.slice(0, 3)) {
+            sections.push(`### ${scene.path}\n\`\`\`\n${scene.content}\n\`\`\`\n`);
+        }
+    }
+    sections.push(`## Scenetest Team Format
+
+Teams live in \`scenetest/actors/\`, one file per team. Each file exports a single team object mapping role names to actor configs.
+
+### File structure
+
+\`\`\`
+your-project/
+  scenetest/
+    config.ts
+    actors/
+      team-maria.ts      ← one team per file
+      team-john.ts
+    scenes/
+      ...
+\`\`\`
+
+### Team file format
+
+\`\`\`typescript
+// scenetest/actors/team-maria.ts
+import type { TeamConfig } from '@scenetest/scenes'
+
+export default {
+  'primary-learner': {
+    key: 'maria-1',             // Unique key (used for data-key matching in DOM)
+    email: 'maria@test.com',
+    password: 'test123',
+    nativeLanguage: 'english',  // Custom fields are allowed
+  },
+  'existing-friend': {
+    key: 'carlos-1',
+    email: 'carlos@test.com',
+    password: 'test123',
+  },
+  'new-signup': {
+    key: 'fresh-a-1',
+    email: 'fresh-a@test.com',
+    password: 'willregister123',
+  },
+} satisfies TeamConfig
+\`\`\`
+
+### Key requirements
+
+- **Every team must have identical role names** — scenes call \`actor('role-name')\`, and that role must exist in every team
+- **\`key\`** is the only required field on ActorConfig (used for data-key selector matching)
+- Credentials (\`email\`, \`password\`, \`username\`) must match seed data users
+- Relationships (friendships, org membership, etc.) between actors must exist in seed data
+- Each team is a self-contained "world" — no cross-team references
+- Use descriptive role names: \`primary-buyer\`, \`competing-seller\`, not \`user\`, \`admin\`
+
+## What I Need
+
+Generate actor team files for my project:
+1. Identify the user types and relationships in my app
+2. Create 2-3 team files in \`scenetest/actors/\`
+3. Use descriptive, scenario-based role names
+4. Include all credential fields my app needs
+5. Note what relationships need to exist in seed data
+`);
+    return sections.join('\n');
+}
+/**
+ * Generate an LLM prompt for seed data generation
+ */
+export function generateSeedsPrompt(ctx) {
+    const sections = [];
+    sections.push(`# Generate Seed Data for Scenetest Teams
+
+I need help creating seed data that matches my scenetest actor teams.
+
+## Project: ${ctx.projectName}
+`);
+    if (ctx.existingActors.length > 0) {
+        sections.push(`## Actor Team Files\n`);
+        for (const actor of ctx.existingActors) {
+            sections.push(`### ${actor.path}\n\`\`\`typescript\n${actor.content}\n\`\`\`\n`);
+        }
+    }
+    else {
+        sections.push(`## Actor Teams
+
+**No actor files found in \`scenetest/actors/\`.** Please either:
+1. First generate team configurations (\`scenetest prompt teams\`)
+2. Or paste your team files here
+`);
+    }
+    if (ctx.dbSchema.length > 0) {
+        sections.push(`## Database Schema\n`);
+        for (const schema of ctx.dbSchema) {
+            sections.push(`### ${schema.path}\n\`\`\`\n${schema.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.existingSeeds.length > 0) {
+        sections.push(`## Existing Seed Files (for style reference)\n`);
+        for (const seed of ctx.existingSeeds.slice(0, 3)) {
+            sections.push(`### ${seed.path}\n\`\`\`\n${seed.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.authPatterns.length > 0) {
+        sections.push(`## Auth Implementation (for password hashing, etc.)\n`);
+        for (const auth of ctx.authPatterns.slice(0, 2)) {
+            sections.push(`### ${auth.path}\n\`\`\`\n${auth.content}\n\`\`\`\n`);
+        }
+    }
+    sections.push(`## What I Need
+
+Generate seed data files that:
+
+1. **Create users** matching every actor in every team file
+2. **Establish relationships** between actors (friendships, org membership, etc.)
+3. **Match my existing seed style** (if I have existing seeds above)
+4. **Include supporting data** that tests might need (posts, products, etc.)
+
+### Key requirements
+
+- User credentials must match exactly: the email/password in actor files must work to log in
+- Passwords must be hashed using my app's auth system
+- Relationships assumed by scenes must be seeded (e.g., if a scene expects two actors to be friends, the friendship must exist)
+- Each team's data is self-contained — all relationships hold within a single team
+
+### Output format
+
+Generate:
+1. Seed data files in my project's format/style
+2. A seed runner script if I don't have one
+3. A list of all relationships established between actors
+`);
+    return sections.join('\n');
+}
+/**
+ * Generate a combined prompt for both teams and seeds
+ */
+export function generateCombinedPrompt(ctx) {
+    const sections = [];
+    sections.push(`# Generate Scenetest Teams and Seed Data
+
+I'm setting up scenetest for my project and need both actor team files and matching seed data.
+
+## Project: ${ctx.projectName}
+`);
+    if (ctx.packageJson) {
+        const deps = {
+            ...ctx.packageJson.dependencies,
+            ...ctx.packageJson.devDependencies,
+        };
+        const relevantDeps = Object.keys(deps).filter((d) => d.includes('prisma') ||
+            d.includes('drizzle') ||
+            d.includes('sequelize') ||
+            d.includes('typeorm') ||
+            d.includes('mongoose') ||
+            d.includes('auth') ||
+            d.includes('passport') ||
+            d.includes('next-auth') ||
+            d.includes('lucia') ||
+            d.includes('clerk') ||
+            d.includes('react') ||
+            d.includes('vue') ||
+            d.includes('svelte') ||
+            d.includes('solid'));
+        if (relevantDeps.length > 0) {
+            sections.push(`**Tech stack:** ${relevantDeps.join(', ')}\n`);
+        }
+    }
+    if (ctx.userModels.length > 0) {
+        sections.push(`## User/Account Models\n`);
+        for (const model of ctx.userModels) {
+            sections.push(`### ${model.path}\n\`\`\`\n${model.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.dbSchema.length > 0) {
+        sections.push(`## Database Schema\n`);
+        for (const schema of ctx.dbSchema.slice(0, 3)) {
+            sections.push(`### ${schema.path}\n\`\`\`\n${schema.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.existingSeeds.length > 0) {
+        sections.push(`## Existing Seed Files (for style reference)\n`);
+        for (const seed of ctx.existingSeeds.slice(0, 2)) {
+            sections.push(`### ${seed.path}\n\`\`\`\n${seed.content}\n\`\`\`\n`);
+        }
+    }
+    if (ctx.existingScenes.length > 0) {
+        sections.push(`## Existing Scenes (to understand usage patterns)\n`);
+        for (const scene of ctx.existingScenes.slice(0, 2)) {
+            sections.push(`### ${scene.path}\n\`\`\`\n${scene.content}\n\`\`\`\n`);
+        }
+    }
+    sections.push(`## Scenetest Project Layout
+
+\`\`\`
+your-project/
+  scenetest/
+    config.ts            ← project config
+    actors/
+      team-maria.ts      ← one team per file
+      team-john.ts
+    scenes/
+      onboarding.spec.ts
+      social/
+        friend-request.spec.ts
+\`\`\`
+
+## Team File Format
+
+Each file in \`scenetest/actors/\` exports one team:
+
+\`\`\`typescript
+// scenetest/actors/team-maria.ts
+import type { TeamConfig } from '@scenetest/scenes'
+
+export default {
+  'primary-learner': {
+    key: 'maria-1',
+    email: 'maria@test.com',
+    password: 'test123',
+  },
+  'existing-friend': {
+    key: 'carlos-1',
+    email: 'carlos@test.com',
+    password: 'test123',
+  },
+} satisfies TeamConfig
+\`\`\`
+
+- \`key\` is the only required field (used for data-key selector matching)
+- Every team must have the same role names
+- Credentials must match seed data users
+- Use descriptive role names: \`primary-buyer\`, not \`user\`
+
+## What I Need
+
+### Part 1: Actor Teams
+
+Generate 2-3 team files for \`scenetest/actors/\`:
+- Identify user types from my models/schema
+- Choose descriptive, scenario-based role names
+- Include credentials that match seed data
+
+### Part 2: Seed Data
+
+Generate seed files that:
+- Create all users from the team files
+- Establish relationships between actors
+- Follow my existing seed patterns
+- Include supporting data for tests
+
+### Output
+
+1. Complete team files (one per team)
+2. Seed data files in my project's format
+3. Explanation of each role and its purpose
+4. List of relationships established in seeds
+`);
+    return sections.join('\n');
+}
+/**
+ * Generate the appropriate prompt based on type
+ */
+export function generatePrompt(ctx, type) {
+    switch (type) {
+        case 'teams':
+            return generateTeamsPrompt(ctx);
+        case 'seeds':
+            return generateSeedsPrompt(ctx);
+        case 'both':
+            return generateCombinedPrompt(ctx);
+    }
+}
+/**
+ * Format the prompt for CLI output with header/footer
+ */
+export function formatPromptOutput(prompt, type) {
+    const divider = '='.repeat(60);
+    const label = type === 'both' ? 'teams and seed data' : type;
+    return `
+${divider}
+  SCENETEST PROMPT GENERATOR - ${type.toUpperCase()}
+${divider}
+
+Copy the prompt below and paste it into your preferred LLM
+(Claude, ChatGPT, etc.) to generate your ${label}.
+
+${divider}
+
+${prompt}
+
+${divider}
+  END OF PROMPT
+${divider}
+
+Tips:
+- Review the prompt and add any missing context about your app
+- Specify the number of teams you want (2-3 is typical)
+- Mention any specific test scenarios you're planning
+- After generating, audit alignment with: building-teams.md audit prompt
+
+`;
+}
+//# sourceMappingURL=prompt-generator.js.map

package/dist/prompt-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.js","sourceRoot":"","sources":["../src/prompt-generator.ts"],"names":[],"mappings":"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"}

package/dist/reactive.d.ts

@@ -46,7 +46,7 @@
  * ```
  */
 import type { Page } from 'playwright';
-import type { ActorConfig, Selector, TimelineEntry, ScriptWarning, FlowFn, ConcurrentActorHandle } from './types.js';
+import type { ActorConfig, Selector, TimelineEntry, ScriptWarning, FlowFn, SceneOptions, ConcurrentActorHandle } from './types.js';
 import { MessageBus } from './message-bus.js';
 /**
  * Concurrent actor handle implementation (declarative / flow model).
@@ -275,4 +275,5 @@ export declare function drainAll(actors: ConcurrentActorHandleImpl[]): Promise<v
  * ```
  */
 export declare function flow(name: string, fn: FlowFn): void;
+export declare function flow(name: string, options: SceneOptions, fn: FlowFn): void;
 //# sourceMappingURL=reactive.d.ts.map

package/dist/reactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"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"}

package/dist/reactive.js

@@ -750,59 +750,12 @@ export async function drainAll(actors) {
         throw (original ?? failures[0]).reason;
     }
 }
-// ---------------------------------------------------------------------------
-// flow() — reactive scene registration
-// ---------------------------------------------------------------------------
-/**
- * Define a reactive flow.
- *
- * Inside the flow function, actor DSL calls just queue actions — nothing
- * executes.  After the function returns, all actors drain their queues
- * concurrently through the application.
- *
- * @example
- * ```ts
- * import { flow } from '@scenetest/scenes'
- *
- * flow('user updates profile', ({ actor }) => {
- *   const user = actor('user')
- *
- *   user.openTo('/login')
- *   user
- *     .see('login-form')
- *     .typeInto('email', user.email!)
- *     .typeInto('password', user.password!)
- *     .click('submit')
- *
- *   user.see('dashboard')
- *   user.openTo('/profile')
- *   user
- *     .see('profile-form')
- *     .typeInto('name-input', 'New Name')
- *     .click('save-button')
- *
- *   user.seeText('New Name')
- * })
- * ```
- *
- * @example Multi-actor
- * ```ts
- * flow('two users chat', ({ actor }) => {
- *   const alice = actor('alice')
- *   const bob   = actor('bob')
- *
- *   alice.openTo('/chat')
- *   alice.see('message-input').typeInto('message-input', 'Hello!').click('send')
- *
- *   bob.openTo('/chat')
- *   bob.seeText('Hello!')
- * })
- * ```
- */
-export function flow(name, fn) {
+export function flow(name, fnOrOptions, maybeFn) {
+    const fn = typeof fnOrOptions === 'function' ? fnOrOptions : maybeFn;
+    const options = typeof fnOrOptions === 'function' ? undefined : fnOrOptions;
     // Register as a normal scene — the runner doesn't need to know it's
     // reactive.  The wrapping scene fn handles the three-phase execution.
-    scene(name, async (context) => {
+    const wrappedFn = async (context) => {
         const session = getCurrentSession();
         if (!session) {
             throw new Error('flow() must be run inside the scene runner');
@@ -811,6 +764,12 @@ export function flow(name, fn) {
         const actorRoles = [];
         // Actor registry for [role.field] interpolation across actors
         const actorRegistry = new Map();
+        // Build team metadata for [team.field] interpolation from tags
+        const teamMeta = session.meta;
+        const teamMetadataForInterpolation = {
+            ...(teamMeta.tags ?? {}),
+            ...(teamMeta.name ? { name: teamMeta.name } : {}),
+        };
         const flowContext = {
             actor: (role) => {
                 // Check if already created (re-referencing an actor)
@@ -829,6 +788,7 @@ export function flow(name, fn) {
                 return reactive;
             },
             teamIndex: context.teamIndex,
+            team: teamMeta,
         };
         // Phase 1: Declaration — user code queues actions, nothing executes.
         //          actor() is synchronous so the flow body can be sync too.
@@ -836,9 +796,12 @@ export function flow(name, fn) {
         if (result && typeof result.then === 'function') {
             await result;
         }
-        // Set actor registry on all actors for [role.field] interpolation
+        // Set actor registry and team metadata on all actors for interpolation
         for (const actor of reactiveActors) {
             actor._setActorRegistry(actorRegistry);
+            if (Object.keys(teamMetadataForInterpolation).length > 0) {
+                actor._setTeamMetadata(teamMetadataForInterpolation);
+            }
         }
         // Phase 2: Initialize — create browser contexts in parallel
         await Promise.all(reactiveActors.map(async (actor, i) => {
@@ -847,6 +810,12 @@ export function flow(name, fn) {
         }));
         // Phase 3: Execution — all actors drain concurrently
         await drainAll(reactiveActors);
-    });
+    };
+    if (options) {
+        scene(name, options, wrappedFn);
+    }
+    else {
+        scene(name, wrappedFn);
+    }
 }
 //# sourceMappingURL=reactive.js.map