clincalc 0.2.1

Open, auditable clinical calculators: a pure scoring engine plus the `clincalc` CLI in one crate. The engine is a serde-only leaf (build with default-features = false); the default `cli` feature adds the `clincalc` binary.
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

// SPDX-FileCopyrightText: 2026 Marcus Baw and Baw Medical Ltd
// SPDX-License-Identifier: AGPL-3.0-or-later

//! The result schema returned by every calculator.

use serde::{Deserialize, Serialize};
use serde_json::{Map, Value};

/// A completed calculation, ready to be rendered, recorded, or dispatched.
///
/// This mirrors the JSON object the web calculators send through
/// `gitehr-bridge.js` (`calculator`, `result`, `interpretation`, `working`,
/// `reference`), so a result produced here and one produced in the browser are
/// the same shape by construction.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CalculationResponse {
    /// Machine name of the calculator, e.g. `"feverpain"`.
    pub calculator: String,
    /// The primary computed value — a number or short string.
    pub result: Value,
    /// Human-readable clinical interpretation.
    pub interpretation: String,
    /// Step-by-step breakdown of how the result was reached.
    #[serde(default, skip_serializing_if = "Map::is_empty")]
    pub working: Map<String, Value>,
    /// Primary citation / guideline reference.
    pub reference: String,
}

impl CalculationResponse {
    /// A plain-text summary suitable for a clipboard / journal entry.
    ///
    /// Intentionally free of any timestamp — the recording host adds that, so
    /// this output stays deterministic.
    pub fn to_summary_text(&self) -> String {
        let result = match &self.result {
            Value::String(s) => s.clone(),
            other => other.to_string(),
        };
        format!(
            "Calculator: {}\nResult: {}\nInterpretation: {}\nReference: {}",
            self.calculator, result, self.interpretation, self.reference
        )
    }
}