kimun_notes/cli/commands/
journal.rs

1// tui/src/cli/commands/journal.rs
2//
3// Top-level `kimun journal` command: append to and show journal entries.
4
5use clap::Subcommand;
6use color_eyre::eyre::Result;
7use kimun_core::{NoteVault, nfs::VaultPath};
8
9use crate::cli::output::OutputFormat;
10
11#[derive(clap::Args, Debug)]
12pub struct JournalArgs {
13    /// Date in YYYY-MM-DD format (defaults to today)
14    #[arg(long)]
15    pub date: Option<String>,
16    /// Text to append (reads from stdin if omitted and stdin is not a TTY)
17    pub content: Option<String>,
18    #[command(subcommand)]
19    pub subcommand: Option<JournalSubcommand>,
20}
21
22#[derive(Subcommand, Debug)]
23pub enum JournalSubcommand {
24    /// Show a journal entry
25    Show {
26        /// Date in YYYY-MM-DD format (defaults to today)
27        #[arg(long)]
28        date: Option<String>,
29        /// Output format
30        #[arg(long, value_enum, default_value = "text")]
31        format: OutputFormat,
32    },
33}
34
35pub async fn run(args: JournalArgs, vault: &NoteVault, workspace_name: &str) -> Result<()> {
36    match args.subcommand {
37        Some(JournalSubcommand::Show { date, format }) => {
38            run_show(vault, date.as_deref(), format, workspace_name).await
39        }
40        None => run_append(vault, args.date.as_deref(), args.content).await,
41    }
42}
43
44/// Validate and return a `YYYY-MM-DD` date string. Defaults to today when `None`.
45fn resolve_date(date: Option<&str>) -> Result<String> {
46    match date {
47        None => Ok(chrono::Utc::now().format("%Y-%m-%d").to_string()),
48        Some(d) => {
49            chrono::NaiveDate::parse_from_str(d, "%Y-%m-%d").map_err(|_| {
50                color_eyre::eyre::eyre!("Invalid date '{}' — expected format YYYY-MM-DD", d)
51            })?;
52            Ok(d.to_string())
53        }
54    }
55}
56
57/// Build the vault path for a journal entry using the vault's configured journal path.
58fn journal_entry_path(vault: &NoteVault, date_str: &str) -> VaultPath {
59    vault
60        .journal_path()
61        .append(&VaultPath::note_path_from(date_str))
62        .absolute()
63}
64
65async fn run_append(vault: &NoteVault, date: Option<&str>, content: Option<String>) -> Result<()> {
66    use crate::cli::helpers::resolve_content;
67
68    let text = resolve_content(content)?;
69    if text.is_empty() {
70        return Ok(());
71    }
72
73    // Today and a specific date both resolve to journal/<date>; append under the
74    // per-note lock so concurrent journal writes can't lose an entry.
75    let date_str = resolve_date(date)?;
76    let vault_path = journal_entry_path(vault, &date_str);
77    vault
78        .append_to_note(&vault_path, &text, Some(format!("# {}\n\n", date_str)))
79        .await
80        .map_err(|e| color_eyre::eyre::eyre!("{}", e))?;
81
82    println!("Note saved: {}", vault_path);
83    Ok(())
84}
85
86async fn run_show(
87    vault: &NoteVault,
88    date: Option<&str>,
89    format: OutputFormat,
90    workspace_name: &str,
91) -> Result<()> {
92    use crate::cli::commands::note_ops::format_note_show_text;
93    use crate::cli::json_output::{
94        JsonNoteEntry, JsonNoteMetadata, JsonOutput, JsonOutputMetadata,
95    };
96    use chrono::Utc;
97    use kimun_core::error::{FSError, VaultError};
98
99    if matches!(format, OutputFormat::Paths) {
100        return Err(color_eyre::eyre::eyre!(
101            "--format paths is not valid for journal show; use 'text' or 'json'"
102        ));
103    }
104
105    let date_str = resolve_date(date)?;
106    let vault_path = journal_entry_path(vault, &date_str);
107
108    let note_details = vault.load_note(&vault_path).await.map_err(|e| match e {
109        VaultError::FSError(FSError::VaultPathNotFound { .. }) => {
110            color_eyre::eyre::eyre!("No journal entry found for {}", date_str)
111        }
112        _ => color_eyre::eyre::eyre!("{}", e),
113    })?;
114
115    let content = &note_details.raw_text;
116    let content_data = note_details.get_content_data();
117
118    let backlinks = vault
119        .get_backlinks(&vault_path)
120        .await
121        .map_err(|e| color_eyre::eyre::eyre!("{}", e))?;
122    let backlink_paths: Vec<String> = backlinks.iter().map(|(e, _)| e.path.to_string()).collect();
123
124    match format {
125        OutputFormat::Text => {
126            // Tags and links from one walk over the note.
127            let meta = kimun_core::note::NoteMetadata::of(content);
128            print!(
129                "{}",
130                format_note_show_text(
131                    &vault_path,
132                    content,
133                    &content_data.title,
134                    &meta.tags,
135                    &meta.links,
136                    &backlink_paths,
137                )
138            );
139        }
140        OutputFormat::Json => {
141            let note_entry = vault
142                .note_entry(&vault_path)
143                .await
144                .map_err(|e| color_eyre::eyre::eyre!("{}", e))?;
145            let modified_secs = note_entry.modified_secs;
146            let journal_date = vault
147                .journal_date(&vault_path)
148                .map(|d| d.format("%Y-%m-%d").to_string());
149            let entry = JsonNoteEntry {
150                path: vault_path.to_string_with_ext(),
151                title: content_data.title.clone(),
152                content: content.clone(),
153                size: note_entry.size,
154                modified: modified_secs,
155                created: modified_secs,
156                hash: format!("{:x}", content_data.hash),
157                journal_date,
158                metadata: JsonNoteMetadata::from_content(content),
159                backlinks: if backlink_paths.is_empty() {
160                    None
161                } else {
162                    Some(backlink_paths)
163                },
164            };
165            let output = JsonOutput {
166                metadata: JsonOutputMetadata {
167                    workspace: workspace_name.to_string(),
168                    workspace_path: vault.workspace_path().to_string(),
169                    total_results: 1,
170                    query: None,
171                    is_listing: false,
172                    generated_at: Utc::now().to_rfc3339(),
173                },
174                notes: vec![entry],
175            };
176            print!(
177                "{}",
178                serde_json::to_string(&output).map_err(|e| color_eyre::eyre::eyre!("{}", e))?
179            );
180        }
181        OutputFormat::Paths => unreachable!("guarded above"),
182    }
183
184    Ok(())
185}
kimun_notes/cli/commands/journal.rs

kimun_notes/cli/commands/
journal.rs
