spec-ai 0.6.12

A framework for building AI agents with structured outputs, policy enforcement, and execution tracking
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

use anyhow::Result;
use serde_json::json;
use std::path::PathBuf;

use crate::spec_ai_core::persistence::Persistence;

/// Context provided to each bootstrap plugin
#[derive(Clone)]
pub struct PluginContext<'a> {
    pub persistence: &'a Persistence,
    pub session_id: &'a str,
    pub repo_root: &'a PathBuf,
    pub mode: BootstrapMode,
}

/// Outcome from a single plugin's bootstrap run
#[derive(Debug, Clone)]
pub struct PluginOutcome {
    pub plugin_name: String,
    pub nodes_created: usize,
    pub edges_created: usize,
    pub root_node_id: Option<i64>, // The main entity node created by this plugin
    pub phases: Vec<String>,
    pub metadata: serde_json::Value,
}

impl PluginOutcome {
    pub fn new(plugin_name: impl Into<String>) -> Self {
        Self {
            plugin_name: plugin_name.into(),
            nodes_created: 0,
            edges_created: 0,
            root_node_id: None,
            phases: Vec::new(),
            metadata: json!({}),
        }
    }
}

#[derive(Clone, Copy)]
pub enum BootstrapMode {
    Fresh,
    Refresh,
}

/// Trait that bootstrap plugins must implement
pub trait BootstrapPlugin: Send + Sync {
    /// The name of this plugin (e.g., "rust-cargo", "python-pyproject")
    fn name(&self) -> &'static str;

    /// Returns the bootstrap phases this plugin will execute
    fn phases(&self) -> Vec<&'static str>;

    /// Returns true if this plugin should be auto-activated for the given repository
    #[allow(clippy::ptr_arg)]
    fn should_activate(&self, repo_root: &PathBuf) -> bool;

    /// Execute the bootstrap for this plugin
    fn run(&self, context: PluginContext) -> Result<PluginOutcome>;
}