@specverse/engines 4.3.4 → 5.0.0

package/dist/inference/core/rule-engine.js

@@ -3,6 +3,16 @@
  * Provides pattern matching and rule application for both logical and deployment inference
  */
 import * as yaml from 'js-yaml';
+import Handlebars from 'handlebars';
+import { registerCoreHelpers } from './template-helpers.js';
+// Register Handlebars helpers at module load (idempotent). Phase 1 of
+// the template-engine rewrite — infrastructure lands here; templates
+// continue to run through the old string-substitution apply*Template
+// paths below until Phase 2 switches them over. Registering helpers
+// early costs nothing and makes them available the moment the rewrite
+// swaps in `Handlebars.compile(...)`.
+// See docs/plans/2026-04-17-HANDLEBARS-TEMPLATE-ENGINE-REWRITE.md.
+registerCoreHelpers();
 export class RuleEngine {
     debug;
     rules = new Map();
@@ -357,101 +367,78 @@ export class RuleEngine {
         };
     }
     applyHandlebarsTemplate(rule, templateContext) {
-        // For now, we'll do a simple template substitution
-        // In a full implementation, we'd use the Handlebars library
-        let result = Array.isArray(rule.template.content)
+        // Cycle 2: real Handlebars. Previously this method ran one-off
+        // hacks (hardcoded parentRelationships[0].targetModel substitution,
+        // blanket /each/ strip) because the home-rolled substitutor didn't
+        // understand `{{#each}}` or sub-expressions. Handlebars handles
+        // those natively — if multiple parentRelationships exist, the
+        // iteration emits one block per entry instead of just the first.
+        const template = Array.isArray(rule.template.content)
             ? rule.template.content.join('\n')
             : rule.template.content;
-        // Ensure result is a string
-        if (typeof result !== 'string') {
-            throw new Error(`Template content must be string or string array, got ${typeof result} in applyHandlebarsTemplate`);
-        }
-        // Simple variable substitution for common patterns
-        result = result.replace(/\{\{modelName\}\}/g, templateContext.modelName || '');
-        result = result.replace(/\{\{controllerName\}\}/g, templateContext.controllerName || '');
-        result = result.replace(/\{\{serviceName\}\}/g, templateContext.serviceName || '');
-        // Handle arrays and objects in a basic way
-        if (templateContext.parentRelationships?.length > 0) {
-            result = result.replace(/\{\{#each parentRelationships\}\}/g, '');
-            result = result.replace(/\{\{\/each\}\}/g, '');
-            result = result.replace(/\{\{targetModel\}\}/g, templateContext.parentRelationships[0].targetModel);
+        if (typeof template !== 'string') {
+            throw new Error(`Template content must be string or string array, got ${typeof template} in applyHandlebarsTemplate`);
         }
+        const rendered = Handlebars.compile(template, { strict: false, noEscape: true })(templateContext);
+        // If rendered output looks like JSON, parse it; otherwise return
+        // as string. Same shape as before, but the renderer now produces
+        // valid JSON more often (proper iteration, helpers resolved).
         try {
-            // Try to parse as YAML/JSON
-            if (result.trim().startsWith('{') || result.trim().includes(':')) {
-                return JSON.parse(result);
+            const trimmed = rendered.trim();
+            if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+                return JSON.parse(rendered);
             }
         }
         catch {
-            // If parsing fails, return as string
+            // fall through to string return
         }
-        return result;
+        return rendered;
     }
     applyJsonTemplate(rule, templateContext) {
+        // Cycle 2 of the template-engine rewrite: JSON templates now go
+        // through real Handlebars. Helpers (eq / humanize / pluralize /
+        // lowerCase / upperCase) are globally registered at module load.
+        // strict:false makes missing variables render as empty strings
+        // (old behaviour preserved the literal `{{name}}` — which would
+        // break JSON.parse anyway, so this is strictly safer). noEscape
+        // because rule output is machine-read JSON, not HTML.
         try {
-            let template = Array.isArray(rule.template.content)
+            const template = Array.isArray(rule.template.content)
                 ? rule.template.content.join('\n')
                 : rule.template.content;
-            // Simple variable substitution
-            template = template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
-                return templateContext[key] || match;
-            });
-            return JSON.parse(template);
+            const rendered = Handlebars.compile(template, { strict: false, noEscape: true })(templateContext);
+            return JSON.parse(rendered);
         }
         catch (error) {
             throw new Error(`Failed to parse JSON template: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     applyYamlTemplate(rule, templateContext) {
+        // Cycle 3: real Handlebars. Replaces four load-bearing hacks:
+        //   1. Hardcoded parentRelationships[0].targetModel substitution
+        //      — real Handlebars' \`{{#each}}\` iterates every entry.
+        //   2. Global /each/ strip — ate nested closers. Real Handlebars
+        //      pairs opens/closes correctly.
+        //   3. Fake \`{{#if required}}\` (always passed through) — real
+        //      Handlebars evaluates the condition against loop context.
+        //   4. Hardcoded \`{{name}}\` → 'sampleAttribute' when parent
+        //      relationships exist — real Handlebars resolves \`{{name}}\`
+        //      against the iterated attribute, which is what the template
+        //      always intended.
+        // Plus the processSpeclyHandlebars conditional handler, also gone.
         try {
-            let template = Array.isArray(rule.template.content)
+            const template = Array.isArray(rule.template.content)
                 ? rule.template.content.join('\n')
                 : rule.template.content;
-            // Ensure template is a string
             if (typeof template !== 'string') {
                 throw new Error(`Template content must be string or string array, got ${typeof template}`);
             }
-            // Apply basic variable substitution
-            template = template.replace(/\{\{modelName\}\}/g, templateContext.modelName || '');
-            template = template.replace(/\{\{controllerName\}\}/g, templateContext.controllerName || '');
-            template = template.replace(/\{\{serviceName\}\}/g, templateContext.serviceName || '');
-            // Handle parent relationships processing
-            if (templateContext.relationships?.parentRelationships?.length > 0) {
-                const parentRel = templateContext.relationships.parentRelationships[0];
-                // Process the each loop for parent relationships
-                template = template.replace(/\{\{#each relationships\.parentRelationships\}\}/g, '');
-                template = template.replace(/\{\{\/each\}\}/g, '');
-                // Replace context variables
-                template = template.replace(/\{\{targetModel\}\}/g, parentRel.targetModel || '');
-                template = template.replace(/\{\{\.\.\/modelName\}\}/g, templateContext.modelName || '');
-                // Handle nested attribute loops
-                template = template.replace(/\{\{#each \.\.\/model\.attributes\}\}/g, '');
-                // Process the required conditional specifically for attribute loops
-                template = template.replace(/\{\{#if required\}\}([^]*?)\{\{\/if\}\}/g, (match, content) => {
-                    // For attributes, assume required if we're in parent relationship context
-                    return content;
-                });
-                template = template.replace(/\{\{name\}\}/g, 'sampleAttribute');
-            }
-            // Handle many-to-many relationships processing
-            if (templateContext.relationships?.manyToManyRelationships?.length > 0) {
-                const manyToManyRel = templateContext.relationships.manyToManyRelationships[0];
-                // Process the each loop for many-to-many relationships
-                template = template.replace(/\{\{#each relationships\.manyToManyRelationships\}\}/g, '');
-                template = template.replace(/\{\{\/each\}\}/g, '');
-                // Replace context variables
-                template = template.replace(/\{\{targetModel\}\}/g, manyToManyRel.targetModel || '');
-                template = template.replace(/\{\{\.\.\/modelName\}\}/g, templateContext.modelName || '');
-            }
-            // Use the shared handlebars processing that handles all conditionals consistently
-            template = this.processSpeclyHandlebars(template, templateContext);
-            // Clean up any double empty lines that might confuse YAML parser
-            template = template.replace(/\n\n+/g, '\n\n');
-            // Template processing completed
-            // Handlebars processing already done above
-            // Parse the processed template as YAML
-            const result = yaml.load(template);
-            return result;
+            const rendered = Handlebars.compile(template, { strict: false, noEscape: true })(templateContext);
+            // Collapse runs of blank lines — same cleanup the old path did,
+            // still useful because YAML parsers reject trailing garbage in
+            // some shapes.
+            const cleaned = rendered.replace(/\n\n+/g, '\n\n');
+            return yaml.load(cleaned);
         }
         catch (error) {
             throw new Error(`Failed to parse YAML template: ${error instanceof Error ? error.message : String(error)}`);
@@ -459,564 +446,55 @@ export class RuleEngine {
     }
     applySpeclyTemplate(rule, templateContext) {
         try {
-            // For controller rules, return a ControllerSpec object instead of a string
-            if (rule.pattern === 'StandardCURED') {
-                return this.generateCuredControllerSpec(templateContext);
-            }
-            // For service rules, return ServiceSpec objects
-            if (rule.pattern === 'ProcessingService') {
-                return this.generateProcessingServiceSpec(templateContext);
-            }
-            if (rule.pattern === 'ValidationService') {
-                return this.generateValidationServiceSpec(templateContext);
-            }
-            // For event rules, return EventSpec objects
-            if (rule.pattern === 'StandardEvents') {
-                return this.generateStandardEventsSpec(templateContext);
-            }
-            if (rule.pattern === 'RelationshipEvents') {
-                return this.generateRelationshipEventsSpec(templateContext);
-            }
-            // For view rules, return ViewSpec objects
-            if (rule.pattern === 'EnhancedListView' || rule.pattern === 'AnalyticsView') {
-                return this.generateViewSpec(rule.pattern, templateContext);
-            }
-            // For additional service patterns
-            if (rule.pattern === 'IntegrationService') {
-                return this.generateIntegrationServiceSpec(templateContext);
-            }
-            if (rule.pattern === 'LifecycleService') {
-                return this.generateLifecycleServiceSpec(templateContext);
-            }
-            if (rule.pattern === 'RelationshipService') {
-                return this.generateRelationshipServiceSpec(templateContext);
-            }
-            // For other specly templates, process as string
-            let template = Array.isArray(rule.template.content)
+            // StandardCURED now has a real Handlebars template in
+            // entities/src/core/models/inference/controller-rules.json
+            // that renders to the equivalent ControllerSpec. Generator
+            // method removed. See Cycle 5 in the Handlebars-rewrite plan.
+            //
+            // ProcessingService / ValidationService / RelationshipService
+            // rules + generators fully retired (Cycle 6). See
+            // engines/src/inference/DISABLED-RULES.md for the rationale.
+            //
+            // StandardEvents (Cycle 7) + RelationshipEvents (Cycle 8) now
+            // render from real Handlebars templates in
+            // entities/src/core/events/inference/event-rules.json.
+            // EnhancedListView / AnalyticsView (Cycle 9): retired.
+            // Superseded by the view-triggered specialist-views expansion
+            // system (specialist_analytics, specialist_dashboard, etc.) —
+            // see entities/src/core/views/inference/specialist-views.json
+            // and engines/src/inference/DISABLED-RULES.md.
+            // IntegrationService (Cycle 10) + LifecycleService (Cycle 11)
+            // now render from real Handlebars templates in service-rules.json.
+            // Cycle 5: real Handlebars + yaml.load for specly templates that
+            // produce a structured object (like the cured_root_controller
+            // template which renders a ControllerSpec). Falls back to the
+            // raw string if yaml.load fails — for templates that genuinely
+            // produce non-YAML output.
+            const template = Array.isArray(rule.template.content)
                 ? rule.template.content.join('\n')
                 : rule.template.content;
-            // Apply basic variable substitution
-            template = template.replace(/\{\{modelName\}\}/g, templateContext.modelName || '');
-            template = template.replace(/\{\{controllerName\}\}/g, templateContext.controllerName || '');
-            template = template.replace(/\{\{serviceName\}\}/g, templateContext.serviceName || '');
-            // Process conditionals and loops
-            template = this.processSpeclyHandlebars(template, templateContext);
-            return template;
-        }
-        catch (error) {
-            throw new Error(`Failed to process Specly template: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    generateCuredControllerSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        // Build CURED operations spec
-        const curedOps = {
-            create: {
-                parameters: {
-                    data: `${modelName} required`
-                },
-                returns: modelName,
-                requires: [
-                    `${modelName} data is valid`
-                ],
-                ensures: [
-                    `${modelName} created with unique ID`,
-                    `${modelName} persisted to storage`
-                ],
-                publishes: [`${modelName}Created`]
-            },
-            retrieve: {
-                parameters: {
-                    id: 'UUID required'
-                },
-                returns: modelName,
-                requires: [`${modelName} with ID exists`],
-                ensures: [`Returns complete ${modelName} details`]
-            },
-            retrieve_many: {
-                parameters: {
-                    filters: `${modelName}Filter optional`,
-                    limit: 'Integer default=20',
-                    offset: 'Integer default=0'
-                },
-                returns: `Array[${modelName}]`,
-                ensures: [
-                    `Returns paginated list of ${modelName}s`,
-                    `Applies filters if specified`
-                ]
-            },
-            update: {
-                parameters: {
-                    id: 'UUID required',
-                    updates: `Object required`
-                },
-                returns: modelName,
-                requires: [
-                    `${modelName} with ID exists`,
-                    `Update data is valid`
-                ],
-                ensures: [
-                    `${modelName} attributes updated`,
-                    `Version number incremented`
-                ],
-                publishes: [`${modelName}Updated`]
-            },
-            delete: {
-                parameters: {
-                    id: 'UUID required',
-                    soft: 'Boolean default=true'
-                },
-                returns: 'Boolean',
-                requires: [`${modelName} with ID exists`],
-                ensures: [`${modelName} marked as deleted`],
-                publishes: [`${modelName}Deleted`]
-            },
-            validate: {
-                parameters: {
-                    data: `${modelName} required`,
-                    operation: 'String required'
-                },
-                returns: 'ValidationResult',
-                requires: [
-                    `Operation is one of: create, update, evolve`,
-                    `Data structure matches ${modelName} schema`
-                ],
-                ensures: [
-                    `Returns validation status and errors`,
-                    `No side effects - dry run only`
-                ]
-            }
-        };
-        // Add dynamic required field validation
-        if (context.model?.attributes) {
-            const requiredFields = context.model.attributes.filter((attr) => attr.required);
-            if (requiredFields.length > 0) {
-                requiredFields.forEach((attr) => {
-                    curedOps.create.requires.push(`${attr.name} is not empty`);
-                });
-            }
-        }
-        // Add lifecycle operations if model has lifecycle
-        if (context.model?.lifecycle) {
-            curedOps.evolve = {
-                parameters: {
-                    id: 'UUID required',
-                    from: `${modelName}State required`,
-                    to: `${modelName}State required`,
-                    reason: 'String optional'
-                },
-                returns: modelName,
-                requires: [
-                    `${modelName} with ID exists`,
-                    `${modelName} current state is 'from' state`,
-                    `Transition from 'from' to 'to' is valid`
-                ],
-                ensures: [
-                    `${modelName} state changed to 'to' state`,
-                    `State transition logged`
-                ],
-                publishes: [`${modelName}Evolved`]
-            };
-        }
-        return {
-            description: `Auto-generated CURED controller for ${modelName}`,
-            model: modelName,
-            cured: curedOps
-        };
-    }
-    generateProcessingServiceSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const operations = {
-            [`handle${modelName}Creation`]: {
-                parameters: {
-                    event: `${modelName}CreatedEvent required`
-                },
-                returns: 'Void',
-                requires: ['Event data is valid'],
-                ensures: [
-                    `${modelName} creation processing completed`,
-                    'Related systems notified'
-                ]
-            },
-            [`handle${modelName}Update`]: {
-                parameters: {
-                    event: `${modelName}UpdatedEvent required`
-                },
-                returns: 'Void',
-                requires: ['Event data is valid'],
-                ensures: [
-                    `${modelName} update processing completed`,
-                    'Change propagated to dependent systems'
-                ]
-            },
-            [`validate${modelName}`]: {
-                parameters: {
-                    data: `${modelName} required`,
-                    validationContext: 'Object optional'
-                },
-                returns: 'ValidationResult',
-                requires: [`${modelName} data is provided`],
-                ensures: [
-                    'Complete validation performed',
-                    'Business rules checked'
-                ]
-            },
-            [`process${modelName}BusinessRules`]: {
-                parameters: {
-                    id: 'UUID required',
-                    ruleContext: 'Object required'
-                },
-                returns: 'BusinessRuleResult',
-                requires: [
-                    `${modelName} exists`,
-                    'Rule context is valid'
-                ],
-                ensures: [
-                    'All applicable business rules processed',
-                    'Results documented'
-                ]
-            }
-        };
-        const subscribes_to = {
-            [`${modelName}Created`]: `handle${modelName}Creation`,
-            [`${modelName}Updated`]: `handle${modelName}Update`
-        };
-        // Add lifecycle operations if model has lifecycle
-        if (context.model?.lifecycle) {
-            operations[`handle${modelName}Evolution`] = {
-                parameters: {
-                    event: `${modelName}EvolvedEvent required`
-                },
-                returns: 'Void',
-                requires: ['Lifecycle transition is valid'],
-                ensures: [
-                    'Lifecycle change processed',
-                    'State-dependent actions triggered'
-                ]
-            };
-            subscribes_to[`${modelName}Evolved`] = `handle${modelName}Evolution`;
-        }
-        return {
-            description: `Handles complex business logic and processing for ${modelName}`,
-            subscribes_to,
-            operations
-        };
-    }
-    generateValidationServiceSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const operations = {
-            validateCreate: {
-                parameters: {
-                    data: `${modelName} required`,
-                    parentContext: 'Object optional'
-                },
-                returns: 'ValidationResult',
-                requires: [`${modelName} data is provided`],
-                ensures: [
-                    'All create validations performed',
-                    'Parent relationships validated',
-                    'Business constraints checked'
-                ]
-            },
-            validateUpdate: {
-                parameters: {
-                    id: 'UUID required',
-                    updates: 'Object required',
-                    currentState: `${modelName} required`
-                },
-                returns: 'ValidationResult',
-                requires: [
-                    `${modelName} exists`,
-                    'Current state is provided'
-                ],
-                ensures: [
-                    'All update validations performed',
-                    'State transition rules checked'
-                ]
-            },
-            validateBusinessRules: {
-                parameters: {
-                    data: `${modelName} required`,
-                    ruleSet: 'String optional'
-                },
-                returns: 'BusinessRuleValidationResult',
-                ensures: [
-                    'All business rules validated',
-                    'Cross-model dependencies checked'
-                ]
-            }
-        };
-        // Add lifecycle validation if model has lifecycle
-        if (context.model?.lifecycle) {
-            operations.validateStateTransition = {
-                parameters: {
-                    id: 'UUID required',
-                    fromState: 'String required',
-                    toState: 'String required',
-                    transitionContext: 'Object optional'
-                },
-                returns: 'ValidationResult',
-                requires: [
-                    `${modelName} exists`,
-                    'States are valid'
-                ],
-                ensures: [
-                    'Transition rules validated',
-                    'Prerequisites checked'
-                ]
-            };
-        }
-        return {
-            description: `Provides comprehensive validation for ${modelName} data`,
-            operations
-        };
-    }
-    generateStandardEventsSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const events = {};
-        // Created event
-        events[`${modelName}Created`] = {
-            description: `${modelName} was created`,
-            attributes: {
-                id: 'UUID required',
-                timestamp: 'DateTime required',
-                createdBy: 'UUID required',
-                version: 'Integer default=1'
-            }
-        };
-        // Updated event  
-        events[`${modelName}Updated`] = {
-            description: `${modelName} was updated`,
-            attributes: {
-                id: 'UUID required',
-                changedFields: 'Array required',
-                previousValues: 'Object optional',
-                newValues: 'Object required',
-                timestamp: 'DateTime required',
-                updatedBy: 'UUID required',
-                version: 'Integer required'
-            }
-        };
-        // Deleted event
-        events[`${modelName}Deleted`] = {
-            description: `${modelName} was deleted`,
-            attributes: {
-                id: 'UUID required',
-                deletedBy: 'UUID required',
-                timestamp: 'DateTime required',
-                soft: 'Boolean default=true',
-                reason: 'String optional'
-            }
-        };
-        // Add key attributes from model to events
-        if (context.model?.attributes) {
-            const keyAttributes = context.model.attributes.filter((attr) => attr.name === 'name' || attr.name === 'title' || attr.name === 'status');
-            keyAttributes.forEach((attr) => {
-                events[`${modelName}Created`].attributes[attr.name] = `${attr.type} required`;
-                events[`${modelName}Updated`].attributes[attr.name] = `${attr.type} optional`;
-                if (attr.name === 'name') {
-                    events[`${modelName}Deleted`].attributes[attr.name] = `${attr.type} optional`;
-                }
-            });
-        }
-        return events;
-    }
-    generateViewSpec(pattern, context) {
-        const modelName = context.modelName || 'Unknown';
-        if (pattern === 'EnhancedListView') {
-            return {
-                [`${modelName}EnhancedListView`]: {
-                    type: 'list',
-                    model: modelName,
-                    description: `Enhanced list view for ${modelName} with advanced filtering`,
-                    subscribes_to: [
-                        `${modelName}Created`,
-                        `${modelName}Updated`,
-                        `${modelName}Deleted`
-                    ],
-                    uiComponents: {
-                        advancedSearch: {
-                            type: 'AdvancedSearchInput',
-                            properties: {
-                                placeholder: `Search ${modelName}s...`,
-                                debounce: 300,
-                                enableSuggestions: true
-                            }
-                        },
-                        advancedFilters: {
-                            type: 'FilterPanel',
-                            properties: {
-                                model: modelName,
-                                collapsible: true
-                            }
-                        },
-                        [`${modelName.toLowerCase()}Table`]: {
-                            type: 'DataTable',
-                            properties: {
-                                model: modelName,
-                                pagination: {
-                                    enabled: true,
-                                    pageSize: 25,
-                                    showSizeSelector: true
-                                },
-                                selection: {
-                                    enabled: true,
-                                    multiSelect: true
-                                },
-                                sorting: {
-                                    enabled: true,
-                                    multiColumn: true
-                                }
-                            }
-                        }
-                    }
-                }
-            };
-        }
-        else if (pattern === 'AnalyticsView') {
-            return {
-                [`${modelName}AnalyticsView`]: {
-                    type: 'dashboard',
-                    model: modelName,
-                    description: `Analytics and reporting dashboard for ${modelName}`,
-                    subscribes_to: [
-                        `${modelName}Created`,
-                        `${modelName}Updated`,
-                        `${modelName}Deleted`
-                    ],
-                    uiComponents: {
-                        keyMetrics: {
-                            type: 'MetricsSummary',
-                            properties: {
-                                title: `${modelName} Key Metrics`,
-                                refreshInterval: 300000
-                            }
-                        },
-                        trendsChart: {
-                            type: 'TimeSeriesChart',
-                            properties: {
-                                title: `${modelName} Trends Over Time`,
-                                chartType: 'line',
-                                dateRange: 'last30Days'
-                            }
-                        }
-                    }
+            const rendered = Handlebars.compile(template, { strict: false, noEscape: true })(templateContext);
+            try {
+                const trimmed = rendered.trim();
+                if (trimmed.includes(':') || trimmed.startsWith('[') || trimmed.startsWith('{')) {
+                    return yaml.load(rendered);
                 }
-            };
-        }
-        return {};
-    }
-    processSpeclyHandlebars(template, context) {
-        // Process {{#if model.lifecycle}} blocks
-        template = template.replace(/\{\{#if model\.lifecycle\}\}([^]*?)\{\{\/if\}\}/g, (match, content) => {
-            return context.model?.lifecycle ? content : '';
-        });
-        // Process {{#each model.attributes}} blocks  
-        template = template.replace(/\{\{#each model\.attributes\}\}([^]*?)\{\{\/each\}\}/g, (match, content) => {
-            if (!context.model?.attributes)
-                return '';
-            if (typeof content !== 'string') {
-                throw new Error(`content in model.attributes each loop is not a string: ${typeof content}`);
             }
-            return context.model.attributes.map((attr) => {
-                return content.replace(/\{\{name\}\}/g, attr.name)
-                    .replace(/\{\{type\}\}/g, attr.type)
-                    .replace(/\{\{required\}\}/g, attr.required ? 'true' : 'false');
-            }).join('');
-        });
-        // Process {{#if required}} blocks within attribute loops
-        template = template.replace(/\{\{#if required\}\}([^]*?)\{\{\/if\}\}/g, (match, content) => {
-            // This will be processed within the context of each attribute
-            return content; // Keep the content, the required check happens in the attribute loop
-        });
-        // Process {{#each relationships.cascadeDeleteTargets}} blocks
-        template = template.replace(/\{\{#each relationships\.cascadeDeleteTargets\}\}([^]*?)\{\{\/each\}\}/g, (match, content) => {
-            if (!context.relationships?.cascadeDeleteTargets)
-                return '';
-            return context.relationships.cascadeDeleteTargets.map((target) => {
-                return content.replace(/\{\{this\}\}/g, target);
-            }).join('');
-        });
-        // Process {{#each relationships.parentRelationships}} blocks
-        template = template.replace(/\{\{#each relationships\.parentRelationships\}\}([^]*?)\{\{\/each\}\}/g, (match, content) => {
-            if (!context.relationships?.parentRelationships)
-                return '';
-            return context.relationships.parentRelationships.map((rel) => {
-                let processedContent = content;
-                // Ensure content is a string
-                if (typeof processedContent !== 'string') {
-                    throw new Error(`processedContent is not a string: ${typeof processedContent}`);
-                }
-                // Replace relationship-specific variables
-                processedContent = processedContent.replace(/\{\{targetModel\}\}/g, rel.targetModel)
-                    .replace(/\{\{\.\.\/modelName\}\}/g, context.modelName || '')
-                    .replace(/\{\{\.\.\/\.\.\/modelName\}\}/g, context.modelName || '');
-                // Process nested {{#each ../model.attributes}} blocks within this content
-                processedContent = processedContent.replace(/\{\{#each \.\.\/model\.attributes\}\}([^]*?)\{\{\/each\}\}/g, (nestedMatch, nestedContent) => {
-                    if (!context.model?.attributes)
-                        return '';
-                    if (typeof nestedContent !== 'string') {
-                        throw new Error(`nestedContent is not a string: ${typeof nestedContent}`);
-                    }
-                    return context.model.attributes.map((attr) => {
-                        if (attr.required) {
-                            return nestedContent.replace(/\{\{name\}\}/g, attr.name)
-                                .replace(/\{\{type\}\}/g, attr.type);
-                        }
-                        return '';
-                    }).join('');
-                });
-                // Process nested {{#if required}} blocks
-                processedContent = processedContent.replace(/\{\{#if required\}\}([^]*?)\{\{\/if\}\}/g, (ifMatch, ifContent) => {
-                    return ifContent; // Keep content, filtering happens in the attributes loop
-                });
-                return processedContent;
-            }).join('');
-        });
-        return template;
-    }
-    processHandlebarsInJson(obj, context) {
-        if (typeof obj === 'string') {
-            // Process Handlebars variables
-            let result = obj.replace(/\{\{(\w+)\}\}/g, (match, key) => {
-                return context[key] || match;
-            });
-            // Process Handlebars conditionals and loops (basic implementation)
-            result = this.processHandlebarsConditionals(result, context);
-            return result;
-        }
-        else if (Array.isArray(obj)) {
-            return obj.map(item => this.processHandlebarsInJson(item, context));
-        }
-        else if (obj && typeof obj === 'object') {
-            const processed = {};
-            for (const [key, value] of Object.entries(obj)) {
-                const processedKey = this.processHandlebarsInJson(key, context);
-                processed[processedKey] = this.processHandlebarsInJson(value, context);
+            catch {
+                // YAML parse failed — return the raw rendered string.
             }
-            return processed;
+            return rendered;
+        }
+        catch (error) {
+            throw new Error(`Failed to process Specly template: ${error instanceof Error ? error.message : String(error)}`);
         }
-        return obj;
-    }
-    processHandlebarsConditionals(template, context) {
-        // Basic conditional processing for {{#if}} and {{#each}}
-        // This is a simplified version - a full implementation would use the Handlebars library
-        // Process {{#if model.lifecycle}} blocks
-        template = template.replace(/\{\{#if model\.lifecycle\}\}([^]*?)\{\{\/if\}\}/g, (match, content) => {
-            return context.model?.lifecycle ? content : '';
-        });
-        // Process {{#each model.attributes}} blocks  
-        template = template.replace(/\{\{#each model\.attributes\}\}([^]*?)\{\{\/each\}\}/g, (match, content) => {
-            if (!context.model?.attributes)
-                return '';
-            return context.model.attributes.map((attr) => {
-                return content.replace(/\{\{name\}\}/g, attr.name)
-                    .replace(/\{\{type\}\}/g, attr.type)
-                    .replace(/\{\{required\}\}/g, attr.required);
-            }).join('');
-        });
-        return template;
     }
+    // processSpeclyHandlebars / processHandlebarsInJson /
+    // processHandlebarsConditionals — removed in Cycle 3. They were
+    // the home-rolled string-substitution layer that the four
+    // apply*Template methods delegated to. All four methods now go
+    // through real Handlebars (Handlebars.compile + render), so these
+    // have zero callers and are gone.
     convertJsonToSpecly(obj) {
         // Convert processed JSON object to .specly syntax
         let result = '';
@@ -1062,352 +540,5 @@ export class RuleEngine {
         }
         return result;
     }
-    generateIntegrationServiceSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const operations = {
-            syncToExternalSystems: {
-                parameters: {
-                    event: `${modelName}CreatedEvent required`
-                },
-                returns: 'IntegrationResult',
-                requires: ['External systems are available'],
-                ensures: [
-                    `${modelName} synchronized to all external systems`,
-                    'Integration status tracked'
-                ]
-            },
-            updateExternalSystems: {
-                parameters: {
-                    event: `${modelName}UpdatedEvent required`
-                },
-                returns: 'IntegrationResult',
-                requires: ['External systems are available'],
-                ensures: [
-                    'Changes synchronized to external systems',
-                    'Sync conflicts resolved'
-                ]
-            },
-            removeFromExternalSystems: {
-                parameters: {
-                    event: `${modelName}DeletedEvent required`
-                },
-                returns: 'IntegrationResult',
-                ensures: [
-                    `${modelName} removed from external systems`,
-                    'Cleanup operations completed'
-                ]
-            },
-            pullFromExternalSystem: {
-                parameters: {
-                    externalSystemId: 'String required',
-                    lastSyncTime: 'DateTime optional'
-                },
-                returns: `Array[${modelName}]`,
-                requires: ['External system is accessible'],
-                ensures: [
-                    'Latest data retrieved from external system',
-                    'Sync timestamp updated'
-                ]
-            },
-            pushToExternalSystem: {
-                parameters: {
-                    id: 'UUID required',
-                    externalSystemId: 'String required',
-                    forceSync: 'Boolean default=false'
-                },
-                returns: 'IntegrationResult',
-                requires: [
-                    `${modelName} exists`,
-                    'External system is accessible'
-                ],
-                ensures: [
-                    `${modelName} pushed to external system`,
-                    'Integration status updated'
-                ]
-            }
-        };
-        return {
-            description: `Manages external system integration for ${modelName}`,
-            subscribes_to: {
-                [`${modelName}Created`]: 'syncToExternalSystems',
-                [`${modelName}Updated`]: 'updateExternalSystems',
-                [`${modelName}Deleted`]: 'removeFromExternalSystems'
-            },
-            operations
-        };
-    }
-    generateLifecycleServiceSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const operations = {
-            handleStateChange: {
-                parameters: {
-                    event: `${modelName}EvolvedEvent required`
-                },
-                returns: 'Void',
-                requires: ['State transition is valid'],
-                ensures: [
-                    'State-dependent actions triggered',
-                    'Transition side-effects processed'
-                ]
-            },
-            validateTransition: {
-                parameters: {
-                    id: 'UUID required',
-                    fromState: 'String required',
-                    toState: 'String required',
-                    context: 'Object optional'
-                },
-                returns: 'TransitionValidationResult',
-                requires: [
-                    `${modelName} exists`,
-                    'States are valid lifecycle states'
-                ],
-                ensures: [
-                    'Transition prerequisites validated',
-                    'Business rules checked'
-                ]
-            },
-            getAvailableTransitions: {
-                parameters: {
-                    [`${modelName}Id`]: 'UUID required'
-                },
-                returns: 'Array[TransitionOption]',
-                requires: [`${modelName} exists`],
-                ensures: ['Returns all valid transitions from current state']
-            },
-            getStateHistory: {
-                parameters: {
-                    id: 'UUID required',
-                    limit: 'Integer default=50'
-                },
-                returns: 'Array[StateHistoryEntry]',
-                requires: [`${modelName} exists`],
-                ensures: ['Returns chronological state change history']
-            }
-        };
-        // Add dynamic transition operations if lifecycle exists
-        if (context.model?.lifecycle?.transitions) {
-            context.model.lifecycle.transitions.forEach((transition) => {
-                const operationName = `execute${transition.name}Transition`;
-                operations[operationName] = {
-                    parameters: {
-                        id: 'UUID required',
-                        reason: 'String optional',
-                        context: 'Object optional'
-                    },
-                    returns: modelName,
-                    requires: [
-                        `${modelName} exists`,
-                        `${modelName} current state is '${transition.from}'`
-                    ],
-                    ensures: [
-                        `${modelName} state changed to '${transition.to}'`,
-                        'Transition side-effects completed'
-                    ]
-                };
-            });
-        }
-        return {
-            description: `Manages lifecycle transitions and state-dependent behavior for ${modelName}`,
-            subscribes_to: {
-                [`${modelName}Evolved`]: 'handleStateChange'
-            },
-            operations
-        };
-    }
-    generateRelationshipServiceSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const operations = {
-            handleChildAdded: {
-                parameters: {
-                    event: 'ChildEntityEvent required'
-                },
-                returns: 'Void',
-                ensures: [
-                    'Parent relationship established',
-                    'Relationship integrity maintained'
-                ]
-            },
-            handleChildRemoved: {
-                parameters: {
-                    event: 'ChildEntityEvent required'
-                },
-                returns: 'Void',
-                ensures: [
-                    'Parent relationship cleaned up',
-                    'Cascade rules applied'
-                ]
-            },
-            validateRelationshipIntegrity: {
-                parameters: {
-                    id: 'UUID required',
-                    relationshipType: 'String optional'
-                },
-                returns: 'IntegrityValidationResult',
-                requires: [`${modelName} exists`],
-                ensures: [
-                    'All relationships validated for integrity',
-                    'Constraint violations identified'
-                ]
-            },
-            repairRelationshipIntegrity: {
-                parameters: {
-                    id: 'UUID required',
-                    repairOptions: 'RepairOptions required'
-                },
-                returns: 'RepairResult',
-                requires: [
-                    `${modelName} exists`,
-                    'Repair options are valid'
-                ],
-                ensures: [
-                    'Relationship integrity issues resolved',
-                    'Repair actions logged'
-                ]
-            }
-        };
-        const subscribes_to = {};
-        // Add child relationship subscriptions
-        if (context.relationships?.childRelationships) {
-            context.relationships.childRelationships.forEach((rel) => {
-                subscribes_to[`${rel.targetModel}Created`] = 'handleChildAdded';
-                subscribes_to[`${rel.targetModel}Deleted`] = 'handleChildRemoved';
-            });
-        }
-        // Add many-to-many relationship subscriptions and operations
-        if (context.relationships?.manyToManyRelationships) {
-            context.relationships.manyToManyRelationships.forEach((rel) => {
-                subscribes_to[`${modelName}AssociatedWith${rel.targetModel}`] = 'handleAssociationAdded';
-                subscribes_to[`${modelName}DisassociatedFrom${rel.targetModel}`] = 'handleAssociationRemoved';
-                operations.handleAssociationAdded = {
-                    parameters: {
-                        event: 'AssociationEvent required'
-                    },
-                    returns: 'Void',
-                    ensures: [
-                        'Association established',
-                        'Association metadata updated'
-                    ]
-                };
-                operations.handleAssociationRemoved = {
-                    parameters: {
-                        event: 'DisassociationEvent required'
-                    },
-                    returns: 'Void',
-                    ensures: [
-                        'Association removed',
-                        'Related data cleaned up'
-                    ]
-                };
-            });
-        }
-        return {
-            description: `Manages complex relationships and ensures relationship integrity for ${modelName}`,
-            subscribes_to,
-            operations
-        };
-    }
-    generateRelationshipEventsSpec(context) {
-        const modelName = context.modelName || 'Unknown';
-        const events = {};
-        // Parent relationship events
-        if (context.relationships?.parentRelationships) {
-            context.relationships.parentRelationships.forEach((rel) => {
-                const targetModel = rel.targetModel;
-                // Child created within parent
-                events[`${modelName}CreatedIn${targetModel}`] = {
-                    description: `${modelName} was created within ${targetModel}`,
-                    attributes: {
-                        id: 'UUID required',
-                        [`${targetModel.toLowerCase()}Id`]: 'UUID required',
-                        [`${targetModel.toLowerCase()}Name`]: 'String optional',
-                        timestamp: 'DateTime required',
-                        createdBy: 'UUID required'
-                    }
-                };
-                // Add name attribute if model has one
-                if (context.model?.attributes?.some((attr) => attr.name === 'name')) {
-                    events[`${modelName}CreatedIn${targetModel}`].attributes.name = 'String required';
-                }
-                // Child removed from parent
-                events[`${modelName}RemovedFrom${targetModel}`] = {
-                    description: `${modelName} was removed from ${targetModel}`,
-                    attributes: {
-                        id: 'UUID required',
-                        [`${targetModel.toLowerCase()}Id`]: 'UUID required',
-                        [`${targetModel.toLowerCase()}Name`]: 'String optional',
-                        removedBy: 'UUID required',
-                        timestamp: 'DateTime required',
-                        reason: 'String optional'
-                    }
-                };
-            });
-        }
-        // Child relationship events
-        if (context.relationships?.childRelationships) {
-            context.relationships.childRelationships.forEach((rel) => {
-                const targetModel = rel.targetModel || rel.name;
-                const relType = rel.type || 'hasMany';
-                // Child added to parent
-                events[`${targetModel}AddedTo${modelName}`] = {
-                    description: `${targetModel} was added to ${modelName}`,
-                    attributes: {
-                        [`${modelName.toLowerCase()}Id`]: 'UUID required',
-                        [`${targetModel.toLowerCase()}Id`]: 'UUID required',
-                        relationshipType: `String default=${relType}`,
-                        addedBy: 'UUID required',
-                        timestamp: 'DateTime required'
-                    }
-                };
-                // Child removed from parent
-                const removeEvent = {
-                    description: `${targetModel} was removed from ${modelName}`,
-                    attributes: {
-                        [`${modelName.toLowerCase()}Id`]: 'UUID required',
-                        [`${targetModel.toLowerCase()}Id`]: 'UUID required',
-                        relationshipType: `String default=${relType}`,
-                        removedBy: 'UUID required',
-                        timestamp: 'DateTime required'
-                    }
-                };
-                // Add cascade flag if specified
-                if (rel.cascadeDelete) {
-                    removeEvent.attributes.cascadeTriggered = 'Boolean default=true';
-                }
-                events[`${targetModel}RemovedFrom${modelName}`] = removeEvent;
-            });
-        }
-        // Many-to-many relationship events
-        if (context.relationships?.manyToManyRelationships) {
-            context.relationships.manyToManyRelationships.forEach((rel) => {
-                const targetModel = rel.targetModel;
-                // Association created
-                events[`${modelName}AssociatedWith${targetModel}`] = {
-                    description: `${modelName} was associated with ${targetModel}`,
-                    attributes: {
-                        [`${modelName.toLowerCase()}Id`]: 'UUID required',
-                        [`${targetModel.toLowerCase()}Id`]: 'UUID required',
-                        associationType: 'String default=manyToMany',
-                        associationData: 'Object optional',
-                        associatedBy: 'UUID required',
-                        timestamp: 'DateTime required'
-                    }
-                };
-                // Association removed
-                events[`${modelName}DisassociatedFrom${targetModel}`] = {
-                    description: `${modelName} was disassociated from ${targetModel}`,
-                    attributes: {
-                        [`${modelName.toLowerCase()}Id`]: 'UUID required',
-                        [`${targetModel.toLowerCase()}Id`]: 'UUID required',
-                        associationType: 'String default=manyToMany',
-                        disassociatedBy: 'UUID required',
-                        timestamp: 'DateTime required',
-                        reason: 'String optional'
-                    }
-                };
-            });
-        }
-        return events;
-    }
 }
 //# sourceMappingURL=rule-engine.js.map