aiox-core 5.0.4 → 5.0.5

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

@@ -5,104 +5,119 @@
 # Created: {{CREATEDAT}}
 # Story: {{STORYID}}
 
-name: {{COMPONENTNAME}}
-version: 1.0.0
-description: {{DESCRIPTION}}
-squad: {{SQUADNAME}}
+workflow:
+  id: "{{COMPONENTNAME}}"
+  name: "{{COMPONENTNAME}}"
+  version: "1.0.0"
+  description: "{{DESCRIPTION}}"
+  type: development
+  scope: "{{SQUADNAME}}"
 
-# Metadata
-metadata:
-  created: {{CREATEDAT}}
-  author: squad-creator
-  tags:
-    - workflow
-    - {{SQUADNAME}}
+  metadata:
+    created: "{{CREATEDAT}}"
+    author: squad-creator
+    story: "{{STORYID}}"
+    tags:
+      - workflow
+      - "{{SQUADNAME}}"
 
-# Trigger conditions
-triggers:
-  - type: manual
-    command: "*{{COMPONENTNAME}}"
-  # - type: event
-  #   event: some-event-name
-  # - type: schedule
-  #   cron: "0 0 * * *"
+  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"
+  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
+  # Optional compatibility metadata for non-executable phase grouping.
+  phases:
+    - phase_1: Initialize
+    - phase_2: Process
+    - phase_3: Finalize
 
-  - 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
+  # Canonical executable contract (official): workflow.sequence[]
+  sequence:
+    - step: initialize
+      id: init
+      phase: 1
+      phase_name: "Initialize"
+      agent: "{{SQUADNAME}}-chief"
+      action: "Initialize the workflow"
+      task: "task-name-1"
+      inputs:
+        param: "{{inputs.param1}}"
+      outputs:
+        - init_output
+      next: process
+      on_failure: abort
 
-  - 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}}"
+    - step: process
+      id: process
+      phase: 2
+      phase_name: "Process"
+      agent: "{{SQUADNAME}}-chief"
+      action: "Execute main processing step"
+      task: "task-name-2"
+      requires: init
+      inputs:
+        data: "{{init_output}}"
+      outputs:
+        - process_output
+      next: finalize
+      on_failure: retry
 
-# 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
+    - step: finalize
+      id: finalize
+      phase: 3
+      phase_name: "Finalize"
+      agent: "{{SQUADNAME}}-chief"
+      action: "Finalize workflow execution"
+      task: "task-name-3"
+      requires: process
+      inputs:
+        data: "{{process_output}}"
+      outputs:
+        - workflow_result
+      on_complete:
+        status: success
 
-# Output definition
-outputs:
-  - name: result
-    from: "{{steps.step-3.output}}"
-    description: "Final workflow result"
+    - workflow_end: true
+      id: complete
+      action: "workflow_complete"
 
-# Completion handlers
-completion:
-  on_success:
-    message: "Workflow '{{COMPONENTNAME}}' completed successfully"
-    notify: false
-  on_failure:
-    message: "Workflow '{{COMPONENTNAME}}' failed"
-    notify: true
-    rollback: true
+  outputs:
+    - name: result
+      from: "{{workflow_result}}"
+      description: "Final workflow result"
 
-# Validation
-validation:
-  pre_run:
-    - "Check all required inputs are provided"
-    - "Validate input formats"
-  post_run:
-    - "Verify output is valid"
-    - "Log completion metrics"
+  handoff_prompts:
+    init_to_process: "Initialization complete. Proceeding to processing."
+    process_to_finalize: "Processing complete. Proceeding to finalization."
+
+  completion:
+    on_success:
+      message: "Workflow '{{COMPONENTNAME}}' completed successfully"
+      notify: false
+    on_failure:
+      message: "Workflow '{{COMPONENTNAME}}' failed"
+      notify: true
+      rollback: true
+
+  validation:
+    pre_run:
+      - "Check all required inputs are provided"
+      - "Validate input formats"
+    post_run:
+      - "Verify output is valid"
+      - "Log completion metrics"

package/.aiox-core/development/templates/squad-template/workflows/example-workflow.yaml

@@ -1,54 +1,75 @@
 # Example Workflow Definition
 # Replace placeholders with your workflow's details
 
-name: example-workflow
-version: 1.0.0
-description: Multi-step workflow that orchestrates tasks
-
-trigger:
-  command: "*example-command"
-  agent: example-agent
-
-elicitation:
-  enabled: true
-  questions:
-    - id: action_type
-      prompt: "What would you like to do?"
-      type: choice
-      options:
-        - Create new item
-        - Update existing item
-        - Delete item
-
-    - id: item_name
-      prompt: "What is the name of the item?"
-      type: text
-      required: true
-
-steps:
-  - id: step-1
-    task: example-task
-    inputs:
-      input1: "{{elicitation.item_name}}"
-      options:
-        action: "{{elicitation.action_type}}"
-    on_success: step-2
-    on_error: error-handler
-
-  - id: step-2
-    action: log-result
-    description: Log the successful result
-    inputs:
-      message: "Operation completed successfully"
-
-error_handling:
-  - id: error-handler
-    action: notify
-    message: "Workflow failed: {{error.message}}"
-    severity: error
-
-completion:
-  message: "Workflow completed successfully!"
-  next_steps:
-    - Review the output
-    - Verify the changes
+workflow:
+  id: example-workflow
+  name: Example Workflow
+  version: "1.0.0"
+  description: Multi-step workflow that orchestrates tasks
+  type: example
+
+  triggers:
+    - type: manual
+      command: "*example-command"
+
+  elicitation:
+    enabled: true
+    questions:
+      - id: action_type
+        prompt: "What would you like to do?"
+        type: choice
+        options:
+          - Create new item
+          - Update existing item
+          - Delete item
+      - id: item_name
+        prompt: "What is the name of the item?"
+        type: text
+        required: true
+
+  phases:
+    - phase_1: Execute task
+    - phase_2: Log result
+
+  sequence:
+    - step: execute_task
+      id: run_task
+      phase: 1
+      phase_name: "Execute Task"
+      agent: example-agent
+      task: example-task
+      inputs:
+        input1: "{{elicitation.item_name}}"
+        options:
+          action: "{{elicitation.action_type}}"
+      outputs:
+        - task_result
+      next: log_result
+      on_failure: notify_error
+
+    - step: log_result
+      id: log_result
+      phase: 2
+      phase_name: "Log Result"
+      agent: example-agent
+      action: log-result
+      inputs:
+        message: "Operation completed successfully"
+      on_complete:
+        status: success
+
+    - workflow_end: true
+      id: complete
+      action: workflow_complete
+
+  error_handling:
+    - id: notify_error
+      action: notify
+      message: "Workflow failed: {{error.message}}"
+      severity: error
+
+  completion:
+    message: "Workflow completed successfully!"
+    next_steps:
+      - Review the output
+      - Verify the changes

package/.aiox-core/development/workflows/README.md

@@ -67,10 +67,17 @@ workflow:
   metadata:
     elicit: true  # If user interaction required
     confirmation_required: true
-  steps:
-    - id: step-1
-      name: Step name
-      description: What this step does
+  sequence:
+    - step: step_slug
+      id: step-1
+      agent: responsible-agent
+      action: What this step does
+      next: next-step-id
+
+  # Optional compatibility metadata (non-executable)
+  phases:
+    - phase_1: Discovery
+    - phase_2: Execution
 ```
 
 ## Best Practices
@@ -78,4 +85,4 @@ workflow:
 2. Include error handling for each step
 3. Provide clear user feedback
 4. Make workflows idempotent when possible
-5. Document prerequisites and outcomes
+5. Document prerequisites and outcomes

package/.aiox-core/development/workflows/development-cycle.yaml

@@ -318,6 +318,96 @@ workflow:
       on_review: show_summary_then_checkpoint
       on_abort: workflow_aborted
 
+  # ============================================
+  # Canonical Execution Contract
+  # ============================================
+  sequence:
+    - step: validate_story
+      id: validation
+      phase: 1
+      phase_name: "Story Validation"
+      agent: "@po"
+      task: "validate-story-draft"
+      action: "Validate story and assignments"
+      outputs:
+        - validation_result
+      next: development
+      on_failure: reject_with_feedback
+
+    - step: develop_story
+      id: development
+      phase: 2
+      phase_name: "Development"
+      agent: "${story.executor}"
+      task: "develop"
+      action: "Implement approved story"
+      requires: validation
+      outputs:
+        - implementation
+        - test_results
+      next: self_healing
+      on_failure: return_to_po
+
+    - step: run_self_healing
+      id: self_healing
+      phase: 3
+      phase_name: "Self-Healing"
+      agent: "@dev"
+      task: "self-heal"
+      action: "Apply automated fixes when enabled"
+      requires: development
+      condition: "${config.coderabbit_integration.enabled} == true"
+      outputs:
+        - healed_code
+      next: quality_gate
+      on_failure: quality_gate
+
+    - step: quality_review
+      id: quality_gate
+      phase: 4
+      phase_name: "Quality Gate"
+      agent: "${story.quality_gate}"
+      task: "quality-review"
+      action: "Review code quality and acceptance"
+      requires:
+        - development
+        - self_healing
+      outputs:
+        - review_result
+      next: push
+      on_failure: return_to_development
+
+    - step: push_and_pr
+      id: push
+      phase: 5
+      phase_name: "Push & PR"
+      agent: "@devops"
+      task: "push-and-pr"
+      action: "Run checks and publish PR"
+      requires: quality_gate
+      outputs:
+        - push_result
+        - pr_url
+      next: checkpoint
+      on_failure: return_to_quality_gate
+
+    - step: story_checkpoint
+      id: checkpoint
+      phase: 6
+      phase_name: "Story Checkpoint"
+      agent: "@po"
+      task: "story-checkpoint"
+      action: "Collect human decision (GO/PAUSE/REVIEW/ABORT)"
+      requires: push
+      outputs:
+        - decision
+        - next_story
+      on_complete:
+        GO: validation
+        PAUSE: workflow_paused
+        REVIEW: show_summary_then_checkpoint
+        ABORT: workflow_aborted
+
   # ============================================
   # Error Handlers
   # ============================================

package/.aiox-core/infrastructure/scripts/config-cache.js

@@ -71,7 +71,16 @@ class ConfigCache {
    * @returns {boolean} True if key exists and is valid
    */
   has(key) {
-    return this.get(key) !== null;
+    if (!this.cache.has(key)) {
+      return false;
+    }
+    const timestamp = this.timestamps.get(key);
+    if (Date.now() - timestamp > this.ttl) {
+      this.cache.delete(key);
+      this.timestamps.delete(key);
+      return false;
+    }
+    return true;
   }
 
   /**