tracebridge

type CaptureConfig struct {
	// RepoPath is the absolute path to the repository root.
	RepoPath string

	// SessionID is a unique identifier for this capture session.
	// If empty, one is generated.
	SessionID string

	// Tags are initial metadata tags for the session (equivalent to
	// TRACE_TAG_* environment variables). Keys should not include the
	// TRACE_TAG_ prefix.
	Tags map[string]string
}

type CaptureResult struct {
	// SessionID is the unique identifier for this capture session.
	SessionID string

	// TranscriptPath is the filesystem path to the session transcript.
	TranscriptPath string

	// SpanCount is the number of spans recorded during the session.
	SpanCount int

	// Duration is the total time the session was active.
	Duration time.Duration

	// Tags are the session metadata tags at the time of capture end.
	Tags map[string]string
}

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

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

type TraceSession interface {
	// ID returns the session identifier.
	ID() string

	// Phase returns the current session phase (e.g., "active", "ended").
	Phase() string

	// TranscriptPath returns the filesystem path to the transcript file.
	TranscriptPath() string

	// SpanCount returns the number of spans recorded in this session.
	SpanCount() int

	// StartedAt returns when the session was started.
	StartedAt() time.Time

	// EndedAt returns when the session ended, or nil if still active.
	EndedAt() *time.Time

	// Metadata returns session tags (equivalent to TRACE_TAG_* metadata).
	Metadata() map[string]string

	// SetMetadata updates a single tag in session metadata.
	SetMetadata(key, value string)

	// Close ends the session.
	Close(ctx context.Context) error
}

type TraceSessionManager interface {
	// Start begins a new capture session for the given repo path and
	// returns a session handle.
	Start(ctx context.Context, repoPath string, sessionID string) (TraceSession, error)

	// Load retrieves an existing session by ID.
	Load(ctx context.Context, sessionID string) (TraceSession, error)
}