progit-forge-client

Async Rust client for the progit-forged daemon, plus the GitBackend trait used by the ProGit TUI to abstract over local-disk vs. daemon-backed git data.

Two layers

┌──────────────────────────────────────────────────┐
│  GitBackend trait        (wire-independent)       │  ← consumed by TUI
└──────────────────────────────────────────────────┘
                  │                │
       ForgedBackend          LocalGitBackend
       (this crate)           (in TUI crate;
            │                  uses gix)
            ▼
┌──────────────────────────────────────────────────┐
│  ForgeClient             (gRPC over tonic)        │  ← raw client
└──────────────────────────────────────────────────┘
            │
     ┌──────▼──────┐
     │ progit-forged│
     └─────────────┘

Use as a daemon-backed backend

use progit_forge_client::{ForgedBackend, backend::{GitBackend, RefUpdate}};

let backend = ForgedBackend::connect("http://127.0.0.1:7421").await?;
backend.create_repo("hello").await?;
backend.push("hello", vec![RefUpdate {
    ref_name: "refs/heads/main".into(),
    old_oid: String::new(),
    new_oid: blob_oid,
}], Some(pack_bytes)).await?;
let pack = backend.fetch("hello", vec![]).await?;

The TUI holds Box<dyn GitBackend> and stays oblivious to whether the bytes round-trip through a sidecar daemon or a local gix invocation.

Use as a raw client (lower-level)

use progit_forge_client::{ForgeClient, RefUpdate};

let mut client = ForgeClient::connect("http://127.0.0.1:7421").await?;
client.create_repo("hello").await?;
// ... full RPC surface, see RPC coverage table below.

RPC coverage

Method	Status
connect / from_channel	full
create_repo / delete_repo / stat	full
list_refs (with optional prefix)	full
push (refs + optional pack, 64 KB chunked)	full
fetch (collected Vec<u8>)	full, single-pack v0.1.3.0
fetch_streaming (raw tonic::Streaming)	full
create_ephemeral_branch (TTL, optional name)	full
merge_ref	bound but server-side Unimplemented until v0.1.4

GitBackend coverage

Method	Status
create_repo / delete_repo	full
list_refs	full
push (refs + optional pack)	full
fetch	full, single-pack
create_ephemeral_branch (default returns Unsupported)	full on ForgedBackend

BackendError carries semantic variants (RepoNotFound, RepoExists, InvalidInput, CasFailed, Unsupported, …) so consumers pattern-match on intent rather than scraping error strings.

Status

v0.1 — full RPC surface, full GitBackend trait, 37 tests passing (14 lib + 22 e2e + 1 doctest).

License

LSL-1.0.