memd 1.2.1

Local memory CLI for AI agents with hybrid retrieval
Documentation
use std::io::Write;
use std::process::{Command, Stdio};

use serde_json::Value;

fn memd_bin() -> &'static str {
    env!("CARGO_BIN_EXE_memd")
}

#[test]
fn supported_cli_help_surfaces_resolve() {
    let commands = [
        vec!["--help"],
        vec!["add", "--help"],
        vec!["search", "--help"],
        vec!["agent-context", "--help"],
        vec!["memory-md", "--help"],
        vec!["eval-memory-md", "--help"],
        vec!["eval-retrieval", "--help"],
        vec!["eval-write-quality", "--help"],
        vec!["audit", "--help"],
        vec!["cleanup-plan", "--help"],
        vec!["purge", "--help"],
        vec!["purge-archive", "--help"],
        vec!["call", "--help"],
        vec!["batch", "--help"],
        vec!["warm", "--help"],
    ];

    for args in commands {
        let output = Command::new(memd_bin())
            .args(&args)
            .output()
            .expect("run memd help");
        assert!(
            output.status.success(),
            "memd {args:?} failed: {}",
            String::from_utf8_lossy(&output.stderr)
        );
        let stdout = String::from_utf8_lossy(&output.stdout);
        assert!(
            stdout.contains("Usage:"),
            "missing usage in {args:?}: {stdout}"
        );
        if args.as_slice() == ["--help"] {
            assert!(
                !stdout.contains("--mode"),
                "top-level help must not expose removed server --mode flag"
            );
        }
        assert!(
            !stdout.contains("mcp"),
            "supported help must not advertise removed MCP startup in {args:?}"
        );
    }
}

#[test]
fn mode_mcp_is_rejected_by_current_cli() {
    let output = Command::new(memd_bin())
        .args(["--mode", "mcp"])
        .output()
        .expect("run memd --mode mcp");

    assert!(
        !output.status.success(),
        "--mode mcp unexpectedly succeeded"
    );
    let stderr = String::from_utf8_lossy(&output.stderr);
    assert!(
        stderr.contains("--mode") || stderr.contains("unexpected argument"),
        "unexpected rejection message: {stderr}"
    );
}

#[test]
fn batch_cli_preserves_operation_response_shapes() {
    let jsonl = r#"{"tool":"memory.add","arguments":{"tenant_id":"cli_contract","project_id":"p","text":"contract alpha memory","type":"doc","tags":["contract"]}}
{"tool":"memory.search","arguments":{"tenant_id":"cli_contract","project_id":"p","query":"contract alpha","k":1,"compact":true,"include_text":true}}
{"tool":"task.start","arguments":{"tenant_id":"cli_contract","project_id":"p","agent_id":"agent","session_id":"session","goal":"contract task"}}
{"tool":"artifact.create","arguments":{"tenant_id":"cli_contract","project_id":"p","task_id":"contract-task","artifact_kind":"evidence","summary":"contract evidence","confidence":0.9}}
not-json
"#;

    let mut child = Command::new(memd_bin())
        .args([
            "--in-memory",
            "batch",
            "--jsonl",
            "-",
            "--continue-on-error",
        ])
        .stdin(Stdio::piped())
        .stdout(Stdio::piped())
        .stderr(Stdio::piped())
        .spawn()
        .expect("spawn memd batch");
    child
        .stdin
        .as_mut()
        .expect("stdin")
        .write_all(jsonl.as_bytes())
        .expect("write jsonl");
    let output = child.wait_with_output().expect("wait for memd batch");

    assert!(
        output.status.success(),
        "batch failed: {}",
        String::from_utf8_lossy(&output.stderr)
    );
    let rows = String::from_utf8(output.stdout).expect("utf8 stdout");
    let rows = rows
        .lines()
        .map(|line| serde_json::from_str::<Value>(line).expect("jsonl row"))
        .collect::<Vec<_>>();

    assert_eq!(rows.len(), 5, "unexpected batch rows: {rows:#?}");
    assert_eq!(rows[0]["tool"], "memory.add");
    assert_eq!(rows[0]["ok"], true);
    assert!(rows[0]["result"]["chunk_id"].is_string());

    assert_eq!(rows[1]["tool"], "memory.search");
    assert_eq!(rows[1]["ok"], true);
    assert!(rows[1]["result"]["results"].is_array());
    assert!(rows[1]["result"]["results"][0]["chunk_id"].is_string());

    assert_eq!(rows[2]["tool"], "task.start");
    assert_eq!(rows[2]["ok"], true);
    assert!(rows[2]["result"]["task_id"].is_string());

    assert_eq!(rows[3]["tool"], "artifact.create");
    assert_eq!(rows[3]["ok"], true);
    assert!(rows[3]["result"]["artifact_id"].is_string());

    assert_eq!(rows[4]["ok"], false);
    assert!(rows[4]["error"]
        .as_str()
        .expect("error")
        .contains("invalid JSONL request"));
}