aios-core 3.6.0 → 3.8.0

package/.aios-core/development/templates/squad/script-template.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+/**
+ * {{COMPONENTNAME}} Script
+ *
+ * {{DESCRIPTION}}
+ *
+ * Squad: {{SQUADNAME}}
+ * Created: {{CREATEDAT}}
+ *
+ * Usage:
+ *   node {{COMPONENTNAME}}.js [options]
+ *
+ * Options:
+ *   --help, -h     Show this help message
+ *   --verbose, -v  Enable verbose output
+ *   --dry-run      Preview changes without applying
+ *
+ * @module {{COMPONENTNAME}}
+ * @version 1.0.0
+ * @see {{STORYID}}
+ */
+
+'use strict';
+
+const fs = require('fs').promises;
+const path = require('path');
+
+/**
+ * Script configuration
+ */
+const CONFIG = {
+  name: '{{COMPONENTNAME}}',
+  version: '1.0.0',
+};
+
+/**
+ * Parse command line arguments
+ *
+ * @param {string[]} args - Command line arguments
+ * @returns {Object} Parsed options
+ */
+function parseArgs(args) {
+  const options = {
+    help: false,
+    verbose: false,
+    dryRun: false,
+    args: [],
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (arg === '--verbose' || arg === '-v') {
+      options.verbose = true;
+    } else if (arg === '--dry-run') {
+      options.dryRun = true;
+    } else if (!arg.startsWith('-')) {
+      options.args.push(arg);
+    }
+  }
+
+  return options;
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log(`
+${CONFIG.name} v${CONFIG.version}
+
+{{DESCRIPTION}}
+
+Usage:
+  node ${CONFIG.name}.js [options] [arguments]
+
+Options:
+  --help, -h     Show this help message
+  --verbose, -v  Enable verbose output
+  --dry-run      Preview changes without applying
+
+Examples:
+  node ${CONFIG.name}.js
+  node ${CONFIG.name}.js --verbose
+  node ${CONFIG.name}.js --dry-run
+`);
+}
+
+/**
+ * Log message if verbose mode is enabled
+ *
+ * @param {string} message - Message to log
+ * @param {boolean} verbose - Verbose mode flag
+ */
+function log(message, verbose) {
+  if (verbose) {
+    console.log(`[${CONFIG.name}] ${message}`);
+  }
+}
+
+/**
+ * Main script execution
+ *
+ * @param {Object} options - Script options
+ * @returns {Promise<Object>} Execution result
+ */
+async function execute(options) {
+  log('Starting execution...', options.verbose);
+
+  // Implementation here
+  const result = {
+    success: true,
+    message: 'Script completed successfully',
+    data: {},
+  };
+
+  // Step 1: Initialize
+  log('Step 1: Initializing...', options.verbose);
+
+  // Step 2: Process
+  log('Step 2: Processing...', options.verbose);
+
+  if (options.dryRun) {
+    log('Dry run mode - no changes applied', options.verbose);
+  }
+
+  // Step 3: Complete
+  log('Step 3: Completing...', options.verbose);
+
+  return result;
+}
+
+/**
+ * Main entry point
+ *
+ * @param {string[]} args - Command line arguments
+ */
+async function main(args) {
+  const options = parseArgs(args);
+
+  if (options.help) {
+    showHelp();
+    return;
+  }
+
+  console.log(`${CONFIG.name} v${CONFIG.version}`);
+  console.log('');
+
+  try {
+    const result = await execute(options);
+
+    if (result.success) {
+      console.log('Success:', result.message);
+    } else {
+      console.error('Failed:', result.message);
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error('Error:', error.message);
+    if (options.verbose) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+// Run if called directly
+if (require.main === module) {
+  main(process.argv.slice(2));
+}
+
+module.exports = {
+  main,
+  execute,
+  parseArgs,
+};

package/.aios-core/development/templates/squad/task-template.md

@@ -0,0 +1,125 @@
+---
+task: {{COMPONENTNAME}}
+responsavel: "@{{AGENTID}}"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: input_param
+    tipo: string
+    origem: User Input
+    obrigatorio: true
+    validacao: "Describe validation rules"
+
+Saida:
+  - campo: result
+    tipo: object
+    destino: Return value
+    persistido: false
+
+Checklist:
+  - "[ ] Step 1: Describe first step"
+  - "[ ] Step 2: Describe second step"
+  - "[ ] Step 3: Describe third step"
+---
+
+# {{COMPONENTNAME}}
+
+## Purpose
+
+{{DESCRIPTION}}
+
+{{#IF STORYID}}
+## Story Reference
+
+- **Story:** {{STORYID}}
+- **Squad:** {{SQUADNAME}}
+{{/IF}}
+
+## Pre-Conditions
+
+```yaml
+pre-conditions:
+  - [ ] Pre-condition 1
+    tipo: pre-condition
+    blocker: true
+    validacao: |
+      Describe what to validate
+    error_message: "Error message if pre-condition fails"
+```
+
+## Execution Steps
+
+### Step 1: Initialize
+
+```javascript
+// Implementation here
+const { Dependency } = require('./path/to/dependency');
+
+async function step1() {
+  // Step 1 logic
+}
+```
+
+### Step 2: Process
+
+```javascript
+async function step2() {
+  // Step 2 logic
+}
+```
+
+### Step 3: Complete
+
+```javascript
+async function step3() {
+  // Step 3 logic
+  return {
+    success: true,
+    data: {},
+  };
+}
+```
+
+## Error Handling
+
+### Error 1: Description
+
+```yaml
+error: ERROR_CODE
+cause: Description of cause
+resolution: How to resolve
+recovery: Suggested recovery action
+```
+
+## Post-Conditions
+
+```yaml
+post-conditions:
+  - [ ] Result is valid
+    tipo: post-condition
+    blocker: true
+    validacao: |
+      Describe validation
+    error_message: "Error message if post-condition fails"
+```
+
+## Metadata
+
+```yaml
+{{#IF STORYID}}
+story: {{STORYID}}
+{{/IF}}
+version: 1.0.0
+created: {{CREATEDAT}}
+updated: {{CREATEDAT}}
+author: squad-creator
+tags:
+  - {{SQUADNAME}}
+  - {{COMPONENTNAME}}
+```
+
+---
+
+*Task definition created by squad-creator*

package/.aios-core/development/templates/squad/template-template.md

@@ -0,0 +1,97 @@
+# {{COMPONENTNAME}} Template
+
+> {{DESCRIPTION}}
+> Squad: {{SQUADNAME}}
+> Created: {{CREATEDAT}}
+{{#IF STORYID}}
+> Story: {{STORYID}}
+{{/IF}}
+
+---
+
+## Template Variables
+
+| Variable | Type | Required | Description |
+|----------|------|----------|-------------|
+| `{{VAR1}}` | string | Yes | Description of variable 1 |
+| `{{VAR2}}` | string | No | Description of variable 2 |
+| `{{VAR3}}` | date | No | Description of variable 3 |
+
+---
+
+## Usage
+
+```javascript
+const { renderTemplate } = require('.aios-core/infrastructure/scripts/template-engine');
+
+const result = await renderTemplate('{{COMPONENTNAME}}.md', {
+  VAR1: 'value1',
+  VAR2: 'value2',
+  VAR3: new Date().toISOString(),
+});
+```
+
+---
+
+## Template Content
+
+<!-- BEGIN TEMPLATE -->
+
+# {{VAR1}}
+
+> Created: {{VAR3}}
+
+## Section 1
+
+{{VAR2}}
+
+### Subsection 1.1
+
+Content here...
+
+### Subsection 1.2
+
+Content here...
+
+## Section 2
+
+Additional content...
+
+## Section 3
+
+Final content...
+
+---
+
+*Generated from {{COMPONENTNAME}} template*
+
+<!-- END TEMPLATE -->
+
+---
+
+## Examples
+
+### Example 1: Basic Usage
+
+```javascript
+const result = await renderTemplate('{{COMPONENTNAME}}.md', {
+  VAR1: 'My Document',
+  VAR2: 'This is the introduction text.',
+  VAR3: '2025-01-01',
+});
+```
+
+### Example 2: With Conditionals
+
+```javascript
+const result = await renderTemplate('{{COMPONENTNAME}}.md', {
+  VAR1: 'My Document',
+  VAR2: 'Introduction',
+  VAR3: new Date().toISOString(),
+  INCLUDE_EXTRA: true,
+});
+```
+
+---
+
+*Template created by squad-creator*

package/.aios-core/development/templates/squad/tool-template.js

@@ -0,0 +1,103 @@
+/**
+ * {{COMPONENTNAME}} Tool
+ *
+ * {{DESCRIPTION}}
+ *
+ * Squad: {{SQUADNAME}}
+ * Created: {{CREATEDAT}}
+ *
+ * @module {{COMPONENTNAME}}
+ * @version 1.0.0
+ * @see {{STORYID}}
+ */
+
+'use strict';
+
+/**
+ * Configuration for the tool
+ * @constant {Object}
+ */
+const CONFIG = {
+  name: '{{COMPONENTNAME}}',
+  version: '1.0.0',
+  description: '{{DESCRIPTION}}',
+};
+
+/**
+ * Main function for {{COMPONENTNAME}}
+ *
+ * @param {Object} input - Input parameters
+ * @param {string} input.param1 - First parameter
+ * @param {Object} [options={}] - Optional configuration
+ * @returns {Object} Result object with success status and data
+ *
+ * @example
+ * const result = await {{CAMELCASE_NAME}}({
+ *   param1: 'value1',
+ * });
+ * console.log(result.data);
+ */
+async function {{CAMELCASE_NAME}}(input, options = {}) {
+  // Validate input
+  if (!input || typeof input !== 'object') {
+    return {
+      success: false,
+      error: 'Invalid input: expected object',
+    };
+  }
+
+  try {
+    // Implementation here
+    const result = {
+      // Process input and generate output
+    };
+
+    return {
+      success: true,
+      data: result,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message,
+    };
+  }
+}
+
+/**
+ * Helper function 1
+ *
+ * @private
+ * @param {*} value - Value to process
+ * @returns {*} Processed value
+ */
+function _helperFunction1(value) {
+  // Helper implementation
+  return value;
+}
+
+/**
+ * Helper function 2
+ *
+ * @private
+ * @param {Object} data - Data to transform
+ * @returns {Object} Transformed data
+ */
+function _helperFunction2(data) {
+  // Helper implementation
+  return data;
+}
+
+/**
+ * Get tool information
+ *
+ * @returns {Object} Tool configuration
+ */
+function getInfo() {
+  return CONFIG;
+}
+
+module.exports = {
+  {{CAMELCASE_NAME}},
+  getInfo,
+};

package/.aios-core/development/templates/squad/workflow-template.yaml

@@ -0,0 +1,108 @@
+# {{COMPONENTNAME}} Workflow
+#
+# {{DESCRIPTION}}
+#
+# Created: {{CREATEDAT}}
+# Story: {{STORYID}}
+
+name: {{COMPONENTNAME}}
+version: 1.0.0
+description: {{DESCRIPTION}}
+squad: {{SQUADNAME}}
+
+# Metadata
+metadata:
+  created: {{CREATEDAT}}
+  author: squad-creator
+  tags:
+    - workflow
+    - {{SQUADNAME}}
+
+# Trigger conditions
+triggers:
+  - type: manual
+    command: "*{{COMPONENTNAME}}"
+  # - type: event
+  #   event: some-event-name
+  # - type: schedule
+  #   cron: "0 0 * * *"
+
+# Input parameters
+inputs:
+  - name: param1
+    type: string
+    required: true
+    description: "Description of parameter 1"
+  - name: param2
+    type: string
+    required: false
+    default: "default-value"
+    description: "Description of parameter 2"
+
+# Workflow steps
+steps:
+  - id: step-1
+    name: "Step 1: Initialize"
+    description: "Initialize the workflow"
+    action: task
+    task: task-name-1
+    inputs:
+      param: "{{inputs.param1}}"
+    on_error: abort
+
+  - id: step-2
+    name: "Step 2: Process"
+    description: "Main processing step"
+    action: task
+    task: task-name-2
+    depends_on:
+      - step-1
+    inputs:
+      data: "{{steps.step-1.output}}"
+    on_error: retry
+    retry:
+      max_attempts: 3
+      delay: 1000
+
+  - id: step-3
+    name: "Step 3: Finalize"
+    description: "Finalize the workflow"
+    action: task
+    task: task-name-3
+    depends_on:
+      - step-2
+    condition: "{{steps.step-2.success}}"
+
+# Conditional branches (optional)
+# branches:
+#   - condition: "{{steps.step-2.output.type == 'a'}}"
+#     steps:
+#       - id: branch-a-step
+#         name: "Branch A Step"
+#         action: task
+#         task: branch-a-task
+
+# Output definition
+outputs:
+  - name: result
+    from: "{{steps.step-3.output}}"
+    description: "Final workflow result"
+
+# Completion handlers
+completion:
+  on_success:
+    message: "Workflow '{{COMPONENTNAME}}' completed successfully"
+    notify: false
+  on_failure:
+    message: "Workflow '{{COMPONENTNAME}}' failed"
+    notify: true
+    rollback: true
+
+# Validation
+validation:
+  pre_run:
+    - "Check all required inputs are provided"
+    - "Validate input formats"
+  post_run:
+    - "Verify output is valid"
+    - "Log completion metrics"

package/.aios-core/infrastructure/scripts/ide-sync/agent-parser.js

@@ -209,6 +209,46 @@ function parseAllAgents(agentsDir) {
   return agents;
 }
 
+/**
+ * Normalize commands to consistent format
+ * Handles both { name, description } and { "cmd-name": "description" } formats
+ * @param {object[]} commands - Array of command objects (may be in various formats)
+ * @returns {object[]} - Normalized command objects with name, description, visibility
+ */
+function normalizeCommands(commands) {
+  if (!Array.isArray(commands)) return [];
+
+  return commands.map(cmd => {
+    // Already in proper format with name property
+    if (cmd.name && typeof cmd.name === 'string') {
+      return {
+        name: cmd.name,
+        description: cmd.description || 'No description',
+        visibility: cmd.visibility || ['full', 'quick'],
+      };
+    }
+
+    // Shorthand format: { "cmd-name": "description text" }
+    const keys = Object.keys(cmd);
+    if (keys.length === 1) {
+      const name = keys[0];
+      const description = cmd[name];
+      return {
+        name: name,
+        description: typeof description === 'string' ? description : 'No description',
+        visibility: ['full', 'quick'],
+      };
+    }
+
+    // Unknown format - try to extract what we can
+    return {
+      name: cmd.name || 'unknown',
+      description: cmd.description || 'No description',
+      visibility: cmd.visibility || ['full', 'quick'],
+    };
+  });
+}
+
 /**
  * Get visibility-filtered commands
  * @param {object[]} commands - Array of command objects
@@ -218,7 +258,10 @@ function parseAllAgents(agentsDir) {
 function getVisibleCommands(commands, visibility) {
   if (!Array.isArray(commands)) return [];
 
-  return commands.filter(cmd => {
+  // First normalize the commands to ensure consistent format
+  const normalized = normalizeCommands(commands);
+
+  return normalized.filter(cmd => {
     if (!cmd.visibility) return true; // Include if no visibility defined
     return cmd.visibility.includes(visibility);
   });
@@ -246,6 +289,7 @@ module.exports = {
   extractSection,
   parseAgentFile,
   parseAllAgents,
+  normalizeCommands,
   getVisibleCommands,
   formatCommandsList,
 };

package/.aios-core/infrastructure/scripts/ide-sync/transformers/antigravity.js

@@ -6,7 +6,7 @@
  * Target: .antigravity/rules/agents/*.md
  */
 
-const { getVisibleCommands } = require('../agent-parser');
+const { getVisibleCommands, normalizeCommands } = require('../agent-parser');
 
 /**
  * Transform agent data to Antigravity format
@@ -23,9 +23,10 @@ function transform(agentData) {
   const whenToUse = agent.whenToUse || 'Use this agent for specific tasks';
   const archetype = persona.archetype || '';
 
-  // Get quick visibility commands
-  const quickCommands = getVisibleCommands(agentData.commands, 'quick');
-  const keyCommands = getVisibleCommands(agentData.commands, 'key');
+  // Get quick visibility commands (normalized to consistent format)
+  const allCommands = normalizeCommands(agentData.commands || []);
+  const quickCommands = getVisibleCommands(allCommands, 'quick');
+  const keyCommands = getVisibleCommands(allCommands, 'key');
 
   // Build content (similar to Cursor)
   let content = `# ${name} (@${agentData.id})
@@ -61,8 +62,7 @@ ${icon} **${title}**${archetype ? ` | ${archetype}` : ''}
     content += '\n';
   }
 
-  // Add all commands for reference
-  const allCommands = agentData.commands || [];
+  // Add all commands for reference (allCommands already normalized above)
   if (allCommands.length > quickCommands.length + keyOnlyCommands.length) {
     content += `## All Commands