atom

type AddAtomParams struct {
	WorkspaceID *uuid.UUID
	ParentTable string
	ParentID    uuid.UUID
	Content     string
	Keywords    []string
	Tags        []string
}

type AddLinkParams struct {
	FromAtomID uuid.UUID
	ToAtomID   uuid.UUID
	LinkType   string
	Confidence float64
}

type Atom struct {
	ID           uuid.UUID  `json:"id"`
	WorkspaceID  *uuid.UUID `json:"workspace_id,omitempty"`
	ParentTable  string     `json:"parent_table"`
	ParentID     uuid.UUID  `json:"parent_id"`
	Content      string     `json:"content"`
	Keywords     []string   `json:"keywords"`
	Tags         []string   `json:"tags"`
	CreatedAt    time.Time  `json:"created_at"`
	DigestStatus *string    `json:"digest_status,omitempty"`
}

type Link struct {
	FromAtomID uuid.UUID `json:"from_atom_id"`
	ToAtomID   uuid.UUID `json:"to_atom_id"`
	LinkType   string    `json:"link_type"` // same_entity|same_action|same_time|same_project
	Confidence float64   `json:"confidence"`
	CreatedAt  time.Time `json:"created_at"`
}

type PromotionEligibility struct {
	ContentOK    bool
	ContentRunes int
	TagsOK       bool
	TagCount     int
}

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

type StoreIface interface {
	// AddAtom inserts a new atom and returns the persisted record.
	AddAtom(ctx context.Context, p AddAtomParams) (*Atom, error)

	// AddLink inserts a directed link between two atoms.
	// If the (from_atom_id, to_atom_id, link_type) triple already exists the
	// call is a no-op (ON CONFLICT DO NOTHING).
	AddLink(ctx context.Context, p AddLinkParams) error

	// ListByParent returns all atoms whose parent_table and parent_id match.
	ListByParent(ctx context.Context, parentTable string, parentID uuid.UUID) ([]Atom, error)

	// Traverse does BFS from startAtomID up to depth hops (capped at 5),
	// returning all visited atoms and the links that connect them.
	// Total atoms returned is capped at 50.
	Traverse(ctx context.Context, startAtomID uuid.UUID, depth int) (*TraverseResult, error)

	// Search returns atoms whose content, keywords, or tags contain query
	// (ILIKE on Postgres, LIKE on SQLite). Scoped to workspaceID when non-nil.
	Search(ctx context.Context, workspaceID *uuid.UUID, query string, limit int) ([]Atom, error)

	// PruneAtoms hard-deletes memory_atoms rows older than cutoff.
	// Called daily by the decay.Pruner to enforce the 90-day TTL.
	PruneAtoms(ctx context.Context, cutoff time.Time) (int64, error)

	// SetDigestStatus updates the digest_status and error_msg for the given atom.
	// status must be one of the five DigestStatus* constants in
	// digest_status.go (Pending, Done, Failed, Consolidated, Promoted); both
	// backend implementations validate against IsValidDigestStatus before
	// issuing the UPDATE and return ErrInvalidDigestStatus for anything else.
	// errMsg is stored only when status=DigestStatusFailed; pass "" otherwise.
	SetDigestStatus(ctx context.Context, atomID uuid.UUID, status string, errMsg string) error

	// CountByDigestStatus returns the number of atoms with the given digest_status
	// in the given workspace (nil = all workspaces).
	CountByDigestStatus(ctx context.Context, workspaceID *uuid.UUID, status string) (int64, error)

	// ListByDigestStatus returns up to limit atoms with the given digest_status,
	// scoped to workspaceID (nil = all workspaces), ordered by created_at ASC.
	// Used by the atom-bridge weekly scheduler job to collect consolidated atoms
	// eligible for promotion to knowledge proposals.
	ListByDigestStatus(ctx context.Context, workspaceID *uuid.UUID, status string, limit int) ([]Atom, error)

	// CountTotal returns the total number of atoms scoped to the given workspace
	// (nil = all workspaces). Used by the M9 consolidation cron to compare
	// against the configured capacity threshold.
	CountTotal(ctx context.Context, workspaceID *uuid.UUID) (int64, error)
}

type TraverseResult struct {
	Atoms []Atom `json:"atoms"`
	Links []Link `json:"links"`
}