git-paw 0.7.0

Parallel AI Worktrees — orchestrate multiple AI coding CLI sessions across git worktrees
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
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

//! Git-context tools: `get_branches`, `get_recent_commits`, `get_diff`.
//!
//! Thin wrappers over read-only git invocations against the resolved
//! repository root. These always work (the repo always exists), so there is no
//! degradation path.

use rmcp::handler::server::wrapper::{Json, Parameters};
use rmcp::{schemars, tool, tool_router};
use serde::{Deserialize, Serialize};

use crate::mcp::query;
use crate::mcp::query::git::Diff;
use crate::mcp::server::GitPawMcpServer;

/// Parameters for [`GitPawMcpServer::get_recent_commits`].
#[derive(Debug, Deserialize, schemars::JsonSchema)]
pub struct GetRecentCommitsParams {
    /// Branch to read commits from.
    pub branch: String,
    /// Maximum number of commits to return (default 20).
    #[serde(default = "default_limit")]
    #[schemars(description = "Maximum number of commits to return (default 20)")]
    pub limit: usize,
}

fn default_limit() -> usize {
    20
}

/// Parameters for [`GitPawMcpServer::get_diff`].
#[derive(Debug, Deserialize, schemars::JsonSchema)]
pub struct GetDiffParams {
    /// Branch to diff.
    pub branch: String,
    /// Base to diff against (defaults to the repository's default branch).
    #[serde(default)]
    pub base: Option<String>,
}

/// Response for `get_branches`.
#[derive(Serialize, schemars::JsonSchema)]
pub struct BranchesResponse {
    /// Local branches.
    pub branches: Vec<query::git::Branch>,
}

/// Response for `get_recent_commits`.
#[derive(Serialize, schemars::JsonSchema)]
pub struct CommitsResponse {
    /// Commits, newest first.
    pub commits: Vec<query::git::Commit>,
}

#[tool_router(router = git_router, vis = "pub(crate)")]
impl GitPawMcpServer {
    /// `get_branches` — local branches with head SHA + flags.
    #[tool(
        description = "List local branches, each with name, head commit SHA, whether it is the \
                       currently checked-out branch, and whether it is checked out in a linked \
                       (git-paw managed) worktree."
    )]
    pub(crate) fn get_branches(&self) -> Json<BranchesResponse> {
        Json(BranchesResponse {
            branches: query::git::branches(&self.ctx.root),
        })
    }

    /// `get_recent_commits` — last N commits on a branch.
    #[tool(
        description = "Return up to `limit` (default 20) recent commits on `branch`, newest first, \
                       each with sha, author, ISO timestamp, and subject."
    )]
    pub(crate) fn get_recent_commits(
        &self,
        Parameters(p): Parameters<GetRecentCommitsParams>,
    ) -> Json<CommitsResponse> {
        Json(CommitsResponse {
            commits: query::git::recent_commits(&self.ctx.root, &p.branch, p.limit),
        })
    }

    /// `get_diff` — diff of a branch against its base.
    #[tool(
        description = "Return the diff of `branch` against `base` (default: the repo's default \
                       branch) with a files-changed / insertions / deletions summary."
    )]
    pub(crate) fn get_diff(&self, Parameters(p): Parameters<GetDiffParams>) -> Json<Diff> {
        Json(query::git::diff(
            &self.ctx.root,
            &p.branch,
            p.base.as_deref(),
        ))
    }
}