@claude-sessions/core 0.4.4 → 0.4.5-beta.1

package/README.md

@@ -33,14 +33,10 @@ const sessions = await Effect.runPromise(listSessions(projectName))
 const messages = await Effect.runPromise(readSession(projectName, sessionId))
 
 // Search sessions (title only)
-const titleResults = await Effect.runPromise(
-  searchSessions('query', { searchContent: false })
-)
+const titleResults = await Effect.runPromise(searchSessions('query', { searchContent: false }))
 
 // Search sessions (title + content)
-const allResults = await Effect.runPromise(
-  searchSessions('query', { searchContent: true })
-)
+const allResults = await Effect.runPromise(searchSessions('query', { searchContent: true }))
 
 // Rename a session
 await Effect.runPromise(renameSession(projectName, sessionId, 'New Title'))
@@ -53,51 +49,52 @@ await Effect.runPromise(deleteSession(projectName, sessionId))
 
 ### Session Operations
 
-| Function | Description |
-|----------|-------------|
-| `listProjects()` | List all Claude Code projects |
-| `listSessions(projectName)` | List sessions in a project |
-| `readSession(projectName, sessionId)` | Read all messages in a session |
-| `searchSessions(query, options?)` | Search sessions by title or content |
-| `renameSession(projectName, sessionId, title)` | Rename a session |
-| `deleteSession(projectName, sessionId)` | Delete a session (backup) |
-| `deleteMessage(projectName, sessionId, uuid)` | Delete a message |
-| `splitSession(projectName, sessionId, uuid)` | Split session at a message |
-| `moveSession(source, sessionId, target)` | Move session to another project |
-| `getSessionFiles(projectName, sessionId)` | Get files changed in session |
-| `previewCleanup(projectName?)` | Preview cleanup candidates |
-| `clearSessions(options)` | Clear empty/invalid sessions |
+| Function                                       | Description                         |
+| ---------------------------------------------- | ----------------------------------- |
+| `listProjects()`                               | List all Claude Code projects       |
+| `listSessions(projectName)`                    | List sessions in a project          |
+| `readSession(projectName, sessionId)`          | Read all messages in a session      |
+| `searchSessions(query, options?)`              | Search sessions by title or content |
+| `renameSession(projectName, sessionId, title)` | Rename a session                    |
+| `deleteSession(projectName, sessionId)`        | Delete a session (backup)           |
+| `deleteMessage(projectName, sessionId, uuid)`  | Delete a message                    |
+| `splitSession(projectName, sessionId, uuid)`   | Split session at a message          |
+| `moveSession(source, sessionId, target)`       | Move session to another project     |
+| `getSessionFiles(projectName, sessionId)`      | Get files changed in session        |
+| `previewCleanup(projectName?)`                 | Preview cleanup candidates          |
+| `clearSessions(options)`                       | Clear empty/invalid sessions        |
 
 ### Path Utilities
 
-| Function | Description |
-|----------|-------------|
-| `getSessionsDir()` | Get Claude Code sessions directory |
-| `getTodosDir()` | Get Claude Code todos directory |
-| `folderNameToDisplayPath(name)` | Convert folder name to display path |
-| `displayPathToFolderName(path)` | Convert display path to folder name |
+| Function                            | Description                                                       |
+| ----------------------------------- | ----------------------------------------------------------------- |
+| `getSessionsDir()`                  | Get Claude Code sessions directory                                |
+| `getTodosDir()`                     | Get Claude Code todos directory                                   |
+| `folderNameToDisplayPath(name)`     | Convert folder name to display path                               |
+| `pathToFolderName(path)`            | Convert absolute path to folder name (official Claude Code logic) |
+| `resolvePathFromClaudeConfig(name)` | Resolve folder name to path via ~/.claude.json                    |
 
 ### Message Utilities
 
-| Function | Description |
-|----------|-------------|
-| `extractTextContent(message)` | Extract text from message content |
-| `extractTitle(messages)` | Extract session title from messages |
+| Function                          | Description                                |
+| --------------------------------- | ------------------------------------------ |
+| `extractTextContent(message)`     | Extract text from message content          |
+| `extractTitle(messages)`          | Extract session title from messages        |
 | `isInvalidApiKeyMessage(message)` | Check if message has invalid API key error |
-| `isContinuationSummary(message)` | Check if message is a continuation summary |
+| `isContinuationSummary(message)`  | Check if message is a continuation summary |
 
 ### Agent & Todo Management
 
-| Function | Description |
-|----------|-------------|
+| Function                                   | Description                   |
+| ------------------------------------------ | ----------------------------- |
 | `findLinkedAgents(projectName, sessionId)` | Find agents linked to session |
-| `findOrphanAgents(projectName?)` | Find orphan agent files |
-| `deleteOrphanAgents(projectName?)` | Delete orphan agents |
-| `findLinkedTodos(projectName, sessionId)` | Find todos linked to session |
-| `sessionHasTodos(projectName, sessionId)` | Check if session has todos |
-| `findOrphanTodos(projectName?)` | Find orphan todo files |
-| `deleteOrphanTodos(projectName?)` | Delete orphan todos |
+| `findOrphanAgents(projectName?)`           | Find orphan agent files       |
+| `deleteOrphanAgents(projectName?)`         | Delete orphan agents          |
+| `findLinkedTodos(projectName, sessionId)`  | Find todos linked to session  |
+| `sessionHasTodos(projectName, sessionId)`  | Check if session has todos    |
+| `findOrphanTodos(projectName?)`            | Find orphan todo files        |
+| `deleteOrphanTodos(projectName?)`          | Delete orphan todos           |
 
 ## License
 
-MIT
+MIT

package/dist/index.d.ts

@@ -17,6 +17,8 @@ interface FileSystem {
 declare const getSessionsDir: () => string;
 /** Get Claude todos directory (~/.claude/todos) */
 declare const getTodosDir: () => string;
+/** Expand ~ path to absolute path with OS-native separators */
+declare const expandHomePath: (tildePath: string, homeDir: string) => string;
 /**
  * Convert project folder name to display path
  * Unix: -home-user-projects -> /home/user/projects
@@ -24,16 +26,10 @@ declare const getTodosDir: () => string;
  * Handle dot-prefixed folders: --claude -> /.claude
  */
 declare const folderNameToDisplayPath: (folderName: string) => string;
-/**
- * Convert display path to folder name (reverse of folderNameToDisplayPath)
- * @deprecated Use pathToFolderName for absolute paths. This function exists
- * for roundtrip testing and does not handle non-ASCII or normalize drive case.
- */
-declare const displayPathToFolderName: (displayPath: string) => string;
 /**
  * Convert absolute path to project folder name
- * Non-ASCII characters are converted to '-' per character
- * Windows drive letter is normalized to lowercase (C: -> c--)
+ * All non-alphanumeric characters are converted to '-'
+ * Matches official Claude Code: A.replace(/[^a-zA-Z0-9]/g, '-')
  */
 declare const pathToFolderName: (absolutePath: string) => string;
 /**
@@ -48,7 +44,7 @@ declare const getRealPathFromSession: (folderName: string, sessionsDir?: string,
  * Convert folder name to relative or absolute path for display
  * If path is under home directory, show relative (~/...)
  */
-declare const folderNameToPath: (folderName: string) => string;
+declare const folderNameToPath: (folderName: string) => Promise<string>;
 /**
  * Find project folder name that matches the given workspace path
  * Searches through all projects and checks if any session's cwd matches
@@ -535,6 +531,7 @@ interface ProgressError {
     line: number;
     hookEvent?: string;
     hookName?: string;
+    messageType?: string;
 }
 interface ValidationResult {
     valid: boolean;
@@ -662,4 +659,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, displayPathToFolderName, extractProjectKnowledge, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, formatRelativeTime, generateTreeNodeId, 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, 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, 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 };

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/paths.ts
 import * as fs2 from "fs";
+import * as fsp from "fs/promises";
 import * as os from "os";
 import * as path from "path";
 
@@ -229,18 +230,11 @@ var WINDOWS_PATTERNS = {
   /** Matches Windows folder name format: C-- */
   folderName: /^([A-Za-z])--/
 };
-var parseWindowsAbsPath = (p) => {
-  const match = p.match(WINDOWS_PATTERNS.absolutePath);
-  return match ? { isWindows: true, drive: match[1], rest: p.slice(3) } : { isWindows: false };
-};
 var parseWindowsFolderName = (name) => {
   const match = name.match(WINDOWS_PATTERNS.folderName);
   return match ? { isWindows: true, drive: match[1], rest: name.slice(3) } : { isWindows: false };
 };
 var isWindowsPath = (p) => WINDOWS_PATTERNS.absolutePath.test(p);
-var convertNonAscii = (str) => [...str].map((c) => c.charCodeAt(0) <= 127 ? c : "-").join("");
-var pathCharsToFolderName = (str) => str.replace(/[/\\]\./g, "--").replace(/[/\\]/g, "-").replace(/\./g, "-");
-var separatorsToFolderName = (str) => str.replace(/[/\\]\./g, "--").replace(/[/\\]/g, "-");
 var extractCwdFromContent = (content, filePath) => {
   const lines = content.split("\n").filter((l) => l.trim());
   for (let i = 0; i < lines.length; i++) {
@@ -252,6 +246,11 @@ var extractCwdFromContent = (content, filePath) => {
   return null;
 };
 var isSessionFile = (filename) => filename.endsWith(".jsonl") && !filename.startsWith("agent-");
+var expandHomePath = (tildePath, homeDir) => {
+  if (!tildePath.startsWith("~")) return tildePath;
+  const relativePart = tildePath.slice(1);
+  return path.join(homeDir, ...relativePart.split("/").filter(Boolean));
+};
 var toRelativePath = (absolutePath, homeDir) => {
   const normalizedPath = absolutePath.replace(/\\/g, "/");
   const normalizedHome = homeDir.replace(/\\/g, "/");
@@ -263,11 +262,10 @@ var toRelativePath = (absolutePath, homeDir) => {
   }
   const startsWithHome = isWin ? pathLower.startsWith(homeLower + "/") : normalizedPath.startsWith(normalizedHome + "/");
   if (startsWithHome) {
-    const sep = isWin ? "\\" : "/";
     const relativePart = absolutePath.slice(homeDir.length);
-    return "~" + relativePart.replace(/[\\/]/g, sep);
+    return "~" + relativePart.replace(/\\/g, "/");
   }
-  return absolutePath;
+  return absolutePath.replace(/\\/g, "/");
 };
 var folderNameToDisplayPath = (folderName) => {
   const parsed = parseWindowsFolderName(folderName);
@@ -276,20 +274,7 @@ var folderNameToDisplayPath = (folderName) => {
   }
   return folderName.replace(/^-/, "/").replace(/--/g, "/.").replace(/-/g, "/");
 };
-var displayPathToFolderName = (displayPath) => {
-  const parsed = parseWindowsAbsPath(displayPath);
-  if (parsed.isWindows) {
-    return parsed.drive + "--" + separatorsToFolderName(parsed.rest);
-  }
-  return displayPath.replace(/^\//g, "-").replace(/\/\./g, "--").replace(/\//g, "-");
-};
-var pathToFolderName = (absolutePath) => {
-  const parsed = parseWindowsAbsPath(absolutePath);
-  if (parsed.isWindows) {
-    return parsed.drive.toLowerCase() + "--" + pathCharsToFolderName(convertNonAscii(parsed.rest));
-  }
-  return convertNonAscii(absolutePath).replace(/^\//g, "-").replace(/\/\./g, "--").replace(/\//g, "-").replace(/\./g, "-");
-};
+var pathToFolderName = (absolutePath) => absolutePath.replace(/[^a-zA-Z0-9]/g, "-");
 var tryGetCwdFromFile = (filePath, fileSystem = fs2, logger2 = log) => {
   const basename3 = path.basename(filePath);
   try {
@@ -323,20 +308,39 @@ var getRealPathFromSession = (folderName, sessionsDir = getSessionsDir(), fileSy
       logger2.warn(
         `getRealPathFromSession: ${folderName} -> no match, cwds found: ${cwdList.join(", ")}`
       );
-    } else {
-      logger2.warn(`getRealPathFromSession: ${folderName} -> no valid cwd in any session`);
     }
     return null;
   } catch {
     return null;
   }
 };
-var folderNameToPath = (folderName) => {
+var getClaudeConfigPath = () => path.join(os.homedir(), ".claude.json");
+var resolvePathFromClaudeConfig = async (folderName, fileSystem = fsp) => {
+  try {
+    const configPath = getClaudeConfigPath();
+    const content = await fileSystem.readFile(configPath, "utf-8");
+    const config = JSON.parse(content);
+    if (!config.projects) return null;
+    for (const projectPath of Object.keys(config.projects)) {
+      if (pathToFolderName(projectPath) === folderName) {
+        return projectPath;
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+};
+var folderNameToPath = async (folderName) => {
   const homeDir = os.homedir();
   const realPath = getRealPathFromSession(folderName);
   if (realPath) {
     return toRelativePath(realPath, homeDir);
   }
+  const configPath = await resolvePathFromClaudeConfig(folderName);
+  if (configPath) {
+    return toRelativePath(configPath, homeDir);
+  }
   const absolutePath = folderNameToDisplayPath(folderName);
   return toRelativePath(absolutePath, homeDir);
 };
@@ -808,9 +812,10 @@ var listProjects = Effect4.gen(function* () {
         const projectPath = path4.join(sessionsDir, entry.name);
         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));
         return {
           name: entry.name,
-          displayName: folderNameToPath(entry.name),
+          displayName,
           path: projectPath,
           sessionCount: sessionFiles.length
         };
@@ -899,6 +904,12 @@ function validateProgressMessages(messages) {
           hookName
         });
       }
+    } else if (msg.type === "saved_hook_context") {
+      errors.push({
+        type: "unwanted_progress",
+        line: i + 1,
+        messageType: "saved_hook_context"
+      });
     }
   }
   return {
@@ -2342,7 +2353,7 @@ export {
   deleteOrphanAgents,
   deleteOrphanTodos,
   deleteSession,
-  displayPathToFolderName,
+  expandHomePath,
   extractProjectKnowledge,
   extractTextContent,
   extractTitle,