tkt 0.2.0

Track tasks as markdown files in your git repo
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

//! Shared helpers for command implementations.

use std::path::{Path, PathBuf};

use anyhow::Result;

use crate::git;

/// Bail with a domain error (exit code 1 or 2 depending on kind).
/// Usage:
///   domain_bail!(NotFound, "ticket {} not found", id)
///   domain_bail!(GateFailed, "message", hint: "use --force")
///   domain_bail!("message")  // defaults to Validation kind
macro_rules! domain_bail {
    ($kind:ident, $fmt:literal $(, $arg:expr)* , hint: $hint:expr) => {
        return Err($crate::DomainError::with_hint(
            $crate::ErrorKind::$kind,
            format!($fmt $(, $arg)*),
            $hint.to_string(),
        ).into())
    };
    ($kind:ident, $fmt:literal $(, $arg:expr)*) => {
        return Err($crate::DomainError::new(
            $crate::ErrorKind::$kind,
            format!($fmt $(, $arg)*),
        ).into())
    };
    ($($arg:tt)*) => {
        return Err($crate::DomainError::new(
            $crate::ErrorKind::Validation,
            format!($($arg)*),
        ).into())
    };
}
pub(crate) use domain_bail;

/// Global quiet flag — set once at startup, read by command functions.
pub(crate) fn is_quiet() -> bool {
    crate::QUIET.load(std::sync::atomic::Ordering::Relaxed)
}

/// Global JSON output flag — set once at startup.
pub(crate) fn is_json_output() -> bool {
    crate::JSON_OUTPUT.load(std::sync::atomic::Ordering::Relaxed)
}

pub(crate) fn is_dry_run() -> bool {
    crate::DRY_RUN.load(std::sync::atomic::Ordering::Relaxed)
}

/// Resolve the .tickets/ directory from cwd.
pub(crate) fn tickets_dir() -> Result<PathBuf> {
    let cwd = std::env::current_dir()?;
    let root = git::repo_root(&cwd)?;
    let dir = root.join(".tickets");
    if !dir.is_dir() {
        domain_bail!("no .tickets/ directory in {}", root.display());
    }
    Ok(dir)
}

/// Load project-level config from .tickets/config.toml.
/// Warns on unknown keys. Returns defaults if file is missing.
pub(crate) fn project_config(tickets_dir: &Path) -> crate::config::ProjectConfig {
    let cfg = crate::config::ProjectConfig::load(tickets_dir);
    for key in &cfg.unknown_keys {
        eprintln!(
            "warning: unknown config key {:?} in .tickets/config.toml",
            key
        );
    }
    cfg
}

/// Format a success message consistently.
pub(crate) fn success_msg(verb: &str, id: &str, slug: &str, detail: &str) -> String {
    format!(
        "{} {} {} {} ({})",
        crate::color::sym_ok(),
        verb,
        id,
        slug,
        detail
    )
}

/// Print a success message — emits JSON envelope when -o json, human text otherwise.
pub(crate) fn print_success(verb: &str, id: &str, slug: &str, detail: &str) {
    if is_json_output() {
        let result = format!("{} {} {} ({})", verb, id, slug, detail);
        crate::cli::emit_json_success(&result);
    } else {
        println!("{}", success_msg(verb, id, slug, detail));
    }
}

/// Extract slug from a ticket filename like "01-my-slug.md" → "my-slug"
pub(crate) fn slug_from_filename(path: &Path) -> String {
    let name = path
        .file_name()
        .unwrap_or_default()
        .to_string_lossy()
        .to_string();
    // Strip leading digits and dash, strip .md
    if let Some(pos) = name.find('-') {
        name[pos + 1..].trim_end_matches(".md").to_string()
    } else {
        name.trim_end_matches(".md").to_string()
    }
}