@specverse/engines 4.3.5 → 5.0.0

package/libs/instance-factories/tools/templates/mcp/static/src/services/HybridResourcesProvider.ts

@@ -1,210 +0,0 @@
-/**
- * HybridResourcesProvider
- * Unified resources provider that can use file system or embedded resources
- * based on deployment environment
- */
-
-import { existsSync, readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { ResourcesProviderService } from './ResourcesProviderService.js';
-import { EmbeddedResourcesAdapter, type EmbeddedResourcesMap } from './EmbeddedResourcesAdapter.js';
-import type { ResourceProvider } from '../interfaces/ResourceProvider.js';
-import type { SpecVerseResource, MCPToolResult } from '../types/index.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-export interface HybridConfig {
-  mode: 'auto' | 'filesystem' | 'embedded';
-  resourcesPath?: string;
-  embeddedResources?: EmbeddedResourcesMap;
-}
-
-export class HybridResourcesProvider implements ResourceProvider {
-  private provider: ResourcesProviderService | EmbeddedResourcesAdapter;
-  private mode: 'filesystem' | 'embedded';
-
-  constructor(config: HybridConfig) {
-    this.mode = this.detectMode(config);
-
-    if (this.mode === 'embedded') {
-      if (!config.embeddedResources) {
-        // For now, create a simple embedded adapter - we'll load resources asynchronously
-        this.provider = new EmbeddedResourcesAdapter({});
-      } else {
-        this.provider = new EmbeddedResourcesAdapter(config.embeddedResources);
-      }
-    } else {
-      this.provider = new ResourcesProviderService(config.resourcesPath);
-    }
-  }
-
-  private detectMode(config: HybridConfig): 'filesystem' | 'embedded' {
-    if (config.mode === 'filesystem') return 'filesystem';
-    if (config.mode === 'embedded') return 'embedded';
-
-    // Auto-detection for 'auto' mode
-    // Priority 1: Check if embedded resources are explicitly provided
-    if (config.embeddedResources) {
-      return 'embedded';
-    }
-
-    // Priority 2: Check if embedded-resources.js exists (web build indicator)
-    if (this.hasEmbeddedResourcesFile()) {
-      return 'embedded';
-    }
-
-    // Priority 3: Check if we're in a web deployment environment
-    if (this.isWebEnvironment()) {
-      return 'embedded';
-    }
-
-    // Priority 4: Check if resources directory exists for local/development
-    const resourcesPath = config.resourcesPath || join(__dirname, '../../resources');
-    if (existsSync(resourcesPath)) {
-      return 'filesystem';
-    }
-
-    // Priority 5: Try to dynamically import embedded resources
-    if (this.tryImportEmbeddedResources()) {
-      return 'embedded';
-    }
-
-    // Default to filesystem for development environments
-    return 'filesystem';
-  }
-
-  private hasEmbeddedResourcesFile(): boolean {
-    try {
-      // Check if embedded-resources.js exists in the same directory as the built files
-      const embeddedPath = join(dirname(__dirname), 'embedded-resources.js');
-      return existsSync(embeddedPath);
-    } catch {
-      return false;
-    }
-  }
-
-  private isWebEnvironment(): boolean {
-    // Detection heuristics for web environment
-    try {
-      // Check if we're in a browser-like environment
-      if (typeof window !== 'undefined') return true;
-      
-      // Check if we have embedded resources file (web build indicator)
-      return this.hasEmbeddedResourcesFile();
-    } catch {
-      return false;
-    }
-  }
-
-  private loadEmbeddedResources(): EmbeddedResourcesMap | null {
-    try {
-      // Try to load embedded resources from the web build
-      const embeddedPath = join(dirname(__dirname), 'embedded-resources.js');
-      if (existsSync(embeddedPath)) {
-        const content = readFileSync(embeddedPath, 'utf-8');
-        
-        // Extract the EMBEDDED_RESOURCES object from the file
-        // This is a bit hacky but works for the generated embedded-resources.js
-        const match = content.match(/export const EMBEDDED_RESOURCES = ({[\s\S]*?});/);
-        if (match) {
-          // Use eval to parse the object (safe since we generated this file)
-          const embeddedResources = eval('(' + match[1] + ')');
-          return embeddedResources;
-        }
-      }
-      return null;
-    } catch (error) {
-      console.warn('Failed to load embedded resources:', error);
-      return null;
-    }
-  }
-
-  private async loadEmbeddedResourcesAsync(): Promise<EmbeddedResourcesMap | null> {
-    try {
-      // Try dynamic import of embedded resources
-      const embeddedPath = join(dirname(__dirname), 'embedded-resources.js');
-      if (existsSync(embeddedPath)) {
-        const embeddedModule = await import(embeddedPath);
-        return embeddedModule.EMBEDDED_RESOURCES || null;
-      }
-      return null;
-    } catch (error) {
-      console.warn('Dynamic import of embedded resources failed:', error);
-      return null;
-    }
-  }
-
-  private tryImportEmbeddedResources(): any {
-    // This is for future async import support
-    return this.loadEmbeddedResources();
-  }
-
-  async initializeResources(): Promise<void> {
-    // If we're in embedded mode but don't have resources loaded yet, try to load them
-    if (this.mode === 'embedded' && this.provider instanceof EmbeddedResourcesAdapter) {
-      const providerInfo = this.provider.getEmbeddedResourcesInfo();
-      if (providerInfo.count === 0) {
-        // Try to load embedded resources dynamically
-        try {
-          const embeddedResources = await this.loadEmbeddedResourcesAsync();
-          if (embeddedResources) {
-            // Create a new adapter with loaded resources
-            this.provider = new EmbeddedResourcesAdapter(embeddedResources);
-          }
-        } catch (error) {
-          console.warn('Failed to load embedded resources, falling back to filesystem:', error);
-          // Fall back to filesystem mode
-          this.mode = 'filesystem';
-          this.provider = new ResourcesProviderService();
-        }
-      }
-    }
-    
-    return this.provider.initializeResources();
-  }
-
-  async listResources(): Promise<SpecVerseResource[]> {
-    return this.provider.listResources();
-  }
-
-  async getResourceContent(uri: string): Promise<string> {
-    return this.provider.getResourceContent(uri);
-  }
-
-  async readResource(uri: string): Promise<MCPToolResult> {
-    return this.provider.readResource(uri);
-  }
-
-  isResourceAvailable(uri: string): boolean {
-    return this.provider.isResourceAvailable(uri);
-  }
-
-  getCachedResourceCount(): number {
-    return this.provider.getCachedResourceCount();
-  }
-
-  getMode(): 'filesystem' | 'embedded' {
-    return this.mode;
-  }
-
-  getProviderInfo(): { mode: string; type: string; resourcesInfo?: any } {
-    const info = {
-      mode: this.mode,
-      type: this.provider.constructor.name,
-      resourcesInfo: undefined as any
-    };
-
-    // Add provider-specific info
-    if (this.provider instanceof EmbeddedResourcesAdapter) {
-      info.resourcesInfo = this.provider.getEmbeddedResourcesInfo();
-    } else if (this.provider instanceof ResourcesProviderService) {
-      info.resourcesInfo = {
-        cached: this.provider.getCachedResourceCount()
-      };
-    }
-
-    return info;
-  }
-}

package/libs/instance-factories/tools/templates/mcp/static/src/services/LibraryToolsService.ts

@@ -1,356 +0,0 @@
-/**
- * LibraryToolsService
- * Clean implementation from extracted specification
- */
-
-import { parse } from 'yaml';
-import { LibrarySuggestionModel } from '../models/LibrarySuggestion.js';
-import type { ResourceProvider } from '../interfaces/ResourceProvider.js';
-import type { 
-  LibraryCatalog, 
-  LibrarySuggestion, 
-  MCPToolResult, 
-  PromptContext 
-} from '../types/index.js';
-
-export class LibraryToolsService {
-  private resourcesProvider: ResourceProvider;
-  private libraryCatalog: LibraryCatalog | null = null;
-  private catalogCache: Map<string, LibrarySuggestionModel> = new Map();
-
-  constructor(resourcesProvider: ResourceProvider) {
-    this.resourcesProvider = resourcesProvider;
-  }
-
-  async getLibrarySuggestions(context: PromptContext): Promise<MCPToolResult> {
-    try {
-      // Ensure library catalog is loaded
-      if (!this.libraryCatalog) {
-        await this.loadLibraryCatalog();
-      }
-
-      if (!this.libraryCatalog) {
-        throw new Error('Library catalog not available');
-      }
-
-      // Extract context parameters
-      const { 
-        requirements = '', 
-        scale = 'business' 
-      } = context;
-
-      // Analyze context and generate suggestions
-      const analysis = this.analyzeSuggestions(requirements, scale);
-
-      return {
-        content: [{
-          type: 'text',
-          text: JSON.stringify({
-            libraries: analysis.libraries.map(lib => ({
-              name: lib.name,
-              path: lib.path,
-              type: lib.type,
-              description: lib.description,
-              ai_description: lib.ai_description,
-              expansion_factor: lib.expansion_factor,
-              complexity_level: lib.complexity_level,
-              best_for: lib.best_for
-            })),
-            reasoning: analysis.reasoning,
-            usage_examples: analysis.usage_examples,
-            total_suggestions: analysis.libraries.length,
-            scale_optimization: scale
-          }, null, 2)
-        }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: 'text',
-          text: `Error generating library suggestions: ${error instanceof Error ? error.message : String(error)}`
-        }],
-        isError: true
-      };
-    }
-  }
-
-  analyzeSuggestions(projectContext: string, scale: string): {
-    libraries: LibrarySuggestionModel[];
-    reasoning: string;
-    usage_examples: string[];
-  } {
-    if (!this.libraryCatalog) {
-      return {
-        libraries: [],
-        reasoning: 'Library catalog not available',
-        usage_examples: []
-      };
-    }
-
-    const suggestions: LibrarySuggestionModel[] = [];
-    const reasoningParts: string[] = [];
-    const usageExamples: string[] = [];
-
-    const contextLower = projectContext.toLowerCase();
-    const allLibraries = this.getAllLibraries();
-
-    // Domain-specific analysis
-    const domainAnalysis = this.analyzeDomain(contextLower, allLibraries);
-    if (domainAnalysis.library) {
-      suggestions.push(domainAnalysis.library);
-      reasoningParts.push(domainAnalysis.reasoning);
-      usageExamples.push(domainAnalysis.usage);
-    }
-
-    // Technology stack analysis
-    const techAnalysis = this.analyzeTechnology(contextLower, allLibraries);
-    if (techAnalysis.library && !suggestions.find(s => s.name === techAnalysis.library!.name)) {
-      suggestions.push(techAnalysis.library);
-      reasoningParts.push(techAnalysis.reasoning);
-      usageExamples.push(techAnalysis.usage);
-    }
-
-    // Scale-based deployment analysis
-    const deploymentAnalysis = this.analyzeDeployment(scale, allLibraries);
-    if (deploymentAnalysis.library && !suggestions.find(s => s.name === deploymentAnalysis.library!.name)) {
-      suggestions.push(deploymentAnalysis.library);
-      reasoningParts.push(deploymentAnalysis.reasoning);
-      usageExamples.push(deploymentAnalysis.usage);
-    }
-
-    // Authentication analysis
-    const authAnalysis = this.analyzeAuthentication(contextLower, allLibraries);
-    if (authAnalysis.library && !suggestions.find(s => s.name === authAnalysis.library!.name)) {
-      suggestions.push(authAnalysis.library);
-      reasoningParts.push(authAnalysis.reasoning);
-      usageExamples.push(authAnalysis.usage);
-    }
-
-    // Default suggestions if nothing specific found
-    if (suggestions.length === 0) {
-      const defaults = allLibraries
-        .filter(lib => this.isGeneralPurpose(lib) || this.matchesScale(lib, scale))
-        .slice(0, 2);
-      
-      suggestions.push(...defaults);
-      reasoningParts.push('General-purpose libraries for common patterns');
-      usageExamples.push('import:\\n  - from: "@specverse/types/examples"\\n    models: [User, BaseEntity]');
-    }
-
-    // Sort by relevance score
-    suggestions.sort((a, b) => {
-      const aScore = a.matchesContext(projectContext, scale);
-      const bScore = b.matchesContext(projectContext, scale);
-      return bScore - aScore;
-    });
-
-    return {
-      libraries: suggestions.slice(0, 5), // Top 5 suggestions
-      reasoning: reasoningParts.join('; '),
-      usage_examples: usageExamples
-    };
-  }
-
-  private async loadLibraryCatalog(): Promise<void> {
-    try {
-      const catalogContent = await this.resourcesProvider.getResourceContent('specverse://libraries/catalog');
-      this.libraryCatalog = parse(catalogContent) as LibraryCatalog;
-      
-      // Cache all library models
-      this.cacheLibraryModels();
-    } catch (error) {
-      console.error('Failed to load library catalog:', error);
-      this.libraryCatalog = this.createEmptyLibraryCatalog();
-    }
-  }
-
-  private cacheLibraryModels(): void {
-    if (!this.libraryCatalog) return;
-
-    const allLibraries = [
-      ...Object.values(this.libraryCatalog.deployments || {}),
-      ...Object.values(this.libraryCatalog.domains || {}),
-      ...Object.values(this.libraryCatalog.manifests || {}),
-      ...Object.values(this.libraryCatalog.types || {})
-    ];
-
-    for (const library of allLibraries) {
-      try {
-        const model = LibrarySuggestionModel.create(library);
-        this.catalogCache.set(library.name, model);
-      } catch (error) {
-        console.warn(`Failed to cache library ${library.name}:`, error);
-      }
-    }
-  }
-
-  private getAllLibraries(): LibrarySuggestionModel[] {
-    return Array.from(this.catalogCache.values());
-  }
-
-  private analyzeDomain(context: string, libraries: LibrarySuggestionModel[]): {
-    library?: LibrarySuggestionModel;
-    reasoning: string;
-    usage: string;
-  } {
-    if (context.includes('ecommerce') || context.includes('store') || context.includes('shop')) {
-      const ecommerce = libraries.find(lib => lib.name.includes('ecommerce'));
-      if (ecommerce) {
-        return {
-          library: ecommerce,
-          reasoning: 'E-commerce domain detected',
-          usage: 'import:\\n  - from: "@specverse/domains/ecommerce"\\n    models: [Product, Order, Customer]'
-        };
-      }
-    }
-
-    if (context.includes('healthcare') || context.includes('medical') || context.includes('patient')) {
-      const healthcare = libraries.find(lib => lib.name.includes('healthcare'));
-      if (healthcare) {
-        return {
-          library: healthcare,
-          reasoning: 'Healthcare domain detected',
-          usage: 'import:\\n  - from: "@specverse/domains/healthcare"\\n    models: [Patient, Provider, Appointment]'
-        };
-      }
-    }
-
-    return { reasoning: 'No specific domain patterns detected', usage: '' };
-  }
-
-  private analyzeTechnology(context: string, libraries: LibrarySuggestionModel[]): {
-    library?: LibrarySuggestionModel;
-    reasoning: string;
-    usage: string;
-  } {
-    if (context.includes('nextjs') || context.includes('next.js') || context.includes('react')) {
-      const nextjs = libraries.find(lib => lib.name.includes('nextjs'));
-      if (nextjs) {
-        return {
-          library: nextjs,
-          reasoning: 'Next.js framework detected',
-          usage: 'import:\\n  - from: "@specverse/manifests/nextjs"\\n    manifests: [nextjs-config]'
-        };
-      }
-    }
-
-    if (context.includes('postgresql') || context.includes('postgres')) {
-      const postgres = libraries.find(lib => lib.name.includes('postgresql'));
-      if (postgres) {
-        return {
-          library: postgres,
-          reasoning: 'PostgreSQL database detected',
-          usage: 'import:\\n  - from: "@specverse/manifests/postgresql"\\n    manifests: [postgres-config]'
-        };
-      }
-    }
-
-    return { reasoning: 'No specific technology patterns detected', usage: '' };
-  }
-
-  private analyzeDeployment(scale: string, libraries: LibrarySuggestionModel[]): {
-    library?: LibrarySuggestionModel;
-    reasoning: string;
-    usage: string;
-  } {
-    switch (scale) {
-      case 'personal':
-        const personal = libraries.find(lib => lib.name.includes('jamstack') || lib.name.includes('monolith'));
-        if (personal) {
-          return {
-            library: personal,
-            reasoning: 'Personal scale: simple deployment recommended',
-            usage: `import:\\n  - from: "@specverse/deployments/${personal.name}"\\n    deployments: [development]`
-          };
-        }
-        break;
-
-      case 'enterprise':
-        const enterprise = libraries.find(lib => lib.name.includes('enterprise') || lib.name.includes('microservices'));
-        if (enterprise) {
-          return {
-            library: enterprise,
-            reasoning: 'Enterprise scale: distributed architecture recommended',
-            usage: `import:\\n  - from: "@specverse/deployments/${enterprise.name}"\\n    deployments: [production-cluster]`
-          };
-        }
-        break;
-
-      default: // business
-        const business = libraries.find(lib => lib.name.includes('microservices') || lib.name.includes('monolith'));
-        if (business) {
-          return {
-            library: business,
-            reasoning: 'Business scale: scalable deployment recommended',
-            usage: `import:\\n  - from: "@specverse/deployments/${business.name}"\\n    deployments: [production]`
-          };
-        }
-        break;
-    }
-
-    return { reasoning: 'No deployment pattern match found', usage: '' };
-  }
-
-  private analyzeAuthentication(context: string, libraries: LibrarySuggestionModel[]): {
-    library?: LibrarySuggestionModel;
-    reasoning: string;
-    usage: string;
-  } {
-    if (context.includes('authentication') || context.includes('auth') || context.includes('login')) {
-      const oauth = libraries.find(lib => lib.name.includes('oauth'));
-      if (oauth) {
-        return {
-          library: oauth,
-          reasoning: 'Authentication features detected',
-          usage: 'import:\\n  - from: "@specverse/manifests/oauth"\\n    manifests: [oauth-config]'
-        };
-      }
-    }
-
-    return { reasoning: 'No authentication patterns detected', usage: '' };
-  }
-
-  private isGeneralPurpose(library: LibrarySuggestionModel): boolean {
-    return library.name.includes('examples') || 
-           library.name.includes('lib') ||
-           library.type === 'type';
-  }
-
-  private matchesScale(library: LibrarySuggestionModel, scale: string): boolean {
-    const scaleComplexity = this.getScaleComplexity(scale);
-    const libComplexity = this.getComplexityScore(library.complexity_level);
-    return Math.abs(libComplexity - scaleComplexity) <= 1;
-  }
-
-  private getScaleComplexity(scale: string): number {
-    switch (scale) {
-      case 'personal': return 1;
-      case 'business': return 2;
-      case 'enterprise': return 3;
-      default: return 2;
-    }
-  }
-
-  private getComplexityScore(complexity: string): number {
-    switch (complexity) {
-      case 'low': return 1;
-      case 'medium': return 2;
-      case 'high': return 3;
-      default: return 2;
-    }
-  }
-
-  private createEmptyLibraryCatalog(): LibraryCatalog {
-    return {
-      version: '3.1.0',
-      generated_at: new Date(),
-      generated_from: 'embedded',
-      ai_optimization: false,
-      total_libraries: 0,
-      deployments: {},
-      domains: {},
-      manifests: {},
-      types: {}
-    };
-  }
-}