filetrack

type Change struct {
	Seq              int64
	EventSeq         int64
	RunID            string
	Path             string
	Kind             string
	ToolName         string
	ToolCallID       string
	BeforeHash       string // empty when absent/unknown/not retained
	AfterHash        string
	BeforeSize       int64
	AfterSize        int64
	Adds             int
	Dels             int
	Truncated        bool
	IsBinary         bool
	Provenance       string
	Provenances      []string
	ClaimKind        string
	ClaimPattern     string
	ClaimLiteral     bool
	ClaimCoverage    string
	BaselineState    string
	ContentStatus    string
	ContentAvailable bool
}

type ChangeRecord struct {
	SessionID  string
	RunID      string
	ToolName   string
	ToolCallID string
	Path       string // absolute path

	// Provenance is mandatory for new callers of RecordAttributedChange.
	Provenance    string
	ClaimKind     string
	ClaimPattern  string
	ClaimLiteral  bool
	ClaimCoverage string
	BaselineState string

	Before []byte // content before the change (ignored when BeforeMissing/BeforeUnknown)
	After  []byte // content after the change (ignored when AfterMissing/AfterUnknown)

	BeforeMissing bool // file did not exist before the change
	AfterMissing  bool // file does not exist after the change (deletion)
	BeforeUnknown bool // file existed before but its content was not captured
	AfterUnknown  bool // file exists after but its content was not captured (e.g. oversized)

	// Size hints for unknown-content sides (from stat); ignored when the
	// corresponding content is provided.
	BeforeSizeHint int64
	AfterSizeHint  int64
}

type CumulativeChange struct {
	Path             string   `json:"path"`
	Kind             string   `json:"kind"`
	Adds             int      `json:"adds"`
	Dels             int      `json:"dels"`
	Truncated        bool     `json:"truncated"`
	Seq              int64    `json:"seq"`                    // latest change sequence for this path in the session
	SnapshotSeq      int64    `json:"snapshot_seq,omitempty"` // compatibility identity for a multi-run window
	Provenance       string   `json:"provenance,omitempty"`
	Provenances      []string `json:"provenances,omitempty"`
	BaselineState    string   `json:"baseline_state,omitempty"`
	ContentStatus    string   `json:"content_status,omitempty"`
	ContentAvailable bool     `json:"content_available"`
	ClaimCoverage    string   `json:"claim_coverage,omitempty"`
}

type DiffLine struct {
	T string `json:"t"` // "ctx" | "add" | "del"
	S string `json:"s"` // line text without the diff prefix
}

type FileDiffContent struct {
	Path             string
	Kind             string
	Before           []byte
	After            []byte
	Truncated        bool
	IsImage          bool
	ContentStatus    string
	ContentAvailable bool
	Provenance       string
	BaselineState    string
	ClaimCoverage    string
}

type FileDiffSide struct {
	Path      string
	Kind      string
	Side      string
	Data      []byte
	MediaType string
}

type FileDiffTextSide struct {
	Path string
	Kind string
	Side string
	Data []byte
}

type FilesystemObservation struct {
	ID               int64          `json:"id"`
	SessionID        string         `json:"-"`
	RunID            string         `json:"-"`
	EventSeq         int64          `json:"event_seq"`
	ToolName         string         `json:"-"`
	ToolCallID       string         `json:"-"`
	Classification   string         `json:"classification"`
	Root             string         `json:"root,omitempty"`
	CreatedCount     int            `json:"created_count"`
	ModifiedCount    int            `json:"modified_count"`
	DeletedCount     int            `json:"deleted_count"`
	SampledPaths     []string       `json:"sampled_paths,omitempty"`
	SamplesTruncated bool           `json:"samples_truncated,omitempty"`
	CoverageStatus   string         `json:"coverage_status"`
	Details          map[string]any `json:"details,omitempty"`
}

type Hunk struct {
	OldStart int        `json:"old_start"`
	NewStart int        `json:"new_start"`
	Lines    []DiffLine `json:"lines"`
}

type Options struct {
	MaxFileBytes               int   // 0 = DefaultMaxFileBytes
	MaxSessionBytes            int   // 0 = DefaultMaxSessionBytes
	MaxTotalBytes              int64 // 0 = DefaultMaxTotalBytes; whole-database size cap enforced live and by GC
	MaxObservationRows         int   // 0 = 10,000; independent sidecar row cap
	MaxObservationSessionRows  int   // 0 = 1,000; independent per-session sidecar row cap
	MaxObservationBytes        int64 // 0 = 16 MiB metadata cap
	MaxObservationSessionBytes int64 // 0 = 2 MiB per-session metadata cap
	MaxObservationAgeDays      int   // 0 = 30
}

type OutputClaimDiagnostic struct {
	NormalizedPattern string `json:"normalized_pattern"`
	ClaimKind         string `json:"claim_kind"`
	Reason            string `json:"reason"`
	CoverageStatus    string `json:"coverage_status"`
	MatchingPathCount int    `json:"matching_path_count"`
	Message           string `json:"message,omitempty"`
}

type Recorder struct {
	// contains filtered or unexported fields
}

type RunRecord struct {
	SessionID   string
	RunID       string
	StartedAt   time.Time
	CompletedAt time.Time
}

type SnapshotToken struct {
	AttributedEventSeq  int64 `json:"a"`
	ObservationEventSeq int64 `json:"o"`
	RunGeneration       int64 `json:"r"`
}

type Store struct {
	// contains filtered or unexported fields
}