api

type DoctorIssue struct {
	Type        string `json:"type"`                   // e.g., "merge_pending", "team_invite_pending"
	Severity    string `json:"severity"`               // "error", "warning", "info"
	Title       string `json:"title"`                  // short display title
	Description string `json:"description"`            // detailed explanation, supports Markdown
	ActionURL   string `json:"action_url,omitempty"`   // URL to resolve the issue
	ActionLabel string `json:"action_label,omitempty"` // button text, e.g., "Resolve merge"
}

type DoctorResponse struct {
	Issues    []DoctorIssue `json:"issues"`
	CheckedAt string        `json:"checked_at"` // RFC3339 timestamp
}

type LedgerStatusResponse struct {
	Status      string `json:"status"`                 // "ready", "pending", "error"
	RepoURL     string `json:"repo_url"`               // git clone URL (empty if not ready)
	RepoID      int    `json:"repo_id"`                // GitLab project ID (internal use)
	CreatedAt   string `json:"created_at"`             // RFC3339 timestamp
	Message     string `json:"message,omitempty"`      // optional status message
	Visibility  string `json:"visibility,omitempty"`   // "public" or "private" (new field, may be empty on older servers)
	AccessLevel string `json:"access_level,omitempty"` // "member" or "viewer" (new field, may be empty on older servers)
}

type RedirectConfig struct {
	RepoID string `json:"repo_id,omitempty"`
	TeamID string `json:"team_id,omitempty"`
}

type RedirectInfo struct {
	Repo   *RedirectMapping `json:"repo,omitempty"`
	Team   *RedirectMapping `json:"team,omitempty"`
	Config *RedirectConfig  `json:"config,omitempty"`
}

type RedirectMapping struct {
	From string `json:"from"`
	To   string `json:"to"`
}

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

type RepoDetailLedger struct {
	Status  string `json:"status"`            // "ready", "pending", "error"
	RepoURL string `json:"repo_url"`          // git clone URL (empty if not ready)
	Message string `json:"message,omitempty"` // status message for pending/error
}

type RepoDetailResponse struct {
	Visibility   string                  `json:"visibility"`    // "public" or "private"
	AccessLevel  string                  `json:"access_level"`  // "member" or "viewer"
	Ledger       *RepoDetailLedger       `json:"ledger"`        // null if not provisioned
	TeamContexts []RepoDetailTeamContext `json:"team_contexts"` // empty if none accessible
}

type RepoDetailTeamContext struct {
	TeamID      string `json:"team_id"`      // team_xxx
	Name        string `json:"name"`         // display name
	Visibility  string `json:"visibility"`   // "public" or "private"
	AccessLevel string `json:"access_level"` // "member" or "viewer"
	RepoURL     string `json:"repo_url"`     // git clone URL
}

type RepoFingerprint struct {
	// FirstCommit is the hash of the initial commit (same as repo_salt).
	FirstCommit string `json:"first_commit"`

	// MonthlyCheckpoints maps "YYYY-MM" to the first commit hash of that month.
	MonthlyCheckpoints map[string]string `json:"monthly_checkpoints"`

	// AncestrySamples contains commit hashes at power-of-2 intervals.
	AncestrySamples []string `json:"ancestry_samples"`

	// RemoteHashes contains salted SHA256 hashes of normalized remote URLs.
	RemoteHashes []string `json:"remote_hashes,omitempty"`
}

type RepoInfo struct {
	Name   string `json:"name"`              // e.g., "acme-corp-team-context"
	URL    string `json:"url"`               // git clone URL
	Type   string `json:"type"`              // "team-context" (ledgers use separate API)
	TeamID string `json:"team_id,omitempty"` // team_xxx (present for team-context repos)
}

type RepoInitRequest struct {
	RepoID           string           `json:"repo_id"`                      // Required: prefixed UUIDv7
	Type             string           `json:"type"`                         // Required: "git" or "svn"
	InitAt           string           `json:"init_at"`                      // Required: RFC3339 timestamp
	Name             string           `json:"name,omitempty"`               // Optional: display name (e.g. "sageox/ox")
	Teams            []string         `json:"teams,omitempty"`              // Optional: team IDs to associate repo with
	RepoSalt         string           `json:"repo_salt,omitempty"`          // Optional: initial commit hash
	RepoRemoteHashes []string         `json:"repo_remote_hashes,omitempty"` // Optional: salted hashes
	Fingerprint      *RepoFingerprint `json:"fingerprint,omitempty"`        // Optional: repo identity fingerprint
	Identities       any              `json:"identities,omitempty"`         // Optional: resolved user identities (identity.ResolvedIdentities)
	IsPublic         bool             `json:"is_public,omitempty"`          // Optional: prevents fork merging
	CreatedByEmail   string           `json:"created_by_email,omitempty"`   // Optional: git user email (backward compat)
	CreatedByName    string           `json:"created_by_name,omitempty"`    // Optional: git user name (backward compat)
}

type RepoInitResponse struct {
	RepoID     string `json:"repo_id"`
	TeamID     string `json:"team_id"`
	WebBaseURL string `json:"web_base_url,omitempty"` // web dashboard base URL (for enterprise endpoints)
}

type RepoMarkerData struct {
	RepoID   string `json:"repo_id"`
	RepoSalt string `json:"repo_salt"`
	Endpoint string `json:"endpoint"`
	// TODO: Remove after 2026-01-31 - legacy field support
	APIEndpoint string `json:"api_endpoint"` // deprecated: use Endpoint
}

type RepoUninstallRequest struct {
	RepoSalt string `json:"repo_salt"` // first commit hash for authentication
}

type ReposResponse struct {
	Token     string              `json:"token"`      // PAT for git operations
	ServerURL string              `json:"server_url"` // GitLab server URL
	Username  string              `json:"username"`   // GitLab username
	ExpiresAt time.Time           `json:"expires_at"` // Token expiration
	Repos     map[string]RepoInfo `json:"repos"`      // Repos indexed by name
	Teams     []TeamMembership    `json:"teams"`      // User's team memberships
}

type TeamInfoResponse struct {
	ID       string `json:"id"`                  // team ID (team_xxx)
	Name     string `json:"name"`                // display name
	Slug     string `json:"slug,omitempty"`      // URL-friendly name
	RepoURL  string `json:"repo_url,omitempty"`  // team context git repo URL
	GitToken string `json:"git_token,omitempty"` // token for git operations
}

type TeamMembership struct {
	ID   string `json:"id"`   // team_xxx
	Name string `json:"name"` // display name
	Role string `json:"role"` // "owner", "admin", "member"
}