nextclaw 0.9.18 → 0.9.19

package/dist/cli/index.js

@@ -4290,6 +4290,13 @@ var ServiceCommands = class {
     if (!child.pid) {
       this.appendStartupStage(logPath, "spawn failed: child pid missing");
       console.error("Error: Failed to start background service.");
+      this.printStartupFailureDiagnostics({
+        uiUrl,
+        apiUrl,
+        healthUrl: `${apiUrl}/health`,
+        logPath,
+        lastProbeError: null
+      });
       return;
     }
     const healthUrl = `${apiUrl}/health`;
@@ -4319,6 +4326,13 @@ var ServiceCommands = class {
         const hint = readiness.lastProbeError ? ` Last probe error: ${readiness.lastProbeError}` : "";
         this.appendStartupStage(logPath, `startup failed: process exited before ready.${hint}`);
         console.error(`Error: Failed to start background service. Check logs: ${logPath}.${hint}`);
+        this.printStartupFailureDiagnostics({
+          uiUrl,
+          apiUrl,
+          healthUrl,
+          logPath,
+          lastProbeError: readiness.lastProbeError
+        });
         return;
       }
       this.appendStartupStage(
@@ -4424,8 +4438,45 @@ var ServiceCommands = class {
     try {
       appendFileSync(logPath, `[${(/* @__PURE__ */ new Date()).toISOString()}] [startup] ${message}
 `, "utf-8");
-    } catch {
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      console.error(`Warning: failed to write startup diagnostics log (${logPath}): ${detail}`);
+    }
+  }
+  printStartupFailureDiagnostics(params) {
+    const statePath = resolveServiceStatePath();
+    const lines = [
+      "Startup diagnostics:",
+      `- UI URL: ${params.uiUrl}`,
+      `- API URL: ${params.apiUrl}`,
+      `- Health probe: ${params.healthUrl}`,
+      `- Service state path: ${statePath}`,
+      `- Startup log path: ${params.logPath}`
+    ];
+    if (params.lastProbeError) {
+      lines.push(`- Last probe detail: ${params.lastProbeError}`);
+    }
+    console.error(lines.join("\n"));
+  }
+  getHeaderValue(headers, key) {
+    const value = headers[key];
+    if (typeof value === "string") {
+      const normalized = value.trim();
+      return normalized.length > 0 ? normalized : null;
+    }
+    if (Array.isArray(value)) {
+      const joined = value.map((item) => item.trim()).filter(Boolean).join(", ");
+      return joined.length > 0 ? joined : null;
+    }
+    return null;
+  }
+  formatProbeBodySnippet(raw, maxLength = 180) {
+    const normalized = raw.replace(/\s+/g, " ").trim();
+    if (!normalized) {
+      return null;
     }
+    const clipped = normalized.length > maxLength ? `${normalized.slice(0, maxLength)}...` : normalized;
+    return JSON.stringify(clipped);
   }
   async probeHealthEndpoint(healthUrl) {
     let parsed;
@@ -4456,12 +4507,26 @@ var ServiceCommands = class {
             chunks.push(chunk);
           });
           res.on("end", () => {
+            const responseText = Buffer.concat(chunks).toString("utf-8");
             if ((res.statusCode ?? 0) < 200 || (res.statusCode ?? 0) >= 300) {
-              resolve10({ healthy: false, error: `http ${res.statusCode ?? "unknown"}` });
+              const serverHeader = this.getHeaderValue(res.headers, "server");
+              const contentType = this.getHeaderValue(res.headers, "content-type");
+              const bodySnippet = this.formatProbeBodySnippet(responseText);
+              const details = [`http ${res.statusCode ?? "unknown"}`];
+              if (serverHeader) {
+                details.push(`server=${serverHeader}`);
+              }
+              if (contentType) {
+                details.push(`content-type=${contentType}`);
+              }
+              if (bodySnippet) {
+                details.push(`body=${bodySnippet}`);
+              }
+              resolve10({ healthy: false, error: details.join("; ") });
               return;
             }
             try {
-              const payload = JSON.parse(Buffer.concat(chunks).toString("utf-8"));
+              const payload = JSON.parse(responseText);
               const healthy = payload?.ok === true && payload?.data?.status === "ok";
               if (!healthy) {
                 resolve10({ healthy: false, error: "health payload not ok" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.9.18",
+  "version": "0.9.19",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -38,10 +38,10 @@
   "dependencies": {
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "@nextclaw/core": "^0.7.3",
-    "@nextclaw/runtime": "^0.1.2",
+    "@nextclaw/runtime": "0.1.2",
     "@nextclaw/server": "0.6.6",
-    "@nextclaw/openclaw-compat": "0.2.1"
+    "@nextclaw/openclaw-compat": "0.2.1",
+    "@nextclaw/core": "0.7.3"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",