create-appraisejs 0.2.0 → 0.3.0-alpha.0

package/templates/default/scripts/protect-seeded-files.ts

@@ -1,38 +1,51 @@
-#!/usr/bin/env tsx
-
-import fs from 'fs'
-import path from 'path'
-
-const SEEDED_TEMPLATE_PATHS = ['prisma/dev.db', 'automation/config/environments/environments.json']
-
-function trimTrailingBlankLines(lines: string[]): string[] {
-  const trimmed = [...lines]
-  while (trimmed.length > 0 && trimmed[trimmed.length - 1] === '') {
-    trimmed.pop()
-  }
-  return trimmed
-}
-
-function setSeededTemplateFilesTracked(content: string, tracked: boolean): string {
-  const managedLines = new Set(SEEDED_TEMPLATE_PATHS.flatMap(filePath => [filePath, `!${filePath}`]))
-  const lines = trimTrailingBlankLines(content.split(/\r?\n/)).filter(line => !managedLines.has(line.trim()))
-
-  for (const filePath of SEEDED_TEMPLATE_PATHS) {
-    lines.push(tracked ? `!${filePath}` : filePath)
-  }
-
-  return `${lines.join('\n')}\n`
-}
-
-const gitignorePath = path.join(process.cwd(), '.gitignore')
-const packagedGitignorePath = path.join(process.cwd(), 'gitignore')
-const sourceGitignorePath = fs.existsSync(gitignorePath) ? gitignorePath : packagedGitignorePath
-const currentGitignore = fs.existsSync(sourceGitignorePath) ? fs.readFileSync(sourceGitignorePath, 'utf8') : ''
-
-fs.writeFileSync(gitignorePath, setSeededTemplateFilesTracked(currentGitignore, false))
-
-if (sourceGitignorePath === packagedGitignorePath && fs.existsSync(packagedGitignorePath)) {
-  fs.rmSync(packagedGitignorePath, { force: true })
-}
-
-console.log('Updated .gitignore to ignore seeded local files.')
+#!/usr/bin/env tsx
+
+import fs from 'fs'
+import path from 'path'
+
+const SEEDED_TEMPLATE_PATHS = ['prisma/dev.db', 'automation/config/environments/environments.json']
+
+/**
+ * Trims trailing blank lines while preserving internal spacing.
+ */
+function trimTrailingBlankLines(lines: string[]): string[] {
+  const trimmed = [...lines]
+  while (trimmed.length > 0 && trimmed[trimmed.length - 1] === '') {
+    trimmed.pop()
+  }
+  return trimmed
+}
+
+/**
+ * Rewrites `.gitignore` content to enforce seeded-template tracking rules.
+ */
+function setSeededTemplateFilesTracked(content: string, tracked: boolean): string {
+  const managedLines = new Set(SEEDED_TEMPLATE_PATHS.flatMap(filePath => [filePath, `!${filePath}`]))
+  const lines = trimTrailingBlankLines(content.split(/\r?\n/)).filter(line => !managedLines.has(line.trim()))
+
+  for (const filePath of SEEDED_TEMPLATE_PATHS) {
+    lines.push(tracked ? `!${filePath}` : filePath)
+  }
+
+  return `${lines.join('\n')}\n`
+}
+
+/**
+ * Updates `.gitignore` so seeded local files stay ignored.
+ */
+function main(): void {
+  const gitignorePath = path.join(process.cwd(), '.gitignore')
+  const packagedGitignorePath = path.join(process.cwd(), 'gitignore')
+  const sourceGitignorePath = fs.existsSync(gitignorePath) ? gitignorePath : packagedGitignorePath
+  const currentGitignore = fs.existsSync(sourceGitignorePath) ? fs.readFileSync(sourceGitignorePath, 'utf8') : ''
+
+  fs.writeFileSync(gitignorePath, setSeededTemplateFilesTracked(currentGitignore, false))
+
+  if (sourceGitignorePath === packagedGitignorePath && fs.existsSync(packagedGitignorePath)) {
+    fs.rmSync(packagedGitignorePath, { force: true })
+  }
+
+  console.log('Updated .gitignore to ignore seeded local files.')
+}
+
+main()

package/templates/default/scripts/regenerate-features.ts

@@ -1,94 +1,98 @@
-#!/usr/bin/env tsx
-
-/**
- * Script to synchronize feature files between database and filesystem
- * This performs bidirectional sync - both DB->FS and FS->DB
- * Run this after merging changes or database migrations to ensure sync
- *
- * Usage: npx tsx scripts/regenerate-features.ts [--dry-run]
- */
-
-import { performBidirectionalSync, performDryRunSync } from '../src/lib/bidirectional-sync'
-import { join } from 'path'
-
-async function main() {
-  try {
-    const isDryRun = process.argv.includes('--dry-run')
-    const featuresBaseDir = join(process.cwd(), 'src', 'tests', 'features')
-
-    if (isDryRun) {
-      console.log('🔍 Performing dry run of bidirectional sync...')
-      console.log('This will show what would be changed without making any modifications.\n')
-
-      const dryRunResult = await performDryRunSync(featuresBaseDir)
-
-      console.log('\n📊 Dry run results:')
-      console.log(`📁 Would generate ${dryRunResult.wouldGenerate.length} feature files:`)
-      dryRunResult.wouldGenerate.forEach((filePath, index) => {
-        const relativePath = filePath.replace(process.cwd(), '.')
-        console.log(`   ${index + 1}. ${relativePath}`)
-      })
-
-      console.log(`\n🔄 Would update ${dryRunResult.wouldUpdate.length} feature files:`)
-      dryRunResult.wouldUpdate.forEach((filePath, index) => {
-        const relativePath = filePath.replace(process.cwd(), '.')
-        console.log(`   ${index + 1}. ${relativePath}`)
-      })
-
-      console.log(`\n➕ Would create ${dryRunResult.wouldCreate.testSuites.length} test suites:`)
-      dryRunResult.wouldCreate.testSuites.forEach((item, index) => {
-        console.log(`   ${index + 1}. ${item}`)
-      })
-
-      console.log(`\n📝 Would create ${dryRunResult.wouldCreate.testCases.length} test cases:`)
-      dryRunResult.wouldCreate.testCases.forEach((item, index) => {
-        console.log(`   ${index + 1}. ${item}`)
-      })
-
-      console.log(`\n🔧 Would create ${dryRunResult.wouldCreate.templateSteps.length} template steps:`)
-      dryRunResult.wouldCreate.templateSteps.forEach((item, index) => {
-        console.log(`   ${index + 1}. ${item}`)
-      })
-
-      console.log(`\n🏷️  Would create ${dryRunResult.wouldCreate.tags.length} tags:`)
-      dryRunResult.wouldCreate.tags.forEach((tag, index) => {
-        console.log(`   ${index + 1}. ${tag}`)
-      })
-
-      console.log('\n💡 To perform the actual sync, run without --dry-run flag')
-    } else {
-      console.log('🔄 Starting bidirectional sync between database and feature files...')
-      console.log('This will sync both directions:')
-      console.log('   📁 Feature files → Database (create missing test suites/cases)')
-      console.log('   🗄️ Database → Feature files (generate/update feature files)')
-      console.log('')
-
-      const syncResult = await performBidirectionalSync(featuresBaseDir)
-
-      console.log('\n✅ Bidirectional sync completed successfully!')
-      console.log(`📊 Summary:`)
-      console.log(`   📁 Generated feature files: ${syncResult.generatedFeatureFiles}`)
-      console.log(`   🔄 Updated feature files: ${syncResult.updatedFeatureFiles}`)
-      console.log(`   🗄️ Merged test suites: ${syncResult.mergedTestSuites}`)
-      console.log(`   📝 Added scenarios: ${syncResult.addedScenarios}`)
-      console.log(`   📊 Total processed: ${syncResult.totalProcessed}`)
-
-      if (syncResult.errors.length > 0) {
-        console.log(`\n⚠️  Errors encountered: ${syncResult.errors.length}`)
-        syncResult.errors.forEach((error, index) => {
-          console.log(`   ${index + 1}. ${error}`)
-        })
-      }
-
-      console.log('\n💡 Tips:')
-      console.log('   - Run with --dry-run to see what would be changed')
-      console.log('   - This script is safe to run multiple times')
-      console.log('   - Changes are automatically merged, not overwritten')
-    }
-  } catch (error) {
-    console.error('\n❌ Error during sync:', error)
-    process.exit(1)
-  }
-}
-
-main()
+#!/usr/bin/env tsx
+
+/**
+ * Script to synchronize feature files between database and filesystem
+ * This performs bidirectional sync - both DB->FS and FS->DB
+ * Run this after merging changes or database migrations to ensure sync
+ *
+ * Usage: npx tsx scripts/regenerate-features.ts [--dry-run]
+ */
+
+import { performBidirectionalSync, performDryRunSync } from '../src/lib/bidirectional-sync'
+import { ensureAutomationWorkspaceReady, getAutomationFeaturesDir } from '../src/lib/automation/paths'
+
+/**
+ * Runs bidirectional feature sync in dry-run or apply mode.
+ */
+async function main(): Promise<void> {
+  try {
+    const isDryRun = process.argv.includes('--dry-run')
+    await ensureAutomationWorkspaceReady()
+    const featuresBaseDir = getAutomationFeaturesDir()
+
+    if (isDryRun) {
+      console.log('🔍 Performing dry run of bidirectional sync...')
+      console.log('This will show what would be changed without making any modifications.\n')
+
+      const dryRunResult = await performDryRunSync(featuresBaseDir)
+
+      console.log('\n📊 Dry run results:')
+      console.log(`📁 Would generate ${dryRunResult.wouldGenerate.length} feature files:`)
+      dryRunResult.wouldGenerate.forEach((filePath, index) => {
+        const relativePath = filePath.replace(process.cwd(), '.')
+        console.log(`   ${index + 1}. ${relativePath}`)
+      })
+
+      console.log(`\n🔄 Would update ${dryRunResult.wouldUpdate.length} feature files:`)
+      dryRunResult.wouldUpdate.forEach((filePath, index) => {
+        const relativePath = filePath.replace(process.cwd(), '.')
+        console.log(`   ${index + 1}. ${relativePath}`)
+      })
+
+      console.log(`\n➕ Would create ${dryRunResult.wouldCreate.testSuites.length} test suites:`)
+      dryRunResult.wouldCreate.testSuites.forEach((item, index) => {
+        console.log(`   ${index + 1}. ${item}`)
+      })
+
+      console.log(`\n📝 Would create ${dryRunResult.wouldCreate.testCases.length} test cases:`)
+      dryRunResult.wouldCreate.testCases.forEach((item, index) => {
+        console.log(`   ${index + 1}. ${item}`)
+      })
+
+      console.log(`\n🔧 Would create ${dryRunResult.wouldCreate.templateSteps.length} template steps:`)
+      dryRunResult.wouldCreate.templateSteps.forEach((item, index) => {
+        console.log(`   ${index + 1}. ${item}`)
+      })
+
+      console.log(`\n🏷️  Would create ${dryRunResult.wouldCreate.tags.length} tags:`)
+      dryRunResult.wouldCreate.tags.forEach((tag, index) => {
+        console.log(`   ${index + 1}. ${tag}`)
+      })
+
+      console.log('\n💡 To perform the actual sync, run without --dry-run flag')
+    } else {
+      console.log('🔄 Starting bidirectional sync between database and feature files...')
+      console.log('This will sync both directions:')
+      console.log('   📁 Feature files → Database (create missing test suites/cases)')
+      console.log('   🗄️ Database → Feature files (generate/update feature files)')
+      console.log('')
+
+      const syncResult = await performBidirectionalSync(featuresBaseDir)
+
+      console.log('\n✅ Bidirectional sync completed successfully!')
+      console.log(`📊 Summary:`)
+      console.log(`   📁 Generated feature files: ${syncResult.generatedFeatureFiles}`)
+      console.log(`   🔄 Updated feature files: ${syncResult.updatedFeatureFiles}`)
+      console.log(`   🗄️ Merged test suites: ${syncResult.mergedTestSuites}`)
+      console.log(`   📝 Added scenarios: ${syncResult.addedScenarios}`)
+      console.log(`   📊 Total processed: ${syncResult.totalProcessed}`)
+
+      if (syncResult.errors.length > 0) {
+        console.log(`\n⚠️  Errors encountered: ${syncResult.errors.length}`)
+        syncResult.errors.forEach((error, index) => {
+          console.log(`   ${index + 1}. ${error}`)
+        })
+      }
+
+      console.log('\n💡 Tips:')
+      console.log('   - Run with --dry-run to see what would be changed')
+      console.log('   - This script is safe to run multiple times')
+      console.log('   - Changes are automatically merged, not overwritten')
+    }
+  } catch (error) {
+    console.error('\n❌ Error during sync:', error)
+    process.exit(1)
+  }
+}
+
+main()

package/templates/default/scripts/run-vitest.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env tsx
+
+import fs from 'node:fs'
+import os from 'node:os'
+import process from 'node:process'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+function isUsableDirectory(directory: string | undefined): directory is string {
+  if (!directory) {
+    return false
+  }
+
+  try {
+    fs.mkdirSync(directory, { recursive: true })
+    fs.accessSync(directory, fs.constants.R_OK | fs.constants.W_OK)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function getTempDirectory(): string | undefined {
+  const envCandidates = [process.env.TMPDIR, process.env.TMP, process.env.TEMP]
+  const fallbackCandidates =
+    process.platform === 'win32' ? [os.tmpdir()] : ['/tmp', os.tmpdir(), '/var/tmp', '/usr/tmp']
+
+  return [...envCandidates, ...fallbackCandidates].find(isUsableDirectory)
+}
+
+function main(): void {
+  const tempDirectory = getTempDirectory()
+  if (!tempDirectory) {
+    console.error('Unable to find a writable temporary directory for Vitest.')
+    process.exit(1)
+  }
+
+  const vitestEntry = fileURLToPath(new URL('../node_modules/vitest/vitest.mjs', import.meta.url))
+  const env = {
+    ...process.env,
+    TMPDIR: tempDirectory,
+    TMP: tempDirectory,
+    TEMP: tempDirectory,
+  }
+
+  const result = spawnSync(process.execPath, [vitestEntry, 'run', ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env,
+  })
+
+  if (result.error) {
+    console.error(result.error)
+    process.exit(1)
+  }
+
+  process.exit(result.status ?? 1)
+}
+
+main()

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

@@ -1,19 +1,26 @@
-#!/usr/bin/env tsx
-
-import fs from 'fs'
-import path from 'path'
-
-const envContent = `# Database configuration for local development
-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')
-} else {
-  console.log('??  .env file already exists, skipping creation')
-}
-
-console.log('?? Environment setup complete!')
+#!/usr/bin/env tsx
+
+import fs from 'fs'
+import path from 'path'
+
+const envContent = `# Database configuration for local development
+DATABASE_URL="file:./dev.db"
+`
+
+/**
+ * Ensures local `.env` exists with a default SQLite DATABASE_URL.
+ */
+function main(): void {
+  const envPath = path.join(process.cwd(), '.env')
+
+  if (!fs.existsSync(envPath)) {
+    fs.writeFileSync(envPath, envContent)
+    console.log('Created .env file with SQLite configuration')
+  } else {
+    console.log('.env file already exists, skipping creation')
+  }
+
+  console.log('Environment setup complete!')
+}
+
+main()

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

@@ -16,7 +16,9 @@ import {
   SYNC_ALL_REQUEST_ID,
   type SyncScriptId,
 } from '../src/lib/sync/sync-registry'
+import { printSyncSummary } from './lib/sync-summary'
 const SYNC_SCRIPT_IDS = resolveRequestedSyncExecutionOrder(SYNC_ALL_REQUEST_ID)
+const DIVIDER = '='.repeat(80)
 
 interface DatabaseChanges {
   scanned: number
@@ -48,6 +50,15 @@ interface SyncSummary {
   totalDbChanges: DatabaseChanges
 }
 
+const DB_CHANGE_PATTERNS: Array<{ key: keyof DatabaseChanges; regex: RegExp }> = [
+  { key: 'scanned', regex: /scanned:\s*(\d+)/i },
+  { key: 'existing', regex: /existing:\s*(\d+)/i },
+  { key: 'created', regex: /created:\s*(\d+)/i },
+  { key: 'updated', regex: /updated:\s*(\d+)/i },
+  { key: 'deleted', regex: /deleted:\s*(\d+)/i },
+  { key: 'errors', regex: /Errors:\s*(\d+)/i },
+]
+
 /**
  * Parses database changes from sync script output
  * Extracts counts from the "Sync Summary:" section
@@ -62,7 +73,8 @@ function parseDatabaseChanges(stdout: string): DatabaseChanges | undefined {
     errors: 0,
   }
 
-  // Look for the Sync Summary section
+  // Child sync scripts are expected to print a canonical "📊 Sync Summary:"
+  // block. If absent, we skip aggregation for that child.
   const summaryIndex = stdout.indexOf('📊 Sync Summary:')
   if (summaryIndex === -1) {
     return undefined
@@ -70,17 +82,7 @@ function parseDatabaseChanges(stdout: string): DatabaseChanges | undefined {
 
   const summarySection = stdout.substring(summaryIndex)
 
-  // Parse patterns like "   📁 Modules scanned: 3" or "   ✅ Modules existing: 3"
-  const patterns = [
-    { key: 'scanned' as const, regex: /scanned:\s*(\d+)/i },
-    { key: 'existing' as const, regex: /existing:\s*(\d+)/i },
-    { key: 'created' as const, regex: /created:\s*(\d+)/i },
-    { key: 'updated' as const, regex: /updated:\s*(\d+)/i },
-    { key: 'deleted' as const, regex: /deleted:\s*(\d+)/i },
-    { key: 'errors' as const, regex: /Errors:\s*(\d+)/i },
-  ]
-
-  for (const pattern of patterns) {
+  for (const pattern of DB_CHANGE_PATTERNS) {
     const match = summarySection.match(pattern.regex)
     if (match) {
       changes[pattern.key] = parseInt(match[1], 10) || 0
@@ -103,7 +105,8 @@ async function executeSyncScript(scriptId: SyncScriptId): Promise<ScriptResult>
     const result = await execa(process.execPath, ['--import', 'tsx', scriptPath], {
       cwd: process.cwd(),
       stdio: 'pipe',
-      reject: false, // Don't throw on non-zero exit codes
+      // Non-zero exit codes are reported in summary but should not stop orchestration.
+      reject: false,
     })
 
     const duration = Date.now() - startTime
@@ -177,10 +180,14 @@ function aggregateDatabaseChanges(results: ScriptResult[]): DatabaseChanges {
 /**
  * Generates and displays a comprehensive summary of the sync operation
  */
+function hasDatabaseChanges(changes: DatabaseChanges): boolean {
+  return Object.values(changes).some(value => value > 0)
+}
+
 function displaySummary(summary: SyncSummary): void {
-  console.log('\n' + '='.repeat(80))
+  console.log('\n' + DIVIDER)
   console.log('📊 SYNC ALL - EXECUTION SUMMARY')
-  console.log('='.repeat(80))
+  console.log(DIVIDER)
 
   console.log(`\n📈 Overall Statistics:`)
   console.log(`   Total scripts: ${summary.totalScripts}`)
@@ -205,50 +212,34 @@ function displaySummary(summary: SyncSummary): void {
     }
   })
 
-  // Display database changes summary
-  const hasChanges = summary.totalDbChanges.created > 0 || 
-                     summary.totalDbChanges.updated > 0 || 
-                     summary.totalDbChanges.deleted > 0 ||
-                     summary.totalDbChanges.existing > 0 ||
-                     summary.totalDbChanges.scanned > 0
-
-  if (hasChanges) {
-    console.log(`\n💾 Database Changes Summary:`)
-    if (summary.totalDbChanges.scanned > 0) {
-      console.log(`   📁 Total entities scanned: ${summary.totalDbChanges.scanned}`)
-    }
-    if (summary.totalDbChanges.existing > 0) {
-      console.log(`   ✅ Total entities existing: ${summary.totalDbChanges.existing}`)
-    }
-    if (summary.totalDbChanges.created > 0) {
-      console.log(`   ➕ Total entities created: ${summary.totalDbChanges.created}`)
-    }
-    if (summary.totalDbChanges.updated > 0) {
-      console.log(`   🔄 Total entities updated: ${summary.totalDbChanges.updated}`)
-    }
-    if (summary.totalDbChanges.deleted > 0) {
-      console.log(`   🗑️  Total entities deleted: ${summary.totalDbChanges.deleted}`)
-    }
-    if (summary.totalDbChanges.errors > 0) {
-      console.log(`   ❌ Total errors encountered: ${summary.totalDbChanges.errors}`)
-    }
+  // Reuse shared summary rendering so aggregate output format remains
+  // structurally aligned with individual sync scripts.
+  if (hasDatabaseChanges(summary.totalDbChanges)) {
+    printSyncSummary([
+      { label: '📁 Total entities scanned', value: summary.totalDbChanges.scanned },
+      { label: '✅ Total entities existing', value: summary.totalDbChanges.existing },
+      { label: '➕ Total entities created', value: summary.totalDbChanges.created },
+      { label: '🔄 Total entities updated', value: summary.totalDbChanges.updated },
+      { label: '🗑️  Total entities deleted', value: summary.totalDbChanges.deleted },
+      { label: '❌ Total errors encountered', value: summary.totalDbChanges.errors },
+    ])
   }
 
-  console.log(`\n${'='.repeat(80)}`)
+  console.log(`\n${DIVIDER}`)
 
   if (summary.failedScripts === 0) {
     console.log('✅ All sync scripts completed successfully!')
-    console.log('='.repeat(80) + '\n')
+    console.log(DIVIDER + '\n')
   } else {
     console.log(`⚠️  ${summary.failedScripts} script(s) failed. Please review the errors above.`)
-    console.log('='.repeat(80) + '\n')
+    console.log(DIVIDER + '\n')
   }
 }
 
 /**
  * Main function that orchestrates all sync scripts
  */
-async function main(): Promise<void> {
+async function main(): Promise<number> {
   const startTime = Date.now()
   const results: ScriptResult[] = []
 
@@ -256,7 +247,8 @@ async function main(): Promise<void> {
   console.log('This will sync all entities from filesystem to database in the correct dependency order.')
   console.log('Execution will continue even if individual scripts fail.\n')
 
-  // Execute each script in order
+  // Execute in dependency order from registry; we intentionally continue through
+  // failures to provide complete visibility of system state in one run.
   for (const scriptId of SYNC_SCRIPT_IDS) {
     const result = await executeSyncScript(scriptId)
     results.push(result)
@@ -282,16 +274,14 @@ async function main(): Promise<void> {
   // Display comprehensive summary
   displaySummary(summary)
 
-  // Exit with appropriate code
-  if (failedScripts > 0) {
-    process.exit(1)
-  } else {
-    process.exit(0)
-  }
+  return failedScripts > 0 ? 1 : 0
 }
 
 // Run the main function
 main().catch(error => {
   console.error('\n❌ Fatal error during sync orchestration:', error)
-  process.exit(1)
+  return 1
 })
+  .then(exitCode => {
+    process.exit(exitCode)
+  })