chore: surface underlying errors when session history fails to load (#26)

* chore: surface underlying errors when session history fails to load

The restore report only counted failed session files, discarding the underlying readSDKSession error, so user feedback could not reveal the root cause. Append each failing session id and its error to the reported detail.

Co-authored-by: QoderAI (Qwen 3.8 Max) <qoder_ai@qoder.com>

* docs: note the underlying file error in the restore diagnostics changelog entry

Co-authored-by: QoderAI (Qwen 3.8 Max) <qoder_ai@qoder.com>

---------

Co-authored-by: QoderAI (Qwen 3.8 Max) <qoder_ai@qoder.com>

Author: luoxuanzao

CHANGELOG.md

@@ -55,7 +55,9 @@ version with its date and start a fresh empty `[Unreleased]` above it.
 - Startup session restore no longer fails silently: when the tab
   layout, an individual tab, session metadata, or conversation history
   cannot be read, Qoderian now shows a single notice with the issue
-  count and logs per-stage details to the developer console.
+  count and logs per-stage details to the developer console, including
+  the underlying file error (such as a permission denial) for each
+  session history file that fails to load.
 
 ## [1.0.4] - 2026-08-12
 

src/qoder/history/qoder-conversation-history-service.ts

@@ -385,6 +385,7 @@ export class QoderConversationHistoryService {
     let missingSessionCount = 0;
     let errorCount = 0;
     let successCount = 0;
+    const loadErrors: string[] = [];
 
     const currentSessionId = isPendingFork
       ? state.forkSource!.sessionId
@@ -404,6 +405,7 @@ export class QoderConversationHistoryService {
 
       if (result.error) {
         errorCount++;
+        loadErrors.push(`${sessionId}: ${result.error}`);
         continue;
       }
 
@@ -415,7 +417,8 @@ export class QoderConversationHistoryService {
     if (errorCount > 0) {
       reportRestoreIssue(
         'history',
-        `Conversation "${conversation.id}": ${errorCount} of ${allSessionIds.length} session file(s) failed to load.`,
+        `Conversation "${conversation.id}": ${errorCount} of ${allSessionIds.length} session file(s) failed to load. `
+          + `Errors: ${loadErrors.join('; ')}`,
       );
     } else if (allSessionsMissing) {
       reportRestoreIssue(

tests/unit/qoder/history/qoder-conversation-history-service.test.ts

@@ -93,6 +93,8 @@ describe('QoderConversationHistoryService restore diagnostics', () => {
       stage: 'history',
       detail: expect.stringContaining('conv-1'),
     });
+    // The underlying error and session id must surface for diagnostics.
+    expect(issues[0].detail).toContain('sess-1: read failed');
   });
 
   it('reports a history issue when session files are missing on disk', async () => {