package trace import ( "encoding/json" "fmt" "io" "os" "path/filepath" "sync" "time" "github.com/priyanshujain/sanderling/internal/hierarchy" ) type Step struct { Index int `json:"step"` Timestamp time.Time `json:"timestamp"` Screen string `json:"screen,omitempty"` Snapshots map[string]json.RawMessage `json:"snapshots,omitempty"` Action *Action `json:"action,omitempty"` Exceptions []Exception `json:"exceptions,omitempty"` Violations []string `json:"violations,omitempty"` Hierarchy *hierarchy.Tree `json:"hierarchy,omitempty"` Residuals map[string]json.RawMessage `json:"residuals,omitempty"` Metrics *Metrics `json:"metrics,omitempty"` } type Metrics struct { CPUPercent float64 `json:"cpu_percent"` HeapBytes int64 `json:"heap_bytes,omitempty"` TotalMemoryBytes int64 `json:"total_memory_bytes,omitempty"` } type Action struct { Kind string `json:"kind"` X int `json:"x,omitempty"` Y int `json:"y,omitempty"` FromX int `json:"from_x,omitempty"` FromY int `json:"from_y,omitempty"` ToX int `json:"to_x,omitempty"` ToY int `json:"to_y,omitempty"` Key string `json:"key,omitempty"` Text string `json:"text,omitempty"` DurationMillis int `json:"duration_millis,omitempty"` Selector string `json:"selector,omitempty"` ResolvedBounds *BoundsRecord `json:"resolved_bounds,omitempty"` TapPoint *PointRecord `json:"tap_point,omitempty"` } type BoundsRecord struct { X int `json:"x"` Y int `json:"y"` Width int `json:"width"` Height int `json:"height"` } type PointRecord struct { X int `json:"x"` Y int `json:"y"` } type Exception struct { Class string `json:"class"` Message string `json:"message,omitempty"` StackTrace string `json:"stack_trace,omitempty"` UnixMillis int64 `json:"unix_millis,omitempty"` } type Meta struct { Seed int64 `json:"seed"` SpecPath string `json:"spec_path"` BundleSHA256 string `json:"bundle_sha256"` Platform string `json:"platform"` BundleID string `json:"bundle_id"` StartedAt time.Time `json:"started_at"` EndedAt *time.Time `json:"ended_at,omitempty"` SanderlingVersion string `json:"sanderling_version"` } type Writer struct { directory string mutex sync.Mutex file io.WriteCloser encoder *json.Encoder } // NewWriter ensures `directory` exists and opens trace.jsonl for append. // meta.json is written separately via WriteMeta. Caller must Close. func NewWriter(directory string) (*Writer, error) { if err := os.MkdirAll(directory, 0o755); err != nil { return nil, fmt.Errorf("mkdir: %w", err) } file, err := os.OpenFile( filepath.Join(directory, "trace.jsonl"), os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0o644, ) if err != nil { return nil, fmt.Errorf("open trace.jsonl: %w", err) } encoder := json.NewEncoder(file) return &Writer{directory: directory, file: file, encoder: encoder}, nil } func (w *Writer) Directory() string { return w.directory } func (w *Writer) WriteMeta(meta Meta) error { body, err := json.MarshalIndent(meta, "", " ") if err != nil { return fmt.Errorf("marshal meta: %w", err) } return os.WriteFile(filepath.Join(w.directory, "meta.json"), body, 0o644) } func (w *Writer) WriteStep(step Step) error { w.mutex.Lock() defer w.mutex.Unlock() if w.file == nil { return fmt.Errorf("trace: writer is closed") } return w.encoder.Encode(step) } func (w *Writer) WriteScreenshot(stepIndex int, png []byte) error { return w.writePNG(fmt.Sprintf("step-%05d.png", stepIndex), png) } // WriteScreenshotAfter writes the post-action screenshot for a step. // Callers use this after applyAction + waitForIdle so the UI can show a // before/after pair. func (w *Writer) WriteScreenshotAfter(stepIndex int, png []byte) error { return w.writePNG(fmt.Sprintf("step-%05d-after.png", stepIndex), png) } func (w *Writer) writePNG(name string, png []byte) error { if len(png) == 0 { return nil } directory := filepath.Join(w.directory, "screenshots") if err := os.MkdirAll(directory, 0o755); err != nil { return fmt.Errorf("mkdir screenshots: %w", err) } return os.WriteFile(filepath.Join(directory, name), png, 0o644) } func (w *Writer) Close() error { w.mutex.Lock() defer w.mutex.Unlock() if w.file == nil { return nil } err := w.file.Close() w.file = nil return err }