@claude-sessions/core 0.4.8-beta.0 → 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, T as TitleDisplayMode, 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-CsXAWb1Q.js';
-export { q as CleanupPreview, p as ClearSessionsResult, w as CompressSessionResult, k as ContentItem, D as DeleteSessionResult, x as ProjectKnowledge, R as RenameSessionResult, s as ResumeSessionOptions, t as ResumeSessionResult, v as SessionAnalysis, n as SessionFilesSummary, l as SessionMeta, z as SessionSortField, B as SessionSortOrder, r as SessionTreeData, o as SplitSessionResult, y as SummarizeSessionResult, m as TodoItem, u as ToolUsageStats } from './types-CsXAWb1Q.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;
@@ -126,13 +127,28 @@ declare function getDisplayTitle(customTitle: string | undefined, currentSummary
  */
 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
@@ -503,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;
@@ -511,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?: {
@@ -593,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[];
@@ -690,4 +708,4 @@ declare const getLogger: () => Logger;
  */
 declare const createLogger: (namespace: string) => Logger;
 
-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, 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, 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

@@ -163,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);
@@ -410,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);
   });
 };
@@ -519,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)
@@ -838,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
         };
       })
     ),
@@ -917,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,
@@ -1219,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 }));
@@ -1610,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,
@@ -1709,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) => {
@@ -1741,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
   });
@@ -1770,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 {
         }
       })
@@ -2027,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]) {
@@ -2216,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"));
@@ -2263,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(
@@ -2286,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
         };
       })
     ),
@@ -2305,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;
@@ -2363,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
   };
 });
 
@@ -2595,6 +2662,7 @@ export {
   formatRelativeTime,
   generateTreeNodeId,
   getCachePath,
+  getDisplaySortTimestamp,
   getDisplayTitle,
   getIndexEntryDisplayTitle,
   getLogger,
@@ -2603,6 +2671,7 @@ export {
   getSessionSortTimestamp,
   getSessionTooltip,
   getSessionsDir,
+  getSummarySortTimestamp,
   getTodoIcon,
   getTodosDir,
   getTotalTodoCount,