@allpepper/task-orchestrator-tui 1.0.0

package/src/ui/lib/types.ts

@@ -0,0 +1,157 @@
+import type { Task, Feature, Priority } from 'task-orchestrator-bun/src/domain/types';
+
+/**
+ * Navigation screens for the TUI
+ */
+export enum Screen {
+  Dashboard = 'dashboard',
+  ProjectView = 'project-view',
+  FeatureView = 'feature-view',
+  TaskDetail = 'task-detail',
+  Search = 'search',
+  Help = 'help',
+}
+
+/**
+ * Screen parameters for navigation
+ */
+export interface ScreenParams {
+  [Screen.Dashboard]: Record<string, never>;
+  [Screen.ProjectView]: { projectId: string };
+  [Screen.FeatureView]: { featureId: string };
+  [Screen.TaskDetail]: { taskId: string };
+  [Screen.Search]: { query?: string };
+  [Screen.Help]: Record<string, never>;
+}
+
+/**
+ * Navigation state with screen stack
+ */
+export interface NavigationState {
+  stack: Array<{
+    screen: Screen;
+    params: Record<string, unknown>;
+  }>;
+}
+
+/**
+ * Keyboard shortcut definition
+ */
+export interface Shortcut {
+  key: string;
+  label: string;
+  action: () => void;
+}
+
+/**
+ * Generic tree node for hierarchical data
+ */
+export interface TreeNode<T> {
+  data: T;
+  children: TreeNode<T>[];
+  expanded: boolean;
+  level: number;
+}
+
+/**
+ * Feature with nested tasks for tree view
+ */
+export interface FeatureWithTasks extends Feature {
+  tasks: Task[];
+}
+
+/**
+ * Kanban board task with optional feature label
+ */
+export interface BoardTask extends Task {
+  featureName?: string;
+}
+
+/**
+ * Kanban board card definition
+ */
+export interface BoardCard {
+  id: string;
+  title: string;
+  featureName: string | null;
+  priority: Priority;
+  task: BoardTask;
+}
+
+/**
+ * Kanban board column definition
+ */
+export interface BoardColumn {
+  id: string;
+  title: string;
+  status: string;
+  tasks: BoardTask[];
+}
+
+/**
+ * Search result types
+ */
+export interface SearchResults {
+  projects: Array<{ id: string; name: string; summary: string }>;
+  features: Array<{ id: string; name: string; summary: string; projectId?: string }>;
+  tasks: Array<{ id: string; title: string; summary: string; projectId?: string; featureId?: string }>;
+}
+
+/**
+ * Dependency information for a task
+ */
+export interface DependencyInfo {
+  blockedBy: Task[];
+  blocks: Task[];
+}
+
+/**
+ * Project overview data
+ */
+export interface ProjectOverview {
+  project: {
+    id: string;
+    name: string;
+    summary: string;
+    status: string;
+  };
+  taskCounts: {
+    total: number;
+    byStatus: Record<string, number>;
+  };
+}
+
+/**
+ * Feature overview data
+ */
+export interface FeatureOverview {
+  feature: {
+    id: string;
+    name: string;
+    summary: string;
+    status: string;
+    priority: Priority;
+  };
+  taskCounts: {
+    total: number;
+    byStatus: Record<string, number>;
+  };
+}
+
+/**
+ * Feature card for the feature-based Kanban board
+ */
+export interface BoardFeature extends Feature {
+  tasks: Task[];
+  taskCounts: { total: number; completed: number };
+}
+
+/**
+ * Column in the feature-based Kanban board
+ */
+export interface FeatureBoardColumn {
+  id: string;
+  title: string;
+  status: string;
+  features: BoardFeature[];
+}

package/src/ui/themes/dark.ts

@@ -0,0 +1,63 @@
+import type { Theme } from './types';
+import { Priority } from 'task-orchestrator-bun/src/domain/types';
+
+export const darkTheme: Theme = {
+  name: 'dark',
+  colors: {
+    // Base colors
+    background: '#1a1a2e',
+    foreground: '#eaeaea',
+    muted: '#6b6b8d',
+    border: '#3d3d5c',
+
+    // Status colors (unique keys only)
+    status: {
+      // Project/Feature/Task shared
+      PLANNING: '#a0a0c0',
+      IN_DEVELOPMENT: '#4da6ff',
+      ON_HOLD: '#cc9966',
+      CANCELLED: '#808080',
+      COMPLETED: '#4ade80',
+      ARCHIVED: '#555555',
+
+      // Feature/Task shared
+      TESTING: '#66cccc',
+      BLOCKED: '#ff6666',
+      DEPLOYED: '#34d399',
+
+      // Feature only
+      DRAFT: '#6b6b8d',
+      VALIDATING: '#66cc99',
+      PENDING_REVIEW: '#b366ff',
+
+      // Task only
+      BACKLOG: '#6b6b8d',
+      PENDING: '#a0a0c0',
+      IN_PROGRESS: '#4da6ff',
+      IN_REVIEW: '#b366ff',
+      CHANGES_REQUESTED: '#ff9966',
+      READY_FOR_QA: '#66cc99',
+      INVESTIGATING: '#ffcc66',
+      DEFERRED: '#999999',
+    },
+
+    // Priority colors
+    priority: {
+      [Priority.HIGH]: '#ff6b6b',
+      [Priority.MEDIUM]: '#ffd93d',
+      [Priority.LOW]: '#6bcb77',
+    },
+
+    // Semantic colors
+    accent: '#4da6ff',
+    success: '#4ade80',
+    warning: '#ffd93d',
+    error: '#ff6b6b',
+    danger: '#ff6666',
+    info: '#66cccc',
+
+    // Interactive colors
+    selection: '#4a4a7a',
+    highlight: '#6060a0',
+  },
+};

package/src/ui/themes/light.ts

@@ -0,0 +1,63 @@
+import type { Theme } from './types';
+import { Priority } from 'task-orchestrator-bun/src/domain/types';
+
+export const lightTheme: Theme = {
+  name: 'light',
+  colors: {
+    // Base colors
+    background: '#ffffff',
+    foreground: '#1a1a2e',
+    muted: '#6b7280',
+    border: '#e5e7eb',
+
+    // Status colors (unique keys only)
+    status: {
+      // Project/Feature/Task shared
+      PLANNING: '#6b7280',
+      IN_DEVELOPMENT: '#3b82f6',
+      ON_HOLD: '#d97706',
+      CANCELLED: '#6b7280',
+      COMPLETED: '#16a34a',
+      ARCHIVED: '#9ca3af',
+
+      // Feature/Task shared
+      TESTING: '#06b6d4',
+      BLOCKED: '#ef4444',
+      DEPLOYED: '#22c55e',
+
+      // Feature only
+      DRAFT: '#9ca3af',
+      VALIDATING: '#14b8a6',
+      PENDING_REVIEW: '#8b5cf6',
+
+      // Task only
+      BACKLOG: '#9ca3af',
+      PENDING: '#6b7280',
+      IN_PROGRESS: '#3b82f6',
+      IN_REVIEW: '#8b5cf6',
+      CHANGES_REQUESTED: '#f97316',
+      READY_FOR_QA: '#14b8a6',
+      INVESTIGATING: '#eab308',
+      DEFERRED: '#9ca3af',
+    },
+
+    // Priority colors
+    priority: {
+      [Priority.HIGH]: '#dc2626',
+      [Priority.MEDIUM]: '#ca8a04',
+      [Priority.LOW]: '#16a34a',
+    },
+
+    // Semantic colors
+    accent: '#2563eb',
+    success: '#16a34a',
+    warning: '#ca8a04',
+    error: '#dc2626',
+    danger: '#dc2626',
+    info: '#0891b2',
+
+    // Interactive colors
+    selection: '#dbeafe',
+    highlight: '#bfdbfe',
+  },
+};

package/src/ui/themes/types.ts

@@ -0,0 +1,71 @@
+import type { Priority } from 'task-orchestrator-bun/src/domain/types';
+
+/**
+ * All possible status values across Project, Feature, and Task
+ * Using string literal union to avoid duplicate key issues
+ */
+export type StatusKey =
+  // Project statuses
+  | 'PLANNING'
+  | 'IN_DEVELOPMENT'
+  | 'ON_HOLD'
+  | 'CANCELLED'
+  | 'COMPLETED'
+  | 'ARCHIVED'
+  // Feature-only statuses
+  | 'DRAFT'
+  | 'TESTING'
+  | 'VALIDATING'
+  | 'PENDING_REVIEW'
+  | 'BLOCKED'
+  | 'DEPLOYED'
+  // Task-only statuses
+  | 'BACKLOG'
+  | 'PENDING'
+  | 'IN_PROGRESS'
+  | 'IN_REVIEW'
+  | 'CHANGES_REQUESTED'
+  | 'READY_FOR_QA'
+  | 'INVESTIGATING'
+  | 'DEFERRED';
+
+/**
+ * Theme interface for the Task Orchestrator UI
+ * Supports both TUI (terminal) and web renderers
+ */
+export interface Theme {
+  name: 'dark' | 'light';
+  colors: {
+    // Base colors
+    background: string;
+    foreground: string;
+    muted: string;
+    border: string;
+
+    // Status colors - maps all unique status values
+    status: Record<StatusKey, string>;
+
+    // Priority colors
+    priority: Record<Priority, string>;
+
+    // Semantic colors
+    accent: string;
+    success: string;
+    warning: string;
+    error: string;
+    danger: string;
+    info: string;
+
+    // Interactive colors
+    selection: string;
+    highlight: string;
+  };
+}
+
+/**
+ * Task counts structure used in overviews
+ */
+export interface TaskCounts {
+  total: number;
+  byStatus: Record<string, number>;
+}