@hienlh/ppm 0.5.8 → 0.5.10

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.5.10] - 2026-03-18
+
+### Added
+- **SDK diagnostic logging** — logs `claude --version` output, auth env var status (SET/unset) before each query; helps identify why SDK hangs on Windows
+
+## [0.5.9] - 2026-03-18
+
+### Fixed
+- **Windows: SDK query hangs silently** — provide fallback `cwd` (home directory) when no project selected; undefined cwd caused SDK subprocess to fail on Windows daemons
+- **Better SDK diagnostics** — log claude CLI path check, full error stack on failure; helps debug Windows daemon PATH issues
+
 ## [0.5.8] - 2026-03-18
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "module": "src/index.ts",
   "type": "module",

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

@@ -295,7 +295,10 @@ export class ClaudeAgentSdkProvider implements AIProvider {
       // Resolve SDK's actual session ID for resume (may differ from PPM's UUID)
       // For fork: use the source session's SDK id
       const sdkId = shouldFork ? getSdkSessionId(forkSourceId!) : getSdkSessionId(sessionId);
-      console.log(`[sdk] query: session=${sessionId} sdkId=${sdkId} isFirst=${isFirstMessage} fork=${shouldFork} cwd=${meta.projectPath ?? "(none)"} platform=${process.platform}`);
+      // Fallback cwd: SDK needs a valid working directory even when no project is selected.
+      // On Windows daemons, undefined cwd can cause the subprocess to fail silently.
+      const effectiveCwd = meta.projectPath || homedir();
+      console.log(`[sdk] query: session=${sessionId} sdkId=${sdkId} isFirst=${isFirstMessage} fork=${shouldFork} cwd=${effectiveCwd} platform=${process.platform}`);
 
       const q = query({
         prompt: message,
@@ -303,7 +306,7 @@ export class ClaudeAgentSdkProvider implements AIProvider {
           sessionId: isFirstMessage && !shouldFork ? sessionId : undefined,
           resume: (isFirstMessage && !shouldFork) ? undefined : sdkId,
           ...(shouldFork && { forkSession: true }),
-          cwd: meta.projectPath,
+          cwd: effectiveCwd,
           // Use full Claude Code system prompt (coding guidelines, security, response style)
           systemPrompt: { type: "preset", preset: "claude_code" },
           // Load skills/settings from both user (~/.claude) and project directory
@@ -341,6 +344,36 @@ export class ClaudeAgentSdkProvider implements AIProvider {
       this.activeQueries.set(sessionId, q);
       console.log(`[sdk] query object created, starting iteration...`);
 
+      // Verify claude CLI is accessible (early warning on Windows daemons)
+      try {
+        const which = Bun.spawnSync({
+          cmd: process.platform === "win32" ? ["where", "claude"] : ["which", "claude"],
+          stdout: "pipe", stderr: "pipe",
+        });
+        const claudePath = which.stdout.toString().trim().split("\n")[0];
+        console.log(`[sdk] claude CLI: ${claudePath || "(not found in PATH)"}`);
+      } catch { console.log("[sdk] claude CLI: check failed"); }
+
+      // Quick CLI version check — verify the binary actually runs from this process
+      try {
+        const verProc = Bun.spawnSync({
+          cmd: ["claude", "--version"],
+          stdout: "pipe", stderr: "pipe",
+          cwd: effectiveCwd,
+        });
+        console.log(`[sdk] claude --version: exit=${verProc.exitCode} out="${verProc.stdout.toString().trim().slice(0, 100)}"`);
+        if (verProc.exitCode !== 0) {
+          console.error(`[sdk] claude --version stderr: ${verProc.stderr.toString().trim().slice(0, 300)}`);
+        }
+      } catch (e) {
+        console.error(`[sdk] claude --version failed: ${(e as Error).message}`);
+      }
+
+      // Log env keys relevant to SDK auth (values redacted)
+      const authKeys = ["ANTHROPIC_API_KEY", "CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY"];
+      const envStatus = authKeys.map(k => `${k}=${process.env[k] ? "SET" : "unset"}`).join(" ");
+      console.log(`[sdk] env auth: ${envStatus}`);
+
       let lastPartialText = "";
       /** Number of tool_use blocks pending results (top-level tools only, not subagent children) */
       let pendingToolCount = 0;
@@ -589,7 +622,10 @@ export class ClaudeAgentSdkProvider implements AIProvider {
         yield approvalEvents.shift()!;
       }
     } catch (e) {
-      const msg = (e as Error).message;
+      const msg = (e as Error).message ?? String(e);
+      const stack = (e as Error).stack ?? "";
+      console.error(`[sdk] error: ${msg}`);
+      if (stack) console.error(`[sdk] stack: ${stack}`);
       // Don't yield error for intentional abort
       if (!msg.includes("abort")) {
         yield { type: "error", message: `SDK error: ${msg}` };