Interface Executor

src/executor/mod.rs:110–152

#[async_trait(?Send)]
pub trait Executor {
    fn name(&self) -> ExecutorName;

    /// Report the installation status of the tool(s) this executor depends on.
    fn tool_status(&self) -> Option<ToolStatus>;

    /// Report whether the elevated privileges this executor needs are in place.
    /// Defaults to `None` for executors that need none. Only consulted once the
    /// tool itself is installed.
    fn privilege_status(&self) -> Option<PrivilegeStatus> {
        None
    }

    /// Declare how well this executor runs on the host system. Drives whether `setup()` is invoked
    /// (only when [`ExecutorSupport::FullySupported`]) and whether we bail out of running the
    /// executor at all (on [`ExecutorSupport::Unsupported`]).
    fn support_level(&self, system_info: &SystemInfo) -> ExecutorSupport;

    async fn setup(
        &self,
        _system_info: &SystemInfo,
        _setup_cache_dir: Option<&Path>,
    ) -> Result<()> {
        Ok(())
    }

    /// Grant any elevated privileges this executor needs (e.g. file capabilities).
    /// Runs after [`setup`](Self::setup) and may prompt for sudo. Defaults to a
    /// no-op for executors that need none.
    fn grant_privileges(&self) -> Result<()> {
        Ok(())
    }

    /// Runs the executor
    async fn run(
        &mut self,
        execution_context: &ExecutionContext,
        // TODO: use Instruments instead of directly passing the mongodb tracer
        mongo_tracer: &Option<MongoTracer>,
    ) -> Result<()>;

    async fn teardown(&self, execution_context: &ExecutionContext) -> Result<()>;
}

/// Run a single executor: setup → run → teardown → persist logs.
/// Does NOT upload.