ai-memory 0.7.0

AI-agnostic persistent memory system — MCP server, HTTP API, and CLI for any AI platform
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

// Copyright 2026 AlphaOne LLC
// SPDX-License-Identifier: Apache-2.0

//! v0.7.0 ARCH-3 / FX-C3 (batch2) — `ai-memory subscription-replay`
//! CLI subcommand.
//!
//! Closes the three-surface-parity gap on `memory_subscription_replay`
//! (v0.7 K7 reliability tool). The MCP tool
//! ([`crate::mcp::handle_subscription_replay`]) and the HTTP route
//! landed previously; this module wires the CLI surface so operators
//! can replay events from a webhook subscription's delivery log.

use crate::models::field_names;
use anyhow::Result;
use clap::Args;
use serde_json::{Value, json};

use crate::cli::CliOutput;
use crate::storage as db;

/// CLI args for `ai-memory subscription-replay`.
#[derive(Args, Debug, Clone)]
pub struct SubscriptionReplayArgs {
    /// Subscription id.
    #[arg(long = "subscription-id", value_name = "ID")]
    pub subscription_id: String,

    /// RFC3339 inclusive lower bound on `delivered_at`.
    #[arg(long, value_name = "RFC3339")]
    pub since: String,

    /// Emit the raw JSON envelope.
    #[arg(long)]
    pub json: bool,
}

/// `ai-memory subscription-replay` dispatch entry.
///
/// # Errors
///
/// - The DB at `db_path` cannot be opened.
/// - The substrate refuses the replay (invalid RFC3339, etc.).
/// - `serde_json::to_string` cannot serialise the envelope.
pub fn cmd_subscription_replay(
    db_path: &std::path::Path,
    args: &SubscriptionReplayArgs,
    out: &mut CliOutput<'_>,
) -> Result<()> {
    let conn = db::open(db_path)?;
    let params = json!({
        (field_names::SUBSCRIPTION_ID): args.subscription_id,
        "since": args.since,
    });
    let envelope = crate::mcp::handle_subscription_replay(&conn, &params, None)
        .map_err(|e| anyhow::anyhow!("subscription-replay: {e}"))?;

    if args.json {
        writeln!(out.stdout, "{}", serde_json::to_string(&envelope)?)?;
        return Ok(());
    }

    let count = envelope.get("count").and_then(Value::as_u64).unwrap_or(0);
    writeln!(out.stdout, "subscription-replay: {count} event(s)")?;
    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::cli::test_utils::TestEnv;

    #[test]
    fn subscription_replay_cli_unknown_id_returns_empty() {
        let mut env = TestEnv::fresh();
        let db = env.db_path.clone();
        let args = SubscriptionReplayArgs {
            subscription_id: "unknown-id".into(),
            since: "2024-01-01T00:00:00Z".into(),
            json: true,
        };
        {
            let mut out = env.output();
            cmd_subscription_replay(&db, &args, &mut out).expect("ok");
        }
        let stdout = env.stdout_str();
        let envelope: Value = serde_json::from_str(stdout.trim()).expect("parse envelope");
        // Owner-mismatch / non-existent ids return the same empty
        // envelope so existence isn't leaked (#1115 caller-ownership).
        assert_eq!(envelope["count"].as_u64(), Some(0));
    }

    #[test]
    fn subscription_replay_cli_text_output() {
        let mut env = TestEnv::fresh();
        let db = env.db_path.clone();
        let args = SubscriptionReplayArgs {
            subscription_id: "unknown-id".into(),
            since: "2024-01-01T00:00:00Z".into(),
            json: false,
        };
        {
            let mut out = env.output();
            cmd_subscription_replay(&db, &args, &mut out).expect("ok");
        }
        assert!(env.stdout_str().contains("subscription-replay: 0 event(s)"));
    }
}