ccswarm 0.5.0

AI-powered multi-agent orchestration system with proactive intelligence, security monitoring, and session management
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// Represents a complete task execution plan
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TaskPlan {
    pub task_id: String,
    pub steps: Vec<TaskStep>,
    pub context: HashMap<String, String>,
    pub adaptive: bool,
}

/// A single step in the task plan
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TaskStep {
    pub id: String,
    pub name: String,
    pub description: String,
    pub step_type: StepType,
    pub parallel_tasks: Vec<ParallelTask>,
    pub dependencies: Vec<String>,
    pub required_context: Vec<String>,
}

/// Type of step execution
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum StepType {
    Analysis,
    Execution,
    Validation,
    Review,
}

/// A task that can be executed in parallel with others
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ParallelTask {
    pub id: String,
    pub name: String,
    pub command: String,
    pub expected_duration_ms: u64,
    pub critical: bool,
    pub expect_failure: bool,
}

/// Result from executing a step
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StepResult {
    pub step_id: String,
    pub success: bool,
    pub summary: String,
    pub outputs: HashMap<String, String>,
    pub errors: Vec<String>,
    pub duration_ms: u64,
    pub parallel_results: Vec<ParallelTaskResult>,
}

/// Result from a parallel task
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ParallelTaskResult {
    pub task_id: String,
    pub success: bool,
    pub output: String,
    pub error: Option<String>,
}

impl TaskPlan {
    pub fn new(task_id: String) -> Self {
        Self {
            task_id,
            steps: Vec::new(),
            context: HashMap::new(),
            adaptive: true,
        }
    }

    pub fn add_step(&mut self, step: TaskStep) {
        self.steps.push(step);
    }

    pub fn update_context(&mut self, key: String, value: String) {
        self.context.insert(key, value);
    }

    pub fn remove_step(&mut self, step_id: &str) {
        self.steps.retain(|s| s.id != step_id);
    }

    pub fn insert_step_after(&mut self, after_id: &str, step: TaskStep) {
        if let Some(pos) = self.steps.iter().position(|s| s.id == after_id) {
            self.steps.insert(pos + 1, step);
        }
    }
}

impl TaskStep {
    pub fn new(id: String, name: String, step_type: StepType) -> Self {
        Self {
            id,
            name,
            description: String::new(),
            step_type,
            parallel_tasks: Vec::new(),
            dependencies: Vec::new(),
            required_context: Vec::new(),
        }
    }

    pub fn with_description(mut self, description: String) -> Self {
        self.description = description;
        self
    }

    pub fn add_parallel_task(&mut self, task: ParallelTask) {
        self.parallel_tasks.push(task);
    }

    pub fn depends_on(mut self, dependency: String) -> Self {
        self.dependencies.push(dependency);
        self
    }

    pub fn requires_context(mut self, context_key: String) -> Self {
        self.required_context.push(context_key);
        self
    }
}

impl StepResult {
    pub fn new(step_id: String) -> Self {
        Self {
            step_id,
            success: true,
            summary: String::new(),
            outputs: HashMap::new(),
            errors: Vec::new(),
            duration_ms: 0,
            parallel_results: Vec::new(),
        }
    }

    pub fn failed(mut self, error: String) -> Self {
        self.success = false;
        self.errors.push(error);
        self
    }

    pub fn with_summary(mut self, summary: String) -> Self {
        self.summary = summary;
        self
    }

    pub fn add_output(mut self, key: String, value: String) -> Self {
        self.outputs.insert(key, value);
        self
    }

    pub fn is_success(&self) -> bool {
        self.success && self.parallel_results.iter().all(|r| r.success)
    }
}