aios-core 2.1.0

package/.aios-core/development/tasks/test-validation-task.md

@@ -0,0 +1,171 @@
+---
+
+## Execution Modes
+
+**Choose your execution mode:**
+
+### 1. YOLO Mode - Fast, Autonomous (0-1 prompts)
+- Autonomous decision making with logging
+- Minimal user interaction
+- **Best for:** Simple, deterministic tasks
+
+### 2. Interactive Mode - Balanced, Educational (5-10 prompts) **[DEFAULT]**
+- Explicit decision checkpoints
+- Educational explanations
+- **Best for:** Learning, complex decisions
+
+### 3. Pre-Flight Planning - Comprehensive Upfront Planning
+- Task analysis phase (identify all ambiguities)
+- Zero ambiguity execution
+- **Best for:** Ambiguous requirements, critical work
+
+**Parameter:** `mode` (optional, default: `interactive`)
+
+---
+
+## Task Definition (AIOS Task Format V2.0)
+
+```yaml
+task: testValidationTask()
+responsável: Dex (Dev Agent)
+responsavel_type: Agente
+atomic_layer: Test
+
+**Entrada:**
+- campo: test_input
+  tipo: string
+  origem: User Input
+  obrigatório: false
+  validação: Optional test input parameter
+
+**Saída:**
+- campo: validation_result
+  tipo: object
+  destino: Memory
+  persistido: false
+
+- campo: success
+  tipo: boolean
+  destino: Return value
+  persistido: false
+```
+
+---
+
+## Pre-Conditions
+
+**Purpose:** Validate prerequisites BEFORE task execution (blocking)
+
+**Checklist:**
+
+```yaml
+pre-conditions:
+  - [ ] Test environment available
+    tipo: pre-condition
+    blocker: true
+    validação: |
+      Verify test environment is available
+    error_message: "Pre-condition failed: Test environment not available"
+```
+
+---
+
+## Post-Conditions
+
+**Purpose:** Validate execution success AFTER task completes
+
+**Checklist:**
+
+```yaml
+post-conditions:
+  - [ ] Validation completed successfully
+    tipo: post-condition
+    blocker: true
+    validação: |
+      Verify validation completed successfully
+    error_message: "Post-condition failed: Validation did not complete successfully"
+```
+
+---
+
+## Acceptance Criteria
+
+**Purpose:** Definitive pass/fail criteria for task completion
+
+**Checklist:**
+
+```yaml
+acceptance-criteria:
+  - [ ] Task executed successfully
+    tipo: acceptance-criterion
+    blocker: true
+    validação: |
+      Assert task executed successfully
+    error_message: "Acceptance criterion not met: Task did not execute successfully"
+```
+
+---
+
+## Purpose
+
+This is a test task created for validating the `create-task` task execution. It provides minimal functionality to test task creation workflow.
+
+## Implementation
+
+1. **Validate Inputs**
+   - Check test input if provided
+   - Validate environment
+
+2. **Execute Validation**
+   - Perform simple validation test
+   - Return success status
+
+3. **Output Result**
+   - Return validation result
+   - Log execution
+
+## Error Handling
+
+**Strategy:** abort
+
+**Common Errors:**
+
+1. **Error:** Test Environment Not Available
+   - **Cause:** Test environment not configured
+   - **Resolution:** Ensure test environment is available
+   - **Recovery:** Log error and abort
+
+---
+
+## Performance
+
+**Expected Metrics:**
+
+```yaml
+duration_expected: < 1 min
+cost_estimated: $0.0001
+token_usage: ~100-200 tokens
+```
+
+---
+
+## Metadata
+
+```yaml
+story: STORY-6.1.7.2
+version: 1.0.0
+dependencies:
+  - N/A
+tags:
+  - test
+  - validation
+updated_at: 2025-01-17
+```
+
+---
+
+**Created By:** Dex (Dev Agent)  
+**Created Date:** 2025-01-17  
+**Purpose:** Test task for validating create-task task execution  
+**Status:** Test/Validation Only
+

package/.aios-core/development/tasks/undo-last.md

@@ -0,0 +1,347 @@
+---
+# No checklists needed - rollback operation with built-in transaction validation
+---
+
+# Task: Undo Last Component Operation
+
+**Task ID:** undo-last  
+**Agent:** aios-developer  
+**Version:** 1.0
+
+## Execution Modes
+
+**Choose your execution mode:**
+
+### 1. YOLO Mode - Fast, Autonomous (0-1 prompts)
+- Autonomous decision making with logging
+- Minimal user interaction
+- **Best for:** Simple, deterministic tasks
+
+### 2. Interactive Mode - Balanced, Educational (5-10 prompts) **[DEFAULT]**
+- Explicit decision checkpoints
+- Educational explanations
+- **Best for:** Learning, complex decisions
+
+### 3. Pre-Flight Planning - Comprehensive Upfront Planning
+- Task analysis phase (identify all ambiguities)
+- Zero ambiguity execution
+- **Best for:** Ambiguous requirements, critical work
+
+**Parameter:** `mode` (optional, default: `interactive`)
+
+---
+
+## Task Definition (AIOS Task Format V1.0)
+
+```yaml
+task: undoLast()
+responsável: Dex (Builder)
+responsavel_type: Agente
+atomic_layer: Atom
+
+**Entrada:**
+- campo: target
+  tipo: string
+  origem: User Input
+  obrigatório: true
+  validação: Must exist
+
+- campo: version
+  tipo: string
+  origem: User Input
+  obrigatório: false
+  validação: Target version or timestamp
+
+**Saída:**
+- campo: restored_state
+  tipo: object
+  destino: File system
+  persistido: true
+
+- campo: rollback_log
+  tipo: array
+  destino: File (.ai/rollback/*)
+  persistido: true
+```
+
+---
+
+## Pre-Conditions
+
+**Purpose:** Validate prerequisites BEFORE task execution (blocking)
+
+**Checklist:**
+
+```yaml
+pre-conditions:
+  - [ ] Backup exists; rollback target valid
+    tipo: pre-condition
+    blocker: true
+    validação: |
+      Check backup exists; rollback target valid
+    error_message: "Pre-condition failed: Backup exists; rollback target valid"
+```
+
+---
+
+## Post-Conditions
+
+**Purpose:** Validate execution success AFTER task completes
+
+**Checklist:**
+
+```yaml
+post-conditions:
+  - [ ] State restored; integrity verified; no data loss
+    tipo: post-condition
+    blocker: true
+    validação: |
+      Verify state restored; integrity verified; no data loss
+    error_message: "Post-condition failed: State restored; integrity verified; no data loss"
+```
+
+---
+
+## Acceptance Criteria
+
+**Purpose:** Definitive pass/fail criteria for task completion
+
+**Checklist:**
+
+```yaml
+acceptance-criteria:
+  - [ ] Original state restored; no residual changes
+    tipo: acceptance-criterion
+    blocker: true
+    validação: |
+      Assert original state restored; no residual changes
+    error_message: "Acceptance criterion not met: Original state restored; no residual changes"
+```
+
+---
+
+## Tools
+
+**External/shared resources used by this task:**
+
+- **Tool:** backup-manager
+  - **Purpose:** Backup and restore operations
+  - **Source:** .aios-core/utils/backup-manager.js
+
+- **Tool:** version-control
+  - **Purpose:** Git operations for rollback
+  - **Source:** npm: simple-git
+
+---
+
+## Scripts
+
+**Agent-specific code for this task:**
+
+- **Script:** rollback-changes.js
+  - **Purpose:** Rollback to previous state
+  - **Language:** JavaScript
+  - **Location:** .aios-core/scripts/rollback-changes.js
+
+---
+
+## Error Handling
+
+**Strategy:** retry
+
+**Common Errors:**
+
+1. **Error:** Backup Not Found
+   - **Cause:** No backup exists for target version
+   - **Resolution:** Verify backup location and version
+   - **Recovery:** List available backups, abort if none
+
+2. **Error:** Rollback Failed
+   - **Cause:** Error restoring previous state
+   - **Resolution:** Check backup integrity and permissions
+   - **Recovery:** Preserve current state, log failure
+
+---
+
+## Performance
+
+**Expected Metrics:**
+
+```yaml
+duration_expected: 0.5-2 min (estimated)
+cost_estimated: $0.0001-0.0005
+token_usage: ~500-1,000 tokens
+```
+
+**Optimization Notes:**
+- Minimize external dependencies; cache results if reusable; validate inputs early
+
+---
+
+## Metadata
+
+```yaml
+story: N/A
+version: 1.0.0
+dependencies:
+  - N/A
+tags:
+  - automation
+  - workflow
+updated_at: 2025-11-17
+```
+
+---
+
+
+## Description
+
+Rollback the last component creation or modification operation. This task allows undoing recent changes made by the aios-developer agent, including single component creation, batch creation, or component updates.
+
+## Context Required
+- Access to transaction history
+- File system permissions for affected files
+- Manifest write permissions
+
+## Prerequisites
+- Transaction logging enabled
+- Backup files available
+- No conflicting operations since last transaction
+
+## Input Requirements
+- Optional: Transaction ID to rollback (defaults to last transaction)
+- Optional: Selective rollback options
+
+## Process Flow
+
+### Step 1: Identify Transaction
+Locate the most recent transaction or use provided transaction ID.
+
+**Actions:**
+- Query transaction history
+- Display transaction details
+- Confirm rollback intent
+
+**Validation:**
+- Transaction exists and is rollbackable
+- User confirms the operation
+
+### Step 2: Analyze Changes
+Review all changes made in the transaction.
+
+**Actions:**
+- List all file operations
+- Show manifest changes
+- Display component metadata updates
+
+**Output Format:**
+```
+Transaction: txn-1234567890-abcd
+Type: component_creation
+Date: 2025-01-31T10:30:00Z
+Operations:
+  - Created: /aios-core/agents/data-analyst.md
+  - Updated: /aios-core/team-manifest.yaml
+  - Created: /aios-core/tasks/analyze-data.md
+```
+
+### Step 3: Execute Rollback
+Perform the rollback operation with proper error handling.
+
+**Actions:**
+- Restore file backups
+- Revert manifest changes
+- Update component metadata
+- Clean up orphaned files
+
+**Error Handling:**
+- Handle missing backup files
+- Manage partial rollback scenarios
+- Report rollback failures
+
+### Step 4: Verify Rollback
+Ensure all changes have been properly reverted.
+
+**Actions:**
+- Verify file states
+- Check manifest integrity
+- Validate component consistency
+
+**Success Criteria:**
+- All files restored to previous state
+- Manifest accurately reflects changes
+- No orphaned references remain
+
+## Output
+
+### Success Response
+```
+✅ Rollback completed successfully!
+
+Transaction: txn-1234567890-abcd
+Rolled back:
+  - ✓ Removed: data-analyst.md
+  - ✓ Restored: team-manifest.yaml
+  - ✓ Removed: analyze-data.md
+  
+Total operations: 3
+Successful: 3
+Failed: 0
+```
+
+### Failure Response
+```
+❌ Rollback partially failed
+
+Transaction: txn-1234567890-abcd
+Results:
+  - ✓ Removed: data-analyst.md
+  - ✗ Failed to restore: team-manifest.yaml (backup not found)
+  - ✓ Removed: analyze-data.md
+
+Please manually review and fix failed operations.
+```
+
+## Error Handling
+
+### Common Errors
+1. **Transaction Not Found**
+   - Display available transactions
+   - Suggest checking transaction ID
+
+2. **Backup Files Missing**
+   - Warn about incomplete rollback
+   - Provide manual recovery steps
+
+3. **Concurrent Modifications**
+   - Detect file changes since transaction
+   - Prompt for force rollback option
+
+## Security Considerations
+- Verify user has permission to rollback
+- Prevent rollback of system transactions
+- Maintain audit trail of rollback operations
+- Validate file paths to prevent traversal
+
+## Performance Notes
+- Load only necessary transaction data
+- Stream large backup files
+- Batch file operations for efficiency
+
+## Dependencies
+- TransactionManager utility
+- File system access
+- Backup storage system
+
+## Notes
+- Rollback is only available for recent transactions (within retention period)
+- Some operations may not be fully reversible
+- Always creates a new transaction for the rollback itself
+- Supports selective rollback for batch operations
+
+## Related Tasks
+- create-agent
+- create-task
+- create-workflow
+- create-suite
+- update-manifest