create-appraisejs 0.1.9 → 0.1.10-alpha.1

package/templates/default/packages/cucumber-runtime/src/random-data.util.ts

@@ -0,0 +1,35 @@
+import { faker } from '@faker-js/faker'
+
+export enum RandomDataType {
+  FULL_NAME = 'fullName',
+  FIRST_NAME = 'firstName',
+  LAST_NAME = 'lastName',
+  EMAIL = 'email',
+  PASSWORD = 'password',
+  PHONE = 'phone',
+  ADDRESS = 'address',
+  UNIQUE_TEXT = 'uniqueText',
+}
+
+export function generateRandomData(randomDataType: RandomDataType): string {
+  switch (randomDataType) {
+    case RandomDataType.FULL_NAME:
+      return faker.person.fullName()
+    case RandomDataType.FIRST_NAME:
+      return faker.person.firstName()
+    case RandomDataType.LAST_NAME:
+      return faker.person.lastName()
+    case RandomDataType.EMAIL:
+      return faker.internet.email()
+    case RandomDataType.PASSWORD:
+      return faker.internet.password()
+    case RandomDataType.PHONE:
+      return faker.phone.number()
+    case RandomDataType.ADDRESS:
+      return faker.location.streetAddress()
+    case RandomDataType.UNIQUE_TEXT:
+      return faker.string.uuid()
+    default:
+      throw new Error(`Invalid random data type: ${randomDataType}`)
+  }
+}

package/templates/default/packages/cucumber-runtime/src/types.ts

@@ -0,0 +1,13 @@
+export type BrowserName = 'chromium' | 'firefox' | 'webkit'
+
+export type CSSSelector = string
+export type XPathSelector = `/${string}` | `//${string}`
+export type SelectorName = string
+export type Selector = CSSSelector | XPathSelector
+export type Locator = Record<string, Selector>
+export type LocatorMap = {
+  name: string
+  path: string
+}
+
+export type LocatorCollection = Record<string, Locator>

package/templates/default/{src/tests/config/executor → packages/cucumber-runtime/src}/world.ts

@@ -9,12 +9,14 @@ export interface ScenarioData {
   token?: string
   vars: Record<string, unknown>
 }
+
 export class CustomWorld extends World {
   context!: BrowserContext
   page!: Page
   data: ScenarioData = {
     vars: {},
   }
+
   constructor(options: IWorldOptions) {
     super(options)
   }
@@ -27,6 +29,7 @@ export class CustomWorld extends World {
     if (!(key in this.data.vars)) {
       throw new Error(`Variable ${key} not found`)
     }
+
     return this.data.vars[key] as T
   }
 
@@ -36,6 +39,6 @@ export class CustomWorld extends World {
 }
 
 setWorldConstructor(CustomWorld)
-
 chai.use(chaiAsPromised)
+
 export const expect = chai.expect

package/templates/default/packages/cucumber-runtime/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "noEmit": false,
+    "declaration": true,
+    "emitDeclarationOnly": false
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/default/scripts/setup-env.ts

@@ -4,16 +4,16 @@ import fs from 'fs'
 import path from 'path'
 
 const envContent = `# Database configuration for local development
-DATABASE_URL="file:./prisma/dev.db"
+DATABASE_URL="file:./dev.db"
 `
 
 const envPath = path.join(process.cwd(), '.env')
 
 if (!fs.existsSync(envPath)) {
   fs.writeFileSync(envPath, envContent)
-  console.log('✅ Created .env file with SQLite configuration')
+  console.log('? Created .env file with SQLite configuration')
 } else {
-  console.log('ℹ️  .env file already exists, skipping creation')
+  console.log('??  .env file already exists, skipping creation')
 }
 
-console.log('🎉 Environment setup complete!')
+console.log('?? Environment setup complete!')

package/templates/default/scripts/sync-appraise-base-template.ts

@@ -1,103 +1,113 @@
 #!/usr/bin/env node
 /**
  * Sync the default template from the base app (repo root).
- * Copies src/, prisma/, public/, scripts/, and root config files into templates/default/,
- * preserves template-only README.md and appraisejs.config.json, and merges package.json scripts.
+ * Copies src/, automation/, prisma/, public/, scripts/, the cucumber runtime package,
+ * and root config files into templates/default/ while preserving template-only files.
  *
  * Usage: npx tsx scripts/sync-appraise-base-template.ts
  * Or: npm run sync-template
  */
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'fs'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+import { shouldBackfillLegacyEnvironmentConfig, shouldExcludeTemplatePath } from '../src/lib/template-sync-utils'
 
-import { cpSync, readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const repoRoot = join(__dirname, '..');
-const target = join(repoRoot, 'templates', 'default');
-
-const EXCLUDED_DIRS = new Set(['node_modules', '.next', '.git']);
-const EXCLUDED_EXTENSIONS = new Set(['.db', '.sqlite', '.sqlite3']);
-const EXCLUDED_TEST_DATA_PREFIXES = [
-  'tests/features/',
-  'tests/config/environments/',
-  'tests/locators/',
-  'tests/reports/',
-];
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const repoRoot = join(__dirname, '..')
+const target = join(repoRoot, 'templates', 'default')
 
 function shouldExclude(relativePath: string): boolean {
-  const parts = relativePath.split(/[/\\]/);
-  if (parts.some((p) => EXCLUDED_DIRS.has(p))) return true;
-  if (EXCLUDED_TEST_DATA_PREFIXES.some((prefix) => relativePath.startsWith(prefix))) return true;
-  const ext = relativePath.endsWith('.sqlite3')
-    ? '.sqlite3'
-    : relativePath.endsWith('.sqlite')
-      ? '.sqlite'
-      : relativePath.slice(relativePath.lastIndexOf('.'));
-  if (EXCLUDED_EXTENSIONS.has(ext)) return true;
-  return false;
+  return shouldExcludeTemplatePath(relativePath)
 }
 
-function copyDirWithFilter(src: string, dest: string): void {
-  cpSync(src, dest, {
-    recursive: true,
-    force: true,
-    filter: (source: string) => {
-      const rel = source.slice(src.length).replace(/^[/\\]/, '') || '';
-      return !shouldExclude(rel);
-    },
-  });
+function copyDirWithFilter(src: string, dest: string, base = src): void {
+  if (!existsSync(src)) return
+
+  mkdirSync(dest, { recursive: true })
+  for (const entry of readdirSync(src, { withFileTypes: true })) {
+    const srcPath = join(src, entry.name)
+    const relativePath = srcPath.slice(base.length + 1).replace(/\\/g, '/')
+    if (shouldExclude(relativePath)) continue
+
+    const destPath = join(dest, entry.name)
+    if (entry.isDirectory()) {
+      copyDirWithFilter(srcPath, destPath, base)
+      continue
+    }
+
+    cpSync(srcPath, destPath, { force: true })
+  }
 }
 
 function copyFile(src: string, dest: string): void {
-  mkdirSync(dirname(dest), { recursive: true });
-  cpSync(src, dest, { force: true });
+  mkdirSync(dirname(dest), { recursive: true })
+  cpSync(src, dest, { force: true })
 }
 
-// 1. Preserve template-only files
-const readmePath = join(target, 'README.md');
-const appraisejsConfigPath = join(target, 'appraisejs.config.json');
-const savedReadme = existsSync(readmePath) ? readFileSync(readmePath, 'utf8') : null;
-const savedAppraisejsConfig = existsSync(appraisejsConfigPath)
-  ? readFileSync(appraisejsConfigPath, 'utf8')
-  : null;
-
-// 2. Copy directories
-console.log('Copying src/...');
-copyDirWithFilter(join(repoRoot, 'src'), join(target, 'src'));
-
-// Clear test data dirs and write empty configs (no project-specific features/envs/locators/reports)
-const dirsToClear = [
-  join(target, 'src', 'tests', 'features'),
-  join(target, 'src', 'tests', 'locators'),
-  join(target, 'src', 'tests', 'reports'),
-];
-for (const dir of dirsToClear) {
-  if (existsSync(dir)) {
-    rmSync(dir, { recursive: true });
+function resetAutomationReports(templateRoot: string): void {
+  const reportsRoot = join(templateRoot, 'automation', 'reports')
+  rmSync(reportsRoot, { recursive: true, force: true })
+  mkdirSync(join(reportsRoot, 'logs'), { recursive: true })
+  mkdirSync(join(reportsRoot, 'traces'), { recursive: true })
+}
+
+function syncLegacyEnvironmentConfig(): void {
+  const legacyEnvironmentsDir = join(repoRoot, 'src', 'tests', 'config', 'environments')
+  const targetEnvironmentsDir = join(target, 'automation', 'config', 'environments')
+  const targetEnvironmentsFile = join(targetEnvironmentsDir, 'environments.json')
+
+  if (!shouldBackfillLegacyEnvironmentConfig(existsSync(targetEnvironmentsFile), existsSync(legacyEnvironmentsDir))) {
+    return
   }
+
+  mkdirSync(targetEnvironmentsDir, { recursive: true })
+  cpSync(legacyEnvironmentsDir, targetEnvironmentsDir, { recursive: true, force: true })
+  console.log('Backfilled automation/config/environments from legacy src/tests config.')
 }
-const testDirs = [
-  join(target, 'src', 'tests', 'features'),
-  join(target, 'src', 'tests', 'config', 'environments'),
-  join(target, 'src', 'tests', 'locators'),
-  join(target, 'src', 'tests', 'reports'),
-  join(target, 'src', 'tests', 'mapping'),
-];
-for (const dir of testDirs) {
-  mkdirSync(dir, { recursive: true });
+
+function syncCucumberRuntimePackage(): void {
+  const runtimeTarget = join(target, 'packages', 'cucumber-runtime')
+  rmSync(runtimeTarget, { recursive: true, force: true })
+  mkdirSync(runtimeTarget, { recursive: true })
+
+  copyFile(join(repoRoot, 'packages', 'cucumber-runtime', 'package.json'), join(runtimeTarget, 'package.json'))
+  copyFile(join(repoRoot, 'packages', 'cucumber-runtime', 'tsconfig.json'), join(runtimeTarget, 'tsconfig.json'))
+  copyDirWithFilter(join(repoRoot, 'packages', 'cucumber-runtime', 'src'), join(runtimeTarget, 'src'))
 }
-writeFileSync(join(target, 'src', 'tests', 'config', 'environments', 'environments.json'), JSON.stringify({}) + '\n');
-writeFileSync(join(target, 'src', 'tests', 'mapping', 'locator-map.json'), JSON.stringify([]) + '\n');
 
-console.log('Copying prisma/...');
-copyDirWithFilter(join(repoRoot, 'prisma'), join(target, 'prisma'));
-console.log('Copying public/...');
-copyDirWithFilter(join(repoRoot, 'public'), join(target, 'public'));
-console.log('Copying scripts/...');
-copyDirWithFilter(join(repoRoot, 'scripts'), join(target, 'scripts'));
+const readmePath = join(target, 'README.md')
+const appraisejsConfigPath = join(target, 'appraisejs.config.json')
+const savedReadme = existsSync(readmePath) ? readFileSync(readmePath, 'utf8') : null
+const savedAppraisejsConfig = existsSync(appraisejsConfigPath)
+  ? readFileSync(appraisejsConfigPath, 'utf8')
+  : null
+
+rmSync(target, { recursive: true, force: true })
+mkdirSync(target, { recursive: true })
+
+console.log('Copying src/...')
+copyDirWithFilter(join(repoRoot, 'src'), join(target, 'src'))
+
+console.log('Copying automation/...')
+copyDirWithFilter(join(repoRoot, 'automation'), join(target, 'automation'))
+syncLegacyEnvironmentConfig()
+resetAutomationReports(target)
+
+console.log('Copying cucumber runtime package...')
+syncCucumberRuntimePackage()
+
+console.log('Copying prisma/...')
+copyDirWithFilter(join(repoRoot, 'prisma'), join(target, 'prisma'))
+console.log('Copying public/...')
+copyDirWithFilter(join(repoRoot, 'public'), join(target, 'public'))
+console.log('Copying scripts/...')
+copyDirWithFilter(join(repoRoot, 'scripts'), join(target, 'scripts'))
+
+const legacyTestsRoot = join(target, 'src', 'tests')
+if (existsSync(legacyTestsRoot)) {
+  rmSync(legacyTestsRoot, { recursive: true, force: true })
+}
 
-// 3. Copy root config files and package lock files
 const configFiles = [
   '.gitignore',
   'eslint.config.mjs',
@@ -106,51 +116,60 @@ const configFiles = [
   'postcss.config.mjs',
   'components.json',
   'next.config.ts',
+  'next-env.d.ts',
   '.env.example',
   'package-lock.json',
   'yarn.lock',
   'pnpm-lock.yaml',
-];
-console.log('Copying config files...');
+  'bun.lockb',
+]
 for (const name of configFiles) {
-  const src = join(repoRoot, name);
+  const src = join(repoRoot, name)
   if (existsSync(src)) {
-    copyFile(src, join(target, name));
+    copyFile(src, join(target, name))
   }
 }
 
-// Copy cucumber.mjs from repo root (required for running tests)
-const cucumberSource = join(repoRoot, 'cucumber.mjs');
+const cucumberSource = join(repoRoot, 'cucumber.mjs')
 if (existsSync(cucumberSource)) {
-  copyFile(cucumberSource, join(target, 'cucumber.mjs'));
-  console.log('Synced cucumber.mjs to template');
+  copyFile(cucumberSource, join(target, 'cucumber.mjs'))
+  console.log('Synced cucumber.mjs to template')
 }
 
-// Copy .vscode folder from repo root
-const vscodeSource = join(repoRoot, '.vscode');
+const vscodeSource = join(repoRoot, '.vscode')
 if (existsSync(vscodeSource)) {
-  cpSync(vscodeSource, join(target, '.vscode'), { recursive: true, force: true });
-  console.log('Synced .vscode to template');
+  cpSync(vscodeSource, join(target, '.vscode'), { recursive: true, force: true })
+  console.log('Synced .vscode to template')
 }
 
-// 4. package.json: base + template-only scripts
 const rootPkg = JSON.parse(readFileSync(join(repoRoot, 'package.json'), 'utf8')) as {
-  scripts: Record<string, string>;
-  [key: string]: unknown;
-};
-rootPkg.scripts['appraisejs:setup'] = 'npm run setup';
-rootPkg.scripts['appraisejs:sync'] = 'npm run sync-all';
-writeFileSync(join(target, 'package.json'), JSON.stringify(rootPkg, null, 2) + '\n');
-console.log('Wrote package.json with appraisejs:setup and appraisejs:sync.');
-
-// 5. Restore template-only files
+  scripts: Record<string, string>
+  [key: string]: unknown
+}
+rootPkg.scripts = {
+  ...rootPkg.scripts,
+  build: 'npm run build:local',
+  'build:local': 'npm run generate-db-client && npm run build:cucumber-runtime && next build',
+  start: 'next start',
+  'generate-db-client': 'npx prisma generate --schema prisma/schema.prisma',
+  'migrate-db': 'npx prisma migrate deploy',
+  'install-playwright': 'npx playwright install',
+  setup: 'npm run install-dependencies && npm run setup:db && npm run build:local',
+  'setup:db': 'npm run setup-env && npm run generate-db-client && npm run migrate-db && npm run sync-all',
+  'setup:full': 'npm run install-dependencies && npm run setup:db && npm run build:local',
+  'appraisejs:setup': 'npm run setup',
+  'appraisejs:sync': 'npm run sync-all',
+}
+writeFileSync(join(target, 'package.json'), JSON.stringify(rootPkg, null, 2) + '\n')
+console.log('Wrote template package.json with production-first scaffold scripts.')
+
 if (savedReadme) {
-  writeFileSync(readmePath, savedReadme);
-  console.log('Restored README.md');
+  writeFileSync(readmePath, savedReadme)
+  console.log('Restored README.md')
 }
 if (savedAppraisejsConfig) {
-  writeFileSync(appraisejsConfigPath, savedAppraisejsConfig);
-  console.log('Restored appraisejs.config.json');
+  writeFileSync(appraisejsConfigPath, savedAppraisejsConfig)
+  console.log('Restored appraisejs.config.json')
 }
 
-console.log('Synced base app to templates/default.');
+console.log('Synced base app to templates/default with starter automation assets.')

package/templates/default/scripts/sync-environments.ts

@@ -9,8 +9,8 @@
  */
 
 import { promises as fs } from 'fs'
-import { join } from 'path'
 import prisma from '../src/config/db-config'
+import { ensureAutomationWorkspaceReady, getAutomationEnvironmentsDir } from '../src/lib/automation/paths'
 
 interface EnvironmentConfig {
   baseUrl: string
@@ -43,8 +43,8 @@ interface SyncResult {
 /**
  * Reads and parses the environments.json file
  */
-async function readEnvironmentsFromFile(baseDir: string): Promise<Record<string, EnvironmentConfig>> {
-  const filePath = join(baseDir, 'src', 'tests', 'config', 'environments', 'environments.json')
+async function readEnvironmentsFromFile(): Promise<Record<string, EnvironmentConfig>> {
+  const filePath = `${getAutomationEnvironmentsDir()}/environments.json`
 
   try {
     await fs.access(filePath)
@@ -285,11 +285,11 @@ async function main() {
     console.log('🔄 Starting environments sync...')
     console.log('This will scan environments.json and sync environments to database.\n')
 
-    const baseDir = process.cwd()
+    await ensureAutomationWorkspaceReady()
 
     // Read environments from file
     console.log('📁 Reading environments.json...')
-    const jsonContent = await readEnvironmentsFromFile(baseDir)
+    const jsonContent = await readEnvironmentsFromFile()
     const environmentKeys = Object.keys(jsonContent)
     console.log(`   Found ${environmentKeys.length} environment(s): ${environmentKeys.join(', ') || 'none'}`)
 
@@ -321,3 +321,6 @@ async function main() {
 
 main()
 
+
+
+

package/templates/default/scripts/sync-locator-groups.ts

@@ -14,6 +14,7 @@ import { join } from 'path'
 import { glob } from 'glob'
 import prisma from '../src/config/db-config'
 import { findModuleByPath, buildModuleHierarchy } from '../src/lib/module-hierarchy-builder'
+import { extractModulePathFromAutomationFile, getAutomationLocatorMapPath } from '../src/lib/template-sync-utils'
 
 /**
  * Represents a locator group from the filesystem
@@ -52,7 +53,7 @@ interface SyncResult {
  * Reads and parses the locator-map.json file
  */
 async function readLocatorMap(baseDir: string): Promise<LocatorMapEntry[]> {
-  const locatorMapPath = join(baseDir, 'src', 'tests', 'mapping', 'locator-map.json')
+  const locatorMapPath = getAutomationLocatorMapPath(baseDir)
 
   try {
     await fs.access(locatorMapPath)
@@ -82,7 +83,7 @@ async function readLocatorMap(baseDir: string): Promise<LocatorMapEntry[]> {
  * Scans the locators directory to find all locator group files
  */
 async function scanLocatorGroupFiles(baseDir: string): Promise<string[]> {
-  const pattern = 'src/tests/locators/**/*.json'
+  const pattern = 'automation/locators/**/*.json'
 
   try {
     const files = await glob(pattern, {
@@ -96,15 +97,11 @@ async function scanLocatorGroupFiles(baseDir: string): Promise<string[]> {
 
 /**
  * Extracts module path from locator file path
- * Example: src/tests/locators/home/home.json -> /home
- * Example: src/tests/locators/users/admins/directors.json -> /users/admins
+ * Example: automation/locators/home/home.json -> /home
+ * Example: automation/locators/users/admins/directors.json -> /users/admins
  */
 function extractModulePathFromLocatorFile(filePath: string, baseDir: string): string {
-  const testsDir = join(baseDir, 'src', 'tests')
-  const relativePath = filePath.replace(testsDir, '').replace(/\\/g, '/')
-  const pathParts = relativePath.split('/').filter(p => p && p !== 'locators')
-  const moduleParts = pathParts.slice(0, -1) // Remove filename
-  return moduleParts.length > 0 ? '/' + moduleParts.join('/') : '/'
+  return extractModulePathFromAutomationFile(filePath, baseDir, 'locators')
 }
 
 /**
@@ -374,7 +371,7 @@ async function main() {
     console.log(`   Found ${locatorMap.length} entry(ies) in locator map`)
 
     // Build locator groups from filesystem
-    console.log('\n📁 Scanning src/tests/locators directory...')
+    console.log('\n📁 Scanning automation/locators directory...')
     const locatorGroups = await buildLocatorGroupsFromFS(baseDir, locatorMap)
     result.locatorGroupsScanned = locatorGroups.length
     console.log(`   Found ${locatorGroups.length} locator group(s) in filesystem`)

package/templates/default/scripts/sync-locators.ts

@@ -15,6 +15,7 @@ import { glob } from 'glob'
 import prisma from '../src/config/db-config'
 import { buildModuleHierarchy } from '../src/lib/module-hierarchy-builder'
 import { getLocatorGroupFilePath } from '../src/lib/locator-group-file-utils'
+import { extractModulePathFromAutomationFile } from '../src/lib/template-sync-utils'
 
 interface SyncResult {
   locatorsScanned: number
@@ -34,7 +35,7 @@ interface SyncResult {
  * Scans locator directory for all JSON files
  */
 async function scanLocatorFiles(baseDir: string): Promise<string[]> {
-  const pattern = 'src/tests/locators/**/*.json'
+  const pattern = 'automation/locators/**/*.json'
   try {
     const files = await glob(pattern, {
       cwd: baseDir,
@@ -47,14 +48,10 @@ async function scanLocatorFiles(baseDir: string): Promise<string[]> {
 
 /**
  * Extracts module path from locator file path
- * Example: src/tests/locators/users/admins/directors/directors.json -> /users/admins/directors
+ * Example: automation/locators/users/admins/directors/directors.json -> /users/admins/directors
  */
 function extractModulePathFromLocatorFile(filePath: string, baseDir: string): string {
-  const testsDir = join(baseDir, 'src', 'tests')
-  const relativePath = filePath.replace(testsDir, '').replace(/\\/g, '/')
-  const pathParts = relativePath.split('/').filter(p => p && p !== 'locators')
-  const moduleParts = pathParts.slice(0, -1) // Remove filename
-  return moduleParts.length > 0 ? '/' + moduleParts.join('/') : '/'
+  return extractModulePathFromAutomationFile(filePath, baseDir, 'locators')
 }
 
 /**
@@ -368,7 +365,7 @@ async function main() {
     const baseDir = process.cwd()
 
     // Scan locator files
-    console.log('📁 Scanning src/tests/locators...')
+    console.log('📁 Scanning automation/locators...')
     const files = await scanLocatorFiles(baseDir)
     console.log(`   Found ${files.length} locator file(s)`)
 
@@ -399,4 +396,3 @@ async function main() {
 }
 
 main()
-

package/templates/default/scripts/sync-modules.ts

@@ -13,6 +13,7 @@ import { buildModuleHierarchy, findModuleByPath, getAllModulesWithPaths } from '
 import { join } from 'path'
 import { glob } from 'glob'
 import prisma from '../src/config/db-config'
+import { extractModulePathFromAutomationFile } from '../src/lib/template-sync-utils'
 
 interface SyncResult {
   modulesScanned: number
@@ -33,7 +34,7 @@ async function scanLocatorDirectories(baseDir: string): Promise<string[]> {
 
   try {
     // Get all JSON files in locators directory
-    const pattern = 'src/tests/locators/**/*.json'
+    const pattern = 'automation/locators/**/*.json'
     const files = await glob(pattern, {
       cwd: baseDir,
     })
@@ -61,7 +62,7 @@ async function scanFeatureDirectories(baseDir: string): Promise<string[]> {
 
   try {
     // Get all feature files
-    const pattern = 'src/tests/features/**/*.feature'
+    const pattern = 'automation/features/**/*.feature'
     const files = await glob(pattern, {
       cwd: baseDir,
     })
@@ -83,26 +84,18 @@ async function scanFeatureDirectories(baseDir: string): Promise<string[]> {
 
 /**
  * Extracts module path from locator file path
- * Example: src/tests/locators/home/home.json -> /home
+ * Example: automation/locators/home/home.json -> /home
  */
 function extractModulePathFromLocatorFile(filePath: string, baseDir: string): string {
-  const testsDir = join(baseDir, 'src', 'tests')
-  const relativePath = filePath.replace(testsDir, '').replace(/\\/g, '/')
-  const pathParts = relativePath.split('/').filter(p => p && p !== 'locators')
-  const moduleParts = pathParts.slice(0, -1) // Remove filename
-  return moduleParts.length > 0 ? '/' + moduleParts.join('/') : '/'
+  return extractModulePathFromAutomationFile(filePath, baseDir, 'locators')
 }
 
 /**
  * Extracts module path from feature file path
- * Example: src/tests/features/login/demo.feature -> /login
+ * Example: automation/features/login/demo.feature -> /login
  */
 function extractModulePathFromFeatureFile(filePath: string, baseDir: string): string {
-  const featuresBaseDir = join(baseDir, 'src', 'tests', 'features')
-  const relativePath = filePath.replace(featuresBaseDir, '').replace(/\\/g, '/')
-  const pathParts = relativePath.split('/').filter(part => part && part !== '')
-  const moduleParts = pathParts.slice(0, -1) // Remove filename
-  return moduleParts.length > 0 ? '/' + moduleParts.join('/') : '/'
+  return extractModulePathFromAutomationFile(filePath, baseDir, 'features')
 }
 
 /**
@@ -301,11 +294,11 @@ async function main() {
     const baseDir = process.cwd()
 
     // Scan directories
-    console.log('📁 Scanning src/tests/locators...')
+    console.log('📁 Scanning automation/locators...')
     const locatorModulePaths = await scanLocatorDirectories(baseDir)
     console.log(`   Found ${locatorModulePaths.length} module path(s): ${locatorModulePaths.join(', ') || 'none'}`)
 
-    console.log('\n📁 Scanning src/tests/features...')
+    console.log('\n📁 Scanning automation/features...')
     const featureModulePaths = await scanFeatureDirectories(baseDir)
     console.log(`   Found ${featureModulePaths.length} module path(s): ${featureModulePaths.join(', ') || 'none'}`)
 
@@ -346,4 +339,3 @@ async function main() {
 }
 
 main()
-

package/templates/default/scripts/sync-tags.ts

@@ -235,10 +235,10 @@ async function main() {
     console.log('Filesystem is the source of truth - tags in DB but not in FS will be deleted.\n')
 
     const baseDir = process.cwd()
-    const featuresDir = join(baseDir, 'src', 'tests', 'features')
+    const featuresDir = join(baseDir, 'automation', 'features')
 
     // Scan feature files
-    console.log('📁 Scanning feature files in src/tests/features...')
+    console.log('📁 Scanning feature files in automation/features...')
     const parsedFeatures = await scanFeatureFiles(featuresDir)
     console.log(`   Found ${parsedFeatures.length} feature file(s)`)