job

type CalendarEventRef struct {
	ID        string    `json:"id"`                // Google's event ID
	Kind      string    `json:"kind"`              // "interview" | "deadline"
	When      time.Time `json:"when"`              // event start (UTC)
	Summary   string    `json:"summary,omitempty"` // event title at create time
	CreatedAt time.Time `json:"created_at"`
}

type Job struct {
	ID          string    `json:"id"`
	Title       string    `json:"title,omitempty"`
	Company     string    `json:"company,omitempty"`
	Location    string    `json:"location,omitempty"`
	URL         string    `json:"url,omitempty"`
	Source      string    `json:"source,omitempty"`
	Description string    `json:"description,omitempty"`
	Notes       string    `json:"notes,omitempty"`
	Tags        []string  `json:"tags,omitempty"`
	Status      Status    `json:"status"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
	LastDraft   string    `json:"last_draft,omitempty"`

	// Match fields are populated by the ranker (jobforge feed). Score is
	// 0-100; zero means unranked. Rationale is one short sentence from
	// the LLM explaining the score. Stale when the user's profile or
	// resume changes - re-run `jobforge feed --rerank` to refresh.
	MatchScore     int       `json:"match_score,omitempty"`
	MatchRationale string    `json:"match_rationale,omitempty"`
	MatchedAt      time.Time `json:"matched_at,omitempty"`

	// CalendarEvents tracks Google Calendar entries this job has created.
	// Populated by `jobforge calendar add-interview` / `add-deadline`.
	// We keep a slice (not a single ID) because one job often has
	// multiple scheduled events: phone screen, technical, onsite.
	CalendarEvents []CalendarEventRef `json:"calendar_events,omitempty"`
}

type Status string