apm-cli 0.1.14

CLI project manager for running AI coding agents in parallel, isolated by design.
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

use anyhow::Result;
use apm_core::{config::Config, git, ticket, ticket_fmt, worktree};
use std::io::{self, BufRead, Write};
use std::path::{Path, PathBuf};

/// Run `git fetch --all` when `aggressive` is true; emit a warning on failure.
pub fn fetch_if_aggressive(root: &Path, aggressive: bool) {
    if aggressive {
        if let Err(e) = git::fetch_all(root) {
            eprintln!("warning: fetch failed: {e:#}");
        }
    }
}

/// Run `git fetch <branch>` when `aggressive` is true; emit a warning on failure.
pub fn fetch_branch_if_aggressive(root: &Path, branch: &str, aggressive: bool) {
    if aggressive {
        if let Err(e) = git::fetch_branch(root, branch) {
            eprintln!("warning: fetch failed: {e:#}");
        }
    }
}

/// Print `prompt`, flush stdout, read one line, return true iff the answer is "y".
pub fn prompt_yes_no(prompt: &str) -> io::Result<bool> {
    print!("{prompt}");
    io::stdout().flush()?;
    let mut line = String::new();
    io::stdin().lock().read_line(&mut line)?;
    Ok(line.trim().eq_ignore_ascii_case("y"))
}

/// Resolve a ticket ID argument to its worktree path and canonical ticket ID.
/// Loads config and tickets from git internally.
pub fn worktree_for_ticket(root: &Path, id_arg: &str) -> Result<(PathBuf, String)> {
    let config = Config::load(root)?;
    let tickets = ticket::load_all_from_git(root, &config.tickets.dir)?;
    let id = ticket::resolve_id_in_slice(&tickets, id_arg)?;
    let t = tickets
        .iter()
        .find(|t| t.frontmatter.id == id)
        .ok_or_else(|| anyhow::anyhow!("ticket {id:?} not found"))?;
    let branch = t
        .frontmatter
        .branch
        .clone()
        .or_else(|| ticket_fmt::branch_name_from_path(&t.path))
        .unwrap_or_else(|| format!("ticket/{id}"));
    let wt = worktree::find_worktree_for_branch(root, &branch)
        .ok_or_else(|| anyhow::anyhow!("no worktree for ticket {id:?}"))?;
    Ok((wt, id))
}