Merge pull request #29 from entireio/update-changelog-first-release

414c006→main·

gtrrz-victor·2mo ago·1 file·+64 added/-48 removed

Document v0.4.2 in CHANGELOG

Changes

1

• MCHANGELOG.md+64/-48

Changelog

Entries are grouped per release. Unreleased changes sit at the top. All notable changes to this project will be documented in this file.

Unreleased

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.4.2] - 2026-04-30

First public release. git-sync mirrors refs from a source remote to a target remote without a local checkout, streaming source packs directly into target receive-pack whenever possible. The release covers the CLI, the library API, and the protocol plumbing they share.

Added

• git-sync replicate subcommand and git-sync plan --mode replicate for
• git-sync sync — relay-based mirror that streams source upload-pack output into target receive-pack without materializing the object graph locally. Falls back to an in-memory go-git store, bounded by --materialized-max-objects, when relay is not eligible (force, prune, deletes, tag retargets) (#1, #2).
• git-sync replicate and git-sync plan --mode replicate for source-authoritative, relay-only replication. Divergent branches and tags are retargeted against the source; --prune deletes orphan managed refs. Relay-only by design: no materialized fallback. Replicate works against targets that advertise no-thin (including any server built on go-git's receive-pack, e.g. entire-server) because the relayed pack is always self-contained — our upload-pack client never requests the thin-pack capability from the source.
• gitsync.Client.Replicate on the stable embedding surface.
• gitsync.OperationMode, gitsync.ModeSync, gitsync.ModeReplicate, and SyncPolicy.Mode for selecting the mode from library callers.
• --max-pack-bytes and --target-max-pack-bytes flags on sync, replicate, and plan. Previously only bootstrap exposed them, but replicate's bootstrap-fallback path internally honors both — without these flags, users couldn't split a huge initial replicate push into tractable receive-pack POSTs for size-limited targets. The unstable library buildSyncConfig now forwards MaxPackBytes and TargetMaxPackBytes from AdvancedOptions to syncer.Config.

Changed (stable API, breaking)

• The stable SyncResult.Execution summary has a new field layout:
  • Added execution.operation_mode ("sync" or "replicate") to describe the high-level product mode the caller requested.
  • Renamed execution.mode to execution.transfer_mode to describe the low-level engine path that actually executed (incremental-relay, materialized, bootstrap-relay, replicate, etc.). The previous mode key is no longer emitted.

External embedders that parse execution.mode must switch to execution.transfer_mode. There is no compatibility alias; the field was renamed in place.

• syncer.Result (the CLI-level JSON shape) gains a top-level operation_mode field alongside the existing relay fields. Callers consuming the flat CLI JSON can use it to distinguish sync vs replicate results.

Fixed

• Work around a go-git v6 upload-pack bug where the server emits two consecutive NAK pktlines in stateless-RPC mode when the client sends haves that are not reachable from any want. The second NAK would otherwise be misread by the sideband demuxer as a frame with channel byte 'N' ("unknown channel NAK"). internal/gitproto.fetchPackV1 and fetchToStoreV1 now drain trailing NAKs before handing off to the demuxer. See the corresponding go-git fix (plumbing/transport: don't emit a second NAK after encoding empty ACKs). Relay-only by design: no materialized fallback (#4).
• git-sync plan — preview the actions a sync or replicate would take, with structured JSON output suitable for automation.
• git-sync bootstrap — initial-seed path for empty targets, with adaptive batching, trunk-first planning to cut per-branch graph fetches, and resume-from-stale-temp-refs recovery (#6).
• git-sync version subcommand with build metadata (#26).
• Reusable Go library at entire.io/entire/git-sync. The stable surface (Probe, Plan, Sync, Replicate, typed results, auth and HTTP injection) lives at the module root; advanced controls (Bootstrap, Fetch, batching knobs, heap measurement) live in entire.io/entire/git-sync/unstable (#3, #17).
• Git protocol v2 source-side support: ls-refs, fetch with v2 acknowledgments and response-end handling, capability negotiation, and graceful fallback when the source does not advertise v2.
• Smart HTTP transport: pkt-line primitives, sideband demultiplexing, info/refs advertisement validation, smart endpoint path normalization, oversized packet rejection, empty pkt-line acceptance, and v2 fetch remote ERR packet handling.
• Optional info/refs redirect following on the source endpoint, exposed through the public gitsync API (#9).
• Git credential helper fallback and --source-token / --target-token flags for HTTPS auth.
• JSON output mode with a stable schema and camelCase keys across all commands (#7).
• Adaptive bootstrap batching: auto-subdivide on target body-size rejection, pre-check PACK header object count before pushing oversized batches, and shared --max-pack-bytes / --target-max-pack-bytes flags across sync, replicate, plan, and bootstrap.
• Sideband progress streamed to stderr when -v is set.
• Homebrew tap install via brew tap entireio/tap && brew install --cask git-sync (#25).
• GoReleaser-based release pipeline for cross-platform binaries (#26).
• Identical source and target endpoints are rejected before any network round-trips.
• Documentation set: docs/usage.md, docs/architecture.md, docs/protocol.md, docs/testing.md, plus README installation, quick-start, and FAQ (#21, #22, #23).