cellsync

type Decision struct {
	// Delete: the deadline has passed, or the cell is stale or superseded (unless
	// KeepRetired), and this instance owns it and it is not a config cell. Delete the cell and call
	// Forget; nothing else applies.
	Delete bool
	// Requeue is when to look at the cell again: the time until its deadline, or
	// zero. It is set on every path that does not delete, so a deadline is never
	// missed because the cell took an early return.
	Requeue time.Duration
	// Index: embed the cell, or seed the vector index from the embedding it
	// carries (index.CellStore.SeedOrEmbed).
	Index bool
	// ClearEmbedding: a private cell holds an embedding or an indexed status.
	// Remove it from the vector index, clear Spec.Embedding and Status.Indexed,
	// so a flip back to public re-embeds fresh.
	ClearEmbedding bool
}

type Options struct {
	// Subject is the identity of this instance. With one set, only cells whose
	// Spec.Subject matches are owned; cells of another instance sharing the
	// namespace are neither ingested nor deleted. With none set, every cell is
	// owned.
	Subject string
	// ConfigKind reports cells that configure the host rather than hold memory.
	// They are never embedded and never deleted at a deadline: a config cell that
	// only looks expired may be the host's only source of its configuration.
	ConfigKind func(cell *memoryv1.MemoryCell) bool
	// NeverEmbed reports cells that stay durable and listable without entering
	// the vector index (a label, a coordination record).
	NeverEmbed func(cell *memoryv1.MemoryCell) bool
	// KeepRetired keeps a cell whose status is stale or superseded instead of
	// deleting it: a host that treats retirement as an audit trail (a refuted cell
	// with the record of why) leaves the cell and drops it from the indexes
	// only. A cell past its deadline is deleted either way.
	KeepRetired bool
}