project

type Entry struct {
	// ID 条目 ID
	ID string `json:"id"`

	// Category 分类（如 preference, constraint, style）
	Category string `json:"category"`

	// Content 内容
	Content string `json:"content"`

	// Value 结构化值（可选）
	Value any `json:"value,omitempty"`

	// Source 来源（dialog, choice, system）
	Source string `json:"source"`

	// Confidence 置信度
	Confidence float64 `json:"confidence"`

	// CreatedAt 创建时间
	CreatedAt time.Time `json:"created_at"`

	// Metadata 元数据
	Metadata map[string]any `json:"metadata,omitempty"`
}

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

type GenerationParams struct {
	// Model 模型名称
	Model string `json:"model"`

	// Temperature 温度
	Temperature float64 `json:"temperature"`

	// MaxTokens 最大 tokens
	MaxTokens int `json:"max_tokens"`

	// Extra 额外参数
	Extra map[string]any `json:"extra,omitempty"`

	// Timestamp 记录时间
	Timestamp time.Time `json:"timestamp"`
}

type MemorySection string

type ProjectMemory struct {
	// ProjectID 项目标识
	ProjectID string `json:"project_id"`

	// Title 项目标题
	Title string `json:"title"`

	// Description 项目描述
	Description string `json:"description"`

	// Sections 章节内容
	Sections map[MemorySection]*Section `json:"sections"`

	// Metadata 元数据
	Metadata map[string]any `json:"metadata,omitempty"`

	// CreatedAt 创建时间
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt 更新时间
	UpdatedAt time.Time `json:"updated_at"`

	// Version 版本号
	Version int `json:"version"`
}

type Section struct {
	// Name 章节名称
	Name string `json:"name"`

	// Protected 是否受保护（不可自动删除）
	Protected bool `json:"protected"`

	// Entries 条目列表
	Entries []*Entry `json:"entries"`
}

type Store interface {
	// Load 加载项目记忆
	Load(ctx context.Context, projectID string) (*ProjectMemory, error)

	// Save 保存项目记忆
	Save(ctx context.Context, memory *ProjectMemory) error

	// Delete 删除项目记忆
	Delete(ctx context.Context, projectID string) error

	// Exists 检查项目记忆是否存在
	Exists(ctx context.Context, projectID string) (bool, error)

	// AppendEntry 追加条目到指定章节
	AppendEntry(ctx context.Context, projectID string, section MemorySection, entry *Entry) error

	// UpdateWorkflowStep 更新工作流步骤状态
	UpdateWorkflowStep(ctx context.Context, projectID string, step *WorkflowStep) error

	// RecordParams 记录生成参数
	RecordParams(ctx context.Context, projectID string, params *GenerationParams) error

	// GetSummary 获取摘要（用于 AI 上下文注入）
	GetSummary(ctx context.Context, projectID string) (string, error)

	// GetVersionHistory 获取版本历史
	GetVersionHistory(ctx context.Context, projectID string, limit int) ([]*ProjectMemory, error)
}

type StoreConfig struct {
	// BasePath 基础路径（用于文件存储）
	BasePath string

	// FileName 文件名（默认 AGENTS.md）
	FileName string

	// Template 模板内容
	Template string

	// AutoCreate 是否自动创建
	AutoCreate bool
}

type WorkflowStep struct {
	// ID 步骤 ID
	ID string `json:"id"`

	// Name 步骤名称
	Name string `json:"name"`

	// Status 状态: pending, in_progress, completed, skipped
	Status string `json:"status"`

	// StartedAt 开始时间
	StartedAt *time.Time `json:"started_at,omitempty"`

	// CompletedAt 完成时间
	CompletedAt *time.Time `json:"completed_at,omitempty"`

	// Note 备注
	Note string `json:"note,omitempty"`
}