easyvcs

module
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 14, 2026 License: MIT

README

easyvcs

A Change-Native version control engine, extracted from EasyLab as a standalone, dependency-light Go module.

Concept

Change (a logical modification) is the first-class entity with a stable id (change_id / revision_id) that never changes, no matter how often it is rebased, squashed, or amended. The content version (Snapshot) is content-addressed and mutable via rewrite. Refs are bookmarks (branches, mutable) and tags (immutable).

  • Snapshots are content-addressed graph nodes (sha derived from parents + tree + description + author). Rebasing changes the sha but never the change_id.
  • Tree / blob / conflict (first-class conflict objects) make up the object model, with 3-way tree merges.
  • Pluggable storage via store.Store: FileStore (local .easyvcs/ directory) and SqlStore (SQLite / Postgres) share one interface; content can live in the DB too (no format-must-match-Git constraint).

Packages

  • object — content-addressed primitives (blob, tree, conflict) and ids
  • store — the persistence boundary (RepoStore interface over GORM; switchable sqlite/postgres/mysql, plus CentralStore/Repo). Object content lives in the DB (no .git object storage).
  • revision — the semantic layer (commit / amend / rebase / squash / merge / resolve / drop / revert / diff), stable-id rules live here
  • merge — 3-way tree merge producing first-class conflicts
  • transfer — serialization / bundling (codecs, deltas)
  • gitbridge — experimental Git interoperability (smart protocol via go-git; exports/imports revisions as Git commits, no .git storage on the easyvcs side)
  • server — the authoritative VCS protocol server library (server.New/Handler), reusable by easylab
  • mirror / encoding / ignore / webapi — supporting layers

CLI

easyvcs init [DIR]
easyvcs commit [--new] [DIR]
easyvcs amend [DIR]
easyvcs log / show / diff / checkout
easyvcs rebase <revision> --onto <sha>
easyvcs branch <name> <revision>     (bookmark; derives an independent revision)
easyvcs tag <name> <revision>        (immutable)
easyvcs refs / rev <expr>
easyvcs git-pull <git-url> [branch] [--token][--ssh-key][--passphrase]
easyvcs git-push <git-url> [branch] [--token][--ssh-key][--passphrase]

Build

CGO_ENABLED=0 go build -o easyvcs ./cmd/easyvcs
CGO_ENABLED=0 go build -o easyvcs-server ./cmd/server

Module

github.com/easylab-platform/easyvcs. It is consumed as a library by github.com/easylab-platform/easylab (the server, agent bridge, and ops platform). Licensed under MIT (see LICENSE).

Directories

Path Synopsis
cmd
easyvcs command
Command easyvcs is the EasyVCS command-line interface.
Command easyvcs is the EasyVCS command-line interface.
server command
Command server is the thin executable entrypoint for the EasyVCS VCS protocol server.
Command server is the thin executable entrypoint for the EasyVCS VCS protocol server.
Package encoding implements compact binary codecs for EasyVCS metadata and trees.
Package encoding implements compact binary codecs for EasyVCS metadata and trees.
Package ignore implements gitignore/.vcsignore handling.
Package ignore implements gitignore/.vcsignore handling.
Package merge implements N-way tree merge and first-class conflicts.
Package merge implements N-way tree merge and first-class conflicts.
Package mirror implements push/pull mirroring between an EasyVCS repository (revision-native) and an external git server over the local git CLI (no inbound git smart protocol).
Package mirror implements push/pull mirroring between an EasyVCS repository (revision-native) and an external git server over the local git CLI (no inbound git smart protocol).
Package object implements content-addressed immutable objects.
Package object implements content-addressed immutable objects.
Package revision implements the semantic layer of EasyVCS.
Package revision implements the semantic layer of EasyVCS.
Package store defines the persistent storage boundary for EasyVCS.
Package store defines the persistent storage boundary for EasyVCS.
Package transfer implements the wire-format for moving repository state between two stores.
Package transfer implements the wire-format for moving repository state between two stores.
Package webapi is the EasyLab UI-facing aggregate gateway.
Package webapi is the EasyLab UI-facing aggregate gateway.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL