operatingmodel

type EmptyProfileReader struct{}

type Entry struct {
	// EntryID is the stable identifier for this entry. Callers should supply a
	// UUID or other dot-free string. Used as the instance part of the entity ID.
	EntryID string `json:"entry_id"`

	// Title is a short human-readable label for the entry.
	Title string `json:"title"`

	// Summary is a one-or-two-sentence description.
	Summary string `json:"summary"`

	// Cadence is an optional cadence string (e.g., "weekly", "daily", "quarterly").
	Cadence string `json:"cadence,omitempty"`

	// Trigger is an optional trigger description (e.g., "Monday 9am").
	Trigger string `json:"trigger,omitempty"`

	// Inputs lists the inputs this entry depends on.
	Inputs []string `json:"inputs,omitempty"`

	// Stakeholders lists the people or systems involved.
	Stakeholders []string `json:"stakeholders,omitempty"`

	// Constraints lists the constraints that apply.
	Constraints []string `json:"constraints,omitempty"`

	// SourceConfidence is ConfidenceConfirmed or ConfidenceSynthesized.
	// Defaults to ConfidenceConfirmed if empty.
	SourceConfidence string `json:"source_confidence,omitempty"`

	// Status is StatusActive, StatusUnresolved, or StatusSuperseded.
	// Defaults to StatusActive if empty.
	Status string `json:"status,omitempty"`
}

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

type LayerApproved struct {
	// UserID is the profile owner. Used as the instance part of profile and
	// layer entity IDs.
	UserID string `json:"user_id"`

	// LoopID is the agentic loop that produced the approval. Used by
	// teams-memory to correlate the graph mutation with its originating loop.
	LoopID string `json:"loop_id"`

	// Layer is one of the five canonical layer names.
	Layer string `json:"layer"`

	// ProfileVersion is the profile version this layer belongs to (starts at 1).
	// Monotonically increments when the user re-runs the full interview.
	ProfileVersion int `json:"profile_version"`

	// CheckpointSummary is the user-approved natural-language summary of the layer.
	CheckpointSummary string `json:"checkpoint_summary"`

	// Entries is the structured list of facts captured during this layer.
	Entries []Entry `json:"entries"`

	// ApprovedAt is the timestamp of user approval. Populated by the publisher.
	ApprovedAt time.Time `json:"approved_at"`
}

type ProfileContext struct {
	// UserID is the profile owner.
	UserID string `json:"user_id"`

	// LoopID is the loop this context is being delivered to.
	LoopID string `json:"loop_id"`

	// ProfileVersion is the version of the operating-model profile the
	// OperatingModel slice was assembled from. Zero if no profile exists yet.
	ProfileVersion int `json:"profile_version"`

	// OperatingModel is the operating-model slice of the context. Populated
	// from the user's profile triples in the graph. Empty if the user has
	// not completed an onboarding interview yet.
	OperatingModel ProfileContextSlice `json:"operating_model"`

	// LessonsLearned is the lessons-learned slice. Reserved — not populated
	// in v1. Future hydrator passes will fill this from
	// compaction-extracted triples.
	LessonsLearned ProfileContextSlice `json:"lessons_learned"`

	// TokenBudget is the total token budget applied when assembling this
	// payload. The sum of OperatingModel.TokenCount and LessonsLearned.TokenCount
	// should not exceed it.
	TokenBudget int `json:"token_budget"`

	// AssembledAt is the timestamp of assembly.
	AssembledAt time.Time `json:"assembled_at"`
}

type ProfileContextSlice struct {
	// Content is the rendered natural-language text for this slice, ready to
	// prepend to the system prompt.
	Content string `json:"content"`

	// TokenCount is the estimated token count for Content.
	TokenCount int `json:"token_count"`

	// EntryCount is the number of distinct entries condensed into Content.
	// Informational; useful for telemetry and UI displays.
	EntryCount int `json:"entry_count"`
}

type ProfileReader interface {
	ReadOperatingModel(ctx context.Context, org, platform, userID string) (*ProfileResult, error)
}

type ProfileRef struct {
	// Org is the organization part of the entity ID.
	Org string
	// Platform is the platform part of the entity ID.
	Platform string
	// UserID is the instance part for the profile entity.
	UserID string
	// Version is the current operating-model profile version (starts at 1).
	Version int
}

type ProfileResult struct {
	Entries []Entry
	Version int
}