orca/src/shared/worktree-card-properties.ts

import type {
  GlobalSettings,
  PersistedUIState,
  WorktreeCardMode,
  WorktreeCardProperty
} from './types'

const FIXED_WORKTREE_CARD_PROPERTIES: WorktreeCardProperty[] = ['status', 'unread']

export const TASK_WORKTREE_CARD_PROPERTIES: WorktreeCardProperty[] = [
  'issue',
  'linear-issue',
  'jira-issue'
]

export const DEFAULT_WORKTREE_CARD_PROPERTIES: WorktreeCardProperty[] = [
  ...FIXED_WORKTREE_CARD_PROPERTIES,
  ...TASK_WORKTREE_CARD_PROPERTIES,
  'pr',
  'automation',
  'cli',
  'comment',
  'ports',
  // Why: agent activity is the primary reason users opt into the feature, so
  // the Default mode keeps it inline on each card while Compact removes the
  // extra row.
  'inline-agents'
]

// Why: compact cards default to the quiet preset; metadata icons remain opt-in
// through Show properties instead of appearing automatically.
export const COMPACT_WORKTREE_CARD_PROPERTIES: WorktreeCardProperty[] = ['status']
const NORMALIZED_COMPACT_WORKTREE_CARD_PROPERTIES: WorktreeCardProperty[] = ['status', 'unread']

const LEGACY_COMPACT_WORKTREE_CARD_PROPERTIES_WITH_AUTOMATION: WorktreeCardProperty[] = [
  'status',
  'automation'
]

const LEGACY_NORMALIZED_COMPACT_WORKTREE_CARD_PROPERTIES_WITH_AUTOMATION: WorktreeCardProperty[] = [
  'status',
  'unread',
  'automation'
]

/** Every card property, in canonical render order. Client schemas derive their
 *  accepted value domain from this so a new property cannot drift out of them. */
export const WORKTREE_CARD_PROPERTIES = [
  'status',
  'unread',
  'ci',
  'branch',
  'issue',
  'linear-issue',
  'jira-issue',
  'pr',
  'automation',
  'cli',
  'comment',
  'ports',
  'inline-agents'
] as const satisfies readonly WorktreeCardProperty[]

export function normalizeWorktreeCardProperties(
  properties: readonly unknown[] | null | undefined
): WorktreeCardProperty[] {
  const normalized: WorktreeCardProperty[] = [...FIXED_WORKTREE_CARD_PROPERTIES]
  const source = properties ?? DEFAULT_WORKTREE_CARD_PROPERTIES
  for (const property of WORKTREE_CARD_PROPERTIES) {
    if (source.includes(property) && !normalized.includes(property)) {
      normalized.push(property)
    }
  }
  return normalized
}

export function getWorktreeCardModeProperties(mode: WorktreeCardMode): WorktreeCardProperty[] {
  return mode === 'Compact'
    ? [...COMPACT_WORKTREE_CARD_PROPERTIES]
    : [...DEFAULT_WORKTREE_CARD_PROPERTIES]
}

export function getWorktreeCardModeUpdates(mode: WorktreeCardMode): {
  settings: Pick<GlobalSettings, 'compactWorktreeCards'>
  ui: Pick<PersistedUIState, 'worktreeCardProperties' | '_worktreeCardModeDefaulted'>
} {
  return {
    settings: { compactWorktreeCards: mode === 'Compact' },
    ui: {
      worktreeCardProperties: getWorktreeCardModeProperties(mode),
      _worktreeCardModeDefaulted: true
    }
  }
}

export function isDefaultedCompactWorktreeCardProperties(
  properties: readonly unknown[] | null | undefined
): boolean {
  return (
    matchesWorktreeCardProperties(properties, COMPACT_WORKTREE_CARD_PROPERTIES) ||
    matchesWorktreeCardProperties(properties, NORMALIZED_COMPACT_WORKTREE_CARD_PROPERTIES) ||
    matchesWorktreeCardProperties(
      properties,
      LEGACY_COMPACT_WORKTREE_CARD_PROPERTIES_WITH_AUTOMATION
    ) ||
    matchesWorktreeCardProperties(
      properties,
      LEGACY_NORMALIZED_COMPACT_WORKTREE_CARD_PROPERTIES_WITH_AUTOMATION
    )
  )
}

function matchesWorktreeCardProperties(
  properties: readonly unknown[] | null | undefined,
  expected: readonly WorktreeCardProperty[]
): boolean {
  if (properties?.length !== expected.length) {
    return false
  }
  return expected.every((property, index) => properties[index] === property)
}