backends

type BackendFactory func(ctx context.Context) (BackendProtocol, error)

type BackendProtocol interface {
	// ListInfo 列出目录内容
	// path: 目录路径,空字符串表示根目录
	// 返回: 文件信息列表
	ListInfo(ctx context.Context, path string) ([]FileInfo, error)

	// Read 读取文件内容
	// path: 文件路径
	// offset: 起始行号 (0-based)
	// limit: 读取行数限制 (0表示无限制)
	// 返回: 文件内容(字符串)
	Read(ctx context.Context, path string, offset, limit int) (string, error)

	// Write 写入文件
	// path: 文件路径
	// content: 文件内容
	// 返回: WriteResult,包含状态更新信息(用于 StateBackend)
	Write(ctx context.Context, path, content string) (*WriteResult, error)

	// Edit 编辑文件(字符串替换)
	// path: 文件路径
	// oldStr: 要替换的旧字符串
	// newStr: 新字符串
	// replaceAll: true=替换所有匹配, false=仅替换第一个
	// 返回: EditResult,包含替换次数
	Edit(ctx context.Context, path, oldStr, newStr string, replaceAll bool) (*EditResult, error)

	// GrepRaw 正则表达式搜索
	// pattern: 正则表达式模式
	// path: 搜索路径(文件或目录)
	// glob: 文件名匹配模式(如 "*.go")
	// 返回: 匹配结果列表
	GrepRaw(ctx context.Context, pattern, path, glob string) ([]GrepMatch, error)

	// GlobInfo Glob 模式匹配
	// pattern: Glob 模式(如 "**/*.go")
	// path: 搜索起始路径
	// 返回: 匹配文件信息列表
	GlobInfo(ctx context.Context, pattern, path string) ([]FileInfo, error)
}

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

type EditResult struct {
	Error            string         `json:"error,omitempty"`             // 错误信息,空字符串表示成功
	Path             string         `json:"path,omitempty"`              // 编辑文件路径,失败时为空
	ReplacementsMade int            `json:"replacements_made,omitempty"` // 替换次数,失败时为 0
	FilesUpdate      map[string]any `json:"files_update,omitempty"`      // StateBackend 状态更新,外部存储为 nil
}

type FileData struct {
	Lines      []string  `json:"lines"`
	CreatedAt  time.Time `json:"created_at"`
	ModifiedAt time.Time `json:"modified_at"`
}

type FileInfo struct {
	Path         string    `json:"path"`
	IsDirectory  bool      `json:"is_directory"`
	Size         int64     `json:"size"`
	ModifiedTime time.Time `json:"modified_time"`
	CreatedTime  time.Time `json:"created_time"`
}

type FileMeta struct {
	Size       int64     `json:"size"`
	CreatedAt  time.Time `json:"created_at"`
	ModifiedAt time.Time `json:"modified_at"`
}

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

type GrepMatch struct {
	Path       string `json:"path"`
	LineNumber int    `json:"line_number"`
	Line       string `json:"line"`
	Match      string `json:"match"`
}

type RouteConfig struct {
	Prefix  string          // 路径前缀
	Backend BackendProtocol // 对应的后端
}

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

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

type WriteResult struct {
	Error        string         `json:"error,omitempty"`         // 错误信息,空字符串表示成功
	Path         string         `json:"path,omitempty"`          // 写入文件路径,失败时为空
	BytesWritten int64          `json:"bytes_written,omitempty"` // 写入字节数
	FilesUpdate  map[string]any `json:"files_update,omitempty"`  // StateBackend 状态更新,外部存储为 nil
}