remem-ai 0.6.93

Local-first coding agent memory for Claude Code and OpenAI Codex
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

//! Dry-run-first application of a digest-bound project alias inventory report.

use std::path::PathBuf;

use anyhow::{bail, Context, Result};
use chrono::Utc;
use clap::Parser;
use remem::project_alias::{
    apply_project_alias_plan, preview_project_alias_plan, ProjectAliasApplyRequest,
    ProjectAliasPlanEntry,
};
use serde::Deserialize;
use serde_json::Value;
use sha2::{Digest, Sha256};

#[derive(Debug, Parser)]
#[command(about = "preview or apply a project alias inventory report")]
struct Args {
    /// JSON emitted by the project_alias_inventory example.
    plan: PathBuf,
    /// Actor stored in append-only alias audit events.
    #[arg(long)]
    actor: String,
    /// Human-readable reason stored in append-only alias audit events.
    #[arg(long)]
    reason: String,
    /// Apply the plan. Omit for a read-only preview.
    #[arg(long)]
    apply: bool,
}

#[derive(Debug, Deserialize)]
struct InventoryReport {
    schema_version: u32,
    inventory_sha256: String,
    proposed_aliases: Vec<ProjectAliasPlanEntry>,
}

fn main() -> Result<()> {
    let args = Args::parse();
    let raw = std::fs::read_to_string(&args.plan)
        .with_context(|| format!("read project alias plan {}", args.plan.display()))?;
    let value: Value = serde_json::from_str(&raw)
        .with_context(|| format!("parse project alias plan {}", args.plan.display()))?;
    verify_inventory_digest(&value)?;
    let report: InventoryReport = serde_json::from_value(value)?;
    if report.schema_version != 1 {
        bail!(
            "unsupported project alias inventory schema version {}",
            report.schema_version
        );
    }
    let request = ProjectAliasApplyRequest {
        source_inventory_sha256: &report.inventory_sha256,
        actor: &args.actor,
        reason: &args.reason,
        now_epoch: Utc::now().timestamp(),
        entries: &report.proposed_aliases,
    };
    let result = if args.apply {
        let conn = remem::db::open_db_no_migrate()
            .context("open current-schema database for project alias apply")?;
        apply_project_alias_plan(&conn, &request)?
    } else {
        let conn = remem::db::open_db_read_only_current()
            .context("open current-schema database for project alias preview")?;
        preview_project_alias_plan(&conn, &request)?
    };
    println!(
        "{}",
        serde_json::to_string_pretty(&serde_json::json!({
            "schema_version": 1,
            "mode": if args.apply { "applied" } else { "dry_run" },
            "source_inventory_sha256": report.inventory_sha256,
            "inserted": result.inserted,
            "unchanged": result.unchanged,
            "aliases": result.aliases
        }))?
    );
    Ok(())
}

fn verify_inventory_digest(value: &Value) -> Result<()> {
    let mut canonical = value.clone();
    let object = canonical
        .as_object_mut()
        .ok_or_else(|| anyhow::anyhow!("project alias inventory must be an object"))?;
    let declared = object
        .get("inventory_sha256")
        .and_then(Value::as_str)
        .ok_or_else(|| anyhow::anyhow!("project alias inventory is missing inventory_sha256"))?
        .to_string();
    object.insert("inventory_sha256".to_string(), Value::String(String::new()));
    let actual = format!("{:x}", Sha256::digest(serde_json::to_vec(&canonical)?));
    if actual != declared {
        bail!(
            "project alias inventory digest mismatch: declared {}, actual {}",
            declared,
            actual
        );
    }
    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn inventory_digest_detects_drift() -> Result<()> {
        let mut value = serde_json::json!({
            "schema_version": 1,
            "inventory_sha256": "",
            "proposed_aliases": []
        });
        let digest = format!("{:x}", Sha256::digest(serde_json::to_vec(&value)?));
        value["inventory_sha256"] = Value::String(digest);
        verify_inventory_digest(&value)?;
        value["schema_version"] = serde_json::json!(2);
        assert!(verify_inventory_digest(&value).is_err());
        Ok(())
    }
}