concern

package
v0.16.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 30, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Overview

Package concern models low-confidence local findings before they become contribution hypotheses or public issues.

Index

Constants

This section is empty.

Variables

View Source 
var (
	// ErrNotFound indicates that a concern ID is absent.
	ErrNotFound = errors.New("concern not found")
	// ErrInvalidStatus indicates an unsupported lifecycle status.
	ErrInvalidStatus = errors.New("invalid concern status")
	// ErrInvalidTransition indicates a forbidden lifecycle transition.
	ErrInvalidTransition = errors.New("invalid concern status transition")
	// ErrInvalidLink indicates a malformed or unsupported relationship.
	ErrInvalidLink = errors.New("invalid concern link")
	// ErrConflict indicates that a caller tried to replace a revision it no
	// longer owns.
	ErrConflict = errors.New("concern changed concurrently")
)

Functions

This section is empty.

Types

type Concern 

type Concern struct {
	ID               string
	Repo             domain.RepoRef
	CommitSHA        string
	WorkspaceID      string
	Title            string
	ProblemStatement string
	SuspectedOwner   string
	Confidence       float64
	Unknowns         []string
	SuccessCriterion string
	Notes            string
	EvidenceIDs      []string
	SourceRefs       []domain.SourceRef
	SourceProvenance []evidence.SourceRevision
	Links            []Link
	Status           Status
	AuditTrail       []StatusChange
	Promotion        *Promotion
	CreatedAt        time.Time
	UpdatedAt        time.Time
}

Concern is a durable local intake record. WorkspaceID is an opaque corpus identity; absolute host paths are never stored here.

type Filter 

type Filter struct {
	Repo   domain.RepoRef
	Status Status
	Query  string
	Limit  int
}

Filter bounds an offline list or search. 

type Link struct {
	Kind       LinkKind
	TargetType string
	TargetID   string
	Note       string
	CreatedAt  time.Time
}

Link points to another local record or a credential-free repository ref.

type LinkKind 

type LinkKind string

LinkKind describes an explicit, non-inferred relationship. 

const (
	// LinkRelated is a non-causal association.
	LinkRelated LinkKind = "related"
	// LinkDuplicateCandidate records possible duplicate work.
	LinkDuplicateCandidate LinkKind = "duplicate_candidate"
	// LinkHotspot points at an affected repository area.
	LinkHotspot LinkKind = "hotspot"
	// LinkInvestigation points at a promoted or related investigation.
	LinkInvestigation LinkKind = "investigation"
	// LinkOpportunity points at a promoted or related opportunity.
	LinkOpportunity LinkKind = "opportunity"
)

type ListResult added in v0.11.0 

type ListResult struct {
	Concerns []*Concern
	Total    int
	Limit    int
}

ListResult separates a bounded concern window from its matching population.

type Promotion 

type Promotion struct {
	Kind            string
	InvestigationID string
	HypothesisID    string
	OpportunityID   string
	PromotedAt      time.Time
}

Promotion preserves the local concern's downstream workflow identity.

type Repository 

type Repository interface {
	SaveConcern(context.Context, *Concern) error
	UpdateConcern(context.Context, *Concern, *Concern) error
	GetConcern(context.Context, string) (*Concern, error)
	ListConcerns(context.Context, Filter) (*ListResult, error)
	AddConcernLink(context.Context, string, Link) error
}

Repository is the narrow persistence boundary for local concerns.

type Service 

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

Service validates local concern lifecycle operations.

func NewService 

func NewService(repo Repository) *Service

NewService returns a concern service backed by repo.

func (*Service) Create 

func (s *Service) Create(ctx context.Context, item *Concern) (*Concern, error)

Create validates and stores one local concern.

func (*Service) Get 

func (s *Service) Get(ctx context.Context, id string) (*Concern, error)

Get returns one concern. 

func (s *Service) Link(ctx context.Context, id string, link Link) error

Link records an explicit relationship. Duplicate candidates remain links; they do not silently change concern status or assert a root cause.

func (*Service) List 

func (s *Service) List(ctx context.Context, filter Filter) (*ListResult, error)

List returns at most 100 concerns with exact population metadata and performs no external reads.

func (*Service) SetStatus 

func (s *Service) SetStatus(ctx context.Context, id string, next Status, rationale string) (*Concern, error)

SetStatus applies an explicit lifecycle transition with rationale.

func (*Service) Update 

func (s *Service) Update(ctx context.Context, item *Concern) (*Concern, error)

Update replaces editable concern fields while preserving identity and audit.

type Status 

type Status string

Status is the lifecycle of a local concern. 

const (
	// StatusUntriaged is newly recorded intake.
	StatusUntriaged Status = "untriaged"
	// StatusAccepted marks a concern as worth investigating.
	StatusAccepted Status = "accepted"
	// StatusInvestigating marks active evidence gathering.
	StatusInvestigating Status = "investigating"
	// StatusDeferred preserves a concern without active work.
	StatusDeferred Status = "deferred"
	// StatusPromoted marks an atomically created downstream workflow.
	StatusPromoted Status = "promoted"
	// StatusResolved closes a concern without active promotion.
	StatusResolved Status = "resolved"
)

type StatusChange 

type StatusChange struct {
	From      Status
	To        Status
	Rationale string
	At        time.Time
}

StatusChange records a deliberate lifecycle transition.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.