@specverse/engine-realize 3.5.3

package/dist/library/validator.js

@@ -0,0 +1,203 @@
+/**
+ * Instance Factory Validator
+ *
+ * Validates instance factory compatibility and requirements.
+ */
+import semver from 'semver';
+/**
+ * Validator for instance factory compatibility
+ */
+export class InstanceFactoryValidator {
+    /**
+     * Validate instance factory against SpecVerse version
+     */
+    validateCompatibility(factory, options = {}) {
+        const errors = [];
+        const warnings = [];
+        // Check SpecVerse version compatibility
+        if (factory.compatibility?.specverse && options.specverseVersion) {
+            if (!semver.satisfies(options.specverseVersion, factory.compatibility.specverse)) {
+                errors.push(`Instance factory "${factory.name}" requires SpecVerse ${factory.compatibility.specverse}, ` +
+                    `but version ${options.specverseVersion} is installed`);
+            }
+        }
+        // Check Node.js version compatibility
+        if (factory.compatibility?.node && options.nodeVersion) {
+            // Extract major version from node version string (e.g., "v20.11.0" -> "20.11.0")
+            const cleanNodeVersion = options.nodeVersion.replace(/^v/, '');
+            if (!semver.satisfies(cleanNodeVersion, factory.compatibility.node)) {
+                errors.push(`Instance factory "${factory.name}" requires Node.js ${factory.compatibility.node}, ` +
+                    `but version ${options.nodeVersion} is installed`);
+            }
+        }
+        // Check for required technology stack elements
+        if (!factory.technology.runtime) {
+            warnings.push(`Instance factory "${factory.name}" does not specify runtime`);
+        }
+        if (!factory.technology.language) {
+            warnings.push(`Instance factory "${factory.name}" does not specify language`);
+        }
+        // Check for at least one code template
+        if (Object.keys(factory.codeTemplates).length === 0) {
+            errors.push(`Instance factory "${factory.name}" has no code templates`);
+        }
+        // Validate code templates
+        for (const [templateName, template] of Object.entries(factory.codeTemplates)) {
+            // Ensure template has required fields based on engine type
+            if (template.engine === 'typescript' && !template.generator) {
+                errors.push(`Template "${templateName}" uses TypeScript engine but has no generator path`);
+            }
+            if (template.engine === 'handlebars' && !template.template) {
+                errors.push(`Template "${templateName}" uses Handlebars engine but has no template content`);
+            }
+            if (template.engine === 'ai' && !template.prompt) {
+                errors.push(`Template "${templateName}" uses AI engine but has no prompt`);
+            }
+            // Validate output pattern
+            if (!template.outputPattern) {
+                errors.push(`Template "${templateName}" has no output pattern`);
+            }
+        }
+        return {
+            compatible: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined
+        };
+    }
+    /**
+     * Validate that all required capabilities are provided
+     */
+    validateCapabilities(factory, availableCapabilities) {
+        const errors = [];
+        const warnings = [];
+        // Check if this implementation provides at least one capability
+        if (factory.capabilities.provides.length === 0) {
+            errors.push(`Instance factory "${factory.name}" does not provide any capabilities`);
+        }
+        // Check if all required capabilities are available
+        if (factory.capabilities.requires) {
+            for (const required of factory.capabilities.requires) {
+                // Support wildcard matching
+                const matches = availableCapabilities.some(available => {
+                    if (required.includes('*')) {
+                        const pattern = required.replace(/\*/g, '.*');
+                        return new RegExp(`^${pattern}$`).test(available);
+                    }
+                    return available === required;
+                });
+                if (!matches) {
+                    errors.push(`Instance factory "${factory.name}" requires capability "${required}" ` +
+                        `which is not available`);
+                }
+            }
+        }
+        return {
+            compatible: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined
+        };
+    }
+    /**
+     * Validate dependencies between resolved implementations
+     */
+    validateDependencies(resolved) {
+        const missing = [];
+        const conflicts = [];
+        // Build map of provided capabilities
+        const provided = new Map();
+        for (const impl of resolved) {
+            for (const capability of impl.instanceFactory.capabilities.provides) {
+                provided.set(capability, impl.instanceFactory.name);
+            }
+        }
+        // Check each implementation's requirements
+        for (const impl of resolved) {
+            if (!impl.instanceFactory.capabilities.requires) {
+                continue;
+            }
+            for (const required of impl.instanceFactory.capabilities.requires) {
+                // Support wildcard matching
+                const matches = Array.from(provided.keys()).some(available => {
+                    if (required.includes('*')) {
+                        const pattern = required.replace(/\*/g, '.*');
+                        return new RegExp(`^${pattern}$`).test(available);
+                    }
+                    return available === required;
+                });
+                if (!matches) {
+                    const availableProvider = provided.get(required);
+                    if (!availableProvider) {
+                        missing.push(`Instance factory "${impl.instanceFactory.name}" requires capability "${required}" ` +
+                            `but no instance factory provides it`);
+                    }
+                    else {
+                        conflicts.push({
+                            capability: required,
+                            required: impl.instanceFactory.name,
+                            available: availableProvider
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            satisfied: missing.length === 0 && conflicts.length === 0,
+            missing: missing.length > 0 ? missing : undefined,
+            conflicts: conflicts.length > 0 ? conflicts : undefined
+        };
+    }
+    /**
+     * Validate that an instance factory can extend another
+     */
+    validateExtension(child, parent) {
+        const errors = [];
+        const warnings = [];
+        // Check that categories match
+        if (child.category !== parent.category) {
+            errors.push(`Cannot extend "${parent.name}" (${parent.category}) with "${child.name}" (${child.category}): ` +
+                `categories must match`);
+        }
+        // Check that runtime matches
+        if (child.technology.runtime !== parent.technology.runtime) {
+            warnings.push(`Child "${child.name}" has different runtime (${child.technology.runtime}) ` +
+                `than parent "${parent.name}" (${parent.technology.runtime})`);
+        }
+        // Check that language matches
+        if (child.technology.language !== parent.technology.language) {
+            warnings.push(`Child "${child.name}" has different language (${child.technology.language}) ` +
+                `than parent "${parent.name}" (${parent.technology.language})`);
+        }
+        return {
+            compatible: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined
+        };
+    }
+    /**
+     * Validate complete instance factory
+     */
+    validateComplete(factory, options = {}) {
+        const allErrors = [];
+        const allWarnings = [];
+        // Validate compatibility
+        const compatResult = this.validateCompatibility(factory, options);
+        if (compatResult.errors)
+            allErrors.push(...compatResult.errors);
+        if (compatResult.warnings)
+            allWarnings.push(...compatResult.warnings);
+        // Validate capabilities if provided
+        if (options.availableCapabilities) {
+            const capResult = this.validateCapabilities(factory, options.availableCapabilities);
+            if (capResult.errors)
+                allErrors.push(...capResult.errors);
+            if (capResult.warnings)
+                allWarnings.push(...capResult.warnings);
+        }
+        return {
+            compatible: allErrors.length === 0,
+            errors: allErrors.length > 0 ? allErrors : undefined,
+            warnings: allWarnings.length > 0 ? allWarnings : undefined
+        };
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/library/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/library/validator.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SpecVerse Realize Types
+ *
+ * TypeScript type definitions for the code realization system.
+ */
+export * from './instance-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * SpecVerse Realize Types
+ *
+ * TypeScript type definitions for the code realization system.
+ */
+export * from './instance-factory.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/types/instance-factory.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Instance Factory Definitions
+ *
+ * TypeScript interfaces for SpecVerse Instance Factories.
+ * These define reusable technology specifications for code generation.
+ */
+/**
+ * Package dependency specification
+ */
+export interface Dependency {
+    name: string;
+    version: string;
+    optional?: boolean;
+}
+/**
+ * Code template specification
+ */
+export interface CodeTemplate {
+    /** Template engine to use */
+    engine: 'typescript' | 'handlebars' | 'ai';
+    /** Template content or path (for handlebars) */
+    template?: string;
+    /** Path to generator function (for typescript) */
+    generator?: string;
+    /** Generation prompt (for AI) */
+    prompt?: string;
+    /** Output file path pattern with variables like {controller}, {model} */
+    outputPattern: string;
+    /** Paths to validation functions */
+    validators?: string[];
+    /** Paths to post-processing functions */
+    postProcessors?: string[];
+}
+/**
+ * Technology stack information
+ */
+export interface TechnologyStack {
+    /**
+     * Runtime environment identifier (kebab-case).
+     * Standard: node, deno, bun, python, rust, go, browser
+     * Custom values allowed (e.g., "zig", "dotnet")
+     * Pattern: ^[a-z][a-z0-9-]+$
+     */
+    runtime: string;
+    /**
+     * Programming language identifier (kebab-case).
+     * Standard: typescript, javascript, python, rust, go, java, csharp, php, ruby, kotlin, swift
+     * Custom values allowed (e.g., "gleam", "elixir")
+     * Pattern: ^[a-z][a-z0-9-]+$
+     */
+    language: string;
+    /** Framework name (fastify, express, react, vue, etc.) */
+    framework?: string;
+    /** ORM/database library (prisma, typeorm, drizzle, etc.) */
+    orm?: string;
+    /** Validation library (zod, joi, class-validator, etc.) */
+    validation?: string;
+    /** Additional technology properties */
+    [key: string]: string | undefined;
+}
+/**
+ * Compatibility requirements
+ */
+export interface CompatibilityRequirements {
+    /** SpecVerse version range (semver) */
+    specverse: string;
+    /** Node.js version requirement */
+    node?: string;
+    /** Additional compatibility requirements */
+    [key: string]: string | undefined;
+}
+/**
+ * Capability declaration
+ */
+export interface Capabilities {
+    /** Capabilities this implementation provides */
+    provides: string[];
+    /** Capabilities this implementation requires */
+    requires?: string[];
+}
+/**
+ * Dependencies specification
+ */
+export interface Dependencies {
+    /** Runtime dependencies */
+    runtime?: Dependency[];
+    /** Development dependencies */
+    dev?: Dependency[];
+    /** Peer dependencies */
+    peer?: Dependency[];
+}
+/**
+ * Instance factory metadata
+ */
+export interface InstanceFactoryMetadata {
+    /** Author name or organization */
+    author?: string;
+    /** Repository URL */
+    repository?: string;
+    /** Homepage URL */
+    homepage?: string;
+    /** License identifier (MIT, Apache-2.0, etc.) */
+    license?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Keywords for search */
+    keywords?: string[];
+    /** Documentation URL */
+    documentation?: string;
+}
+/**
+ * Complete Instance Factory definition
+ *
+ * An instance factory defines a specific technology stack and
+ * how to generate code for that stack from SpecVerse specifications.
+ */
+export interface InstanceFactory {
+    /** Unique name for this instance factory */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** Category for deployment instances */
+    category: 'controller' | 'service' | 'view' | 'storage' | 'security' | 'infrastructure' | 'monitoring' | 'communication';
+    /** Human-readable description */
+    description?: string;
+    /** Version compatibility requirements */
+    compatibility?: CompatibilityRequirements;
+    /** What this implementation provides and requires */
+    capabilities: Capabilities;
+    /** Technology stack information */
+    technology: TechnologyStack;
+    /** Package dependencies */
+    dependencies?: Dependencies;
+    /** Code generation templates */
+    codeTemplates: Record<string, CodeTemplate>;
+    /** Default configuration */
+    configuration?: Record<string, any>;
+    /** Parent implementation type to extend from */
+    extends?: string;
+    /** Additional metadata */
+    metadata?: InstanceFactoryMetadata;
+}
+/**
+ * Reference to an instance factory in a manifest
+ */
+export interface InstanceFactoryReference {
+    /** Reference path: "backend/fastify-prisma" or "@org/impl-types/name" */
+    ref: string;
+    /** Semantic version range */
+    version?: string;
+    /** Short alias for referencing in mappings */
+    alias?: string;
+    /** Configuration overrides */
+    configuration?: Record<string, any>;
+    /** Template overrides */
+    templates?: Record<string, string>;
+}
+/**
+ * Capability mapping in a manifest (v3.3 with instanceFactory)
+ */
+export interface CapabilityMapping {
+    /** Capability pattern (e.g., "api.rest" or "storage.database.*") */
+    capability: string;
+    /** Instance factory reference (alias or full ref) */
+    instanceFactory: string;
+    /** Version constraint for instance factory */
+    version?: string;
+    /** Configuration overrides for this mapping */
+    configuration?: Record<string, any>;
+    /** Namespace for grouping */
+    namespace?: string;
+}
+/**
+ * Instance mapping in a manifest (v3.3 - highest priority)
+ */
+export interface InstanceMapping {
+    /** Specific instance name from deployment */
+    instanceName: string;
+    /** Instance factory reference */
+    instanceFactory: string;
+    /** Version constraint for instance factory */
+    version?: string;
+    /** Configuration overrides for this mapping */
+    configuration?: Record<string, any>;
+}
+/**
+ * Default mappings by category (v3.3 - lowest priority)
+ */
+export interface DefaultMappings {
+    controller?: string;
+    service?: string;
+    view?: string;
+    storage?: string;
+    security?: string;
+    infrastructure?: string;
+    monitoring?: string;
+    communication?: string;
+}
+/**
+ * Deployment reference in manifest (v3.3)
+ */
+export interface DeploymentReference {
+    /** Path to .specly file containing deployment */
+    deploymentSource: string;
+    /** Name of deployment in the spec */
+    deploymentName: string;
+    /** Version constraint for deployment */
+    deploymentVersion?: string;
+}
+/**
+ * Resolved implementation with context
+ */
+export interface ResolvedImplementation {
+    /** The capability being resolved */
+    capability: string;
+    /** The resolved instance factory (with overrides applied) */
+    instanceFactory: InstanceFactory;
+    /** The deployment instance this is for */
+    instance?: any;
+    /** Resolved configuration (defaults + manifest overrides + mapping overrides) */
+    configuration: Record<string, any>;
+    /** Base path for resolving template files (directory containing the instance factory file) */
+    basePath?: string;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Error messages if validation failed */
+    errors?: string[];
+    /** Warning messages */
+    warnings?: string[];
+    /** Suggested fixes */
+    suggestions?: string[];
+}
+/**
+ * Template context for code generation
+ */
+export interface TemplateContext {
+    /** AI-optimized specification */
+    spec: any;
+    /** Resolved instance factory */
+    factory: InstanceFactory;
+    /** Current model (if generating for a specific model) */
+    model?: any;
+    /** Current controller (if generating for a specific controller) */
+    controller?: any;
+    /** Current service (if generating for a specific service) */
+    service?: any;
+    /** Deployment instance (if generating for a specific instance) */
+    instance?: any;
+    /** Additional context properties */
+    [key: string]: any;
+}
+/**
+ * Template engine interface
+ */
+export interface TemplateEngine {
+    /**
+     * Render a template with the given context
+     */
+    render(template: CodeTemplate, context: TemplateContext): Promise<string>;
+}
+/**
+ * Library source configuration
+ */
+export interface LibrarySource {
+    /** Source type */
+    type: 'local' | 'npm' | 'remote';
+    /** Source path or URL */
+    path: string;
+    /** Priority (higher = checked first) */
+    priority?: number;
+}
+/**
+ * Implementation type library configuration
+ */
+export interface LibraryConfig {
+    /** Library sources to search */
+    sources: LibrarySource[];
+    /** Cache configuration */
+    cache?: {
+        enabled: boolean;
+        ttl?: number;
+    };
+}
+//# sourceMappingURL=instance-factory.d.ts.map

package/dist/types/instance-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-factory.d.ts","sourceRoot":"","sources":["../../src/types/instance-factory.ts"],"names":[],"mappings":"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"}

package/dist/types/instance-factory.js

@@ -0,0 +1,8 @@
+/**
+ * Instance Factory Definitions
+ *
+ * TypeScript interfaces for SpecVerse Instance Factories.
+ * These define reusable technology specifications for code generation.
+ */
+export {};
+//# sourceMappingURL=instance-factory.js.map

package/dist/types/instance-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-factory.js","sourceRoot":"","sources":["../../src/types/instance-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}