domain

type AncestorStatus struct {
	// ID identifies the ancestor issue.
	ID ID
	// State is the ancestor's current state.
	State State
	// IsBlocked is true when the ancestor has at least one unresolved
	// blocked_by relationship. A blocked ancestor gates readiness for
	// all descendants, mirroring the behavior of deferred ancestors.
	IsBlocked bool
}

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

type BackupClaimRecord struct {
	// ClaimSHA512 is the hex-encoded SHA-512 hash of the original claim
	// token. The plaintext token is not recoverable from the backup.
	ClaimSHA512 string `json:"claim_sha512"`

	// Author is the claim holder's name.
	Author string `json:"author"`

	// StaleThreshold is the claim duration in nanoseconds, derived from
	// StaleAt minus ClaimedAt. The JSON field name is retained for backup
	// format compatibility.
	StaleThreshold int64 `json:"stale_threshold"`

	// LastActivity is the timestamp when the claim was created (claimedAt).
	// The JSON field name is retained for backup format compatibility.
	LastActivity time.Time `json:"last_activity"`
}

type BackupCommentRecord struct {
	// CommentID is the auto-increment integer ID.
	CommentID int64 `json:"comment_id"`

	// Author is the comment author's name.
	Author string `json:"author"`

	// CreatedAt is the comment creation timestamp.
	CreatedAt time.Time `json:"created_at"`

	// Body is the comment text.
	Body string `json:"body"`
}

type BackupFieldChangeRecord struct {
	// Field is the name of the changed field.
	Field string `json:"field"`

	// Before is the value before the change.
	Before string `json:"before"`

	// After is the value after the change.
	After string `json:"after"`
}

type BackupHeader struct {
	// Prefix is the issue-ID prefix of the source database (e.g. "NP").
	Prefix string `json:"prefix"`

	// Timestamp is the UTC moment the backup was initiated.
	Timestamp time.Time `json:"timestamp"`

	// Version is the backup algorithm version. Restore implementations
	// use this to select the correct deserialisation logic.
	Version int `json:"version"`
}

type BackupHistoryRecord struct {
	// EntryID is the auto-increment integer ID.
	EntryID int64 `json:"entry_id"`

	// Revision is the zero-based revision index within the issue's
	// history.
	Revision int `json:"revision"`

	// Author is the actor who performed the mutation.
	Author string `json:"author"`

	// Timestamp is when the mutation occurred.
	Timestamp time.Time `json:"timestamp"`

	// EventType is the event type string (e.g. "created", "updated").
	EventType string `json:"event_type"`

	// Changes is the list of field-level changes recorded by this entry.
	Changes []BackupFieldChangeRecord `json:"changes"`
}

type BackupIssueRecord struct {

	// IssueID is the unique identifier (e.g. "NP-a3bxr").
	IssueID string `json:"issue_id"`

	// Role is "task" or "epic".
	Role string `json:"role"`

	// Title is the issue title.
	Title string `json:"title"`

	// Description is the issue body text.
	Description string `json:"description"`

	// AcceptanceCriteria is the issue's acceptance criteria text.
	AcceptanceCriteria string `json:"acceptance_criteria"`

	// Priority is the priority string (e.g. "P1", "P2").
	Priority string `json:"priority"`

	// State is the lifecycle state (e.g. "open", "closed", "deferred").
	State string `json:"state"`

	// ParentID is the parent epic's ID, or empty when unparented.
	ParentID string `json:"parent_id"`

	// CreatedAt is the issue creation timestamp in RFC 3339 with
	// nanosecond precision.
	CreatedAt time.Time `json:"created_at"`

	// Labels is the set of key–value label pairs attached to the issue.
	Labels []BackupLabelRecord `json:"labels"`

	// Comments is the ordered list of comments on the issue.
	Comments []BackupCommentRecord `json:"comments"`

	// Relationships is the list of relationships where this issue is
	// the source.
	Relationships []BackupRelationshipRecord `json:"relationships"`

	// Claims is the list of active claims on the issue. Typically zero
	// or one, but modelled as a slice for forward-compatibility.
	Claims []BackupClaimRecord `json:"claims"`

	// History is the ordered list of history entries for the issue.
	History []BackupHistoryRecord `json:"history"`
}

type BackupLabelRecord struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type BackupRelationshipRecord struct {
	// TargetID is the ID of the related issue.
	TargetID string `json:"target_id"`

	// RelType is the relationship type string (e.g. "blocked_by").
	RelType string `json:"rel_type"`
}

type BlockerStatus struct {
	// IsClosed is true if the blocker is closed (resolved).
	IsClosed bool
	// IsDeleted is true if the blocker has been soft-deleted.
	IsDeleted bool
}

type ChildStatus struct {
	// State is the child's current state.
	State State
	// IsBlocked is true when the child has at least one unresolved
	// blocked_by relationship. Used by epic progress bars to distinguish
	// open-and-blocked from open-and-ready.
	IsBlocked bool
}

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

type ClaimConflictError struct {
	// IssueID is the ID of the issue that could not be claimed.
	IssueID string

	// CurrentHolder is the author who holds the active claim.
	CurrentHolder string

	// StaleAt is the timestamp at which the current claim becomes stale
	// and eligible for stealing.
	StaleAt time.Time
}

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

type DatabaseError struct {
	// Op describes the operation that failed (e.g., "create issue", "begin transaction").
	Op string

	// Err is the underlying storage error.
	Err error
}

type DescendantInfo struct {
	// ID is the descendant's issue ID.
	ID ID
	// IsClaimed is true if the descendant is currently claimed.
	IsClaimed bool
	// ClaimedBy is the author of the active claim, if any.
	ClaimedBy string
}

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

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

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

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

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

type LineError struct {
	Line    int
	Message string
}

type NewClaimParams struct {
	IssueID       ID
	Author        Author
	StaleDuration time.Duration
	// StaleAt is an optional absolute timestamp at which the claim becomes
	// stale. When non-zero, it takes precedence over StaleDuration. The
	// caller is responsible for ensuring StaleAt is in the future and within
	// MaxStaleThreshold of Now.
	StaleAt time.Time
	Now     time.Time
}

type NewCommentParams struct {
	ID        int64
	IssueID   ID
	Author    Author
	CreatedAt time.Time
	Body      string
}

type NewEpicParams struct {
	ID                 ID
	Title              string
	Description        string
	AcceptanceCriteria string
	Priority           Priority
	ParentID           ID
	Labels             LabelSet
	CreatedAt          time.Time
	IdempotencyKey     string
}

type NewTaskParams struct {
	ID                 ID
	Title              string
	Description        string
	AcceptanceCriteria string
	Priority           Priority
	ParentID           ID
	Labels             LabelSet
	CreatedAt          time.Time
	IdempotencyKey     string
}

type ParseError struct {
	Line int
	Err  error
}

type Priority int

type RawLine struct {
	// IdempotencyLabel is the full "key:value" label string used for deduplication.
	// It is required on every import line.
	IdempotencyLabel   string            `json:"idempotency_label"`
	Role               string            `json:"role"`
	Title              string            `json:"title"`
	Description        string            `json:"description"`
	AcceptanceCriteria string            `json:"acceptance_criteria"`
	Priority           string            `json:"priority"`
	State              string            `json:"state"`
	Author             string            `json:"author"`
	Comment            string            `json:"comment"`
	Claim              bool              `json:"claim"`
	Labels             map[string]string `json:"labels"`
	Parent             string            `json:"parent"`
	BlockedBy          []string          `json:"blocked_by"`
	Blocks             []string          `json:"blocks"`
	Refs               []string          `json:"refs"`
}

type RelationType int

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

type Role int

type SecondaryState int

type SecondaryStateResult struct {
	// ListState is the single secondary state for list views, chosen by
	// priority: completed > claimed > blocked > ready > active.
	ListState SecondaryState

	// DetailStates is the ordered set of secondary conditions applicable in
	// detail views. May contain multiple entries (e.g., [blocked, active]
	// for a blocked epic with children).
	DetailStates []SecondaryState
}

type State int

type ValidatedRecord struct {
	// IdempotencyLabel is the parsed label used for deduplication. Its string
	// form (Key():Value()) is also the intra-file reference key used to resolve
	// parent, blocked_by, blocks, and refs fields within the same import file.
	IdempotencyLabel   Label
	Role               Role
	Title              string
	Description        string
	AcceptanceCriteria string
	Priority           Priority
	State              State
	Author             string
	Comment            string
	// Claim indicates the imported issue should be immediately claimed after
	// creation. Only valid when State is open; the import service returns an
	// error if Claim is true for a non-open record.
	Claim     bool
	Labels    []Label
	Parent    string
	BlockedBy []string
	Blocks    []string
	Refs      []string
}

type ValidationError struct {
	// Fields maps field names to human-readable descriptions of why
	// validation failed. Multiple fields may fail in a single operation.
	Fields map[string]string
}

type ValidationResult struct {
	Errors  []LineError
	Records []ValidatedRecord
}