memstead_cli/commands/
due.rs

1//! `memstead due` — render the due-brief: every open entity whose
2//! schema-declared due date falls inside the window, overdue first,
3//! across every mem whose schema declares the axis (read-only mounts
4//! labelled as third-party quoted data). The renderer is the shared
5//! engine entry point `Engine::render_due_brief`, so every consuming
6//! surface serves byte-identical content — the projection-brief
7//! precedent. There is deliberately no MCP tool (briefs are the
8//! CLI family); the MCP server instructions name this verb as the
9//! CLI companion.
10
11use clap::Args as ClapArgs;
12use serde_json::json;
13
14use crate::CliError;
15use crate::output::{ExitKind, print_json, print_markdown};
16use crate::setup::CliContext;
17
18#[derive(ClapArgs, Debug)]
19pub struct Args {
20    /// Relative window against today: `<N>d` days, `<N>m` calendar
21    /// months, `<N>y` calendar years (e.g. 90d, 6m, 2y). Everything
22    /// already overdue is always included. Default: 90d.
23    #[arg(long, default_value = memstead_base::engine::due::DEFAULT_DUE_WINDOW)]
24    pub within: String,
25
26    /// Restrict the brief to one mem (default: every mounted mem whose
27    /// schema declares a due axis).
28    #[arg(long)]
29    pub mem: Option<String>,
30
31    /// Override the current date (YYYY-MM-DD). Testing hook — the
32    /// brief is deterministic given the store and this date.
33    #[arg(long, hide = true)]
34    pub today: Option<String>,
35}
36
37pub fn run(ctx: &CliContext, args: Args) -> anyhow::Result<()> {
38    let window = memstead_base::engine::due::parse_due_window(&args.within)
39        .map_err(|msg| CliError::new(ExitKind::Validation, "INVALID_INPUT", msg))?;
40    let today = match &args.today {
41        Some(t) => t.clone(),
42        None => current_date(),
43    };
44    let engine = ctx.cli_engine()?;
45    let brief = engine
46        .base()
47        .render_due_brief(&today, &window, args.mem.as_deref())
48        .map_err(|msg| CliError::new(ExitKind::Validation, "INVALID_INPUT", msg))?;
49    if ctx.json {
50        // The reading as data beside the prose: `overdue` rows carry the
51        // days past, `due_soon` rows the days until; no severity, no verdict.
52        let data = engine
53            .base()
54            .due_brief(&today, &window, args.mem.as_deref())
55            .map_err(|msg| CliError::new(ExitKind::Validation, "INVALID_INPUT", msg))?;
56        print_json(&json!({
57            "today": today,
58            "within": args.within,
59            "through": data.through,
60            "mem": args.mem,
61            "mems": data.mems,
62            "overdue": data.overdue,
63            "due_soon": data.due_soon,
64            "brief": brief,
65        }))?;
66    } else {
67        print_markdown(&brief);
68    }
69    Ok(())
70}
71
72/// Today's date as ISO `YYYY-MM-DD` (UTC — the engine's date
73/// convention throughout). Taken once per invocation.
74fn current_date() -> String {
75    let now = time::OffsetDateTime::now_utc();
76    format!(
77        "{:04}-{:02}-{:02}",
78        now.year(),
79        u8::from(now.month()),
80        now.day()
81    )
82}
memstead_cli/commands/due.rs

memstead_cli/commands/
due.rs
