aios-core 1.0.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/development/workflows/README.md

@@ -0,0 +1,84 @@
+# AIOS Workflows
+
+This directory contains workflow definitions for the Synkra AIOS framework. Workflows define multi-step processes that can be executed by AIOS agents.
+
+## Available Workflows
+
+### Development Workflows
+- **brownfield-fullstack.md** - Workflow for existing full-stack projects
+- **brownfield-service.md** - Workflow for existing service/backend projects
+- **brownfield-ui.md** - Workflow for existing UI/frontend projects
+- **greenfield-fullstack.md** - Workflow for new full-stack projects
+- **greenfield-service.md** - Workflow for new service/backend projects
+- **greenfield-ui.md** - Workflow for new UI/frontend projects
+
+### Configuration Workflows
+- **setup-environment.yaml** - Configure IDE (Windsurf/Cursor/Claude Code) with AIOS development rules
+
+## Setup Environment Workflow
+
+The `setup-environment` workflow helps developers configure their IDE for optimal AIOS development experience.
+
+### Features
+- Detects installed IDEs (Windsurf, Cursor, Claude Code)
+- Backs up existing IDE configurations
+- Applies AIOS-specific development rules
+- Verifies GitHub CLI installation and authentication
+- Provides clear feedback throughout the process
+
+### Usage
+
+From the aios-master agent:
+```
+@aios-master
+*setup-environment
+```
+
+Or directly via npm:
+```bash
+npm run setup:environment
+```
+
+### What It Does
+1. **IDE Detection** - Scans for `.windsurf/`, `.cursor/`, or `.claude/` directories
+2. **GitHub CLI Check** - Ensures GitHub CLI is installed and authenticated
+3. **Backup Creation** - Saves existing rules before making changes
+4. **Rule Application** - Copies AIOS-specific rules to appropriate locations
+5. **Verification** - Confirms successful setup
+
+### IDE Rule Locations
+- **Windsurf**: `.windsurf/rules`
+- **Cursor**: `.cursorules`
+- **Claude Code**: `.claude/CLAUDE.md`
+
+### Requirements
+- Node.js 18+
+- One or more supported IDEs installed
+- GitHub CLI (recommended)
+
+## Creating New Workflows
+
+Workflows can be defined in YAML or Markdown format with YAML frontmatter. See existing workflows for examples.
+
+### Workflow Structure
+```yaml
+workflow:
+  id: unique-workflow-id
+  name: Human-readable name
+  description: What this workflow does
+  type: configuration|development|deployment
+  metadata:
+    elicit: true  # If user interaction required
+    confirmation_required: true
+  steps:
+    - id: step-1
+      name: Step name
+      description: What this step does
+```
+
+## Best Practices
+1. Keep workflows focused on a single objective
+2. Include error handling for each step
+3. Provide clear user feedback
+4. Make workflows idempotent when possible
+5. Document prerequisites and outcomes