specrails-desktop 2.11.2 → 2.11.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-desktop",
-  "version": "2.11.2",
+  "version": "2.11.3",
   "license": "MIT",
   "repository": {
     "type": "git",

package/server/dist/setup-manager.js

@@ -620,19 +620,42 @@ async function validateCoreContract() {
 }
 // ─── SetupManager ─────────────────────────────────────────────────────────────
 const INSTALL_LOG_BUFFER_MAX = 2000;
-function formatBufferedInstallError(baseMessage, logBuffer) {
+/**
+ * Persist the FULL install log to `~/.specrails/logs/` and return the path (or
+ * null on failure). The in-error tail is only a window; the full log carries the
+ * complete child stack — needed because a Node uncaught error prints the ORIGIN
+ * frames ABOVE the entry frames, so an 8-line tail shows only the bottom of the
+ * stack + the error object, never where it was thrown.
+ */
+function persistInstallLog(projectId, logBuffer) {
+    try {
+        const dir = (0, path_1.join)((0, artifact_registry_1.resolveHome)(), '.specrails', 'logs');
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const file = (0, path_1.join)(dir, `setup-${projectId}-${stamp}.log`);
+        (0, fs_1.writeFileSync)(file, logBuffer.join('\n') + '\n', { mode: 0o600 });
+        return file;
+    }
+    catch {
+        return null;
+    }
+}
+function formatBufferedInstallError(baseMessage, logBuffer, logPath) {
+    // Show a generous tail: a Node uncaught-exception dump is ~15-30 lines (header,
+    // stack frames, the `{errno,code,syscall,path}` object, version footer). 8 lines
+    // truncated to just the entry frames + error object, hiding the throw origin.
     const recentLines = logBuffer
         .map((line) => line.trim())
         .filter(Boolean)
-        .slice(-8);
-    if (recentLines.length === 0)
-        return baseMessage;
-    return [
-        baseMessage,
-        '',
-        'Recent output:',
-        ...recentLines.map((line) => `- ${line}`),
-    ].join('\n');
+        .slice(-40);
+    const parts = [baseMessage];
+    if (recentLines.length > 0) {
+        parts.push('', 'Recent output:', ...recentLines.map((line) => `- ${line}`));
+    }
+    if (logPath) {
+        parts.push('', `Full log: ${logPath}`);
+    }
+    return parts.join('\n');
 }
 class SetupManager {
     _broadcast;
@@ -788,12 +811,20 @@ class SetupManager {
         const initArgs = hasConfig
             ? ['--yes', '--from-config', spawnConfigPath ?? configPath]
             : ['--yes', '--root-dir', projectPath];
+        // Seed the install log with a diagnostic header capturing the EXACT spawn
+        // (node interpreter, cli entry, cwd) + relevant env. This lands in the
+        // failure report so a Windows/packaged path issue (e.g. an EISDIR on the
+        // entry realpath) is diagnosable without server-console access.
+        const diagHeader = [];
+        if (useBundledCore) {
+            diagHeader.push(`[diag] node=${(0, path_resolver_1.resolveBundledNodeExe)() ?? process.execPath}`, `[diag] cli=${(0, bundled_core_1.getBundledCoreCli)() ?? '<none>'}`, `[diag] cwd=${projectPath}`, `[diag] args=${initArgs.join(' ')}`, `[diag] SPECRAILS_BUNDLED_RUNTIMES_PATH=${process.env.SPECRAILS_BUNDLED_RUNTIMES_PATH ?? '<unset>'}`, `[diag] SPECRAILS_BUNDLED_CORE_PATH=${process.env.SPECRAILS_BUNDLED_CORE_PATH ?? '<unset>'}`);
+        }
         // Bundled core (offline, node <cli> init) when available, else legacy npx.
         const child = useBundledCore
             ? spawnBundledCoreInit(initArgs, projectPath)
             : spawnCoreInit(initArgs, projectPath);
         this._installProcesses.set(projectId, child);
-        this._installLogBuffer.set(projectId, []);
+        this._installLogBuffer.set(projectId, diagHeader);
         // spawnCoreInit uses shell:false on POSIX, so a spawn failure emits 'error'
         // (and NOT 'close') — without this handler the temp config file leaks and
         // the unhandled 'error' event would crash the app.
@@ -867,10 +898,11 @@ class SetupManager {
             }
             else {
                 const logBuffer = this._installLogBuffer.get(projectId) ?? [];
+                const logPath = persistInstallLog(projectId, logBuffer);
                 this._broadcast({
                     type: 'setup_error',
                     projectId,
-                    error: formatBufferedInstallError(`${useBundledCore ? 'bundled specrails-core' : 'npx specrails-core'} exited with code ${code ?? 'unknown'}`, logBuffer),
+                    error: formatBufferedInstallError(`${useBundledCore ? 'bundled specrails-core' : 'npx specrails-core'} exited with code ${code ?? 'unknown'}`, logBuffer, logPath),
                 });
             }
         });