Artifact [3aa8e17d71]

Artifact 3aa8e17d7112ac7d9f7ef8a460f190d871035b446260caad4f6b29034e3afb38:

• File internal/sync/stubs.go — part of check-in [f5744359d3] at 2026-04-19 16:30:54 on branch trunk — Initial open source release

  libfossil is a pure-Go implementation of the Fossil SCM, reading and writing the same .fossil SQLite repository format as upstream Fossil.

  This is the first public release of code that previously lived in a private repository. The module path is github.com/danmestas/libfossil and the binary is named libfossil to avoid $PATH collisions with upstream fossil.

  Included: - Repo lifecycle (create, clone), checkout/checkin, timeline, merge, diff, annotate, shun, tag, branch, bisect, stash, undo/redo - Sync-over-HTTP protocol (client and handler) - Two SQLite drivers: modernc (pure Go, default) and ncruces (wasm-capable) - Observer interfaces (SyncObserver, CheckoutObserver) with an optional OpenTelemetry implementation in observer/otel (separate submodule) - Deterministic simulation testing harness with BUGGIFY fault injection - Kong-based embeddable CLI under cli/ and a standalone binary under cmd/libfossil/ (user: [email protected], size: 739) [annotate] [blame] [check-ins using]

package sync

import "github.com/danmestas/libfossil/simio"

// CloneOpts configures a clone operation.
type CloneOpts struct {
	User     string     // Credentials for clone auth (also default admin user)
	Password string
	Version  int        // Protocol version (default 3)
	Env      *simio.Env // nil defaults to RealEnv
	Observer Observer   // nil defaults to no-op
	Buggify  BuggifyChecker // fault injection for DST (nil = no faults)
}

// CloneResult reports what happened during a clone.
type CloneResult struct {
	Rounds         int
	BlobsRecvd     int
	ArtifactsLinked int     // Manifests crosslinked into event table
	ProjectCode    string
	ServerCode     string
	Messages       []string // Informational messages from server
}