agentvcs

type Adapter struct {
	// contains filtered or unexported fields
}

type Commit struct {
	ID               string `json:"id"`                           // Content-derived hash
	ParentID         string `json:"parent_id"`                    // Previous commit (empty for root)
	SessionID        string `json:"session_id"`                   // Owning agent session
	TreeID           string `json:"tree_id"`                      // Hash of the Tree object
	Description      string `json:"description"`                  // Human-readable label
	Author           string `json:"author"`                       // "agent" or user identifier
	CreatedAt        int64  `json:"created_at"`                   // Unix timestamp
	FileCount        int    `json:"file_count"`                   // Number of tracked files in the resulting tree
	TotalSize        int64  `json:"total_size"`                   // Sum of file sizes in the resulting tree
	ChangedFileCount int    `json:"changed_file_count,omitempty"` // Files changed vs parent for this commit
	ChangedTotalSize int64  `json:"changed_total_size,omitempty"` // Aggregate size of changed files for this commit
}

type CommitSummary struct {
	ID               string `json:"id"`
	ShortID          string `json:"short_id"` // First 12 hex chars
	ParentID         string `json:"parent_id,omitempty"`
	SessionID        string `json:"session_id"`
	Description      string `json:"description"`
	FileCount        int    `json:"file_count"`
	TotalSize        int64  `json:"total_size"`
	CreatedAt        int64  `json:"created_at"`
	ChangedFiles     int    `json:"changed_files"`      // Files changed vs parent
	ChangedTotalSize int64  `json:"changed_total_size"` // Aggregate size of changed files
}

type DiffEntry struct {
	Path    string   `json:"path"`
	Type    DiffType `json:"type"`
	OldHash string   `json:"old_hash,omitempty"`
	NewHash string   `json:"new_hash,omitempty"`
	OldSize int64    `json:"old_size,omitempty"`
	NewSize int64    `json:"new_size,omitempty"`
}

type DiffType string

type Service interface {
	pubsub.Suscriber[Commit]

	// NewChange creates the initial commit for a session, capturing the current
	// working directory state. Analogous to `jj new`.
	NewChange(ctx context.Context, sessionID, description string) (Commit, error)

	// Record snapshots the working directory and creates a new commit in the
	// session's chain if any files changed since the last commit. Returns the
	// new commit or the previous HEAD if nothing changed.
	Record(ctx context.Context, sessionID, description string) (Commit, error)

	// Log returns the ordered list of commits for a session (oldest first).
	Log(ctx context.Context, sessionID string) ([]CommitSummary, error)

	// GetCommit retrieves a single commit by ID.
	GetCommit(ctx context.Context, id string) (Commit, error)

	// GetTree retrieves a tree object by ID.
	GetTree(ctx context.Context, id string) (Tree, error)

	// Diff computes the file-level changes between two commits.
	Diff(ctx context.Context, commitID1, commitID2 string) ([]DiffEntry, error)

	// DiffFromParent computes the file-level changes between a commit and its parent.
	DiffFromParent(ctx context.Context, commitID string) ([]DiffEntry, error)

	// GetFileContent retrieves blob content by hash.
	GetFileContent(ctx context.Context, hash string) ([]byte, error)

	// ListSessions returns all session IDs that have at least one commit.
	ListSessions(ctx context.Context) ([]string, error)

	// SessionCommitCount returns the number of commits in a session.
	SessionCommitCount(ctx context.Context, sessionID string) (int, error)

	// Revert restores the working directory to the state captured in a commit.
	Revert(ctx context.Context, commitID string) error

	// Cleanup removes old sessions and orphan blobs.
	Cleanup(ctx context.Context, maxAgeDays, maxSessions int) error
}

type SessionLog struct {
	SessionID string   `json:"session_id"`
	Commits   []string `json:"commits"` // Oldest first
	CreatedAt int64    `json:"created_at"`
	UpdatedAt int64    `json:"updated_at"`
}

type Tree struct {
	ID      string      `json:"id"`      // SHA-256 of the serialised entries
	Entries []TreeEntry `json:"entries"` // Sorted list of tracked files
}

type TreeEntry struct {
	Path    string `json:"path"`             // Slash-separated relative path
	Hash    string `json:"hash,omitempty"`   // SHA-256 of file content
	Size    int64  `json:"size,omitempty"`   // File size in bytes
	ModTime int64  `json:"mod_time"`         // Last modification (Unix)
	IsDir   bool   `json:"is_dir,omitempty"` // Directory marker
}