config

type ActorConfig struct {
	Slug string `json:"slug,omitempty"`
	Name string `json:"name,omitempty"`
}

type Appearance struct {
	Theme string `json:"theme,omitempty"`
}

type Config struct {
	// Kind is the workspace kind. Empty (or any value other than
	// KindStandalone) is a connected workspace — Jira-site bound, the
	// default. Absent from existing configs; no migration.
	// Do not store the word "local" here: gadak is already local-first.
	Kind string `json:"kind,omitempty"`

	// Frozen stops every request to this workspace's origin — pulls and
	// writes alike (GDK-507). A scrubbed fixture with a live credential
	// decontaminates itself the moment something opens it (GDK-181), and the
	// same live credential could create real issues on the origin; both are
	// refused at the client mint (origin.ErrWorkspaceFrozen). Demo, recording
	// and screenshot workspaces set this. Mirror reads are unaffected.
	Frozen bool `json:"frozen,omitempty"`

	// The credential and what it connects to. Token is never copied out of this file.
	// A standalone workspace leaves these empty.
	Site     string   `json:"site,omitempty"` // https://your-site.atlassian.net
	Email    string   `json:"email,omitempty"`
	Token    string   `json:"token,omitempty"`
	Projects []string `json:"projects,omitempty"`

	// DevStatus turns on development-panel mirroring (GDK-496/497): sync
	// fetches each changed issue's dev-status (pull requests) from the origin
	// into dev_links. Off by default on a connected Cloud workspace — that
	// path calls Jira's internal /rest/dev-status API (Atlassian marks it
	// unstable) and adds per-issue requests. Standalone / issuetap always
	// fetches regardless of this flag (GDK-536): the panel is local.
	DevStatus bool `json:"devStatus,omitempty"`

	// Locale is the display-name language of a standalone workspace's
	// origin ("" | en | ko | ja | de; "" and "en" are both English,
	// GDK-597). It rides EmbeddedConfig into the embedded issuetap, so
	// status / issue-type / field-catalog names — and the agent alias
	// dictionary (GDK-593) — follow it; priority names stay English, like
	// a live Cloud site. A connected workspace ignores it: there the
	// language is the Atlassian account's, not ours.
	Locale string `json:"locale,omitempty"`

	// DefaultProject is the project key used when create omits --project /
	// project_key. Site-bound: never team-exported. Empty means unset.
	DefaultProject string `json:"defaultProject,omitempty"`
	// DefaultIssueTypeID is the Jira issue type id used when create omits
	// --type / issue_type. Stored as id, never a localized display name —
	// a Korean account's "Task" is "작업". Empty means unset. Display names
	// are not a fallback; see DefaultIssueType.
	DefaultIssueTypeID string `json:"defaultIssueTypeId,omitempty"`
	// DefaultIssueType is an optional display label for DefaultIssueTypeID.
	// Resolution never reads this field (names localize per account).
	DefaultIssueType string `json:"defaultIssueType,omitempty"`

	// Result of verifying the credential: when `PUT credential/` last confirmed it
	// against /myself, and who owns it. Unlike the token itself, both may be
	// returned in a response.
	TokenVerifiedAt string `json:"tokenVerifiedAt,omitempty"`
	TokenOwner      string `json:"tokenOwner,omitempty"`
	// TokenExpiresAt is when the stored API token stops working (RFC3339).
	// Set on connect / replace: the date typed from Atlassian's create
	// dialog, or verification time plus 365 days when that field was skipped.
	// There is no Atlassian API for this; the token string is opaque.
	// TokenExpirySource is "user" or "assumed" so a warning can hedge.
	TokenExpiresAt    string `json:"tokenExpiresAt,omitempty"`
	TokenExpirySource string `json:"tokenExpirySource,omitempty"`
	// AccountID is the Jira accountId returned by /myself. Used for feed
	// relevance (assignee/reporter/mention) and self-action filtering. Empty
	// when the credential was never verified against a live site.
	AccountID string `json:"account_id,omitempty"`

	// Sync field mapping (contracts/sync.md, "Field mapping").
	// Fields is the sole on-disk truth. FieldMap/EditableFields exist only as
	// unmarshal targets so LoadFor can migrate a pre-Fields config once.
	Fields []FieldSpec `json:"fields,omitempty"`
	// FieldsAppliedAt is when `gadak fields --apply` last succeeded (RFC3339,
	// millisecond UTC). Mapping lives in Fields; the timestamp lives here too
	// so a regenerated mirror does not lose "when discovery last ran".
	FieldsAppliedAt string `json:"fieldsAppliedAt,omitempty"`
	// FieldMap is a migration-only unmarshal target (alias → customfield id).
	// LoadFor converts it into Fields and clears it; new writes must not set it.
	FieldMap   map[string]string `json:"fieldMap,omitempty"`
	BodyFields []string          `json:"bodyFields,omitempty"` // ADF custom-field ids to fold into FTS
	// EditableFields is a migration-only unmarshal target (alias → field id).
	// LoadFor overlays it onto Fields (legacy wins per alias) and clears it.
	EditableFields map[string]string `json:"editableFields,omitempty"`

	// Optional surfaces carried over from the tool this was extracted from.
	Members    []Member    `json:"members,omitempty"`
	GroupRules []GroupRule `json:"groupRules,omitempty"`
	// GroupQuery is an optional read-only SELECT/WITH run when the derived
	// view is rebuilt (config or sync version change), never on a keystroke.
	// It must return two columns: issue key, group. An empty group string
	// leaves the issue unclassified; NULL (or a missing key) falls through
	// to groupRules and then the assignee's member group. Installation
	// logic belongs in this string, not in gadak source.
	GroupQuery     string             `json:"groupQuery,omitempty"`
	GroupLabels    map[string]string  `json:"groupLabels,omitempty"`
	GroupColors    map[string]string  `json:"groupColors,omitempty"`
	ProductByGroup map[string]Product `json:"productByGroup,omitempty"`
	Features       map[string]bool    `json:"features,omitempty"` // feed/deploy/qa/teamGroups
	QaDashboardURL string             `json:"qaDashboardUrl,omitempty"`

	StaleThresholdHours int `json:"staleThresholdHours,omitempty"` // 0 = the client default (72)
	// AttachmentCacheMB caps the on-disk attachment byte cache. 0 = package
	// default (512 MB); a negative value is treated as 0.
	AttachmentCacheMB int `json:"attachmentCacheMB,omitempty"`

	// Sync periods in seconds. 0 means use DefaultSyncIntervalSec /
	// DefaultReconcileIntervalSec. Watch re-reads config on each cycle when
	// opts.Reload is set (serve, desktop, and workspace all pass config.Load),
	// so a change applies on the next tick without restarting the process.
	SyncIntervalSec      int `json:"syncIntervalSec,omitempty"`
	ReconcileIntervalSec int `json:"reconcileIntervalSec,omitempty"`

	// Notify enables OS desktop notifications from the sync watch loop after
	// new personal-feed events. Default true when absent; set false to opt out.
	// Pointer so omitempty can distinguish "unset" from explicit false.
	Notify *bool `json:"notify,omitempty"`

	// UpdateCheck enables the once-per-day GitHub release lookup that surfaces
	// a newer version on sync/status/serve bootstrap. Default true when absent;
	// set false to opt out (restores the prior "outbound is only Jira" model).
	UpdateCheck *bool `json:"updateCheck,omitempty"`

	// Appearance is the look of the web/desktop UI. Nil (or empty Theme) means
	// "system" and is not written — the default is not persisted. A pointer so
	// encoding/json omitempty can drop the block; a zero struct would write {}.
	Appearance *Appearance `json:"appearance,omitempty"`

	// UI is the user color-override block (GDK-786/791): token overrides,
	// per-palette overlays, and per-data-key inks. Nil means nothing is
	// overridden and is not written. See uitokens.go for the write contract.
	UI *UIConfig `json:"ui,omitempty"`

	// Actor is the workspace-default acting identity for agent writes to an
	// issuetap origin (GDK-586): the X-Issuetap-Actor slug (the origin
	// accountId, verbatim) plus an optional display name. Nil or empty slug
	// means unset; GADAK_ACTOR wins over it and Claude Code is auto-detected
	// when neither is set (internal/config/actor.go ResolveActor). Nil blocks
	// are not written.
	Actor *ActorConfig `json:"actor,omitempty"`

	// Confluence, when non-nil, enables the wiki-page mirror (second source).
	// Spaces empty means every *global* space — not every space the account can
	// see, which is what this comment used to claim and what a warning written
	// from it went on to tell users. Cloud gives each person a personal space,
	// so an unfiltered listing is mostly noise; personal spaces are mirrored
	// only when named here. The rule itself lives in internal/sync/confluence.go.
	Confluence *ConfluenceConfig `json:"confluence,omitempty"`

	// Linear, when non-nil, enables the Linear issue mirror (third source,
	// read-only — GDK-263). Unlike Confluence it carries its own credential:
	// APIKey is a Linear personal API key and gets the same article-8
	// treatment as Token — never a log line, a snapshot, or a team export
	// (teamconfig classifies the whole block never-export).
	Linear *LinearConfig `json:"linear,omitempty"`
	// contains filtered or unexported fields
}

type ConfluenceConfig struct {
	Spaces []string `json:"spaces,omitempty"`
}

type DimCatalogEntry struct {
	Axis      string   `json:"axis"`
	Name      string   `json:"name"`
	CSSVar    string   `json:"cssVar"`
	Tier      string   `json:"tier"`
	Unit      string   `json:"unit"`
	Default   string   `json:"default"`
	Min       *float64 `json:"min"`
	Max       *float64 `json:"max"`
	Relations []string `json:"relations"`
}

type FieldSpec struct {
	Alias string   `json:"alias"`          // stable key: ascii slug of the name, else cf_<id>
	Label string   `json:"label"`          // Jira display name, in the account's language
	IDs   []string `json:"ids"`            // all field ids sharing the name, most-filled first
	Role  string   `json:"role"`           // body | facet | user | plain
	Kind  string   `json:"kind,omitempty"` // editor: option | multi_option | user | version_array | ""
	Auto  bool     `json:"auto,omitempty"` // discovery-owned; regenerated on re-apply
}

type GroupRule struct {
	Group      string   `json:"group"`
	Projects   []string `json:"projects,omitempty"`
	Labels     []string `json:"labels,omitempty"`
	Components []string `json:"components,omitempty"`
}

type LinearConfig struct {
	APIKey  string   `json:"apiKey,omitempty"`
	TeamIDs []string `json:"teamIds,omitempty"`
}

type Member struct {
	Email         string `json:"email"`
	Name          string `json:"name,omitempty"`
	DisplayName   string `json:"display_name,omitempty"`
	Group         string `json:"group,omitempty"`
	Department    string `json:"department,omitempty"`
	JobRole       string `json:"job_role,omitempty"`
	JiraAccountID string `json:"jira_account_id,omitempty"`
	AvatarURL     string `json:"avatar_url,omitempty"`
}

type Product struct {
	Key   string `json:"key"`
	Label string `json:"label"`
}

type ResolvedActor struct {
	Slug   string `json:"slug"`
	Name   string `json:"name,omitempty"`
	Source string `json:"source"`
}

type Setting struct {
	Path        string
	Root        string
	Description string
	Get         func(*Config) any
	Set         func(*Config, json.RawMessage) error
}

type TokenExpiry struct {
	State     string `json:"state"`
	DaysLeft  *int   `json:"days_left,omitempty"`
	ExpiresAt string `json:"expires_at,omitempty"`
	Source    string `json:"source,omitempty"`
	Urgent    bool   `json:"urgent,omitempty"`
	// Message is the one English warning line. Empty when there is nothing
	// to say (ok / unknown).
	Message string `json:"message,omitempty"`
}

type UIConfig struct {
	Tokens *UITokens `json:"tokens,omitempty"`
	// TokensByTheme overlays Tokens for one palette. Keys are palette ids;
	// ids outside today's catalog are carried with a warning (theme ids are
	// an open set by design — ValidateTheme accepts any [a-z0-9-]+).
	TokensByTheme map[string]*UITokens `json:"tokensByTheme,omitempty"`
	// DataColors is family → key → hex. Families: label, type, status.
	DataColors map[string]map[string]string `json:"dataColors,omitempty"`
}

type UITokens struct {
	Colors  map[string]string `json:"colors,omitempty"`
	Spacing map[string]string `json:"spacing,omitempty"`
	Layout  map[string]string `json:"layout,omitempty"`
	Type    map[string]string `json:"type,omitempty"`
}