discovery

type AttentionReason string

type GitInfo struct {
	// Branch is the current branch name (e.g. "main", "feat/foo").
	// Empty if not a git repo or on a detached HEAD.
	Branch string

	// IsDirty is true when the working tree has uncommitted changes
	// (staged, unstaged, or untracked files).
	IsDirty bool

	// Ahead is the number of commits ahead of the upstream tracking branch.
	// Zero if no upstream is configured or git fails.
	Ahead int

	// Behind is the number of commits behind the upstream tracking branch.
	// Zero if no upstream is configured or git fails.
	Behind int

	// LastCommit is the short hash and subject of the most recent commit
	// (e.g. "abc1234 Fix the thing"). Empty if there are no commits.
	LastCommit string

	// LatestTag is the most recent git tag (e.g. "v1.0.1").
	// Empty if no tags exist.
	LatestTag string
}

type IndexEntry struct {
	SessionID    string `json:"sessionId"`
	Summary      string `json:"summary"`
	MessageCount int    `json:"messageCount"`
}

type Project struct {
	// Name is the project identifier. Normally the basename of the shared CWD
	// (e.g. "QuantMind"). When multiple projects share the same basename,
	// GroupByProject expands it to "parent/basename" (e.g. "work/api") to
	// prevent identity collisions.
	Name string

	// Path is the full filesystem path to the project directory.
	Path string

	// Sessions contains all discovered sessions for this project.
	Sessions []Session
}

type Session struct {
	// ID is the session UUID from the session file (sessionId field).
	ID string

	// PID is the process ID of the Claude Code process.
	PID int

	// CWD is the working directory the session was started in.
	CWD string

	// ProjectName is the basename of CWD (or the git root if available).
	ProjectName string

	// StartedAt is when the session was created (from the session file).
	StartedAt time.Time

	// State is the classified lifecycle state.
	State SessionState

	// LastActivity is the timestamp of the most recent transcript entry.
	// Zero value means no activity information is available.
	LastActivity time.Time

	// Summary is the human-readable summary from sessions-index.json, if
	// available. Empty string if not found.
	Summary string

	// MessageCount is the number of messages from sessions-index.json.
	// Zero if not available.
	MessageCount int

	// Attention holds diagnostic flags (orphaned, stale, no-transcript).
	// Empty slice means no issues.
	Attention []AttentionReason
}

type SessionState string