scan

type Completed ¶

type Completed struct {
	ID            ID
	At            time.Time
	FindingsCount int
}

Completed is recorded on transition Running → Completed.

func (Completed) EventName() string

type DomainEvent ¶

type DomainEvent interface {
	EventName() string
}

DomainEvent is implemented by every event recorded by the Scan aggregate.

type Failed ¶

type Failed struct {
	ID     ID
	At     time.Time
	Reason string
}

Failed is recorded on any → Failed transition.

func (Failed) EventName() string

type ID ¶

type ID string

ID identifies a Scan instance. Generation is the application layer's responsibility (typically a UUID via an injected IDGenerator port).

func (id ID) Empty() bool

func (id ID) String() string

type Queued ¶

type Queued struct {
	ID       ID
	Revision Revision
}

Queued is recorded the moment a Scan is constructed.

func (Queued) EventName() string

type Revision ¶

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

Revision describes the git revision under analysis.

func UnknownRevision() Revision

func (r Revision) Branch() string

func (r Revision) Commit() string

func (r Revision) IsUnknown() bool

type Scan ¶

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

Scan is the aggregate root for one execution of the Cortex engine against a given revision. It owns the lifecycle status, the timestamps, and the (referential) list of findings produced.

Findings are held by Fingerprint, not by value — keeping the Scan aggregate lean and avoiding accidental coupling to Finding internals.

All transition methods return a NEW Scan; the receiver is never mutated.

func New(id ID, revision Revision) Scan

func (s Scan) Complete(now time.Time, findings []finding.Fingerprint) mo.Result[Scan]

func (s Scan) Duration() time.Duration

func (s Scan) EndedAt() time.Time

func (s Scan) Events() []DomainEvent

func (s Scan) Fail(now time.Time, reason string) mo.Result[Scan]

func (s Scan) Failure() string

func (s Scan) Findings() []finding.Fingerprint

func (s Scan) ID() ID

func (s Scan) Revision() Revision

func (s Scan) Start(now time.Time) mo.Result[Scan]

func (s Scan) StartedAt() time.Time

func (s Scan) Status() Status

type Started ¶

type Started struct {
	ID ID
	At time.Time
}

Started is recorded on transition Queued → Running.

func (Started) EventName() string

type Status ¶

type Status int

Status represents the lifecycle state of a Scan.

Transitions:

Queued ──Start──▶ Running ──Complete──▶ Completed (terminal)
   │                  │
   └──Fail──▶ Failed (terminal)
                      │
                      └──Fail──▶ Failed (terminal)

const (
	StatusQueued Status = iota
	StatusRunning
	StatusCompleted
	StatusFailed
)

func (s Status) IsTerminal() bool

func (s Status) String() string