snapshot.go RawHistoryFolder

1// Package snapshotcodec owns the durable snapshot format: the session codec,
2// checkpoint manifests, content-addressed objects, and their bounded preflight.
3// It depends only on domain values and ports, so both the daemon use case and
4// the snapshot repository adapter can consume it.
5package snapshotcodec
6
7import "github.com/bnema/vev/internal/domain/layout"
8
9// Session is the durable transfer representation for a named daemon session.
10type Session struct {
11	Name      string
12	CreatedAt uint64
13	Active    uint16
14	Tabs      []Tab
15}
16
17// Tab captures one tab's layout, dimensions, and pane snapshots.
18type Tab struct {
19	StableID   string
20	Cols       uint16
21	Rows       uint16
22	NextPaneID uint64
23	Focus      layout.PaneID
24	Tree       *layout.Tree
25	Panes      []Pane
26}
27
28// Pane captures terminal state as opaque, canonical VT blobs. Snapshot owns
29// their length framing and order; pkg/vt owns their contents and validation.
30type Pane struct {
31	ID           layout.PaneID
32	StableID     string
33	Cwd          string
34	SealedChunks [][]byte // oldest-first, each a self-contained canonical history blob
35	Tail         []byte   // mandatory nonempty canonical history blob
36	Transcript   []byte   // mandatory nonempty canonical history blob
37	Process      *Process
38}
39
40// Process captures restorable foreground process metadata.
41type Process struct {
42	Argv     []string
43	Strategy string
44	Opts     ProcessOpts
45}
46
47// ProcessOpts captures strategy-specific process restore options.
48type ProcessOpts struct {
49	AgentSessionID string
50}