@claude-sessions/core 0.4.7 → 0.4.8-beta.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as Project, M as MessagePayload$1, a as Message, S as SummaryInfo, b as SessionTodos, c as MoveSessionResult, A as AgentInfo, d as SessionSortOptions, e as ProjectTreeData, C as CompressSessionOptions, f as SummarizeSessionOptions, g as ConversationLine, h as SearchResult, F as FileChange, i as SessionsIndex, j as SessionIndexEntry } from './types-BMQErZZE.js';
-export { p as CleanupPreview, o as ClearSessionsResult, v as CompressSessionResult, k as ContentItem, D as DeleteSessionResult, w as ProjectKnowledge, R as RenameSessionResult, r as ResumeSessionOptions, s as ResumeSessionResult, u as SessionAnalysis, m as SessionFilesSummary, l as SessionMeta, y as SessionSortField, z as SessionSortOrder, q as SessionTreeData, n as SplitSessionResult, x as SummarizeSessionResult, T as TodoItem, t as ToolUsageStats } from './types-BMQErZZE.js';
+import { P as Project, M as MessagePayload$1, a as Message, T as TitleDisplayMode, S as SummaryInfo, b as SessionSortField, c as SessionTodos, d as MoveSessionResult, A as AgentInfo, e as SessionSortOptions, f as ProjectTreeData, C as CompressSessionOptions, g as SummarizeSessionOptions, h as ConversationLine, i as SearchResult, F as FileChange, j as SessionsIndex, k as SessionIndexEntry } from './types-CoLRUgPk.js';
+export { r as CleanupPreview, q as ClearSessionsResult, x as CompressSessionResult, l as ContentItem, D as DeleteSessionResult, y as ProjectKnowledge, R as RenameSessionResult, t as ResumeSessionOptions, u as ResumeSessionResult, w as SessionAnalysis, o as SessionFilesSummary, m as SessionMeta, B as SessionSortOrder, s as SessionTreeData, p as SplitSessionResult, z as SummarizeSessionResult, n as TodoItem, v as ToolUsageStats } from './types-CoLRUgPk.js';
 import * as effect_Cause from 'effect/Cause';
 import { Effect } from 'effect';
 
@@ -71,7 +71,8 @@ declare const findProjectByWorkspacePath: (workspacePath: string, projectNames:
  * Sort projects with priority:
  * 1. Current project (if specified)
  * 2. Current user's home directory subpaths
- * 3. Others (alphabetically by displayName)
+ * 3. Most recently modified first (by newest session file mtime)
+ * 4. Alphabetically by displayName as tiebreaker
  */
 declare const sortProjects: (projects: Project[], options?: {
     currentProjectName?: string | null;
@@ -94,25 +95,60 @@ declare const parseCommandMessage: (content?: string) => {
 declare const extractTitle: (input: MessagePayload$1 | string | undefined) => string;
 declare const isInvalidApiKeyMessage: (msg: Message) => boolean;
 declare const isContinuationSummary: (msg: Message) => boolean;
+/**
+ * Options for getDisplayTitle when using the options-based signature
+ */
+interface DisplayTitleOptions {
+    customTitle?: string;
+    currentSummary?: string;
+    title?: string;
+    createdAt?: string;
+    maxLength?: number;
+    fallback?: string;
+    /** 'message' = first user message (default), 'datetime' = relative date/time */
+    mode?: TitleDisplayMode;
+    /** Locale for date formatting (e.g. 'de-DE', 'en-GB'). Defaults to system locale. */
+    locale?: string;
+}
 /**
  * Get display title with fallback logic
- * Priority: customTitle > currentSummary (truncated) > title > fallback
+ * Priority: customTitle > currentSummary (truncated) > title/datetime > fallback
  * Also handles slash command format in title
+ *
+ * Supports two call signatures:
+ * - Legacy: getDisplayTitle(customTitle, currentSummary, title, maxLength?, fallback?)
+ * - Options: getDisplayTitle(options)
  */
-declare const getDisplayTitle: (customTitle: string | undefined, currentSummary: string | undefined, title: string | undefined, maxLength?: number, fallback?: string) => string;
+declare function getDisplayTitle(options: DisplayTitleOptions): string;
+declare function getDisplayTitle(customTitle: string | undefined, currentSummary: string | undefined, title: string | undefined, maxLength?: number, fallback?: string): string;
 /**
  * Mask home directory path with ~
  * Only masks the specified homeDir, not other users' paths
  */
 declare const maskHomePath: (text: string, homeDir: string) => string;
 /**
- * Get sort timestamp for session (Unix timestamp ms)
- * Priority: summaries[0].timestamp > createdAt > 0
+ * Get summary-based sort timestamp for session (Unix timestamp ms)
+ * Used for 'summary' sort field. Priority: summaries[0].timestamp > createdAt > 0
  */
+declare const getSummarySortTimestamp: (session: {
+    summaries?: SummaryInfo[];
+    createdAt?: string;
+}) => number;
+/** @deprecated Use getSummarySortTimestamp instead */
 declare const getSessionSortTimestamp: (session: {
     summaries?: SummaryInfo[];
     createdAt?: string;
 }) => number;
+/**
+ * Get display-ready sort timestamp based on active sort field.
+ * Returns the timestamp matching what the user sees as the sort order.
+ */
+declare const getDisplaySortTimestamp: (session: {
+    summaries?: SummaryInfo[];
+    createdAt?: string;
+    updatedAt?: string;
+    fileMtime?: number;
+}, sortField: SessionSortField) => number;
 /**
  * Try to parse a single JSON line, returning null on failure with optional warning log
  * Use this when you want to skip invalid lines instead of throwing
@@ -139,7 +175,7 @@ declare const readJsonlFile: <T = Record<string, unknown>>(filePath: string, opt
  * @param timestamp - Unix timestamp (ms) or ISO date string
  * @returns Relative time string
  */
-declare const formatRelativeTime: (timestamp: number | string) => string;
+declare const formatRelativeTime: (timestamp: number | string, locale?: string) => string;
 /**
  * Calculate total todo count from session todos
  * Includes both session-level and agent-level todos
@@ -483,6 +519,7 @@ declare const previewCleanup: (projectName?: string) => Effect.Effect<{
     emptyWithTodosCount: number;
     orphanAgentCount: number;
     orphanTodoCount: number;
+    isStale: boolean;
 }[], effect_Cause.UnknownException, never>;
 declare const clearSessions: (options: {
     projectName?: string;
@@ -491,12 +528,15 @@ declare const clearSessions: (options: {
     skipWithTodos?: boolean;
     clearOrphanAgents?: boolean;
     clearOrphanTodos?: boolean;
+    clearStale?: boolean;
+    staleProjects?: string[];
 }) => Effect.Effect<{
     success: true;
     deletedCount: number;
     removedMessageCount: number;
     deletedOrphanAgentCount: number;
     deletedOrphanTodoCount: number;
+    deletedStaleProjectCount: number;
 }, effect_Cause.UnknownException, never>;
 
 declare const searchSessions: (query: string, options?: {
@@ -573,9 +613,7 @@ declare function validateChain(messages: readonly GenericMessage[]): ValidationR
     errors: ChainError[];
 };
 /**
- * Validate for unwanted progress messages (hook outputs)
- *
- * Only 'Stop' hookEvent is treated as an error (should be removed)
+ * Validate for unwanted cleanup artifacts that should not remain in sessions.
  */
 declare function validateProgressMessages(messages: readonly GenericMessage[]): ValidationResult & {
     errors: ProgressError[];
@@ -670,4 +708,4 @@ declare const getLogger: () => Logger;
  */
 declare const createLogger: (namespace: string) => Logger;
 
-export { AgentInfo, type ChainError, CompressSessionOptions, ConversationLine, FileChange, type GenericMessage, type Logger, Message, MessagePayload$1 as MessagePayload, MoveSessionResult, type ProgressError, Project, ProjectTreeData, SearchResult, SessionIndexEntry, SessionSortOptions, SessionTodos, SessionsIndex, SummarizeSessionOptions, SummaryInfo, TREE_ICONS, type ToolUseResultError, type TreeItemType, type ValidationResult, analyzeSession, autoRepairChain, canMoveSession, clearSessions, compressSession, createLogger, deleteLinkedTodos, deleteMessage, deleteMessageWithChainRepair, deleteOrphanAgents, deleteOrphanTodos, deleteSession, expandHomePath, extractProjectKnowledge, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, formatRelativeTime, generateTreeNodeId, getCachePath, getDisplayTitle, getIndexEntryDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionSortTimestamp, getSessionTooltip, getSessionsDir, getTodoIcon, getTodosDir, getTotalTodoCount, hasSessionsIndex, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, loadSessionsIndex, maskHomePath, moveSession, parseCommandMessage, parseJsonlLines, parseTreeNodeId, pathToFolderName, previewCleanup, readJsonlFile, readSession, renameSession, repairChain, repairParentUuidChain, restoreMessage, searchSessions, sessionHasSubItems, sessionHasTodos, setLogger, sortIndexEntriesByModified, sortProjects, splitSession, summarizeSession, tryParseJsonLine, updateSessionSummary, validateChain, validateProgressMessages, validateToolUseResult };
+export { AgentInfo, type ChainError, CompressSessionOptions, ConversationLine, type DisplayTitleOptions, FileChange, type GenericMessage, type Logger, Message, MessagePayload$1 as MessagePayload, MoveSessionResult, type ProgressError, Project, ProjectTreeData, SearchResult, SessionIndexEntry, SessionSortField, SessionSortOptions, SessionTodos, SessionsIndex, SummarizeSessionOptions, SummaryInfo, TREE_ICONS, TitleDisplayMode, type ToolUseResultError, type TreeItemType, type ValidationResult, analyzeSession, autoRepairChain, canMoveSession, clearSessions, compressSession, createLogger, deleteLinkedTodos, deleteMessage, deleteMessageWithChainRepair, deleteOrphanAgents, deleteOrphanTodos, deleteSession, expandHomePath, extractProjectKnowledge, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, formatRelativeTime, generateTreeNodeId, getCachePath, getDisplaySortTimestamp, getDisplayTitle, getIndexEntryDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionSortTimestamp, getSessionTooltip, getSessionsDir, getSummarySortTimestamp, getTodoIcon, getTodosDir, getTotalTodoCount, hasSessionsIndex, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, loadSessionsIndex, maskHomePath, moveSession, parseCommandMessage, parseJsonlLines, parseTreeNodeId, pathToFolderName, previewCleanup, readJsonlFile, readSession, renameSession, repairChain, repairParentUuidChain, restoreMessage, searchSessions, sessionHasSubItems, sessionHasTodos, setLogger, sortIndexEntriesByModified, sortProjects, splitSession, summarizeSession, tryParseJsonLine, updateSessionSummary, validateChain, validateProgressMessages, validateToolUseResult };

package/dist/index.js

@@ -95,11 +95,31 @@ var isContinuationSummary = (msg) => {
   const text = extractTextContent(msg.message);
   return text.startsWith("This session is being continued from");
 };
-var getDisplayTitle = (customTitle, currentSummary, title, maxLength = 60, fallback = "Untitled") => {
+function getDisplayTitle(customTitleOrOptions, currentSummary, title, maxLength = 60, fallback = "Untitled") {
+  let mode = "message";
+  let createdAt;
+  let customTitle;
+  let locale;
+  if (typeof customTitleOrOptions === "object" && customTitleOrOptions !== null) {
+    const opts = customTitleOrOptions;
+    customTitle = opts.customTitle;
+    currentSummary = opts.currentSummary;
+    title = opts.title;
+    createdAt = opts.createdAt;
+    maxLength = opts.maxLength ?? 60;
+    fallback = opts.fallback ?? "Untitled";
+    mode = opts.mode ?? "message";
+    locale = opts.locale;
+  } else {
+    customTitle = customTitleOrOptions;
+  }
   if (customTitle) return customTitle;
   if (currentSummary) {
     return currentSummary.length > maxLength ? currentSummary.slice(0, maxLength - 3) + "..." : currentSummary;
   }
+  if (mode === "datetime" && createdAt) {
+    return formatRelativeTime(createdAt, locale);
+  }
   if (title && title !== "Untitled") {
     const firstParagraph = title.includes("\n\n") ? title.split("\n\n")[0] : title;
     if (firstParagraph.includes("<command-name>")) {
@@ -109,7 +129,7 @@ var getDisplayTitle = (customTitle, currentSummary, title, maxLength = 60, fallb
     return firstParagraph;
   }
   return fallback;
-};
+}
 var replaceMessageContent = (msg, text) => ({
   ...msg,
   message: {
@@ -143,10 +163,27 @@ var maskHomePath = (text, homeDir) => {
   const regex = new RegExp(`${escapedHome}(?=[/\\\\]|$)`, "g");
   return text.replace(regex, "~");
 };
-var getSessionSortTimestamp = (session) => {
+var getSummarySortTimestamp = (session) => {
   const timestampStr = session.summaries?.[0]?.timestamp ?? session.createdAt;
   return timestampStr ? new Date(timestampStr).getTime() : 0;
 };
+var getSessionSortTimestamp = getSummarySortTimestamp;
+var getDisplaySortTimestamp = (session, sortField) => {
+  switch (sortField) {
+    case "updated": {
+      if (session.updatedAt) return new Date(session.updatedAt).getTime();
+      return getSummarySortTimestamp(session);
+    }
+    case "created": {
+      if (session.createdAt) return new Date(session.createdAt).getTime();
+      return getSummarySortTimestamp(session);
+    }
+    case "modified":
+      return session.fileMtime ?? getSummarySortTimestamp(session);
+    default:
+      return getSummarySortTimestamp(session);
+  }
+};
 var tryParseJsonLine = (line, lineNumber, filePath) => {
   try {
     return JSON.parse(line);
@@ -179,7 +216,7 @@ var readJsonlFile = (filePath, options) => Effect.gen(function* () {
   const lines = content.trim().split("\n").filter(Boolean);
   return parseJsonlLines(lines, filePath, options);
 });
-var formatRelativeTime = (timestamp) => {
+var formatRelativeTime = (timestamp, locale) => {
   const date = typeof timestamp === "string" ? new Date(timestamp) : new Date(timestamp);
   const now = /* @__PURE__ */ new Date();
   const diff = now.getTime() - date.getTime();
@@ -190,7 +227,7 @@ var formatRelativeTime = (timestamp) => {
   if (minutes < 60) return `${minutes}m ago`;
   if (hours < 24) return `${hours}h ago`;
   if (days < 7) return `${days}d ago`;
-  return date.toLocaleDateString();
+  return date.toLocaleDateString(locale, { day: "numeric", month: "short", year: "numeric" });
 };
 var getTotalTodoCount = (todos) => {
   return todos.sessionTodos.length + todos.agentTodos.reduce((sum, a) => sum + a.todos.length, 0);
@@ -390,6 +427,9 @@ var sortProjects = (projects, options = {}) => {
       if (aIsUserHome && !bIsUserHome) return -1;
       if (!aIsUserHome && bIsUserHome) return 1;
     }
+    const aMtime = a.lastModified ?? 0;
+    const bMtime = b.lastModified ?? 0;
+    if (aMtime !== bMtime) return bMtime - aMtime;
     return a.displayName.localeCompare(b.displayName);
   });
 };
@@ -499,8 +539,8 @@ var findOrphanAgentsWithPaths = (projectName) => Effect2.gen(function* () {
   }
   for (const entry of files) {
     const entryPath = path2.join(projectPath, entry);
-    const stat4 = yield* Effect2.tryPromise(() => fs3.stat(entryPath).catch(() => null));
-    if (stat4?.isDirectory() && !entry.startsWith(".")) {
+    const stat6 = yield* Effect2.tryPromise(() => fs3.stat(entryPath).catch(() => null));
+    if (stat6?.isDirectory() && !entry.startsWith(".")) {
       const subagentsPath = path2.join(entryPath, "subagents");
       const subagentsExists = yield* Effect2.tryPromise(
         () => fs3.stat(subagentsPath).then(() => true).catch(() => false)
@@ -818,11 +858,24 @@ var listProjects = Effect4.gen(function* () {
         const files = yield* Effect4.tryPromise(() => fs5.readdir(projectPath));
         const sessionFiles = files.filter((f) => f.endsWith(".jsonl") && !f.startsWith("agent-"));
         const displayName = yield* Effect4.tryPromise(() => folderNameToPath(entry.name));
+        let lastModified = 0;
+        if (sessionFiles.length > 0) {
+          const stats = yield* Effect4.all(
+            sessionFiles.map(
+              (f) => Effect4.tryPromise(
+                () => fs5.stat(path4.join(projectPath, f)).then((s) => s.mtimeMs)
+              ).pipe(Effect4.orElseSucceed(() => 0))
+            ),
+            { concurrency: 20 }
+          );
+          lastModified = stats.reduce((max, value) => value > max ? value : max, 0);
+        }
         return {
           name: entry.name,
           displayName,
           path: projectPath,
-          sessionCount: sessionFiles.length
+          sessionCount: sessionFiles.length,
+          lastModified
         };
       })
     ),
@@ -897,19 +950,7 @@ function validateProgressMessages(messages) {
   const errors = [];
   for (let i = 0; i < messages.length; i++) {
     const msg = messages[i];
-    if (msg.type === "progress") {
-      const progressMsg = msg;
-      const hookEvent = progressMsg.hookEvent ?? progressMsg.data?.hookEvent;
-      const hookName = progressMsg.hookName ?? progressMsg.data?.hookName;
-      if (hookEvent === "Stop") {
-        errors.push({
-          type: "unwanted_progress",
-          line: i + 1,
-          hookEvent,
-          hookName
-        });
-      }
-    } else if (msg.type === "saved_hook_context") {
+    if (msg.type === "saved_hook_context") {
       errors.push({
         type: "unwanted_progress",
         line: i + 1,
@@ -1199,8 +1240,8 @@ var deleteSession = (projectName, sessionId) => Effect5.gen(function* () {
   const projectPath = path5.join(sessionsDir, projectName);
   const filePath = path5.join(projectPath, `${sessionId}.jsonl`);
   const linkedAgents = yield* findLinkedAgents(projectName, sessionId);
-  const stat4 = yield* Effect5.tryPromise(() => fs6.stat(filePath));
-  if (stat4.size === 0) {
+  const stat6 = yield* Effect5.tryPromise(() => fs6.stat(filePath));
+  if (stat6.size === 0) {
     yield* Effect5.tryPromise(() => fs6.unlink(filePath));
     const agentBackupDir2 = path5.join(projectPath, ".bak");
     yield* Effect5.tryPromise(() => fs6.mkdir(agentBackupDir2, { recursive: true }));
@@ -1590,7 +1631,7 @@ var loadSessionTreeDataInternal = (projectName, sessionId, summariesByTargetSess
   }
   const todos = yield* findLinkedTodos(sessionId, linkedAgentIds);
   const createdAt = firstMessage?.timestamp ?? void 0;
-  const sortTimestamp = getSessionSortTimestamp({ summaries, createdAt });
+  const sortTimestamp = getSummarySortTimestamp({ summaries, createdAt });
   return {
     id: sessionId,
     projectName,
@@ -1689,12 +1730,16 @@ var buildProjectTreeResult = (project, sessions, sort) => {
     if (isErrorSessionTitle(s.currentSummary)) return false;
     return true;
   });
+  const displaySessions = filteredSessions.map((s) => ({
+    ...s,
+    sortTimestamp: getDisplaySortTimestamp(s, sort.field)
+  }));
   return {
     name: project.name,
     displayName: project.displayName,
     path: project.path,
-    sessionCount: filteredSessions.length,
-    sessions: filteredSessions
+    sessionCount: displaySessions.length,
+    sessions: displaySessions
   };
 };
 var buildTreeCache = (globalUuidMap, allSummaries, sessions, fileMtimes) => {
@@ -1721,7 +1766,7 @@ var updateSessionSummaries = (cached, summariesByTargetSession) => {
   const oldJson = JSON.stringify(cached.summaries);
   const newJson = JSON.stringify(newSummaries);
   if (oldJson === newJson) return cached;
-  const newSortTimestamp = getSessionSortTimestamp({
+  const newSortTimestamp = getSummarySortTimestamp({
     summaries: newSummaries,
     createdAt: cached.createdAt
   });
@@ -1750,8 +1795,8 @@ var loadProjectTreeData = (projectName, sortOptions) => Effect6.gen(function* ()
       (file) => Effect6.gen(function* () {
         const filePath = path7.join(projectPath, file);
         try {
-          const stat4 = yield* Effect6.tryPromise(() => fs8.stat(filePath));
-          fileMtimes.set(file.replace(".jsonl", ""), stat4.mtimeMs);
+          const stat6 = yield* Effect6.tryPromise(() => fs8.stat(filePath));
+          fileMtimes.set(file.replace(".jsonl", ""), stat6.mtimeMs);
         } catch {
         }
       })
@@ -2007,9 +2052,12 @@ var compressSession = (projectName, sessionId, options = {}) => Effect7.gen(func
   const messagesToRemove = [];
   const filteredMessages = messages.filter((msg, idx) => {
     if (msg.type === "progress") {
-      removedProgress++;
-      messagesToRemove.push(msg);
-      return false;
+      const hookEvent = (typeof msg.hookEvent === "string" ? msg.hookEvent : void 0) ?? (typeof msg.data === "object" && msg.data !== null && "hookEvent" in msg.data ? msg.data.hookEvent : void 0);
+      if (hookEvent !== "Stop") {
+        removedProgress++;
+        messagesToRemove.push(msg);
+        return false;
+      }
     }
     if (msg.type === "custom-title") {
       if (customTitleIndices.length > 1 && idx !== customTitleIndices[customTitleIndices.length - 1]) {
@@ -2196,6 +2244,7 @@ var summarizeSession = (projectName, sessionId, options = {}) => Effect7.gen(fun
 import { Effect as Effect8 } from "effect";
 import * as fs10 from "fs/promises";
 import * as path9 from "path";
+import * as os2 from "os";
 var cleanInvalidMessages = (projectName, sessionId) => Effect8.gen(function* () {
   const filePath = path9.join(getSessionsDir(), projectName, `${sessionId}.jsonl`);
   const content = yield* Effect8.tryPromise(() => fs10.readFile(filePath, "utf-8"));
@@ -2243,9 +2292,32 @@ var previewCleanup = (projectName) => Effect8.gen(function* () {
   const targetProjects = projectName ? projects.filter((p) => p.name === projectName) : projects;
   const orphanTodos = yield* findOrphanTodos();
   const orphanTodoCount = orphanTodos.length;
+  const homeDir = os2.homedir();
+  const staleSet = /* @__PURE__ */ new Set();
+  yield* Effect8.all(
+    targetProjects.map(
+      (project) => Effect8.tryPromise(async () => {
+        const displayPath = await folderNameToPath(project.name);
+        const absPath = expandHomePath(displayPath, homeDir);
+        try {
+          const stats = await fs10.stat(absPath);
+          if (!stats.isDirectory()) {
+            staleSet.add(project.name);
+          }
+        } catch (error) {
+          const err = error;
+          if (err.code === "ENOENT") {
+            staleSet.add(project.name);
+          }
+        }
+      })
+    ),
+    { concurrency: 10 }
+  );
   const results = yield* Effect8.all(
     targetProjects.map(
       (project) => Effect8.gen(function* () {
+        const isStale = staleSet.has(project.name);
         const sessions = yield* listSessions(project.name);
         const emptySessions = sessions.filter((s) => s.messageCount === 0);
         const invalidSessions = sessions.filter(
@@ -2266,8 +2338,9 @@ var previewCleanup = (projectName) => Effect8.gen(function* () {
           invalidSessions,
           emptyWithTodosCount,
           orphanAgentCount: orphanAgents.length,
-          orphanTodoCount: 0
+          orphanTodoCount: 0,
           // Will set for first project only
+          isStale
         };
       })
     ),
@@ -2285,7 +2358,9 @@ var clearSessions = (options) => Effect8.gen(function* () {
     clearInvalid = true,
     skipWithTodos = true,
     clearOrphanAgents = true,
-    clearOrphanTodos = false
+    clearOrphanTodos = false,
+    clearStale = false,
+    staleProjects = []
   } = options;
   const projects = yield* listProjects;
   const targetProjects = projectName ? projects.filter((p) => p.name === projectName) : projects;
@@ -2343,12 +2418,24 @@ var clearSessions = (options) => Effect8.gen(function* () {
     const result = yield* deleteOrphanTodos();
     deletedOrphanTodoCount = result.deletedCount;
   }
+  let deletedStaleProjectCount = 0;
+  if (clearStale && staleProjects.length > 0) {
+    const sessionsDir = getSessionsDir();
+    for (const staleProjectName of staleProjects) {
+      const projectSessionsPath = path9.join(sessionsDir, staleProjectName);
+      const deleted = yield* Effect8.tryPromise(
+        () => fs10.rm(projectSessionsPath, { recursive: true, force: true }).then(() => true)
+      ).pipe(Effect8.orElse(() => Effect8.succeed(false)));
+      if (deleted) deletedStaleProjectCount++;
+    }
+  }
   return {
     success: true,
     deletedCount: deletedSessionCount,
     removedMessageCount,
     deletedOrphanAgentCount,
-    deletedOrphanTodoCount
+    deletedOrphanTodoCount,
+    deletedStaleProjectCount
   };
 });
 
@@ -2575,6 +2662,7 @@ export {
   formatRelativeTime,
   generateTreeNodeId,
   getCachePath,
+  getDisplaySortTimestamp,
   getDisplayTitle,
   getIndexEntryDisplayTitle,
   getLogger,
@@ -2583,6 +2671,7 @@ export {
   getSessionSortTimestamp,
   getSessionTooltip,
   getSessionsDir,
+  getSummarySortTimestamp,
   getTodoIcon,
   getTodosDir,
   getTotalTodoCount,