Git designed for AI agents.
package stats
import (
"errors"
"fmt"
"io"
"strings"
"time"
"github.com/feder-cr/git-ai/internal/git/pktline"
"github.com/feder-cr/git-ai/internal/helper/text"
)
// Reference as used by the reference discovery protocol
type Reference struct {
// Oid is the object ID the reference points to
Oid string
// Name of the reference. The name will be suffixed with ^{} in case
// the reference is the peeled commit.
Name string
}
// ReferenceDiscovery contains information about a reference discovery session.
type ReferenceDiscovery struct {
// FirstPacket tracks the time when the first pktline was received
FirstPacket time.Time
// LastPacket tracks the time when the last pktline was received
LastPacket time.Time
// PayloadSize tracks the size of all pktlines' data
PayloadSize int64
// Packets tracks the total number of packets consumed
Packets int
// Refs contains all announced references
Refs []Reference
// Caps contains all supported capabilities
Caps []string
}
type referenceDiscoveryState int
const (
referenceDiscoveryExpectService referenceDiscoveryState = iota
referenceDiscoveryExpectFlush
referenceDiscoveryExpectRefWithCaps
referenceDiscoveryExpectRef
referenceDiscoveryExpectEnd
)
// ParseReferenceDiscovery parses a client's reference discovery stream and
// returns either information about the reference discovery or an error in case
// it couldn't make sense of the client's request.
func ParseReferenceDiscovery(body io.Reader) (ReferenceDiscovery, error) {
d := ReferenceDiscovery{}
return d, d.Parse(body)
}
// Parse parses a client's reference discovery stream into the given
// ReferenceDiscovery struct or returns an error in case it couldn't make sense
// of the client's request.
//
// Expected protocol:
// - "# service=git-upload-pack\n"
// - FLUSH
// - "<OID> <ref>\x00<capabilities>\n"
// - "<OID> <ref>\n"
// - ...
// - FLUSH
func (d *ReferenceDiscovery) Parse(body io.Reader) error {
state := referenceDiscoveryExpectService
scanner := pktline.NewScanner(body)
for ; scanner.Scan(); d.Packets++ {
pkt := scanner.Bytes()
data := text.ChompBytes(pktline.Data(pkt))
d.PayloadSize += int64(len(data))
switch state {
case referenceDiscoveryExpectService:
d.FirstPacket = time.Now()
if data != "# service=git-upload-pack" {
return fmt.Errorf("unexpected header %q", data)
}
state = referenceDiscoveryExpectFlush
case referenceDiscoveryExpectFlush:
if !pktline.IsFlush(pkt) {
return errors.New("missing flush after service announcement")
}
state = referenceDiscoveryExpectRefWithCaps
case referenceDiscoveryExpectRefWithCaps:
split := strings.SplitN(data, "\x00", 2)
if len(split) != 2 {
return errors.New("invalid first reference line")
}
ref := strings.SplitN(split[0], " ", 2)
if len(ref) != 2 {
return errors.New("invalid reference line")
}
d.Refs = append(d.Refs, Reference{Oid: ref[0], Name: ref[1]})
d.Caps = strings.Split(split[1], " ")
state = referenceDiscoveryExpectRef
case referenceDiscoveryExpectRef:
if pktline.IsFlush(pkt) {
state = referenceDiscoveryExpectEnd
continue
}
split := strings.SplitN(data, " ", 2)
if len(split) != 2 {
return errors.New("invalid reference line")
}
d.Refs = append(d.Refs, Reference{Oid: split[0], Name: split[1]})
case referenceDiscoveryExpectEnd:
return errors.New("received packet after flush")
}
}
if err := scanner.Err(); err != nil {
return err
}
if len(d.Refs) == 0 {
return errors.New("received no references")
}
if len(d.Caps) == 0 {
return errors.New("received no capabilities")
}
if state != referenceDiscoveryExpectEnd {
return errors.New("discovery ended prematurely")
}
d.LastPacket = time.Now()
return nil
}