feat: sort briefs by updated at (#1409)

packages/tm-core/package.json

@@ -31,6 +31,7 @@
 	},
 	"dependencies": {
 		"@supabase/supabase-js": "^2.57.4",
+		"date-fns": "^4.1.0",
 		"fs-extra": "^11.3.2",
 		"simple-git": "^3.28.0",
 		"steno": "^4.0.2",

packages/tm-core/src/index.ts

@@ -50,6 +50,7 @@ export * from './common/errors/index.js';
 
 // Utils
 export * from './common/utils/index.js';
+export * from './utils/time.utils.js';
 
 // ========== Domain-Specific Type Exports ==========
 

packages/tm-core/src/modules/auth/services/organization.service.ts

@@ -3,13 +3,13 @@
  * Handles fetching and managing organizations and briefs from the API
  */
 
-import { SupabaseClient } from '@supabase/supabase-js';
+import type { SupabaseClient } from '@supabase/supabase-js';
 import {
 	ERROR_CODES,
 	TaskMasterError
 } from '../../../common/errors/task-master-error.js';
 import { getLogger } from '../../../common/logger/index.js';
-import { Database } from '../../../common/types/database.types.js';
+import type { Database } from '../../../common/types/database.types.js';
 import type { Brief } from '../../briefs/types.js';
 
 /**
@@ -171,7 +171,8 @@ export class OrganizationService {
 						title
 					)
 				`)
-				.eq('account_id', orgId);
+				.eq('account_id', orgId)
+				.order('updated_at', { ascending: false });
 
 			if (error) {
 				throw new TaskMasterError(

packages/tm-core/src/utils/time.utils.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Time utilities for formatting relative timestamps
+ * Shared across CLI, MCP, extension, and other interfaces
+ */
+
+import { formatDistanceToNow } from 'date-fns';
+
+/**
+ * Format a date as relative time from now (e.g., "2 hours ago", "3 days ago")
+ * @param date - Date string or Date object to format
+ * @returns Relative time string (e.g., "less than a minute ago", "5 minutes ago", "2 weeks ago")
+ */
+export function formatRelativeTime(date: string | Date): string {
+	const dateObj = typeof date === 'string' ? new Date(date) : date;
+
+	// Use date-fns for robust formatting with proper edge case handling
+	return formatDistanceToNow(dateObj, { addSuffix: true });
+}