transcript

type Availability struct {
	Harness  string
	Root     string
	Found    bool
	Reason   string // when !Found: why it was skipped, per invariant 3
	Sessions int    // discoverable session files, best effort
}

type Session struct {
	Harness string // "claude-code", "codex", "cursor", ...
	ID      string // harness-native session id
	Path    string // absolute path to the source file
	Project string // best-effort repo/dir the session ran in
	Started int64
	Ended   int64
	Turns   []Turn
	Hash    string // content hash of the source, for idempotence

	// Skipped counts lines the reader could not parse but stepped over rather
	// than failing the whole session on. Surfaced, never swallowed (invariant
	// 3): a session with Skipped > 0 is reported as partially read.
	Skipped int
}

type SkipReason struct {
	Harness string
	Why     string
}

type Turn struct {
	Role   string // "user" | "assistant" | "tool"
	Text   string
	Tool   string // tool name, when Role == "tool"
	Status string // "ok" | "error", when known
	// Input is the tool invocation — the shell command, the file path — carried
	// on the tool turn so a harvest can list commands run and files touched
	// without a model. Empty when the harness did not record it.
	Input string
}