Dynamic Status System

export interface StatusConfig {
  /** Unique ID (slug-style: 'todo', 'in-progress', 'my-custom-status') */
  id: string;

  /** Display name */
  label: string;

  /** Optional color. If omitted, uses design system defaults. */
  color?: EntityColor;

  /**
   * Icon: emoji or URL (auto-downloaded)
   * - Emoji: "✅", "🔥" - rendered as text
   * - URL: "https://..." - auto-downloaded to statuses/icons/{id}.{ext}
   * - Omit to use auto-discovered local file (statuses/icons/{id}.svg)
   */
  icon?: string;

  /** Category (open = inbox, closed = archive) */
  category: StatusCategory;

  /** If true, cannot be deleted/renamed (todo, done, cancelled) */
  isFixed: boolean;

  /** If true, can be modified but not deleted (in-progress, needs-review) */
  isDefault: boolean;

  /** Display order in UI (lower = first) */
  order: number;
}

export const DEFAULT_ICON_SVGS: Record<string, string> = {
  /**
   * Backlog - CircleDashed (larger gaps)
   */
  'backlog': `<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
    <circle cx="12" cy="12" r="9" stroke="currentColor" stroke-dasharray="6 5" />
  </svg>`,

  /**
   * Todo - Circle (solid outline)
   */
  'todo': `<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
    <circle cx="12" cy="12" r="9" stroke="currentColor" />
  </svg>`,

  // ... more icons ...
};

import { createStatus } from '@craft-agent/shared/statuses';

const status = createStatus(workspaceRootPath, {
  label: 'In Progress',
  color: 'accent',
  icon: '🚀',
  category: 'open'
});

// Returns:
// {
//   id: 'in-progress',     // Auto-generated slug
//   label: 'In Progress',
//   color: 'accent',
//   icon: '🚀',
//   category: 'open',
//   isFixed: false,
//   isDefault: false,
//   order: 5
// }

import { updateStatus } from '@craft-agent/shared/statuses';

// Update label and color
const updated = updateStatus(workspaceRootPath, 'in-progress', {
  label: 'Active',
  color: { light: '#3B82F6', dark: '#60A5FA' }
});

// Fixed statuses cannot change category
try {
  updateStatus(workspaceRootPath, 'todo', {
    category: 'closed'  // ERROR: Cannot change category of fixed status
  });
} catch (error) {
  console.error(error);
}

import { deleteStatus } from '@craft-agent/shared/statuses';

// Delete a custom status
const result = deleteStatus(workspaceRootPath, 'in-progress');

console.log(`Migrated ${result.migrated} sessions to 'todo'`);

// Cannot delete fixed statuses
try {
  deleteStatus(workspaceRootPath, 'todo');
} catch (error) {
  console.error(error);  // Cannot delete fixed status 'todo'
}

import { reorderStatuses } from '@craft-agent/shared/statuses';

// Reorder by providing full list of IDs in desired order
reorderStatuses(workspaceRootPath, [
  'backlog',
  'todo',
  'in-progress',
  'needs-review',
  'done',
  'cancelled'
]);

import { loadStatusConfig } from '@craft-agent/shared/statuses';

const config = loadStatusConfig(workspaceRootPath);

console.log(config);
// {
//   version: 1,
//   statuses: [...],
//   defaultStatusId: 'todo'
// }

import { listStatuses } from '@craft-agent/shared/statuses';

const statuses = listStatuses(workspaceRootPath);
// Returns StatusConfig[] sorted by order field

import { getStatus, getStatusCategory } from '@craft-agent/shared/statuses';

const status = getStatus(workspaceRootPath, 'in-progress');
if (status) {
  console.log(status.label, status.category);
}

// Get just the category
const category = getStatusCategory(workspaceRootPath, 'done');
// Returns: 'closed'

import { validateSessionStatus } from '@craft-agent/shared/statuses';

// Returns valid status ID or fallback
const validStatus = validateSessionStatus(
  workspaceRootPath,
  'in-progress'  // User-provided status
);

// If 'in-progress' doesn't exist, returns 'todo'
if (validStatus !== 'in-progress') {
  console.warn('Invalid status, using fallback:', validStatus);
}

function headerToMetadata(
  header: SessionHeader,
  workspaceRootPath: string
): SessionMetadata | null {
  // Validate sessionStatus against workspace status config
  const validatedStatus = validateSessionStatus(
    workspaceRootPath,
    rawStatus
  );
  
  return {
    ...header,
    sessionStatus: validatedStatus,  // Guaranteed valid or 'todo'
  };
}