heal-cli 0.4.0

Hook-driven Evaluation & Autonomous Loop — code-health harness CLI for AI coding agents
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

//! Observer families and the trait surface they share.
//!
//! Findings-emitting observers live under [`code`] and [`docs`];
//! [`shared`] holds Findings-free utilities consumed by both families.

use serde::{Deserialize, Serialize};

pub mod code;
pub mod docs;
pub mod shared;
pub mod test;

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct ObservationMeta {
    pub name: &'static str,
    pub version: u32,
}

/// Marker trait for metric observers. Each observer reads the project tree
/// (and possibly git history) and produces a structured payload to be
/// appended to `.heal/history/*.jsonl`.
pub trait Observer {
    type Output: Serialize;

    fn meta(&self) -> ObservationMeta;
    fn observe(&self, project_root: &std::path::Path) -> anyhow::Result<Self::Output>;
}

/// Generates the `with_workspace(self, ws: Option<PathBuf>) -> Self`
/// builder for an observer that carries a `workspace: Option<PathBuf>`
/// field. Centralized so the five observers honoring `--workspace`
/// (`ComplexityObserver`, `LcomObserver`, `DuplicationObserver`,
/// `ChurnObserver`, `ChangeCouplingObserver`) don't carry five
/// verbatim copies of the same setter.
macro_rules! impl_workspace_builder {
    ($t:ty) => {
        impl $t {
            #[must_use]
            pub fn with_workspace(mut self, workspace: Option<std::path::PathBuf>) -> Self {
                self.workspace = workspace;
                self
            }
        }
    };
}
pub(crate) use impl_workspace_builder;