@vincentt-xr/cli 0.1.1 → 0.1.2

package/dist/preview/runner.d.ts

@@ -16,7 +16,9 @@ export interface StartPreviewOptions {
     /** stdio for the app dev serve. "ignore" (default) keeps an MCP server's stdout
      *  clean; a CLI can pass "inherit" to surface build output. */
     appStdio?: "ignore" | "inherit";
-    /** How long to wait for cloudflared to register before giving up (default 45s). */
+    /** How long to wait for cloudflared to register before giving up (default 90s).
+     *  Generous because on a network that blocks the QUIC edge, cloudflared spends
+     *  ~20-30s failing QUIC before it falls back to the http2 edge, which does work. */
     registerTimeoutMs?: number;
     /** How long to wait for the app to serve before returning anyway (default 8s).
      *  Kept short so an MCP tool call stays within strict clients' ~30s timeout;
@@ -40,6 +42,9 @@ export interface RunningPreview {
 export declare function startPreview(opts: StartPreviewOptions): Promise<RunningPreview>;
 /**
  * Resolve once cloudflared reports a live edge connection, reject if it exits
- * first or never registers. Exported for unit testing the log-scan/timeout logic.
+ * first or never registers. On failure the rejection carries cloudflared's own
+ * recent output — otherwise "did not register" hides the real cause (an invalid
+ * run token, or a network that blocks the QUIC edge, the two common culprits).
+ * `onLine` streams each log line out live. Exported for unit testing.
  */
-export declare function waitForRegister(tunnel: ChildProcess, timeoutMs: number): Promise<void>;
+export declare function waitForRegister(tunnel: ChildProcess, timeoutMs: number, onLine?: (line: string) => void): Promise<void>;

package/dist/preview/runner.js

@@ -16,7 +16,7 @@ import { startSessionTunnel } from "./tunnel.js";
 import { proxyWeb, proxyWs } from "./proxy.js";
 import { getFreePort, isPortListening, waitForApp } from "./net.js";
 export async function startPreview(opts) {
-    const { projectCwd, harnessPath = "/__harness", devCommand = ["npm", "run", "dev"], appStdio = "ignore", registerTimeoutMs = 45_000, appReadyTimeoutMs = 8_000, onLog = () => undefined, } = opts;
+    const { projectCwd, harnessPath = "/__harness", devCommand = ["npm", "run", "dev"], appStdio = "ignore", registerTimeoutMs = 90_000, appReadyTimeoutMs = 8_000, onLog = () => undefined, } = opts;
     // Resolve ports. The app port defaults to 5173; the relay + front ports are
     // harness-internal, so auto-pick free ones (the relay port is returned for the
     // MCP diag_* tools to point at) instead of colliding on fixed defaults.
@@ -70,7 +70,7 @@ export async function startPreview(opts) {
         tunnel = spawn(cloudflaredBin, ["tunnel", "run", "--token", session.runToken], {
             stdio: ["ignore", "pipe", "pipe"],
         });
-        await waitForRegister(tunnel, registerTimeoutMs);
+        await waitForRegister(tunnel, registerTimeoutMs, (line) => onLog(`[cloudflared] ${line}`));
         // Don't hand back a live URL that serves a blank page: wait for the app to
         // actually respond. Non-fatal — a slow build still returns, flagged not-ready.
         const appReady = reuseApp ? true : await waitForApp(appPort, appReadyTimeoutMs);
@@ -86,11 +86,15 @@ export async function startPreview(opts) {
 }
 /**
  * Resolve once cloudflared reports a live edge connection, reject if it exits
- * first or never registers. Exported for unit testing the log-scan/timeout logic.
+ * first or never registers. On failure the rejection carries cloudflared's own
+ * recent output — otherwise "did not register" hides the real cause (an invalid
+ * run token, or a network that blocks the QUIC edge, the two common culprits).
+ * `onLine` streams each log line out live. Exported for unit testing.
  */
-export function waitForRegister(tunnel, timeoutMs) {
+export function waitForRegister(tunnel, timeoutMs, onLine) {
     return new Promise((resolve, reject) => {
         let settled = false;
+        const recent = [];
         const finish = (fn) => {
             if (settled)
                 return;
@@ -98,14 +102,25 @@ export function waitForRegister(tunnel, timeoutMs) {
             clearTimeout(timer);
             fn();
         };
+        const tail = () => {
+            const lines = recent.slice(-15).join("\n").trim();
+            return lines ? `\ncloudflared output:\n${lines}` : "";
+        };
         const scan = (buf) => {
-            if (/Registered tunnel connection|Connection [^ ]+ registered/.test(String(buf))) {
+            const text = String(buf);
+            for (const line of text.split(/\r?\n/)) {
+                if (!line.trim())
+                    continue;
+                recent.push(line);
+                onLine?.(line);
+            }
+            if (/Registered tunnel connection|Connection [^ ]+ registered/.test(text)) {
                 finish(resolve);
             }
         };
         tunnel.stdout?.on("data", scan);
         tunnel.stderr?.on("data", scan);
-        tunnel.on("exit", (code) => finish(() => reject(new Error(`cloudflared exited before registering (code ${code}).`))));
-        const timer = setTimeout(() => finish(() => reject(new Error(`cloudflared did not register within ${timeoutMs}ms.`))), timeoutMs);
+        tunnel.on("exit", (code) => finish(() => reject(new Error(`cloudflared exited before registering (code ${code}).${tail()}`))));
+        const timer = setTimeout(() => finish(() => reject(new Error(`cloudflared did not register within ${timeoutMs}ms.${tail()}`))), timeoutMs);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincentt-xr/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Vincentt CLI — the vincentt command-line dev loop (login, create, publish, preview, diagnostics, feedback, relay, mcp)",
   "license": "UNLICENSED",
   "type": "module",