specfold-core 0.2.5

Library behind specfold: typed Markdown documents, owners, a derived graph and checks.
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

//! Stalled: active plans without recent updates, and drafts that never became anything.

use super::super::types::{Item, Kind};
use super::days_between;
use crate::corpus::Corpus;
use crate::model::stamp;

pub fn run(c: &Corpus, docs: &[usize], out: &mut Vec<Item>) {
    let today = stamp::today();
    let a = &c.cfg.raw.audit;
    for &i in docs {
        let d = &c.docs[i];
        let status = d.status().unwrap_or_default();
        let (limit, what) = match (d.id.ty.as_str(), status.as_str()) {
            ("plan", "active") => (a.stalled_days, "active plan has no update"),
            (_, "draft") => (a.draft_days, "draft not decided"),
            _ => continue,
        };
        let Some(updated) = d.str_field("updated") else { continue };
        let Some(age) = days_between(&updated, &today) else { continue };
        if age > limit {
            out.push(Item {
                kind: Kind::Stalled,
                subject: d.id.to_string(),
                path: d.path.clone(),
                line: 1,
                detail: format!("{what} for {age} days (since {updated})"),
                next: Some(format!(
                    "spec set {} status=archived   # or record progress and spec set {} updated=today",
                    d.id, d.id
                )),
            });
        }
    }
}