contextual_hints.go RawHistoryFolder

1package palette
2
3import (
4	"fmt"
5
6	"github.com/bnema/vev/internal/usecase/command"
7)
8
9// RecentSessionHint is the immutable display data for one captured MRU rank.
10type RecentSessionHint struct {
11	Rank               int
12	Name               string
13	SnapshotGeneration uint64
14	Key                uint64
15	Generation         uint64
16}
17
18// ContextualHints is immutable contextual palette guidance.
19type ContextualHints struct {
20	Kind         command.ContextHint
21	Recent       []RecentSessionHint
22	SelectedRank int
23	Feedback     string
24}
25
26// BuildRecentSessionHints produces guidance without consulting live daemon state.
27func BuildRecentSessionHints(names []string, args []string) ContextualHints {
28	h := ContextualHints{Kind: command.ContextHintRecentSessions}
29	h.Recent = make([]RecentSessionHint, len(names))
30	for i, name := range names {
31		h.Recent[i] = RecentSessionHint{Rank: i + 1, Name: name}
32	}
33	if len(names) == 0 {
34		h.Feedback = "no recent sessions"
35		return h
36	}
37	rank, err := command.ParsePositiveDecimal(args)
38	if len(args) == 0 {
39		h.Feedback = "enter a recent-session rank"
40	} else if err != nil {
41		h.Feedback = "rank must be one positive decimal"
42	} else if rank > len(names) {
43		h.Feedback = fmt.Sprintf("rank %d is unavailable", rank)
44	} else {
45		h.SelectedRank = rank
46		h.Feedback = fmt.Sprintf("jump to recent session %d", rank)
47	}
48	return h
49}