memoryevent

type Event struct {
	// 主键 ID（ULID 单调递增；非内置 provider 可用任意稳定字符串）
	ID string `json:"id"`
	// 用户 ID
	UserID string `json:"userId"`
	// 事件类型 milestone / event
	Type string `json:"type"`
	// 事件发生日期（YYYY-MM-DD 起始的语义时间，不一定等于 CreatedAt）
	EventDate time.Time `json:"eventDate"`
	// 关键词（用于关键词检索）
	Keywords []string `json:"keywords,omitempty"`
	// 事件正文（精简事实陈述）
	Summary string `json:"summary"`
	// 入库时间
	CreatedAt time.Time `json:"createdAt"`
}

type Query struct {
	// 用户 ID（必填）
	UserID string
	// 事件类型 milestone / event，留空匹配全部
	Type string
	// 关键词列表
	Keywords []string
	// 关键词匹配方式 any/all
	Match string
	// 起止时间（基于 EventDate）
	Since *time.Time
	Until *time.Time
	// 返回条数上限，<=0 由调用方按默认处理
	Limit int
}