client

type Config struct {
	CodebaseID string `json:"codebase_id"`
	BaseURL    string `json:"base_url,omitempty"`
}

type FailedBatch struct {
	Idx   int
	Files int
	Err   string
}

type FileEntry struct {
	AbsPath      string
	RelativePath string
	Size         int64
	ModTime      time.Time
}

type FileState struct {
	SHA256  string    `json:"sha256"`
	Size    int64     `json:"size"`
	ModTime time.Time `json:"mtime,omitempty"` // 用于秒级跳过 sha256：mtime+size 一致就认为内容未变
}

type HTTP struct {
	BaseURL string
	Client  *http.Client
}

type IndexState struct {
	Version  int                  `json:"version"`
	Files    map[string]FileState `json:"files"`
	LastSync time.Time            `json:"last_sync,omitempty"`
}

type ScanOptions struct {
	Extensions map[string]bool // nil 表示用默认
	MaxSize    int64           // 0 表示用默认
}

type SyncOptions struct {
	BatchSize   int     // 单次 upsert 的最大文件数；默认 50
	BatchBytes  int64   // 单次 upsert 的最大累计字节；默认 5 MiB
	RPS         float64 // 每秒最多多少次 upsert 请求（避免 EMB 提供商 RPM 限流）；0 = 无限制
	TPM         int     // 每分钟最多多少 tokens（避免 EMB 提供商 TPM 限流）；0 = 无限制
	Concurrency int     // 并发上传的 worker 数；默认 4
	Progress    func(stage string, args ...any)
}

type SyncReport struct {
	Scanned       int
	Added         int
	Modified      int
	Removed       int
	Unchanged     int
	UpsertResults []model.UpsertResult
	ChunksDeleted int
	FailedBatches []FailedBatch // 单批失败不中断整体；这里记录每个失败 batch 的诊断
	Duration      time.Duration
}