# Merge pull request #27 from entireio/naming

`c771d1e`→[main](/content/gh/entireio/git-sync/commits/main/index.html)·

Consolidate module prefix to `entire.io/entire/git-sync`

## Changes

40

- M.golangci.yaml+1/-1
- MCONTRIBUTING.md+1/-1
- MREADME.md+2/-2
- MSECURITY.md+1/-1
- Mclient.go+2/-2
- Mclient_test.go+1/-1

- cmd
  
  - git-sync-bench
    
    - Mmain.go+4/-4
    - Mmain_test.go+1/-1

- git-sync
    
    - Mmain.go+13/-13
    - Mmain_test.go+1/-1

- docs
  
  - Mprotocol.md+1/-1

- Mexample_test.go+1/-1
- Mgo.mod+1/-1

- internal
  
  - convert
    
    - Mconvert.go+2/-2
    - Mconvert_test.go+2/-2
  
  - planner
    
    - Mplanner.go+1/-1
    - Mplanner_test.go+1/-1
    - Mtypes.go+1/-1
  
  - strategy
    
    - bootstrap
      
      - Mbootstrap.go+3/-3
      - Mbootstrap_test.go+2/-2
    
    - incremental
      
      - Mincremental.go+3/-3
      - Mincremental_test.go+3/-3
    
    - materialized
      
      - Mmaterialized.go+3/-3
      - Mmaterialized_test.go+4/-4
    
    - replicate
      
      - Mreplicate.go+3/-3
      - Mreplicate_test.go+2/-2
  
  - syncer
    
    - Mauth_test.go+1/-1
    - Mbenchmark_test.go+1/-1
    - Mgit_http_backend_test.go+3/-3
    - Mintegration_test.go+4/-4
    - Mstats.go+1/-1
    - Msyncer.go+9/-9
    - Msyncer_test.go+1/-1

- internalbridge
  
  - Mconfig.go+2/-2
  - Mmodel.go+2/-2
  - Mmodel_test.go+2/-2

- mise-tasks/lint
  
  - Mlicenses+1/-1

- Mtypes.go+1/-1
- unstable
  
  - Mclient.go+4/-4
  - Mclient_test.go+1/-1

```

96 unmodified lines

```go
- github.com/go-git/go-git/v6/storage.Storer
- github.com/go-git/go-git/v6/plumbing/storer.EncodedObjectIter
- github.com/go-git/go-billy/v6.Filesystem
- entire.io/entire/gitsync/internal/auth.Method
- entire.io/entire/git-sync/internal/auth.Method
  nolintlint:
    require-explanation: true
    require-specific: true
```

M.golangci.yaml+1/-1

```

153 unmodified lines

---

```go
- **Formatting**: Code must pass `gofmt` (run `mise run fmt`)
- **Linting**: Code must pass `golangci-lint` (run `mise run lint`)
- **Naming**: Use meaningful, descriptive names following Go conventions
- **Public API**: `entire.io/entire/gitsync` is the stable embedding surface. Additions there should be reviewed carefully. `entire.io/entire/gitsync/unstable` is for advanced controls and may change.
- **Public API**: `entire.io/entire/git-sync` is the stable embedding surface. Additions there should be reviewed carefully. `entire.io/entire/git-sync/unstable` is for advanced controls and may change.
````

## Library API

`git-sync` is also a Go library. Use `entire.io/entire/gitsync` for the stable embedding surface (`Probe`, `Plan`, `Sync`, `Replicate`, typed results, auth and HTTP injection). `entire.io/entire/gitsync/unstable` exposes advanced controls (`Bootstrap`, `Fetch`, batching knobs, heap measurement) and is not stable.

## Installation

Install the latest release with `go install`:

```bash
go install entire.io/entire/gitsync/cmd/git-sync@latest
go install entire.io/entire/git-sync/cmd/git-sync@latest
```

This drops a `git-sync` binary into `$(go env GOPATH)/bin`. Make sure that directory is on your `PATH`.

MCONTRIBUTING.md+1/-1

````
28 unmodified lines

## Security Policy

This security policy applies to:

- The `git-sync` CLI and `git-sync-bench` benchmark command
- The `entire.io/entire/gitsync` and `entire.io/entire/gitsync/unstable` Go packages
- The `entire.io/entire/git-sync` and `entire.io/entire/git-sync/unstable` Go packages
- Official Entire GitHub repositories

### Out of Scope
````

MREADME.md+2/-2

```

36 unmodified lines

---

MSECURITY.md+1/-1

```

5 unmodified lines

```
Mclient.go+2/-2

```go

14 unmodified lines

```
Mclient_test.go+1/-1

```go

14 unmodified lines

Mcmd/git-sync-bench/main.go+4/-4

```go

2 unmodified lines

```
Mcmd/git-sync-bench/main_test.go+1/-1

```go

8 unmodified lines

```
Mcmd/git-sync/main.go+13/-13

```go

13 unmodified lines

```
Mcmd/git-sync/main_test.go+1/-1

```go

303 unmodified lines

```
Mdocs/protocol.md+1/-1

```go

3 unmodified lines

```
Mexample_test.go+1/-1

````
1
1
2
3
4

module entire.io/entire/gitsync
module entire.io/entire/git-sync

go 1.26.2
````

Mgo.mod+1/-1

```

5 unmodified lines

```
Minternal/convert/convert.go+2/-2

````
4 unmodified lines

````
Minternal/convert/convert_test.go+2/-2

````
4 unmodified lines

Mtypes.go+1/-1

````
22 unmodified lines

````\nMinternal/strategy/bootstrap/bootstrap.go+3/-3

````
17 unmodified lines

````
Minternal/strategy/bootstrap/bootstrap_test.go+2/-2

````
11 unmodified lines

````
Minternal/strategy/incremental/incremental.go+3/-3

````
8 unmodified lines

````
Minternal/strategy/incremental/incremental_test.go+3/-3

````
11 unmodified lines

````
Minternal/strategy/materialized/materialized.go+3/-3

````
7 unmodified lines

````
Minternal/strategy/materialized/materialized_test.go+4/-4

````
9 unmodified lines

````
Minternal/strategy/replicate/replicate.go+3/-3

````
7 unmodified lines

````
Minternal/strategy/replicate/replicate_test.go+2/-2

````
13 unmodified lines

````
Minternal/syncer/auth_test.go+1/-1

````
1 unmodified line

````
Minternal/syncer/benchmark_test.go+1/-1

````
14 unmodified lines

````
Minternal/syncer/git_http_backend_test.go+3/-3

````
13 unmodified lines

````
Minternal/syncer/integration_test.go+4/-4

````
6 unmodified lines

````
Minternal/syncer/stats.go+1/-1

````
20 unmodified lines

````
Minternal/syncer/syncer.go+9/-9

````
4 unmodified lines

````
Minternal/syncer/syncer_test.go+1/-1

````
3 unmodified lines

````
Minternalbridge/config.go+2/-2

````
2 unmodified lines

````
Minternalbridge/model.go+2/-2

````
4 unmodified lines

````
Munstable/client.go+4/-4

````
6 unmodified lines

```
