create-appraisejs 0.3.1-alpha.0 → 0.4.0-alpha.0

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

@@ -248,55 +248,55 @@ async function deleteOrphanedModules(fsModulePaths: Set<string>, result: SyncRes
  * Generates and displays sync summary
  */
 async function main(): Promise<SyncResult> {
-    console.log('🔄 Starting modules sync...')
-    console.log('This will scan filesystem directories and sync module hierarchy to database.')
-    console.log('Filesystem is the source of truth - modules in DB but not in FS will be deleted.\n')
+  console.log('🔄 Starting modules sync...')
+  console.log('This will scan filesystem directories and sync module hierarchy to database.')
+  console.log('Filesystem is the source of truth - modules in DB but not in FS will be deleted.\n')
 
-    const baseDir = process.cwd()
+  const baseDir = process.cwd()
 
-    // Scan directories
-    console.log('📁 Scanning automation/locators...')
-    const locatorModulePaths = await scanLocatorDirectories(baseDir)
-    console.log(`   Found ${locatorModulePaths.length} module path(s): ${locatorModulePaths.join(', ') || 'none'}`)
+  // Scan directories
+  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 automation/features...')
-    const featureModulePaths = await scanFeatureDirectories(baseDir)
-    console.log(`   Found ${featureModulePaths.length} module path(s): ${featureModulePaths.join(', ') || 'none'}`)
+  console.log('\n📁 Scanning automation/features...')
+  const featureModulePaths = await scanFeatureDirectories(baseDir)
+  console.log(`   Found ${featureModulePaths.length} module path(s): ${featureModulePaths.join(', ') || 'none'}`)
 
-    // Combine and deduplicate
-    const allModulePaths = Array.from(new Set([...locatorModulePaths, ...featureModulePaths]))
-    console.log(`\n🔍 Building module hierarchy from ${allModulePaths.length} unique module path(s)...`)
+  // Combine and deduplicate
+  const allModulePaths = Array.from(new Set([...locatorModulePaths, ...featureModulePaths]))
+  console.log(`\n🔍 Building module hierarchy from ${allModulePaths.length} unique module path(s)...`)
 
-    // Build module tree
-    const moduleTree = buildModuleTree(allModulePaths)
+  // Build module tree
+  const moduleTree = buildModuleTree(allModulePaths)
 
-    // Sync to database (create missing modules)
-    console.log('\n✅ Syncing modules to database...')
-    const result = await syncModulesToDatabase(moduleTree)
+  // Sync to database (create missing modules)
+  console.log('\n✅ Syncing modules to database...')
+  const result = await syncModulesToDatabase(moduleTree)
 
-    // Delete orphaned modules (modules in DB but not in FS)
-    const fsModulePathsSet = new Set(allModulePaths)
-    // Also add all parent paths from the tree
-    for (const path of moduleTree.keys()) {
-      fsModulePathsSet.add(path)
-    }
-    await deleteOrphanedModules(fsModulePathsSet, result)
-
-    printSyncSummary(
-      [
-        { label: '📁 Modules scanned', value: result.modulesScanned },
-        { label: '✅ Modules existing', value: result.modulesExisting },
-        { label: '➕ Modules created', value: result.modulesCreated },
-        { label: '🗑️  Modules deleted', value: result.modulesDeleted },
-        { label: '❌ Errors', value: result.errors.length },
-      ],
-      [
-        { title: 'Created modules', items: result.createdModules },
-        { title: 'Deleted modules', items: result.deletedModules },
-        { title: 'Errors', items: result.errors },
-      ],
-    )
-    return result
+  // Delete orphaned modules (modules in DB but not in FS)
+  const fsModulePathsSet = new Set(allModulePaths)
+  // Also add all parent paths from the tree
+  for (const path of moduleTree.keys()) {
+    fsModulePathsSet.add(path)
+  }
+  await deleteOrphanedModules(fsModulePathsSet, result)
+
+  printSyncSummary(
+    [
+      { label: '📁 Modules scanned', value: result.modulesScanned },
+      { label: '✅ Modules existing', value: result.modulesExisting },
+      { label: '➕ Modules created', value: result.modulesCreated },
+      { label: '🗑️  Modules deleted', value: result.modulesDeleted },
+      { label: '❌ Errors', value: result.errors.length },
+    ],
+    [
+      { title: 'Created modules', items: result.createdModules },
+      { title: 'Deleted modules', items: result.deletedModules },
+      { title: 'Errors', items: result.errors },
+    ],
+  )
+  return result
 }
 
 runSyncScript(main)

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

@@ -191,65 +191,65 @@ async function syncTagsToDatabase(tagObjects: TagData[]): Promise<SyncResult> {
  * Generates and displays sync summary
  */
 async function main(): Promise<SyncResult | void> {
-    console.log('🔄 Starting tags sync...')
-    console.log('This will scan feature files and sync tags to database.')
-    console.log('Filesystem is the source of truth - tags in DB but not in FS will be deleted.\n')
+  console.log('🔄 Starting tags sync...')
+  console.log('This will scan feature files and sync tags to database.')
+  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, 'automation', 'features')
+  const baseDir = process.cwd()
+  const featuresDir = join(baseDir, 'automation', 'features')
 
-    // Scan feature files
-    console.log('📁 Scanning feature files in automation/features...')
-    const parsedFeatures = await scanFeatureFiles(featuresDir)
-    console.log(`   Found ${parsedFeatures.length} feature file(s)`)
+  // Scan feature files
+  console.log('📁 Scanning feature files in automation/features...')
+  const parsedFeatures = await scanFeatureFiles(featuresDir)
+  console.log(`   Found ${parsedFeatures.length} feature file(s)`)
 
-    if (parsedFeatures.length === 0) {
-      console.log('\n⚠️  No feature files found. Nothing to sync.')
-      return
-    }
+  if (parsedFeatures.length === 0) {
+    console.log('\n⚠️  No feature files found. Nothing to sync.')
+    return
+  }
 
-    // Extract unique tags
-    console.log('\n🔍 Extracting unique tags from feature files...')
-    const uniqueTagExpressions = extractUniqueTags(parsedFeatures)
-    console.log(`   Found ${uniqueTagExpressions.size} unique tag(s)`)
+  // Extract unique tags
+  console.log('\n🔍 Extracting unique tags from feature files...')
+  const uniqueTagExpressions = extractUniqueTags(parsedFeatures)
+  console.log(`   Found ${uniqueTagExpressions.size} unique tag(s)`)
 
-    if (uniqueTagExpressions.size === 0) {
-      console.log('\n⚠️  No tags found in feature files. Nothing to sync.')
-      return
-    }
+  if (uniqueTagExpressions.size === 0) {
+    console.log('\n⚠️  No tags found in feature files. Nothing to sync.')
+    return
+  }
 
-    // Build tag objects
-    console.log('\n🔨 Building tag objects...')
-    const tagObjects = buildTagObjects(uniqueTagExpressions)
-    console.log(`   Built ${tagObjects.length} tag object(s)`)
+  // Build tag objects
+  console.log('\n🔨 Building tag objects...')
+  const tagObjects = buildTagObjects(uniqueTagExpressions)
+  console.log(`   Built ${tagObjects.length} tag object(s)`)
 
-    // Log tag details
-    console.log('\n   Tag details:')
-    for (const tag of tagObjects) {
-      console.log(`      - ${tag.tagExpression} → name: '${tag.name}', type: ${tag.type}`)
-    }
+  // Log tag details
+  console.log('\n   Tag details:')
+  for (const tag of tagObjects) {
+    console.log(`      - ${tag.tagExpression} → name: '${tag.name}', type: ${tag.type}`)
+  }
 
-    // Sync to database
-    const result = await syncTagsToDatabase(tagObjects)
-
-    printSyncSummary(
-      [
-        { label: '📁 Tags scanned', value: result.tagsScanned },
-        { label: '✅ Tags existing', value: result.tagsExisting },
-        { label: '➕ Tags created', value: result.tagsCreated },
-        { label: '🔄 Tags updated', value: result.tagsUpdated },
-        { label: '🗑️  Tags deleted', value: result.tagsDeleted },
-        { label: '❌ Errors', value: result.errors.length },
-      ],
-      [
-        { title: 'Updated tags', items: result.updatedTags },
-        { title: 'Created tags', items: result.createdTags },
-        { title: 'Deleted tags', items: result.deletedTags },
-        { title: 'Errors', items: result.errors },
-      ],
-    )
-
-    return result
+  // Sync to database
+  const result = await syncTagsToDatabase(tagObjects)
+
+  printSyncSummary(
+    [
+      { label: '📁 Tags scanned', value: result.tagsScanned },
+      { label: '✅ Tags existing', value: result.tagsExisting },
+      { label: '➕ Tags created', value: result.tagsCreated },
+      { label: '🔄 Tags updated', value: result.tagsUpdated },
+      { label: '🗑️  Tags deleted', value: result.tagsDeleted },
+      { label: '❌ Errors', value: result.errors.length },
+    ],
+    [
+      { title: 'Updated tags', items: result.updatedTags },
+      { title: 'Created tags', items: result.createdTags },
+      { title: 'Deleted tags', items: result.deletedTags },
+      { title: 'Errors', items: result.errors },
+    ],
+  )
+
+  return result
 }
 
 runSyncScript(main)

package/templates/blank/scripts/sync-template-step-groups.ts

@@ -206,42 +206,44 @@ async function syncStepGroupsToDatabase(stepGroups: StepGroupData[]): Promise<Sy
  * Generates and displays sync summary
  */
 async function main(): Promise<SyncResult> {
-    console.log('🔄 Starting template step group sync...')
-    console.log('This will scan step definition files and sync step groups to database.\n')
+  console.log('🔄 Starting template step group sync...')
+  console.log('This will scan step definition files and sync step groups to database.\n')
 
-    const baseDir = process.cwd()
+  const baseDir = process.cwd()
 
-    // Read step groups from files
-    console.log('📁 Scanning step definition files...')
-    const stepGroups = await readStepGroupsFromFiles(baseDir)
-    console.log(`   Found ${stepGroups.length} step group(s) with valid JSDoc`)
+  // Read step groups from files
+  console.log('📁 Scanning step definition files...')
+  const stepGroups = await readStepGroupsFromFiles(baseDir)
+  console.log(`   Found ${stepGroups.length} step group(s) with valid JSDoc`)
 
-    if (stepGroups.length === 0) {
-      console.log('\n⚠️  No step groups found. Continuing so the database can be reconciled with an empty filesystem state.')
-    }
-
-    // Sync to database
-    console.log('\n✅ Syncing step groups to database...')
-    const result = await syncStepGroupsToDatabase(stepGroups)
-
-    printSyncSummary(
-      [
-        { label: '📁 Step groups scanned', value: result.groupsScanned },
-        { label: '✅ Step groups existing', value: result.groupsExisting },
-        { label: '➕ Step groups created', value: result.groupsCreated },
-        { label: '🗑️  Step groups deleted', value: result.groupsDeleted },
-        { label: '⚠️  Step groups skipped', value: result.groupsSkipped },
-        { label: '❌ Errors', value: result.errors.length },
-      ],
-      [
-        { title: 'Created step groups', items: result.createdGroups },
-        { title: 'Existing step groups', items: result.existingGroups },
-        { title: 'Deleted step groups', items: result.deletedGroups },
-        { title: 'Skipped step groups (have template steps)', items: result.skippedGroups },
-        { title: 'Errors', items: result.errors },
-      ],
+  if (stepGroups.length === 0) {
+    console.log(
+      '\n⚠️  No step groups found. Continuing so the database can be reconciled with an empty filesystem state.',
     )
-    return result
+  }
+
+  // Sync to database
+  console.log('\n✅ Syncing step groups to database...')
+  const result = await syncStepGroupsToDatabase(stepGroups)
+
+  printSyncSummary(
+    [
+      { label: '📁 Step groups scanned', value: result.groupsScanned },
+      { label: '✅ Step groups existing', value: result.groupsExisting },
+      { label: '➕ Step groups created', value: result.groupsCreated },
+      { label: '🗑️  Step groups deleted', value: result.groupsDeleted },
+      { label: '⚠️  Step groups skipped', value: result.groupsSkipped },
+      { label: '❌ Errors', value: result.errors.length },
+    ],
+    [
+      { title: 'Created step groups', items: result.createdGroups },
+      { title: 'Existing step groups', items: result.existingGroups },
+      { title: 'Deleted step groups', items: result.deletedGroups },
+      { title: 'Skipped step groups (have template steps)', items: result.skippedGroups },
+      { title: 'Errors', items: result.errors },
+    ],
+  )
+  return result
 }
 
 runSyncScript(main)

package/templates/blank/scripts/sync-template-steps.ts

@@ -267,120 +267,120 @@ async function syncStepsToDatabase(
  * Generates and displays sync summary
  */
 async function main(): Promise<SyncResult | void> {
-    console.log('🔄 Starting template step sync...')
-    console.log('This will scan step definition files and sync template steps to database.')
-    console.log('Filesystem is the source of truth - steps in DB but not in FS will be deleted.\n')
+  console.log('🔄 Starting template step sync...')
+  console.log('This will scan step definition files and sync template steps to database.')
+  console.log('Filesystem is the source of truth - steps in DB but not in FS will be deleted.\n')
 
-    const baseDir = process.cwd()
+  const baseDir = process.cwd()
 
-    // Scan step files
-    console.log('📁 Scanning step definition files...')
-    const stepFiles = await scanStepFiles(baseDir)
-    console.log(`   Found ${stepFiles.length} step file(s)`)
+  // Scan step files
+  console.log('📁 Scanning step definition files...')
+  const stepFiles = await scanStepFiles(baseDir)
+  console.log(`   Found ${stepFiles.length} step file(s)`)
 
-    if (stepFiles.length === 0) {
-      console.log('\n⚠️  No step files found. Nothing to sync.')
-      return
-    }
-
-    // Parse all files
-    console.log('\n📖 Parsing step files...')
-    const allSteps: Array<{ step: ParsedStep; groupName: string; filePath: string }> = []
-    const errors: string[] = []
+  if (stepFiles.length === 0) {
+    console.log('\n⚠️  No step files found. Nothing to sync.')
+    return
+  }
 
-    for (const file of stepFiles) {
-      try {
-        const filePath = join(baseDir, file)
-        const content = await fs.readFile(filePath, 'utf-8')
-        const stepData = parseStepFile(content, file)
-
-        if (!stepData) {
-          errors.push(`File '${file}' does not have a valid group JSDoc comment`)
-          console.log(`   ⚠️  Skipped '${file}' (no group JSDoc)`)
-          continue
-        }
+  // Parse all files
+  console.log('\n📖 Parsing step files...')
+  const allSteps: Array<{ step: ParsedStep; groupName: string; filePath: string }> = []
+  const errors: string[] = []
 
-        if (stepData.steps.length === 0) {
-          console.log(`   ⚠️  No steps found in '${file}'`)
-          continue
-        }
+  for (const file of stepFiles) {
+    try {
+      const filePath = join(baseDir, file)
+      const content = await fs.readFile(filePath, 'utf-8')
+      const stepData = parseStepFile(content, file)
 
-        console.log(`   ✓ Parsed '${file}' (${stepData.steps.length} step(s))`)
+      if (!stepData) {
+        errors.push(`File '${file}' does not have a valid group JSDoc comment`)
+        console.log(`   ⚠️  Skipped '${file}' (no group JSDoc)`)
+        continue
+      }
 
-        for (const step of stepData.steps) {
-          allSteps.push({
-            step,
-            groupName: stepData.group.name,
-            filePath: file,
-          })
-        }
-      } catch (error) {
-        const errorMsg = `Error parsing file '${file}': ${error}`
-        errors.push(errorMsg)
-        console.error(`   ❌ ${errorMsg}`)
+      if (stepData.steps.length === 0) {
+        console.log(`   ⚠️  No steps found in '${file}'`)
+        continue
       }
-    }
 
-    if (errors.length > 0 && allSteps.length === 0) {
-      console.log('\n⚠️  No valid steps found. Please check the errors above.')
-      process.exit(1)
-    }
+      console.log(`   ✓ Parsed '${file}' (${stepData.steps.length} step(s))`)
 
-    // Check for duplicate signatures
-    const signatureMap = new Map<string, string[]>()
-    for (const { step, filePath } of allSteps) {
-      if (!signatureMap.has(step.signature)) {
-        signatureMap.set(step.signature, [])
+      for (const step of stepData.steps) {
+        allSteps.push({
+          step,
+          groupName: stepData.group.name,
+          filePath: file,
+        })
       }
-      signatureMap.get(step.signature)!.push(filePath)
+    } catch (error) {
+      const errorMsg = `Error parsing file '${file}': ${error}`
+      errors.push(errorMsg)
+      console.error(`   ❌ ${errorMsg}`)
     }
+  }
 
-    for (const [signature, files] of signatureMap.entries()) {
-      if (files.length > 1) {
-        const errorMsg = `Duplicate signature found: "${signature}" in files: ${files.join(', ')}`
-        errors.push(errorMsg)
-        console.error(`   ❌ ${errorMsg}`)
-      }
+  if (errors.length > 0 && allSteps.length === 0) {
+    console.log('\n⚠️  No valid steps found. Please check the errors above.')
+    process.exit(1)
+  }
+
+  // Check for duplicate signatures
+  const signatureMap = new Map<string, string[]>()
+  for (const { step, filePath } of allSteps) {
+    if (!signatureMap.has(step.signature)) {
+      signatureMap.set(step.signature, [])
     }
+    signatureMap.get(step.signature)!.push(filePath)
+  }
 
-    if (errors.length > 0 && allSteps.length === 0) {
-      console.log('\n⚠️  Cannot proceed due to errors. Please fix the issues above.')
-      process.exit(1)
+  for (const [signature, files] of signatureMap.entries()) {
+    if (files.length > 1) {
+      const errorMsg = `Duplicate signature found: "${signature}" in files: ${files.join(', ')}`
+      errors.push(errorMsg)
+      console.error(`   ❌ ${errorMsg}`)
     }
+  }
 
-    // Sync to database
-    console.log('\n✅ Syncing template steps to database...')
-    const result = await syncStepsToDatabase(allSteps)
-
-    // Add parsing errors to result
-    result.errors.push(...errors)
-
-    printSyncSummary(
-      [
-        { label: '📁 Steps scanned', value: result.stepsScanned },
-        { label: '✅ Steps existing', value: result.stepsExisting },
-        { label: '➕ Steps created', value: result.stepsCreated },
-        { label: '🔄 Steps updated', value: result.stepsUpdated },
-        { label: '🗑️  Steps deleted', value: result.stepsDeleted },
-        { label: '❌ Errors', value: result.errors.length },
-      ],
-      [
-        {
-          title: 'Created steps',
-          items: result.createdSteps.map(step => `${step.name} (${step.signature}) [${step.group}]`),
-        },
-        {
-          title: 'Updated steps',
-          items: result.updatedSteps.map(step => `${step.name} (${step.signature}) [${step.group}]`),
-        },
-        {
-          title: 'Deleted steps',
-          items: result.deletedSteps.map(step => `${step.name} (${step.signature}) [${step.group}]`),
-        },
-        { title: 'Errors', items: result.errors },
-      ],
-    )
-    return result
+  if (errors.length > 0 && allSteps.length === 0) {
+    console.log('\n⚠️  Cannot proceed due to errors. Please fix the issues above.')
+    process.exit(1)
+  }
+
+  // Sync to database
+  console.log('\n✅ Syncing template steps to database...')
+  const result = await syncStepsToDatabase(allSteps)
+
+  // Add parsing errors to result
+  result.errors.push(...errors)
+
+  printSyncSummary(
+    [
+      { label: '📁 Steps scanned', value: result.stepsScanned },
+      { label: '✅ Steps existing', value: result.stepsExisting },
+      { label: '➕ Steps created', value: result.stepsCreated },
+      { label: '🔄 Steps updated', value: result.stepsUpdated },
+      { label: '🗑️  Steps deleted', value: result.stepsDeleted },
+      { label: '❌ Errors', value: result.errors.length },
+    ],
+    [
+      {
+        title: 'Created steps',
+        items: result.createdSteps.map(step => `${step.name} (${step.signature}) [${step.group}]`),
+      },
+      {
+        title: 'Updated steps',
+        items: result.updatedSteps.map(step => `${step.name} (${step.signature}) [${step.group}]`),
+      },
+      {
+        title: 'Deleted steps',
+        items: result.deletedSteps.map(step => `${step.name} (${step.signature}) [${step.group}]`),
+      },
+      { title: 'Errors', items: result.errors },
+    ],
+  )
+  return result
 }
 
 runSyncScript(main)