api

type DistillObservation struct {
	Content    string `json:"content"`
	RecordedAt string `json:"recorded_at"` // RFC3339
}

type DistillRequest struct {
	Observations []DistillObservation `json:"observations"`
	DateRange    [2]string            `json:"date_range"` // [start, end] RFC3339
}

type DistillResponse struct {
	Summary   string `json:"summary"`
	UpdatedAt string `json:"updated_at"`
}

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 ImportNotification struct {
	TeamID   string          `json:"team_id"`
	Metadata json.RawMessage `json:"metadata"`
}

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 MergeRepoRequest struct {
	RepoMarkers map[string]json.RawMessage `json:"repo_markers"` // filename -> marker JSON
}

type MergeRepoResponse struct {
	Canonical string        `json:"canonical_repo_id"`  // the winning repo_id
	Merged    []string      `json:"merged_repo_ids"`    // repo_ids that were marked as merged
	Redirect  *RedirectInfo `json:"redirect,omitempty"` // redirect info (also in header)
}

type QueryLatency struct {
	Embed  int64 `json:"embed"`
	Search int64 `json:"search"`
	Total  int64 `json:"total"`
}

type QueryRequest struct {
	Query     string   `json:"query"`
	Mode      string   `json:"mode,omitempty"`       // "hybrid", "knn", "bm25" (default: hybrid)
	K         int      `json:"k,omitempty"`          // number of results (default: 10, max: 100)
	Teams     []string `json:"teams"`                // team IDs to search team-context indexes
	Repos     []string `json:"repos"`                // repo IDs to search ledger indexes
	AgentID   string   `json:"agent_id,omitempty"`   // querying agent instance (e.g. "Oxa7b3")
	AgentType string   `json:"agent_type,omitempty"` // querying agent type (e.g. "claude-code")
}

type QueryResponse struct {
	Results   []QueryResult `json:"results"`
	LatencyMs QueryLatency  `json:"latency_ms"`
}

type QueryResult struct {
	Score      float64 `json:"score"`
	Text       string  `json:"text"`
	DocType    string  `json:"doc_type"`
	FilePath   string  `json:"file_path"`
	SourceType string  `json:"source_type"`
	SourceID   string  `json:"source_id"`
	CreatedAt  string  `json:"created_at,omitempty"`
}

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
	Slug        string `json:"slug,omitempty"` // kebab-case team slug
	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)
	Slug   string `json:"slug,omitempty"`    // kebab-case team slug (server-provided)
}

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)
	ExistingRepoID   string `json:"existing_repo_id,omitempty"`  // set when dedup matched a different repo_id
	DuplicateWarning string `json:"duplicate_warning,omitempty"` // human-readable warning for CLI display
}

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
	Slug string `json:"slug,omitempty"` // kebab-case team slug
	Role string `json:"role"`           // "owner", "admin", "member"
}