@hienlh/ppm 0.8.3 → 0.8.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.8.5] - 2026-03-23
+
+### Fixed
+- **Diagnostic error messages for project-specific failures**: When SDK returns `assistant error: unknown`, error now includes project path and exact `claude` CLI command to run for diagnosis
+- **Full SDK event dump on error**: Log complete assistant message JSON for debugging (visible in server logs)
+- **Removed broken session retry**: Retry-as-fresh-session didn't help since fresh sessions also fail for the same project — removed to avoid masking the real error
+
+## [0.8.4] - 2026-03-23
+
+### Fixed
+- **Poisoned session auto-recovery**: When resuming an existing SDK session fails with an assistant error (e.g. `unknown`), automatically retry as a fresh session instead of hanging for minutes — fixes projects stuck on a bad session
+
 ## [0.8.3] - 2026-03-23
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "author": "hienlh",
   "license": "MIT",

package/src/providers/claude-agent-sdk.ts

@@ -799,16 +799,18 @@ export class ClaudeAgentSdkProvider implements AIProvider {
           // SDK assistant messages can carry an error field for auth/billing/rate-limit failures
           const assistantError = (msg as any).error as string | undefined;
           if (assistantError) {
+            // Dump full SDK message for debugging
+            console.error(`[sdk] session=${sessionId} cwd=${effectiveCwd} assistant error: ${assistantError} (isFirst=${isFirstMessage} retry=${retryCount})`);
+            console.error(`[sdk] assistant message dump: ${JSON.stringify(msg).slice(0, 2000)}`);
             const errorHints: Record<string, string> = {
               authentication_failed: "API authentication failed. Check your account credentials in Settings → Accounts.",
               billing_error: "Billing error on this account. Check your subscription status.",
               rate_limit: "Rate limited by the API. Please wait and try again.",
               invalid_request: "Invalid request sent to the API.",
               server_error: "Anthropic API server error. Try again shortly.",
-              unknown: "API connection failed. Possible causes: network unreachable, expired OAuth token, or API outage. Try: 1) Check connectivity (`curl -s https://api.anthropic.com`), 2) Re-add account in Settings, 3) Create a new chat session.",
+              unknown: `API error in project "${effectiveCwd}". Debug: run \`cd ${effectiveCwd} && claude -p "hi"\` in your terminal. If that also fails, the issue is Claude CLI auth or project config (.claude/ folder). Try: 1) \`claude login\`, 2) Remove .claude/settings.local.json, 3) Create a new chat session.`,
             };
             const hint = errorHints[assistantError] ?? `API error: ${assistantError}`;
-            console.error(`[sdk] session=${sessionId} assistant error: ${assistantError}`);
             yield { type: "error", message: hint };
           }
           const content = (msg as any).message?.content;
@@ -987,7 +989,7 @@ export class ClaudeAgentSdkProvider implements AIProvider {
       } // end retryLoop
     } catch (e) {
       const msg = (e as Error).message ?? String(e);
-      console.error(`[sdk] error: ${msg}`);
+      console.error(`[sdk] session=${sessionId} cwd=${meta.projectPath} error: ${msg}`);
       if (msg.includes("abort") || msg.includes("closed")) {
         // User-initiated abort or WS closed — nothing to report
       } else if (!isFirstMessage && msg.includes("exited with code")) {