coglog-cli 0.9.1

CogLog CLI — a meta-cognition log for LLMs
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

//! CogLog CLI
//!
//! Usage:
//!   coglog-command read
//!   echo '{"user":"...","thinking":"...","assistant":"...","current_focus":"...","theory_of_mind":"...","self_narrative":"...","annotation":"..."}' | coglog-command write
//!   coglog-command clear

use coglog_core::{Error, CogLog, WriteArgs};
use std::io::Read;
use std::path::PathBuf;
use std::process;

fn print_usage() {
    print!(
        "usage: coglog-command <read|write|clear>\n\
         \n\
         \x20 read    — display the previous turn's coglog\n\
         \x20 write   — save current turn (reads JSON from stdin)\n\
         \x20 clear   — reset coglog\n\
         \n\
         write expects JSON on stdin (all fields required):\n\
         \x20 {{\n\
         \x20   \"user\": \"user's message\",\n\
         \x20   \"thinking\": \"AI thinking process\",\n\
         \x20   \"assistant\": \"AI output\",\n\
         \x20   \"current_focus\": \"what is happening right now\",\n\
         \x20   \"theory_of_mind\": \"user intent/state inference\",\n\
         \x20   \"self_narrative\": \"improvised self-story at this moment\",\n\
         \x20   \"annotation\": \"note to future self\"\n\
         \x20 }}\n\
         \n\
         \x20 fact layer (user, thinking, assistant): non-empty string required\n\
         \x20 interpretation layer (current_focus, theory_of_mind,\n\
         \x20   self_narrative, annotation): string required, empty string acceptable\n"
    );
}

fn run() -> Result<(), Error> {
    let mut args: Vec<String> = std::env::args().collect();

    // Parse --coglog-dir <path> (priority: arg > COGLOG_DIR env > default)
    let ml = if args.len() >= 3 && args[1] == "--coglog-dir" {
        let dir = PathBuf::from(&args[2]);
        args.remove(1);
        args.remove(1);
        CogLog::with_dir(dir)
    } else {
        CogLog::new()
    };

    if args.len() < 2 {
        print_usage();
        return Ok(());
    }

    match args[1].as_str() {
        "read" => {
            match ml.read()? {
                Some(entry) => {
                    let json = serde_json::to_string_pretty(&entry)?;
                    println!("{}", json);
                }
                None => {
                    println!("(no coglog found)");
                }
            }
        }
        "write" => {
            let mut input = String::new();
            std::io::stdin().read_to_string(&mut input)?;
            let write_args: WriteArgs = serde_json::from_str(&input)?;
            let entry = ml.write(write_args)?;
            println!("coglog: turn {} written", entry.turn_id);
        }
        "clear" => {
            let result = ml.clear()?;
            if result.cleared {
                println!("coglog: cleared");
            } else if let Some(reason) = &result.reason {
                println!("coglog: {}", reason);
            }
        }
        _ => {
            print_usage();
            process::exit(1);
        }
    }

    Ok(())
}

fn main() {
    if let Err(e) = run() {
        eprintln!("coglog error: {}", e);
        process::exit(1);
    }
}