threadcontext

Documentation

Overview

Package threadcontext normalizes inline review threads into prompt-safe domain context.

Index

• func SanitizeBody(body string) string
• type Anchor
• type Comment
• type Options
• type Status
• type Thread
  • func Normalize(threads []gitprovider.InlineThread, opts Options) ([]Thread, error)
  • func PendingCRAuthoredFindingThreads(threads []Thread) []Thread
  • func (thread Thread) EffectiveSettledSummary() (*ThreadSummary, bool)
• type ThreadSummary

Functions

func SanitizeBody

func SanitizeBody(body string) string

SanitizeBody removes closed codereview marker comments and escapes any remaining marker opening so prompt-facing text cannot carry live markers.

Types

type Anchor

type Anchor struct {
	Path        string
	Side        review.DiffSide
	Line        int
	SubjectType review.AnchorKind
	CommitSHA   string
}

Anchor identifies the review-thread location.

type Comment

type Comment struct {
	ID                        gitprovider.CommentID
	ThreadID                  gitprovider.ThreadID
	Body                      string
	Author                    gitprovider.Identity
	Anchor                    Anchor
	URL                       string
	CreatedAt                 time.Time
	UpdatedAt                 time.Time
	AuthoredByPostingIdentity bool
	HasFindingMarker          bool
	HasThreadReplyMarker      bool
	HasThreadSummaryMarker    bool
	// contains filtered or unexported fields
}

Comment is one prompt-safe normalized thread comment.

type Options

type Options struct {
	PostingIdentity gitprovider.Identity
}

Options controls thread normalization.

type Status

type Status struct {
	CRAuthoredFinding       bool
	HasCRSummary            bool
	LatestCRComment         *Comment
	LatestHumanReplyAfterCR *Comment
	PendingHumanReply       bool
}

Status summarizes lifecycle-relevant thread state.

type Thread

type Thread struct {
	ID               gitprovider.ThreadID
	Resolved         bool
	Anchor           Anchor
	Comments         []Comment
	Status           Status
	ResolvedSummary  *ThreadSummary
	CRSettledSummary *ThreadSummary
}

Thread is one normalized inline review thread.

func Normalize

func Normalize(threads []gitprovider.InlineThread, opts Options) ([]Thread, error)

Normalize converts provider inline threads into deterministic prompt-safe domain threads.

func PendingCRAuthoredFindingThreads

func PendingCRAuthoredFindingThreads(threads []Thread) []Thread

PendingCRAuthoredFindingThreads filters to unresolved CR-authored finding threads that have a human reply after the latest CR-authored comment.

func (Thread) EffectiveSettledSummary

func (thread Thread) EffectiveSettledSummary() (*ThreadSummary, bool)

EffectiveSettledSummary returns the compact settled context that reviewer prompts should use, preserving provider resolution as the preferred source.

type ThreadSummary

type ThreadSummary struct {
	ThreadID                             gitprovider.ThreadID
	Anchor                               Anchor
	URL                                  string
	Body                                 string
	LastCommentID                        gitprovider.CommentID
	LastCommentAuthor                    gitprovider.Identity
	LastCommentAuthoredByPostingIdentity bool
	LastCommentHasThreadSummaryMarker    bool
}

ThreadSummary is compact reviewer context for a provider-resolved or CR-settled inline thread.