@wundr.io/cli 1.0.1 → 1.0.2-dev.20260530174250.ef0ec927

package/src/utils/claude-config-installer.ts

@@ -3,13 +3,15 @@
  * Handles installation of CLAUDE.md, hooks, conventions, and agent templates
  */
 
+import { existsSync } from 'fs';
 import * as fs from 'fs/promises';
 import * as path from 'path';
-import { existsSync } from 'fs';
+
 import chalk from 'chalk';
 import ora from 'ora';
-import { logger } from './logger';
+
 import { BackupRollbackManager } from './backup-rollback-manager';
+import { logger } from './logger';
 
 export interface ClaudeConfigOptions {
   claudeDir?: string;
@@ -55,7 +57,12 @@ export class ClaudeConfigInstaller {
    * Install all Claude Code configurations
    */
   async install(options: ClaudeConfigOptions = {}): Promise<InstallResult> {
-    const { dryRun = false, skipBackup = false, overwrite = false, verbose = false } = options;
+    const {
+      dryRun = false,
+      skipBackup = false,
+      overwrite = false,
+      verbose = false,
+    } = options;
 
     const result: InstallResult = {
       success: false,
@@ -71,7 +78,9 @@ export class ClaudeConfigInstaller {
       if (!skipBackup && !dryRun) {
         const existingFiles = await this.getExistingConfigFiles();
         if (existingFiles.length > 0) {
-          const spinner = ora('Creating backup of existing configurations...').start();
+          const spinner = ora(
+            'Creating backup of existing configurations...'
+          ).start();
           const backup = await this.backupManager.createBackup(
             existingFiles,
             'Pre-installation backup'
@@ -94,10 +103,18 @@ export class ClaudeConfigInstaller {
       await this.installAgentTemplates(result, { dryRun, overwrite, verbose });
 
       // Install git-worktree workflows
-      await this.installGitWorktreeWorkflows(result, { dryRun, overwrite, verbose });
+      await this.installGitWorktreeWorkflows(result, {
+        dryRun,
+        overwrite,
+        verbose,
+      });
 
       // Install validation scripts
-      await this.installValidationScripts(result, { dryRun, overwrite, verbose });
+      await this.installValidationScripts(result, {
+        dryRun,
+        overwrite,
+        verbose,
+      });
 
       result.success = result.errors.length === 0;
 
@@ -109,7 +126,7 @@ export class ClaudeConfigInstaller {
       logger.error('Installation failed', error);
       result.errors.push({
         file: 'general',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       return result;
     }
@@ -157,7 +174,7 @@ export class ClaudeConfigInstaller {
       spinner.fail('Failed to install CLAUDE.md');
       result.errors.push({
         file: 'CLAUDE.md',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       logger.error('CLAUDE.md installation failed', error);
     }
@@ -202,7 +219,7 @@ export class ClaudeConfigInstaller {
       spinner.fail('Failed to install hooks');
       result.errors.push({
         file: 'hooks',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       logger.error('Hooks installation failed', error);
     }
@@ -242,7 +259,7 @@ export class ClaudeConfigInstaller {
       spinner.fail('Failed to install conventions');
       result.errors.push({
         file: 'conventions.json',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       logger.error('Conventions installation failed', error);
     }
@@ -264,34 +281,90 @@ export class ClaudeConfigInstaller {
       const templates = this.generateAgentTemplates();
 
       for (const [agentName, agentConfig] of Object.entries(templates)) {
-        const agentPath = path.join(agentsDir, `${agentName}.json`);
+        // Generate .md files with proper YAML frontmatter (not .json)
+        const agentPath = path.join(agentsDir, `${agentName}.md`);
 
         if (existsSync(agentPath) && !options.overwrite) {
-          result.skipped.push(`agents/${agentName}.json`);
+          result.skipped.push(`agents/${agentName}.md`);
           continue;
         }
 
         if (options.dryRun) {
-          result.installed.push(`agents/${agentName}.json (dry-run)`);
+          result.installed.push(`agents/${agentName}.md (dry-run)`);
           continue;
         }
 
-        await fs.writeFile(agentPath, JSON.stringify(agentConfig, null, 2));
-        result.installed.push(`agents/${agentName}.json`);
+        // Generate markdown with YAML frontmatter
+        const mdContent = this.generateAgentMarkdownContent(
+          agentName,
+          agentConfig
+        );
+        await fs.writeFile(agentPath, mdContent);
+        result.installed.push(`agents/${agentName}.md`);
       }
 
-      spinner.succeed(`Agent templates installed (${Object.keys(templates).length} templates)`);
-      logger.info('Agent templates installed', { count: Object.keys(templates).length });
+      spinner.succeed(
+        `Agent templates installed (${Object.keys(templates).length} templates)`
+      );
+      logger.info('Agent templates installed', {
+        count: Object.keys(templates).length,
+      });
     } catch (error) {
       spinner.fail('Failed to install agent templates');
       result.errors.push({
         file: 'agent-templates',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       logger.error('Agent templates installation failed', error);
     }
   }
 
+  /**
+   * Generate markdown content with proper YAML frontmatter for agent files
+   */
+  private generateAgentMarkdownContent(
+    agentName: string,
+    config: {
+      name: string;
+      role: string;
+      responsibilities: string[];
+      tools: string[];
+      patterns: string[];
+    }
+  ): string {
+    const firstResponsibility =
+      config.responsibilities[0] ?? 'software development';
+    const description = `${config.name} specialist for ${firstResponsibility.toLowerCase()}.`;
+    const toolsList = 'Read, Write, Edit, Bash, Glob, Grep';
+    const useFor =
+      config.responsibilities.slice(0, 2).join(', ').toLowerCase() ||
+      'development tasks';
+
+    return `---
+name: ${agentName}
+description: >
+  ${description}
+  Use for ${useFor}.
+tools: ${toolsList}
+model: sonnet
+---
+
+# ${config.name}
+
+## Role
+${config.role}
+
+## Responsibilities
+${config.responsibilities.map(r => `- ${r}`).join('\n')}
+
+## Tools & Technologies
+${config.tools.map(t => `- ${t}`).join('\n')}
+
+## Patterns
+${config.patterns.map(p => `- ${p}`).join('\n')}
+`;
+  }
+
   /**
    * Install git-worktree workflows
    */
@@ -320,17 +393,24 @@ export class ClaudeConfigInstaller {
           continue;
         }
 
-        await fs.writeFile(workflowPath, JSON.stringify(workflowContent, null, 2));
+        await fs.writeFile(
+          workflowPath,
+          JSON.stringify(workflowContent, null, 2)
+        );
         result.installed.push(`workflows/${workflowName}.json`);
       }
 
-      spinner.succeed(`Git-worktree workflows installed (${Object.keys(workflows).length} workflows)`);
-      logger.info('Git-worktree workflows installed', { count: Object.keys(workflows).length });
+      spinner.succeed(
+        `Git-worktree workflows installed (${Object.keys(workflows).length} workflows)`
+      );
+      logger.info('Git-worktree workflows installed', {
+        count: Object.keys(workflows).length,
+      });
     } catch (error) {
       spinner.fail('Failed to install git-worktree workflows');
       result.errors.push({
         file: 'git-worktree-workflows',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       logger.error('Git-worktree workflows installation failed', error);
     }
@@ -369,13 +449,17 @@ export class ClaudeConfigInstaller {
         result.installed.push(`scripts/${scriptName}`);
       }
 
-      spinner.succeed(`Validation scripts installed (${Object.keys(scripts).length} scripts)`);
-      logger.info('Validation scripts installed', { count: Object.keys(scripts).length });
+      spinner.succeed(
+        `Validation scripts installed (${Object.keys(scripts).length} scripts)`
+      );
+      logger.info('Validation scripts installed', {
+        count: Object.keys(scripts).length,
+      });
     } catch (error) {
       spinner.fail('Failed to install validation scripts');
       result.errors.push({
         file: 'validation-scripts',
-        error: error instanceof Error ? error.message : String(error)
+        error: error instanceof Error ? error.message : String(error),
       });
       logger.error('Validation scripts installation failed', error);
     }
@@ -571,7 +655,8 @@ echo "✅ Post-checkout completed"
       },
       'bug-fix': {
         name: 'Bug Fix Workflow',
-        description: 'Workflow for fixing bugs without affecting main development',
+        description:
+          'Workflow for fixing bugs without affecting main development',
         steps: [
           {
             name: 'Create worktree',
@@ -719,13 +804,19 @@ echo "✅ Configuration check complete"
       console.log(chalk.green('✅ Installation completed successfully!\n'));
       console.log(chalk.cyan('Next steps:'));
       console.log(chalk.white('  1. Review installed configurations'));
-      console.log(chalk.white('  2. Run validation: ~/.claude/scripts/validate-setup.sh'));
+      console.log(
+        chalk.white('  2. Run validation: ~/.claude/scripts/validate-setup.sh')
+      );
       console.log(chalk.white('  3. Customize agent templates as needed'));
     } else {
       console.log(chalk.red('❌ Installation completed with errors\n'));
       if (result.backupId) {
         console.log(chalk.cyan('To rollback:'));
-        console.log(chalk.white(`  wundr computer-setup rollback --backup ${result.backupId}`));
+        console.log(
+          chalk.white(
+            `  wundr computer-setup rollback --backup ${result.backupId}`
+          )
+        );
       }
     }
   }

package/src/utils/config-manager.ts

@@ -1,10 +1,13 @@
-import fs from 'fs-extra';
-import path from 'path';
 import os from 'os';
+import path from 'path';
+
+import fs from 'fs-extra';
 import { z } from 'zod';
-import { WundrConfig } from '../types';
-import { logger } from './logger';
+
 import { errorHandler } from './error-handler';
+import { logger } from './logger';
+
+import type { WundrConfig } from '../types';
 
 // Zod schema for configuration validation
 const WundrConfigSchema = z.object({
@@ -213,7 +216,7 @@ export class ConfigManager {
         throw new Error(`Invalid path: empty key at position ${i}`);
       }
       if (!current || typeof current !== 'object') {
-        throw new Error(`Invalid path: cannot set property on non-object`);
+        throw new Error('Invalid path: cannot set property on non-object');
       }
       if (!current[key] || typeof current[key] !== 'object') {
         current[key] = {};
@@ -226,7 +229,7 @@ export class ConfigManager {
       throw new Error('Invalid path: empty final key');
     }
     if (!finalKey || !current || typeof current !== 'object') {
-      throw new Error(`Invalid path: cannot set property`);
+      throw new Error('Invalid path: cannot set property');
     }
     current[finalKey] = value;
   }

package/src/utils/error-handler.ts

@@ -1,7 +1,9 @@
 import chalk from 'chalk';
-import { WundrError } from '../types';
+
 import { logger } from './logger';
 
+import type { WundrError } from '../types';
+
 /**
  * Centralized error handling system
  */

package/src/utils/logger.ts

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
-import { Logger } from '../types';
+
+import type { Logger } from '../types';
 
 /**
  * Enhanced logger with multiple levels and colored output
@@ -17,7 +18,9 @@ class WundrLogger implements Logger {
   }
 
   private shouldLog(level: string): boolean {
-    if (this.silent) return false;
+    if (this.silent) {
+      return false;
+    }
 
     const levels = { debug: 0, info: 1, warn: 2, error: 3 };
     return levels[level as keyof typeof levels] >= levels[this.level];
@@ -36,54 +39,74 @@ class WundrLogger implements Logger {
   }
 
   debug(message: string, ...args: any[]): void {
-    if (!this.shouldLog('debug')) return;
+    if (!this.shouldLog('debug')) {
+      return;
+    }
     console.log(chalk.gray(this.formatMessage('debug', message, ...args)));
   }
 
   info(message: string, ...args: any[]): void {
-    if (!this.shouldLog('info')) return;
+    if (!this.shouldLog('info')) {
+      return;
+    }
     console.log(chalk.blue(this.formatMessage('info', message, ...args)));
   }
 
   warn(message: string, ...args: any[]): void {
-    if (!this.shouldLog('warn')) return;
+    if (!this.shouldLog('warn')) {
+      return;
+    }
     console.warn(chalk.yellow(this.formatMessage('warn', message, ...args)));
   }
 
   error(message: string, ...args: any[]): void {
-    if (!this.shouldLog('error')) return;
+    if (!this.shouldLog('error')) {
+      return;
+    }
     console.error(chalk.red(this.formatMessage('error', message, ...args)));
   }
 
   success(message: string, ...args: any[]): void {
-    if (!this.shouldLog('info')) return;
+    if (!this.shouldLog('info')) {
+      return;
+    }
     console.log(chalk.green(this.formatMessage('success', message, ...args)));
   }
 
   // Utility methods for structured logging
   table(data: any[]): void {
-    if (this.silent) return;
+    if (this.silent) {
+      return;
+    }
     console.table(data);
   }
 
   json(data: any): void {
-    if (this.silent) return;
+    if (this.silent) {
+      return;
+    }
     console.log(JSON.stringify(data, null, 2));
   }
 
   group(label: string): void {
-    if (this.silent) return;
+    if (this.silent) {
+      return;
+    }
     console.group(chalk.cyan(label));
   }
 
   groupEnd(): void {
-    if (this.silent) return;
+    if (this.silent) {
+      return;
+    }
     console.groupEnd();
   }
 
   // Progress logging
   progress(current: number, total: number, message?: string): void {
-    if (this.silent) return;
+    if (this.silent) {
+      return;
+    }
     const percentage = Math.round((current / total) * 100);
     const bar = '█'.repeat(Math.round(percentage / 2));
     const empty = '░'.repeat(50 - Math.round(percentage / 2));

package/templates/batch/ci-cd.yaml

@@ -7,7 +7,7 @@ description: Continuous Integration and Deployment pipeline
 # Global settings
 parallel: false
 continueOnError: false
-timeout: 1800000  # 30 minutes
+timeout: 1800000 # 30 minutes
 
 # Environment variables
 variables:
@@ -23,7 +23,7 @@ commands:
   # Install dependencies
   - command: "npm ci"
     retry: 2
-    timeout: 300000  # 5 minutes
+    timeout: 300000 # 5 minutes
 
   # Code quality checks
   - command: "npm run lint"
@@ -34,11 +34,11 @@ commands:
 
   # Testing
   - command: "npm run test"
-    timeout: 600000  # 10 minutes
+    timeout: 600000 # 10 minutes
 
   - command: "npm run test:e2e"
     condition: "e2e-tests-exist"
-    timeout: 900000  # 15 minutes
+    timeout: 900000 # 15 minutes
 
   # Security audit
   - command: "npm audit --audit-level high"
@@ -46,7 +46,7 @@ commands:
 
   # Build
   - command: "npm run build"
-    timeout: 300000  # 5 minutes
+    timeout: 300000 # 5 minutes
 
   # Package
   - command: "npm pack"
@@ -55,8 +55,8 @@ commands:
   # Deploy (conditional)
   - command: "npm run deploy"
     condition: "production"
-    timeout: 600000  # 10 minutes
+    timeout: 600000 # 10 minutes
 
   # Cleanup
   - command: "echo 'CI/CD pipeline completed'"
-    condition: "always"
+    condition: "always"

package/test-suites/api/health.spec.ts

@@ -15,11 +15,11 @@ test.describe('API Health Checks', () => {
       '/status',
       '/api/status',
       '/_health',
-      '/ping'
+      '/ping',
     ];
 
     let healthyEndpoint = null;
-    
+
     for (const endpoint of healthEndpoints) {
       try {
         const response = await request.get(`${baseURL}${endpoint}`);
@@ -38,23 +38,18 @@ test.describe('API Health Checks', () => {
 
   test('API returns proper content types', async ({ request, baseURL }) => {
     // Try to find an API endpoint
-    const apiEndpoints = [
-      '/api',
-      '/api/v1',
-      '/api/v2',
-      '/graphql'
-    ];
+    const apiEndpoints = ['/api', '/api/v1', '/api/v2', '/graphql'];
 
     for (const endpoint of apiEndpoints) {
       try {
         const response = await request.get(`${baseURL}${endpoint}`);
         if (response.ok() || response.status() === 404) {
           const contentType = response.headers()['content-type'];
-          
+
           // Should return JSON or HTML
           expect(
             contentType?.includes('application/json') ||
-            contentType?.includes('text/html')
+              contentType?.includes('text/html')
           ).toBeTruthy();
         }
       } catch {
@@ -65,11 +60,13 @@ test.describe('API Health Checks', () => {
 
   test('API handles errors gracefully', async ({ request, baseURL }) => {
     // Test 404 handling
-    const response = await request.get(`${baseURL}/api/nonexistent-endpoint-${Date.now()}`);
-    
+    const response = await request.get(
+      `${baseURL}/api/nonexistent-endpoint-${Date.now()}`
+    );
+
     // Should return appropriate status code
     expect([404, 400, 401, 403]).toContain(response.status());
-    
+
     // Should not expose sensitive information
     const body = await response.text();
     expect(body).not.toContain('stack');
@@ -78,12 +75,12 @@ test.describe('API Health Checks', () => {
 
   test('API responds within acceptable time', async ({ request, baseURL }) => {
     const startTime = Date.now();
-    
+
     // Make a simple request
     await request.get(`${baseURL}/`);
-    
+
     const responseTime = Date.now() - startTime;
-    
+
     // Should respond within 5 seconds
     expect(responseTime).toBeLessThan(5000);
   });
@@ -92,18 +89,18 @@ test.describe('API Health Checks', () => {
     try {
       const response = await request.get(`${baseURL}/api`, {
         headers: {
-          'Origin': 'https://example.com'
-        }
+          Origin: 'https://example.com',
+        },
       });
 
       const headers = response.headers();
-      
+
       // Check for CORS headers if API exists
       if (response.status() !== 404) {
-        const hasCorsHeaders = 
+        const hasCorsHeaders =
           headers['access-control-allow-origin'] !== undefined ||
           headers['access-control-allow-methods'] !== undefined;
-        
+
         // Log CORS configuration
         console.log('CORS configured:', hasCorsHeaders);
       }
@@ -119,7 +116,7 @@ test.describe('API Health Checks', () => {
     for (const method of methods) {
       try {
         const response = await request.fetch(`${baseURL}/api`, {
-          method
+          method,
         });
         results[method] = response.status();
       } catch {
@@ -131,4 +128,4 @@ test.describe('API Health Checks', () => {
     expect(results['GET']).toBeGreaterThan(0);
     expect(results['OPTIONS']).toBeGreaterThan(0);
   });
-});
+});

package/test-suites/helpers/test-config.ts

@@ -12,7 +12,7 @@ export interface TestConfig {
   screenshot: 'off' | 'on' | 'only-on-failure';
   video: 'off' | 'on' | 'retain-on-failure';
   trace: 'off' | 'on' | 'on-first-retry';
-  
+
   // Custom selectors for specific apps
   selectors?: {
     navigation?: string;
@@ -21,14 +21,14 @@ export interface TestConfig {
     searchInput?: string;
     loginButton?: string;
   };
-  
+
   // API configuration
   api?: {
     baseURL?: string;
     headers?: Record<string, string>;
     timeout?: number;
   };
-  
+
   // Test data
   testData?: {
     validUser?: {
@@ -47,18 +47,19 @@ export const defaultConfig: TestConfig = {
   screenshot: 'only-on-failure',
   video: 'retain-on-failure',
   trace: 'on-first-retry',
-  
+
   selectors: {
     navigation: 'nav, [role="navigation"], header',
     mainContent: 'main, [role="main"], #content',
     footer: 'footer, [role="contentinfo"]',
     searchInput: 'input[type="search"], input[placeholder*="search" i]',
-    loginButton: 'button[type="submit"], button:has-text("Login"), button:has-text("Sign in")'
+    loginButton:
+      'button[type="submit"], button:has-text("Login"), button:has-text("Sign in")',
   },
-  
+
   api: {
-    timeout: 10000
-  }
+    timeout: 10000,
+  },
 };
 
 /**
@@ -70,15 +71,15 @@ export function loadConfig(customConfig?: Partial<TestConfig>): TestConfig {
     ...customConfig,
     selectors: {
       ...defaultConfig.selectors,
-      ...customConfig?.selectors
+      ...customConfig?.selectors,
     },
     api: {
       ...defaultConfig.api,
-      ...customConfig?.api
+      ...customConfig?.api,
     },
     testData: {
       ...defaultConfig.testData,
-      ...customConfig?.testData
-    }
+      ...customConfig?.testData,
+    },
   };
-}
+}