aios-core 3.7.0 → 3.9.1

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

@@ -0,0 +1,82 @@
+# {{COMPONENTNAME}} Checklist
+
+> {{DESCRIPTION}}
+> Squad: {{SQUADNAME}}
+> Created: {{CREATEDAT}}
+{{#IF STORYID}}
+> Story: {{STORYID}}
+{{/IF}}
+
+---
+
+## Pre-Conditions
+
+Before starting, verify:
+
+- [ ] Pre-condition 1
+- [ ] Pre-condition 2
+- [ ] Pre-condition 3
+
+---
+
+## Checklist Items
+
+### Category 1: Setup
+
+| # | Item | Status | Notes |
+|---|------|--------|-------|
+| 1.1 | Item description | [ ] | |
+| 1.2 | Item description | [ ] | |
+| 1.3 | Item description | [ ] | |
+
+### Category 2: Implementation
+
+| # | Item | Status | Notes |
+|---|------|--------|-------|
+| 2.1 | Item description | [ ] | |
+| 2.2 | Item description | [ ] | |
+| 2.3 | Item description | [ ] | |
+
+### Category 3: Validation
+
+| # | Item | Status | Notes |
+|---|------|--------|-------|
+| 3.1 | Item description | [ ] | |
+| 3.2 | Item description | [ ] | |
+| 3.3 | Item description | [ ] | |
+
+---
+
+## Post-Conditions
+
+After completion, verify:
+
+- [ ] Post-condition 1
+- [ ] Post-condition 2
+- [ ] Post-condition 3
+
+---
+
+## Sign-off
+
+| Role | Name | Date | Signature |
+|------|------|------|-----------|
+| Creator | | | |
+| Reviewer | | | |
+| Approver | | | |
+
+---
+
+## Usage
+
+```bash
+# Use this checklist with:
+*checklist {{COMPONENTNAME}}
+
+# Or reference in tasks:
+checklist: {{COMPONENTNAME}}.md
+```
+
+---
+
+*Checklist created by squad-creator*

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

@@ -0,0 +1,105 @@
+# {{COMPONENTNAME}} Data
+#
+# {{DESCRIPTION}}
+#
+# Squad: {{SQUADNAME}}
+# Created: {{CREATEDAT}}
+# Story: {{STORYID}}
+
+name: {{COMPONENTNAME}}
+version: 1.0.0
+description: {{DESCRIPTION}}
+
+# Metadata
+metadata:
+  created: {{CREATEDAT}}
+  author: squad-creator
+  squad: {{SQUADNAME}}
+  tags:
+    - data
+    - {{SQUADNAME}}
+
+# Data schema definition
+schema:
+  type: object
+  required:
+    - id
+    - name
+  properties:
+    id:
+      type: string
+      description: "Unique identifier"
+      pattern: "^[a-z][a-z0-9-]*$"
+    name:
+      type: string
+      description: "Display name"
+      minLength: 1
+      maxLength: 100
+    description:
+      type: string
+      description: "Optional description"
+    enabled:
+      type: boolean
+      description: "Whether this entry is enabled"
+      default: true
+    priority:
+      type: integer
+      description: "Priority level (1-10)"
+      minimum: 1
+      maximum: 10
+      default: 5
+    metadata:
+      type: object
+      description: "Additional metadata"
+      additionalProperties: true
+
+# Default values for new entries
+defaults:
+  enabled: true
+  priority: 5
+  metadata: {}
+
+# Validation rules
+validation:
+  - rule: "id must be unique"
+    check: "unique(entries.id)"
+  - rule: "name must not be empty"
+    check: "length(name) > 0"
+
+# Data entries
+entries:
+  - id: example-1
+    name: "Example Entry 1"
+    description: "This is an example entry"
+    enabled: true
+    priority: 5
+    metadata:
+      category: example
+
+  - id: example-2
+    name: "Example Entry 2"
+    description: "Another example entry"
+    enabled: true
+    priority: 3
+    metadata:
+      category: example
+
+# Usage examples
+usage:
+  load: |
+    const yaml = require('js-yaml');
+    const fs = require('fs');
+    const data = yaml.load(fs.readFileSync('{{COMPONENTNAME}}.yaml', 'utf8'));
+    console.log(data.entries);
+
+  query: |
+    const activeEntries = data.entries.filter(e => e.enabled);
+    const highPriority = data.entries.filter(e => e.priority >= 7);
+
+  add_entry: |
+    data.entries.push({
+      id: 'new-entry',
+      name: 'New Entry',
+      enabled: true,
+      priority: 5,
+    });

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,
+};