migrate

type Attachment struct {
	Filename   string `json:"filename"`
	MimeType   string `json:"mimeType,omitempty"`
	Text       string `json:"text,omitempty"`
	DataBase64 string `json:"dataBase64,omitempty"`
	Author     string `json:"author,omitempty"`
	Created    string `json:"created,omitempty"`
	// ContentID is the origin content id for the byte download
	// (external_id when set, else the store row id — the same rule as
	// store.AttachmentOrigin). Never emitted.
	ContentID string `json:"-"`
	// Size is the mirror's byte count, used to skip oversized files
	// before spending the download. Never emitted.
	Size int64 `json:"-"`
	// SourceURL is the mirror's stored origin content URL (non-Jira
	// sources). Non-empty means the bytes do not live behind Jira's
	// /attachment/content/{id} and this pass skips them. Never emitted.
	SourceURL string `json:"-"`
}

type Comment struct {
	Author  string `json:"author,omitempty"`
	Body    string `json:"body"`
	Created string `json:"created,omitempty"`
}

type Doc struct {
	Users      []User      `json:"users,omitempty"`
	Projects   []Project   `json:"projects,omitempty"`
	Statuses   []Status    `json:"statuses,omitempty"`
	Priorities []Priority  `json:"priorities,omitempty"`
	IssueTypes []IssueType `json:"issueTypes,omitempty"`
	Issues     []Issue     `json:"issues,omitempty"`
	Spaces     []Space     `json:"spaces,omitempty"`
	Pages      []Page      `json:"pages,omitempty"`
}

type Fetch func(ctx context.Context, contentID string) (status int, body []byte, err error)

type History struct {
	At     string        `json:"at"`
	Author string        `json:"author,omitempty"`
	Items  []HistoryItem `json:"items"`
}

type HistoryItem struct {
	Field      string `json:"field"`
	From       string `json:"from,omitempty"`
	FromString string `json:"fromString,omitempty"`
	To         string `json:"to,omitempty"`
	ToString   string `json:"toString,omitempty"`
}

type Issue struct {
	Key         string       `json:"key"`
	Summary     string       `json:"summary"`
	Description string       `json:"description,omitempty"`
	Project     string       `json:"project,omitempty"`
	Type        string       `json:"type,omitempty"`   // id
	Status      string       `json:"status,omitempty"` // id
	Priority    string       `json:"priority,omitempty"`
	Assignee    string       `json:"assignee,omitempty"`
	Reporter    string       `json:"reporter,omitempty"`
	Parent      string       `json:"parent,omitempty"`
	Labels      []string     `json:"labels,omitempty"`
	Components  []string     `json:"components,omitempty"`
	FixVersions []string     `json:"fixVersions,omitempty"`
	Duedate     string       `json:"duedate,omitempty"`
	Resolution  string       `json:"resolution,omitempty"`
	Created     string       `json:"created,omitempty"`
	Updated     string       `json:"updated,omitempty"`
	Comments    []Comment    `json:"comments,omitempty"`
	Attachments []Attachment `json:"attachments,omitempty"`
	Links       []Link       `json:"links,omitempty"`
	History     []History    `json:"history,omitempty"`
	// StatusCategory (new|inprogress|done) and PriorityRank are the
	// mirror's contract axes — what a target with its own catalogs (Linear)
	// maps from, since ids mean nothing there. Never emitted: the fixture
	// path carries the ids and rebuilds both from its catalogs.
	StatusCategory string `json:"-"`
	PriorityRank   int    `json:"-"`
	// AssigneeEmail is the row's own email column — the fallback when the
	// users catalog has no row for the account (scrubbed fixtures).
	AssigneeEmail string `json:"-"`
}

type IssueType struct {
	ID             string `json:"id"`
	Name           string `json:"name"`
	HierarchyLevel int    `json:"hierarchyLevel,omitempty"`
	Subtask        bool   `json:"subtask,omitempty"`
}

type LinearOptions struct {
	TeamKey string
	// Limit keeps the first N issues by key (0 = all); references to the
	// cut-off rest are dropped and counted like out-of-set ones.
	Limit int
	// DryRun computes the mapping and counts without one network call.
	DryRun bool
	// Progress receives one line per created issue ("NMS-1 → MID-42").
	Progress io.Writer
	// AttachmentURL turns a Jira attachment content id into the URL a
	// browser session at the source can open; nil or "" skips the link.
	AttachmentURL func(contentID string) string
}

type LinearReport struct {
	Team        string      `json:"team"`
	DryRun      bool        `json:"dry_run"`
	Counts      []VerifyRow `json:"counts"`
	Mapping     []string    `json:"mapping"`
	NotMigrated []string    `json:"not_migrated"`
	Warnings    []string    `json:"warnings,omitempty"`
}

type Link struct {
	Type    string `json:"type"`
	Inward  string `json:"inward,omitempty"`
	Outward string `json:"outward,omitempty"`
}

type Options struct {
	Projects []string // issue project keys
	Spaces   []string // wiki space keys
}

type Page struct {
	ID       string        `json:"id,omitempty"`
	Title    string        `json:"title"`
	Space    string        `json:"space"`
	Version  int           `json:"version,omitempty"`
	When     string        `json:"when,omitempty"`
	Author   string        `json:"author,omitempty"`
	Body     string        `json:"body,omitempty"`
	Labels   []string      `json:"labels,omitempty"`
	Parent   string        `json:"parent,omitempty"`
	Comments []PageComment `json:"comments,omitempty"`
}

type PageComment struct {
	Author string `json:"author,omitempty"`
	Body   string `json:"body"`
	When   string `json:"when,omitempty"`
}

type Priority struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type Project struct {
	Key  string `json:"key"`
	Name string `json:"name"`
}

type Space struct {
	Key  string `json:"key"`
	Name string `json:"name"`
}

type Stats struct {
	Projects []string
	Spaces   []string

	Issues       int
	Comments     int
	Attachments  int
	Links        int
	History      int
	Pages        int
	PageComments int
	Users        int

	// Derived columns the target must reproduce from the migrated
	// changelog (they are never stored in the fixture).
	ReopenSum int
	EpicKeys  int

	// Formatting nodes flattened to plain text by the fixture path
	// (descriptions, comments and page bodies all load as adf.Doc(text)).
	LossCodeBlock int
	LossMedia     int
	LossTable     int

	// Dropped because the other end is outside the migrated set.
	DroppedLinks       int
	DroppedParents     []string
	DroppedPageParents int

	// Not migrated (the fixture has no slot, or out of scope).
	DevLinks     int
	CustomIssues int
	SprintIssues int

	// Attachment byte pass.
	AttachInlined  int
	AttachMissing  int // origin answered 404 — metadata kept
	AttachTooLarge int
	AttachSkipURL  int // stored origin URL (non-Jira source) — out of scope
	AttachErrors   []string

	MissingUsers    []string // referenced account ids absent from the users catalog
	UnnamedStatuses []string // history-only status ids with no display name
}

type Status struct {
	ID       string `json:"id"`
	Name     string `json:"name"`
	Category string `json:"category"` // new | indeterminate | done
}

type User struct {
	AccountID   string `json:"accountId,omitempty"`
	DisplayName string `json:"displayName"`
	Email       string `json:"email,omitempty"`
	AccountType string `json:"accountType,omitempty"`
}

type VerifyRow struct {
	Metric   string `json:"metric"`
	Source   int    `json:"source"`
	Migrated int    `json:"migrated"`
	// Skipped is the part of Migrated that was already at the target
	// before this run (the Linear path's idempotency scan); zero on the
	// built-in-tracker path, where the target is always new.
	Skipped int `json:"skipped,omitempty"`
}