aios-core 2.1.0

package/.aios-core/infrastructure/scripts/status-mapper.js

@@ -0,0 +1,115 @@
+// File: common/utils/status-mapper.js
+
+/**
+ * Status Mapper - Bidirectional status mapping between AIOS and ClickUp
+ *
+ * This module provides utilities for:
+ * - Mapping AIOS story statuses to ClickUp custom field values
+ * - Mapping ClickUp story-status values back to AIOS statuses
+ * - Handling ClickUp-specific statuses (e.g., "Ready for Dev")
+ *
+ * CRITICAL: Stories use ClickUp custom field "story-status", NOT native status.
+ * Epics use the native ClickUp status field (Planning, In Progress, Done).
+ */
+
+const STATUS_MAPPING = {
+  AIOS_TO_CLICKUP: {
+    'Draft': 'Draft',
+    'Ready for Review': 'Ready for Review',
+    'Review': 'Review',
+    'In Progress': 'In Progress',
+    'Done': 'Done',
+    'Blocked': 'Blocked',
+  },
+  CLICKUP_TO_AIOS: {
+    'Draft': 'Draft',
+    'Ready for Dev': 'Ready for Review',  // ClickUp-specific status
+    'Ready for Review': 'Ready for Review',
+    'Review': 'Review',
+    'In Progress': 'In Progress',
+    'Done': 'Done',
+    'Blocked': 'Blocked',
+  },
+};
+
+/**
+ * Maps an AIOS story status to ClickUp story-status custom field value
+ *
+ * @param {string} aiosStatus - Local .md file status
+ * @returns {string} ClickUp story-status value
+ */
+function mapStatusToClickUp(aiosStatus) {
+  const mapped = STATUS_MAPPING.AIOS_TO_CLICKUP[aiosStatus];
+
+  if (!mapped) {
+    console.warn(`Unknown AIOS status: ${aiosStatus}, using as-is`);
+    return aiosStatus;
+  }
+
+  return mapped;
+}
+
+/**
+ * Maps a ClickUp story-status custom field value to AIOS story status
+ *
+ * @param {string} clickupStatus - ClickUp story-status value
+ * @returns {string} Local .md file status
+ */
+function mapStatusFromClickUp(clickupStatus) {
+  const mapped = STATUS_MAPPING.CLICKUP_TO_AIOS[clickupStatus];
+
+  if (!mapped) {
+    console.warn(`Unknown ClickUp status: ${clickupStatus}, using as-is`);
+    return clickupStatus;
+  }
+
+  return mapped;
+}
+
+/**
+ * Validates if a status is a valid AIOS story status
+ *
+ * @param {string} status - Status to validate
+ * @returns {boolean} True if valid
+ */
+function isValidAIOSStatus(status) {
+  return Object.keys(STATUS_MAPPING.AIOS_TO_CLICKUP).includes(status);
+}
+
+/**
+ * Validates if a status is a valid ClickUp story-status value
+ *
+ * @param {string} status - Status to validate
+ * @returns {boolean} True if valid
+ */
+function isValidClickUpStatus(status) {
+  return Object.keys(STATUS_MAPPING.CLICKUP_TO_AIOS).includes(status);
+}
+
+/**
+ * Gets all valid AIOS story statuses
+ *
+ * @returns {string[]} Array of valid statuses
+ */
+function getValidAIOSStatuses() {
+  return Object.keys(STATUS_MAPPING.AIOS_TO_CLICKUP);
+}
+
+/**
+ * Gets all valid ClickUp story-status values
+ *
+ * @returns {string[]} Array of valid statuses
+ */
+function getValidClickUpStatuses() {
+  return Object.keys(STATUS_MAPPING.CLICKUP_TO_AIOS);
+}
+
+module.exports = {
+  mapStatusToClickUp,
+  mapStatusFromClickUp,
+  isValidAIOSStatus,
+  isValidClickUpStatus,
+  getValidAIOSStatuses,
+  getValidClickUpStatuses,
+  STATUS_MAPPING, // Export for testing
+};

package/.aios-core/infrastructure/scripts/template-engine.js

@@ -0,0 +1,240 @@
+/**
+ * Template Engine for AIOS-FULLSTACK
+ * Handles variable substitution, conditionals, and loops for component generation
+ * @module template-engine
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+
+class TemplateEngine {
+  constructor() {
+    this.variablePattern = /\{\{([^}]+)\}\}/g;
+    this.conditionalPattern = /\{\{#IF_([^}]+)\}\}([\s\S]*?)\{\{\/IF_\1\}\}/g;
+    this.loopPattern = /\{\{#EACH_([^}]+)\}\}([\s\S]*?)\{\{\/EACH_\1\}\}/g;
+    this.escapePattern = /\\\{\{([^}]+)\}\}/g;
+  }
+
+  /**
+   * Process a template string with given variables
+   * @param {string} template - The template string
+   * @param {Object} variables - Variables to substitute
+   * @returns {string} Processed template
+   */
+  process(template, variables = {}) {
+    // First, handle escaped braces
+    let processed = template.replace(this.escapePattern, '{{$1}}');
+    
+    // Process loops
+    processed = this.processLoops(processed, variables);
+    
+    // Process conditionals
+    processed = this.processConditionals(processed, variables);
+    
+    // Process simple variables
+    processed = this.processVariables(processed, variables);
+    
+    // Restore escaped braces
+    processed = processed.replace(/\{\{ESCAPED_BRACE_(LEFT|RIGHT)\}\}/g, (match, side) => 
+      side === 'LEFT' ? '{{' : '}}',
+    );
+    
+    return processed;
+  }
+
+  /**
+   * Process loop constructs in template
+   * @private
+   * @param {string} template - Template string
+   * @param {Object} variables - Variables object
+   * @returns {string} Processed template
+   */
+  processLoops(template, variables) {
+    return template.replace(this.loopPattern, (match, loopVar, content) => {
+      const items = this.resolveVariable(loopVar, variables);
+      
+      // Handle non-array values gracefully
+      if (!Array.isArray(items)) {
+        console.warn(`[TemplateEngine] Expected array for loop variable '${loopVar}', got ${typeof items}`);
+        return '';
+      }
+      
+      return items.map((item, index) => {
+        // Create proper loop context with item and metadata
+        const loopVars = {
+          ...variables,
+          ITEM: item,
+          INDEX: index,
+          FIRST: index === 0,
+          LAST: index === items.length - 1,
+          [loopVar.replace('_', '')]: item,
+        };
+        
+        // Process nested loops and conditionals
+        let processedContent = this.processLoops(content, loopVars);
+        processedContent = this.processConditionals(processedContent, loopVars);
+        processedContent = this.processVariables(processedContent, loopVars);
+        
+        return processedContent;
+      }).join('');
+    });
+  }
+
+  /**
+   * Process conditional constructs in template
+   * @private
+   */
+  processConditionals(template, variables) {
+    return template.replace(this.conditionalPattern, (match, condition, content) => {
+      const value = this.resolveVariable(condition, variables);
+      
+      // Check for truthy value
+      if (value && (Array.isArray(value) ? value.length > 0 : true)) {
+        return content;
+      }
+      return '';
+    });
+  }
+
+  /**
+   * Process simple variable substitutions
+   * @private
+   */
+  processVariables(template, variables) {
+    return template.replace(this.variablePattern, (match, varName) => {
+      const value = this.resolveVariable(varName.trim(), variables);
+      return value !== undefined ? String(value) : match;
+    });
+  }
+
+  /**
+   * Resolve a variable name to its value
+   * @private
+   */
+  resolveVariable(varName, variables) {
+    // Handle nested paths like "user.name"
+    const parts = varName.split('.');
+    let value = variables;
+    
+    for (const part of parts) {
+      if (value && typeof value === 'object') {
+        value = value[part];
+      } else {
+        return undefined;
+      }
+    }
+    
+    return value;
+  }
+
+  /**
+   * Validate that a template has all required placeholders
+   * @param {string} template - Template to validate
+   * @param {string[]} requiredVars - List of required variable names
+   * @returns {Object} Validation result with {valid: boolean, missing: string[]}
+   */
+  validateTemplate(template, requiredVars = []) {
+    const foundVars = new Set();
+    const missing = [];
+    
+    // Extract all variable names from template
+    let match;
+    const allPatterns = [
+      this.variablePattern,
+      /\{\{#IF_([^}]+)\}\}/g,
+      /\{\{#EACH_([^}]+)\}\}/g,
+    ];
+    
+    for (const pattern of allPatterns) {
+      pattern.lastIndex = 0; // Reset regex
+      while ((match = pattern.exec(template)) !== null) {
+        foundVars.add(match[1].trim());
+      }
+    }
+    
+    // Check for missing required variables
+    for (const reqVar of requiredVars) {
+      if (!foundVars.has(reqVar)) {
+        missing.push(reqVar);
+      }
+    }
+    
+    return {
+      valid: missing.length === 0,
+      missing,
+      found: Array.from(foundVars),
+    };
+  }
+
+  /**
+   * Load and process a template file
+   * @param {string} templatePath - Path to template file
+   * @param {Object} variables - Variables to substitute
+   * @returns {Promise<string>} Processed template
+   */
+  async loadAndProcess(templatePath, variables = {}) {
+    const template = await fs.readFile(templatePath, 'utf8');
+    return this.process(template, variables);
+  }
+
+  /**
+   * Escape special characters in user input to prevent injection
+   * @param {string} input - User input to escape
+   * @returns {string} Escaped input
+   */
+  escapeInput(input) {
+    if (typeof input !== 'string') return input;
+    
+    // Escape template syntax
+    return input
+      .replace(/\{\{/g, '\\{{')
+      .replace(/\}\}/g, '\\}}')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#39;');
+  }
+
+  /**
+   * Get all available variables from a template
+   * @param {string} template - Template to analyze
+   * @returns {Object} Object with variables categorized by type
+   */
+  getTemplateVariables(template) {
+    const variables = {
+      simple: [],
+      conditionals: [],
+      loops: [],
+    };
+    
+    // Extract simple variables
+    let match;
+    this.variablePattern.lastIndex = 0;
+    while ((match = this.variablePattern.exec(template)) !== null) {
+      if (!match[1].startsWith('#') && !match[1].startsWith('/')) {
+        variables.simple.push(match[1].trim());
+      }
+    }
+    
+    // Extract conditionals
+    const conditionalStartPattern = /\{\{#IF_([^}]+)\}\}/g;
+    while ((match = conditionalStartPattern.exec(template)) !== null) {
+      variables.conditionals.push(match[1].trim());
+    }
+    
+    // Extract loops
+    const loopStartPattern = /\{\{#EACH_([^}]+)\}\}/g;
+    while ((match = loopStartPattern.exec(template)) !== null) {
+      variables.loops.push(match[1].trim());
+    }
+    
+    // Remove duplicates
+    for (const key in variables) {
+      variables[key] = [...new Set(variables[key])];
+    }
+    
+    return variables;
+  }
+}
+
+module.exports = TemplateEngine;

package/.aios-core/infrastructure/scripts/template-validator.js

@@ -0,0 +1,279 @@
+/**
+ * Template Validator for AIOS-FULLSTACK
+ * Validates component templates for required structure and placeholders
+ * @module template-validator
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const yaml = require('js-yaml');
+const TemplateEngine = require('./template-engine');
+
+class TemplateValidator {
+  constructor() {
+    this.engine = new TemplateEngine();
+    this.requiredVariables = {
+      agent: [
+        'AGENT_NAME',
+        'AGENT_ID', 
+        'AGENT_TITLE',
+        'AGENT_ICON',
+        'WHEN_TO_USE',
+        'PERSONA_ROLE',
+        'PERSONA_STYLE',
+        'PERSONA_IDENTITY',
+        'PERSONA_FOCUS',
+      ],
+      task: [
+        'TASK_TITLE',
+        'TASK_ID',
+        'AGENT_NAME',
+        'VERSION',
+        'TASK_DESCRIPTION',
+        'OUTPUT_DESCRIPTION',
+      ],
+      workflow: [
+        'WORKFLOW_ID',
+        'WORKFLOW_NAME',
+        'WORKFLOW_DESCRIPTION',
+        'WORKFLOW_VERSION',
+        'WORKFLOW_TYPE',
+        'AUTHOR',
+        'CREATED_DATE',
+        'LAST_MODIFIED',
+      ],
+    };
+  }
+
+  /**
+   * Validate a template file
+   * @param {string} templatePath - Path to template file
+   * @param {string} templateType - Type of template (agent, task, workflow)
+   * @returns {Promise<Object>} Validation result
+   */
+  async validateTemplateFile(templatePath, templateType) {
+    try {
+      const template = await fs.readFile(templatePath, 'utf8');
+      return this.validateTemplate(template, templateType);
+    } catch (error) {
+      return {
+        valid: false,
+        errors: [`Failed to read template file: ${error.message}`],
+      };
+    }
+  }
+
+  /**
+   * Validate a template string
+   * @param {string} template - Template content
+   * @param {string} templateType - Type of template
+   * @returns {Object} Validation result
+   */
+  validateTemplate(template, templateType) {
+    const errors = [];
+    const warnings = [];
+    
+    // Check template type is valid
+    if (!this.requiredVariables[templateType]) {
+      return {
+        valid: false,
+        errors: [`Unknown template type: ${templateType}`],
+      };
+    }
+    
+    // Validate required variables
+    const requiredVars = this.requiredVariables[templateType];
+    const validation = this.engine.validateTemplate(template, requiredVars);
+    
+    if (!validation.valid) {
+      errors.push(`Missing required variables: ${validation.missing.join(', ')}`);
+    }
+    
+    // Check for balanced conditionals
+    const conditionalCheck = this.checkBalancedConditionals(template);
+    if (!conditionalCheck.valid) {
+      errors.push(...conditionalCheck.errors);
+    }
+    
+    // Check for balanced loops
+    const loopCheck = this.checkBalancedLoops(template);
+    if (!loopCheck.valid) {
+      errors.push(...loopCheck.errors);
+    }
+    
+    // Template-specific validation
+    const specificCheck = this.validateSpecificTemplate(template, templateType);
+    if (!specificCheck.valid) {
+      errors.push(...specificCheck.errors);
+    }
+    warnings.push(...specificCheck.warnings);
+    
+    // Check for potential security issues
+    const securityCheck = this.checkSecurityIssues(template);
+    if (!securityCheck.valid) {
+      errors.push(...securityCheck.errors);
+    }
+    warnings.push(...securityCheck.warnings);
+    
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings,
+      variables: this.engine.getTemplateVariables(template),
+    };
+  }
+
+  /**
+   * Check for balanced conditional blocks
+   * @private
+   */
+  checkBalancedConditionals(template) {
+    const errors = [];
+    const openTags = template.match(/\{\{#IF_([^}]+)\}\}/g) || [];
+    const closeTags = template.match(/\{\{\/IF_([^}]+)\}\}/g) || [];
+    
+    const openConditions = openTags.map(tag => tag.match(/IF_([^}]+)/)[1]);
+    const closeConditions = closeTags.map(tag => tag.match(/IF_([^}]+)/)[1]);
+    
+    // Check each open has a close
+    for (const condition of openConditions) {
+      if (!closeConditions.includes(condition)) {
+        errors.push(`Unclosed conditional: {{#IF_${condition}}}`);
+      }
+    }
+    
+    // Check each close has an open
+    for (const condition of closeConditions) {
+      if (!openConditions.includes(condition)) {
+        errors.push(`Unexpected closing tag: {{/IF_${condition}}}`);
+      }
+    }
+    
+    return { valid: errors.length === 0, errors };
+  }
+
+  /**
+   * Check for balanced loop blocks
+   * @private
+   */
+  checkBalancedLoops(template) {
+    const errors = [];
+    const openTags = template.match(/\{\{#EACH_([^}]+)\}\}/g) || [];
+    const closeTags = template.match(/\{\{\/EACH_([^}]+)\}\}/g) || [];
+    
+    const openLoops = openTags.map(tag => tag.match(/EACH_([^}]+)/)[1]);
+    const closeLoops = closeTags.map(tag => tag.match(/EACH_([^}]+)/)[1]);
+    
+    // Check each open has a close
+    for (const loop of openLoops) {
+      if (!closeLoops.includes(loop)) {
+        errors.push(`Unclosed loop: {{#EACH_${loop}}}`);
+      }
+    }
+    
+    // Check each close has an open
+    for (const loop of closeLoops) {
+      if (!openLoops.includes(loop)) {
+        errors.push(`Unexpected closing tag: {{/EACH_${loop}}}`);
+      }
+    }
+    
+    return { valid: errors.length === 0, errors };
+  }
+
+  /**
+   * Template-specific validation
+   * @private
+   */
+  validateSpecificTemplate(template, templateType) {
+    const errors = [];
+    const warnings = [];
+    
+    switch (templateType) {
+      case 'agent':
+        // Check for YAML structure
+        if (!template.includes('agent:') || !template.includes('persona:')) {
+          errors.push('Agent template must include agent: and persona: sections');
+        }
+        if (!template.includes('commands:')) {
+          warnings.push('Agent template should include commands: section');
+        }
+        break;
+        
+      case 'task':
+        // Check for markdown headers
+        if (!template.includes('# {{TASK_TITLE}}')) {
+          warnings.push('Task template should start with # {{TASK_TITLE}}');
+        }
+        if (!template.includes('## Workflow')) {
+          warnings.push('Task template should include ## Workflow section');
+        }
+        break;
+        
+      case 'workflow':
+        // Check for YAML structure
+        if (!template.includes('workflow:') || !template.includes('steps:')) {
+          errors.push('Workflow template must include workflow: and steps: sections');
+        }
+        if (!template.includes('metadata:')) {
+          warnings.push('Workflow template should include metadata: section');
+        }
+        break;
+    }
+    
+    return { valid: errors.length === 0, errors, warnings };
+  }
+
+  /**
+   * Check for potential security issues in template
+   * @private
+   */
+  checkSecurityIssues(template) {
+    const errors = [];
+    const warnings = [];
+    
+    // Check for dangerous patterns
+    const dangerousPatterns = [
+      { pattern: /eval\s*\(/, message: 'Template contains eval() - security risk' },
+      { pattern: /Function\s*\(/, message: 'Template contains Function() - security risk' },
+      { pattern: /require\s*\([^'"]+\)/, message: 'Dynamic require detected - potential security risk' },
+      { pattern: /<script/i, message: 'Script tags detected in template' },
+    ];
+    
+    for (const { pattern, message } of dangerousPatterns) {
+      if (pattern.test(template)) {
+        errors.push(message);
+      }
+    }
+    
+    // Check for suspicious patterns
+    if (template.includes('__proto__') || template.includes('constructor')) {
+      warnings.push('Template contains potentially dangerous property access');
+    }
+    
+    return { valid: errors.length === 0, errors, warnings };
+  }
+
+  /**
+   * Get required variables for a template type
+   * @param {string} templateType - Type of template
+   * @returns {string[]} Array of required variable names
+   */
+  getRequiredVariables(templateType) {
+    return this.requiredVariables[templateType] || [];
+  }
+
+  /**
+   * Add custom required variables for a template type
+   * @param {string} templateType - Type of template
+   * @param {string[]} variables - Additional required variables
+   */
+  addRequiredVariables(templateType, variables) {
+    if (!this.requiredVariables[templateType]) {
+      this.requiredVariables[templateType] = [];
+    }
+    this.requiredVariables[templateType].push(...variables);
+  }
+}
+
+module.exports = TemplateValidator;