turnlog 0.1.0

Lightweight local provenance recorder for agent sessions and turns
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

use clap::{Parser, Subcommand};

#[derive(Debug, Parser)]
#[command(
    name = "turnlog",
    version,
    about = "Lightweight agent provenance recorder"
)]
pub struct Cli {
    /// Directory whose repository/turnlog should be used instead of the process cwd
    #[arg(long, short = 'C', global = true, value_name = "DIR")]
    pub cwd: Option<std::path::PathBuf>,

    #[command(subcommand)]
    pub command: Command,
}

#[derive(Debug, Subcommand)]
pub enum Command {
    /// Initialize .turnlog storage
    Init,
    /// Start a new agent session
    Start {
        #[arg(long)]
        ticket: Option<String>,
        #[arg(long)]
        goal: String,
    },
    /// Record an agent turn on the latest session
    Record {
        #[arg(long)]
        session: Option<String>,
        #[arg(long)]
        model: Option<String>,
        #[arg(long)]
        summary: Option<String>,
        #[arg(long = "verification")]
        verification: Vec<String>,
        #[arg(long)]
        attach_diff: bool,
    },
    /// Show the active session
    Current,
    /// Set the active session
    Use { id: String },
    /// Show current turnlog and VCS status
    Status,
    /// List trace events
    Log {
        #[arg(long)]
        session: Option<String>,
        #[arg(long)]
        ticket: Option<String>,
        #[arg(long)]
        grep: Option<String>,
        #[arg(long)]
        changed: Option<String>,
    },
    /// Show one session or turn by ID
    Show {
        id: String,
        #[arg(long)]
        json: bool,
    },
    /// Search trace events for text
    Grep { pattern: String },
    /// Write a Markdown report for a session
    Report {
        id: String,
        #[arg(long)]
        stdout: bool,
    },
}