@pushpalsdev/cli 1.0.4 → 1.0.6

package/dist/pushpals-cli.js

@@ -2,7 +2,7 @@
 // @bun
 
 // ../../scripts/pushpals-cli.ts
-import { chmodSync, cpSync, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { appendFileSync, chmodSync, cpSync, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { dirname, join as join2, resolve as resolve2 } from "path";
 import { createInterface } from "readline";
 
@@ -742,11 +742,14 @@ function loadPushPalsConfig(options = {}) {
 // ../../scripts/pushpals-cli.ts
 var DEFAULT_MONITOR_PORT = 8081;
 var MONITOR_SCAN_PORTS = 32;
+var MONITOR_POLL_MS = 2000;
 var HTTP_TIMEOUT_MS = 2500;
 var LOCALBUDDY_TIMEOUT_MS = 4000;
 var SSE_RECONNECT_MS = 1500;
 var DEFAULT_RUNTIME_BOOT_TIMEOUT_MS = 90000;
 var DEFAULT_RUNTIME_BOOT_POLL_MS = 1000;
+var DEFAULT_SERVER_BOOT_TIMEOUT_MS = 20000;
+var DEFAULT_SERVICE_STABILITY_GRACE_MS = 4000;
 var GITHUB_OWNER = "PushPalsDev";
 var GITHUB_REPO = "pushpals";
 var GITHUB_API_URL = `https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}`;
@@ -756,6 +759,16 @@ var GITHUB_HEADERS = {
   "User-Agent": "pushpals-cli"
 };
 var stateVersion = 1;
+function logCliInvocation(argv) {
+  const startedAt = new Date().toISOString();
+  const cliVersion = String(process.env.PUSHPALS_CLI_PACKAGE_VERSION ?? "").trim() || "unknown";
+  const argsText = argv.length > 0 ? argv.join(" ") : "(none)";
+  console.log(`[pushpals] invocation=${startedAt}`);
+  console.log(`[pushpals] version=${cliVersion} runtime=bun@${Bun.version}`);
+  console.log(`[pushpals] platform=${process.platform}/${process.arch}`);
+  console.log(`[pushpals] cwd=${process.cwd()}`);
+  console.log(`[pushpals] args=${argsText}`);
+}
 function printUsage() {
   console.log("PushPals CLI");
   console.log("");
@@ -847,6 +860,9 @@ function normalizePath(value) {
     return normalized.toLowerCase();
   return normalized;
 }
+function jsonHtmlBootstrap(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c");
+}
 async function runGit(args, cwd) {
   const proc = Bun.spawn(["git", ...args], {
     cwd,
@@ -909,9 +925,16 @@ async function resolveRuntimeReleaseTag(explicitTag) {
   if (fromEnv)
     return fromEnv;
   const packageVersion = parseSemverFromPackageVersion(process.env.PUSHPALS_CLI_PACKAGE_VERSION);
-  if (packageVersion)
-    return `v${packageVersion}`;
-  return await fetchLatestReleaseTag();
+  try {
+    return await fetchLatestReleaseTag();
+  } catch (err) {
+    if (packageVersion) {
+      const fallbackTag = `v${packageVersion}`;
+      console.warn(`[pushpals] Could not resolve latest runtime tag; falling back to package version tag ${fallbackTag}: ${String(err)}`);
+      return fallbackTag;
+    }
+    throw err;
+  }
 }
 function writeTextFileIfMissing(pathValue, text) {
   if (existsSync2(pathValue))
@@ -940,7 +963,7 @@ async function downloadRuntimeAssetsFromSourceTag(runtimeRoot, tag) {
     throw new Error(`Failed to fetch runtime source tree for ${tag} (HTTP ${treeResponse.status})`);
   }
   const treePayload = await treeResponse.json();
-  const paths = (treePayload.tree ?? []).filter((entry) => entry.type === "blob" && typeof entry.path === "string").map((entry) => String(entry.path)).filter((pathValue) => pathValue === ".env.example" || pathValue.startsWith("configs/") || pathValue.startsWith("prompts/"));
+  const paths = (treePayload.tree ?? []).filter((entry) => entry.type === "blob" && typeof entry.path === "string").map((entry) => String(entry.path)).filter((pathValue) => pathValue === ".env.example" || pathValue.startsWith("configs/") || pathValue.startsWith("prompts/") || pathValue.startsWith("packages/protocol/src/schemas/"));
   if (paths.length === 0) {
     throw new Error(`Runtime source tree for ${tag} did not include prompts/config assets`);
   }
@@ -948,7 +971,7 @@ async function downloadRuntimeAssetsFromSourceTag(runtimeRoot, tag) {
   for (const pathValue of sorted) {
     const rawUrl = `https://raw.githubusercontent.com/${GITHUB_OWNER}/${GITHUB_REPO}/${encodeURIComponent(tag)}/${pathValue}`;
     const body = await fetchTextFromUrl(rawUrl, 20000);
-    const outPath = join2(runtimeRoot, pathValue);
+    const outPath = pathValue.startsWith("packages/protocol/src/schemas/") ? join2(runtimeRoot, "protocol", "schemas", pathValue.slice("packages/protocol/src/schemas/".length)) : join2(runtimeRoot, pathValue);
     mkdirSync(dirname(outPath), { recursive: true });
     writeFileSync(outPath, body, "utf8");
   }
@@ -956,10 +979,14 @@ async function downloadRuntimeAssetsFromSourceTag(runtimeRoot, tag) {
 async function ensureRuntimeAssets(runtimeRoot, runtimeTag) {
   const markerPath = join2(runtimeRoot, ".runtime-assets-tag");
   const currentTag = existsSync2(markerPath) ? readFileSync2(markerPath, "utf8").trim() : "";
-  const hasAssets = existsSync2(join2(runtimeRoot, ".env.example")) && existsSync2(join2(runtimeRoot, "configs", "default.toml")) && existsSync2(join2(runtimeRoot, "prompts"));
+  const protocolSchemasDir = join2(runtimeRoot, "protocol", "schemas");
+  const hasProtocolSchemas = existsSync2(join2(protocolSchemasDir, "envelope.schema.json")) && existsSync2(join2(protocolSchemasDir, "events.schema.json"));
+  const hasAssets = existsSync2(join2(runtimeRoot, ".env.example")) && existsSync2(join2(runtimeRoot, "configs", "default.toml")) && existsSync2(join2(runtimeRoot, "prompts")) && hasProtocolSchemas;
   if (!hasAssets || currentTag !== runtimeTag) {
-    const copied = copyBundledRuntimeAssets(runtimeRoot);
-    if (!copied) {
+    copyBundledRuntimeAssets(runtimeRoot);
+    const hasProtocolSchemasAfterCopy = existsSync2(join2(protocolSchemasDir, "envelope.schema.json")) && existsSync2(join2(protocolSchemasDir, "events.schema.json"));
+    const hasAssetsAfterCopy = existsSync2(join2(runtimeRoot, ".env.example")) && existsSync2(join2(runtimeRoot, "configs", "default.toml")) && existsSync2(join2(runtimeRoot, "prompts")) && hasProtocolSchemasAfterCopy;
+    if (!hasAssetsAfterCopy) {
       await downloadRuntimeAssetsFromSourceTag(runtimeRoot, runtimeTag);
     }
     writeFileSync(markerPath, `${runtimeTag}
@@ -980,6 +1007,30 @@ function runtimeBinaryFilename(serviceName, platformKey) {
   const extension = platformKey.startsWith("windows-") ? ".exe" : "";
   return `pushpals-runtime-${serviceToken}-${platformKey}${extension}`;
 }
+function buildEmbeddedRuntimeEnv(baseEnv, opts) {
+  return {
+    ...baseEnv,
+    PUSHPALS_REPO_ROOT_OVERRIDE: opts.repoRoot,
+    PUSHPALS_PROJECT_ROOT_OVERRIDE: opts.repoRoot,
+    PUSHPALS_CONFIG_DIR_OVERRIDE: join2(opts.runtimeRoot, "configs"),
+    PUSHPALS_PROMPTS_ROOT_OVERRIDE: opts.runtimeRoot,
+    PUSHPALS_PROTOCOL_SCHEMAS_DIR: join2(opts.runtimeRoot, "protocol", "schemas"),
+    REMOTEBUDDY_AUTONOMY_ENABLED: String(baseEnv.REMOTEBUDDY_AUTONOMY_ENABLED ?? "").trim() || "false"
+  };
+}
+function timestampFileToken() {
+  return new Date().toISOString().replace(/[:.]/g, "-");
+}
+function readLogTail(logPath, maxLines = 40) {
+  if (!existsSync2(logPath))
+    return "";
+  const raw = readFileSync2(logPath, "utf8");
+  const lines = raw.split(/\r?\n/).map((line) => line.trimEnd()).filter((line) => line.length > 0);
+  if (lines.length === 0)
+    return "";
+  return lines.slice(-maxLines).join(`
+`);
+}
 async function downloadBinaryAsset(tag, assetName, outPath) {
   const url = `${GITHUB_RELEASE_URL}/${encodeURIComponent(tag)}/${assetName}`;
   const response = await fetchWithTimeout(url, { headers: GITHUB_HEADERS }, 60000);
@@ -1021,16 +1072,50 @@ async function ensureRuntimeBinaries(runtimeRoot, runtimeTag) {
   }
   return runtimeBinaries;
 }
-function spawnRuntimeService(name, command, cwd, env) {
+function spawnRuntimeService(name, command, cwd, env, logPath) {
+  writeFileSync(logPath, `[pushpals] service=${name} command=${command.join(" ")} cwd=${cwd}
+`, "utf8");
   const proc = Bun.spawn(command, {
     cwd,
     env,
-    stdout: "ignore",
-    stderr: "ignore"
+    stdout: "pipe",
+    stderr: "pipe"
   });
+  const pipeToLog = async (stream, channel) => {
+    if (!stream)
+      return;
+    const reader = stream.getReader();
+    const decoder = new TextDecoder;
+    let pending = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      const chunk = decoder.decode(value, { stream: true });
+      if (!chunk)
+        continue;
+      pending += chunk;
+      const lines = pending.split(/\r?\n/);
+      pending = lines.pop() ?? "";
+      for (const line of lines) {
+        appendFileSync(logPath, `[${channel}] ${line}
+`, "utf8");
+      }
+    }
+    const rest = decoder.decode();
+    if (rest)
+      pending += rest;
+    if (pending.trim().length > 0) {
+      appendFileSync(logPath, `[${channel}] ${pending.trimEnd()}
+`, "utf8");
+    }
+  };
+  pipeToLog(proc.stdout, "stdout");
+  pipeToLog(proc.stderr, "stderr");
   const service = {
     name,
     proc,
+    logPath,
     exited: false,
     exitCode: null
   };
@@ -1043,10 +1128,25 @@ function spawnRuntimeService(name, command, cwd, env) {
 function stopRuntimeServices(services) {
   for (const service of services) {
     try {
-      service.proc.kill();
+      if (process.platform === "win32" && typeof service.proc.pid === "number" && service.proc.pid > 0) {
+        Bun.spawnSync(["taskkill", "/PID", String(service.proc.pid), "/T", "/F"], {
+          stdin: "ignore",
+          stdout: "ignore",
+          stderr: "ignore"
+        });
+      } else {
+        service.proc.kill();
+      }
     } catch {}
   }
 }
+async function repoHasRemote(repoRoot, remote) {
+  const normalizedRemote = remote.trim();
+  if (!normalizedRemote)
+    return false;
+  const result = await runGit(["remote", "get-url", normalizedRemote], repoRoot);
+  return result.ok && Boolean(result.stdout);
+}
 async function probeServer(serverUrl) {
   try {
     const response = await fetchWithTimeout(`${serverUrl}/healthz`, {}, HTTP_TIMEOUT_MS);
@@ -1100,29 +1200,65 @@ async function autoStartRuntimeServices(opts) {
   console.log(`[pushpals] LocalBuddy unavailable. Auto-starting runtime for repo: ${opts.repoRoot}`);
   console.log(`[pushpals] runtimeRoot=${runtimeRoot}`);
   console.log(`[pushpals] runtimeTag=${runtimeTag}`);
-  const runtimeEnv = {
-    ...process.env,
-    PUSHPALS_REPO_ROOT_OVERRIDE: opts.repoRoot,
-    PUSHPALS_PROJECT_ROOT_OVERRIDE: opts.repoRoot,
-    PUSHPALS_CONFIG_DIR_OVERRIDE: join2(runtimeRoot, "configs"),
-    PUSHPALS_PROMPTS_ROOT_OVERRIDE: runtimeRoot
-  };
+  const runtimeEnv = buildEmbeddedRuntimeEnv(process.env, {
+    repoRoot: opts.repoRoot,
+    runtimeRoot
+  });
   const services = [];
+  const runToken = timestampFileToken();
+  const logDir = join2(runtimeRoot, "logs", "bootstrap");
+  mkdirSync(logDir, { recursive: true });
+  const logPathFor = (name) => join2(logDir, `${runToken}-${name}.log`);
   const serverHealthy = await probeServer(opts.serverUrl);
   if (!serverHealthy) {
     console.log("[pushpals] Starting embedded server...");
-    services.push(spawnRuntimeService("server", [runtimeBinaries.server], opts.repoRoot, runtimeEnv));
+    const serverService = spawnRuntimeService("server", [runtimeBinaries.server], opts.repoRoot, runtimeEnv, logPathFor("server"));
+    services.push(serverService);
+    console.log(`[pushpals] server log: ${serverService.logPath}`);
+    const serverDeadline = Date.now() + DEFAULT_SERVER_BOOT_TIMEOUT_MS;
+    let serverIsReady = false;
+    while (Date.now() < serverDeadline) {
+      if (serverService.exited) {
+        const tail = readLogTail(serverService.logPath);
+        stopRuntimeServices(services);
+        throw new Error(`Embedded server exited during bootstrap (code=${serverService.exitCode ?? "unknown"}). ` + `See ${serverService.logPath}${tail ? `
+--- server log tail ---
+${tail}` : ""}`);
+      }
+      if (await probeServer(opts.serverUrl)) {
+        serverIsReady = true;
+        break;
+      }
+      await Bun.sleep(DEFAULT_RUNTIME_BOOT_POLL_MS);
+    }
+    if (!serverIsReady) {
+      const tail = readLogTail(serverService.logPath);
+      stopRuntimeServices(services);
+      throw new Error(`Embedded server did not become healthy within ${DEFAULT_SERVER_BOOT_TIMEOUT_MS}ms. ` + `See ${serverService.logPath}${tail ? `
+--- server log tail ---
+${tail}` : ""}`);
+    }
+    console.log("[pushpals] Embedded server is healthy.");
   } else {
     console.log("[pushpals] Server already healthy; skipping embedded server start.");
   }
   console.log("[pushpals] Starting embedded LocalBuddy...");
-  services.push(spawnRuntimeService("localbuddy", [runtimeBinaries.localbuddy], opts.repoRoot, runtimeEnv));
+  const localbuddyService = spawnRuntimeService("localbuddy", [runtimeBinaries.localbuddy], opts.repoRoot, runtimeEnv, logPathFor("localbuddy"));
+  services.push(localbuddyService);
+  console.log(`[pushpals] localbuddy log: ${localbuddyService.logPath}`);
   console.log("[pushpals] Starting embedded RemoteBuddy...");
-  services.push(spawnRuntimeService("remotebuddy", [runtimeBinaries.remotebuddy], opts.repoRoot, runtimeEnv));
+  const remotebuddyService = spawnRuntimeService("remotebuddy", [runtimeBinaries.remotebuddy], opts.repoRoot, runtimeEnv, logPathFor("remotebuddy"));
+  services.push(remotebuddyService);
+  console.log(`[pushpals] remotebuddy log: ${remotebuddyService.logPath}`);
   const scmHealthy = await probeSourceControlManager(opts.sourceControlManagerPort);
-  if (!scmHealthy) {
+  const scmRemoteAvailable = await repoHasRemote(opts.repoRoot, opts.sourceControlManagerRemote);
+  if (!scmHealthy && scmRemoteAvailable) {
     console.log("[pushpals] Starting embedded SourceControlManager...");
-    services.push(spawnRuntimeService("source_control_manager", [runtimeBinaries.sourceControlManager, "--skip-clean-check"], opts.repoRoot, runtimeEnv));
+    const sourceControlManagerService = spawnRuntimeService("source_control_manager", [runtimeBinaries.sourceControlManager, "--skip-clean-check"], opts.repoRoot, runtimeEnv, logPathFor("source_control_manager"));
+    services.push(sourceControlManagerService);
+    console.log(`[pushpals] source_control_manager log: ${sourceControlManagerService.logPath}`);
+  } else if (!scmRemoteAvailable) {
+    console.log(`[pushpals] Repo has no git remote "${opts.sourceControlManagerRemote}"; skipping embedded SourceControlManager.`);
   } else {
     console.log("[pushpals] SourceControlManager already healthy; skipping embedded start.");
   }
@@ -1133,15 +1269,36 @@ async function autoStartRuntimeServices(opts) {
       if (service.exited) {
         if (service.name === "source_control_manager") {
           console.warn(`[pushpals] Embedded ${service.name} exited during startup (code=${service.exitCode ?? "unknown"}); continuing without SCM.`);
+          const tail2 = readLogTail(service.logPath);
+          if (tail2) {
+            console.warn(`[pushpals] ${service.name} log tail:
+${tail2}`);
+          }
           services.splice(i, 1);
           continue;
         }
+        const tail = readLogTail(service.logPath);
         stopRuntimeServices(services);
-        throw new Error(`Embedded ${service.name} exited during startup (code=${service.exitCode ?? "unknown"})`);
+        throw new Error(`Embedded ${service.name} exited during startup (code=${service.exitCode ?? "unknown"}). ` + `See ${service.logPath}${tail ? `
+--- ${service.name} log tail ---
+${tail}` : ""}`);
       }
     }
     const health = await probeLocalBuddy(opts.localAgentUrl, opts.authToken);
     if (health?.ok) {
+      const stabilityDeadline = Date.now() + DEFAULT_SERVICE_STABILITY_GRACE_MS;
+      while (Date.now() < stabilityDeadline) {
+        for (const service of services) {
+          if (!service.exited)
+            continue;
+          const tail = readLogTail(service.logPath);
+          stopRuntimeServices(services);
+          throw new Error(`Embedded ${service.name} exited immediately after bootstrap (code=${service.exitCode ?? "unknown"}). ` + `See ${service.logPath}${tail ? `
+--- ${service.name} log tail ---
+${tail}` : ""}`);
+        }
+        await Bun.sleep(250);
+      }
       console.log("[pushpals] Embedded runtime is ready.");
       return services;
     }
@@ -1195,17 +1352,221 @@ async function looksLikeMonitoringHub(url) {
     return false;
   }
 }
-async function resolveMonitoringHubUrl(preferredUrl, fallbackPort) {
-  const explicit = normalizeUrl(preferredUrl);
-  if (explicit)
-    return explicit;
-  const basePort = fallbackPort;
-  for (let port = basePort;port < basePort + MONITOR_SCAN_PORTS; port++) {
-    const candidate = `http://localhost:${port}`;
-    if (await looksLikeMonitoringHub(candidate))
-      return candidate;
+function buildEmbeddedMonitoringHubHtml(opts) {
+  const bootstrap = jsonHtmlBootstrap(opts);
+  return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>PushPals CLI Monitor</title>
+  <style>
+    :root { color-scheme: dark; --bg:#08111b; --panel:#112235; --panel2:#16324a; --line:#2b5876; --fg:#edf6ff; --muted:#90b5d6; --accent:#58d8c3; --warn:#ffbf5f; --bad:#ff7f7f; }
+    * { box-sizing:border-box; }
+    body { margin:0; font-family:Consolas, "SFMono-Regular", monospace; background:radial-gradient(circle at top, #0d2233, var(--bg) 56%); color:var(--fg); }
+    main { max-width:1200px; margin:0 auto; padding:24px; }
+    h1,h2 { margin:0 0 12px; }
+    p { color:var(--muted); }
+    .row { display:grid; gap:16px; margin-top:16px; }
+    .cards { grid-template-columns:repeat(auto-fit,minmax(180px,1fr)); }
+    .panels { grid-template-columns:repeat(auto-fit,minmax(320px,1fr)); }
+    .card, .panel { border:1px solid var(--line); background:linear-gradient(180deg,var(--panel),var(--panel2)); border-radius:16px; padding:16px; box-shadow:0 12px 40px rgba(0,0,0,.22); }
+    .label { font-size:12px; letter-spacing:.12em; text-transform:uppercase; color:var(--muted); margin-bottom:10px; }
+    .value { font-size:32px; font-weight:700; color:var(--accent); }
+    .sub { margin-top:8px; color:var(--muted); white-space:pre-wrap; word-break:break-word; }
+    .list { display:grid; gap:10px; margin-top:12px; }
+    .item { border:1px solid rgba(88,216,195,.18); border-radius:12px; padding:12px; background:rgba(8,17,27,.42); }
+    .meta { display:flex; flex-wrap:wrap; gap:8px; margin:12px 0 0; }
+    .pill { border:1px solid var(--line); border-radius:999px; padding:6px 10px; color:var(--muted); }
+    a { color:var(--accent); }
+  </style>
+</head>
+<body>
+  <main>
+    <h1>PushPals CLI Monitor</h1>
+    <p>Lightweight embedded monitor for CLI-managed runtimes.</p>
+    <div class="meta" id="meta"></div>
+    <section class="row cards" id="cards"></section>
+    <section class="row panels">
+      <div class="panel">
+        <h2>Requests</h2>
+        <div id="requests" class="list"></div>
+      </div>
+      <div class="panel">
+        <h2>Jobs</h2>
+        <div id="jobs" class="list"></div>
+      </div>
+      <div class="panel">
+        <h2>Completions</h2>
+        <div id="completions" class="list"></div>
+      </div>
+    </section>
+  </main>
+  <script>
+    const boot = ${bootstrap};
+    const pollMs = ${MONITOR_POLL_MS};
+    const metaEl = document.getElementById("meta");
+    const cardsEl = document.getElementById("cards");
+    const requestsEl = document.getElementById("requests");
+    const jobsEl = document.getElementById("jobs");
+    const completionsEl = document.getElementById("completions");
+
+    function esc(value) {
+      return String(value ?? "")
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    }
+
+    async function fetchJson(path) {
+      const res = await fetch(path, { cache: "no-store" });
+      if (!res.ok) throw new Error(path + " -> HTTP " + res.status);
+      return await res.json();
+    }
+
+    function setList(target, rows, emptyLabel, formatter) {
+      if (!Array.isArray(rows) || rows.length === 0) {
+        target.innerHTML = '<div class="item">' + esc(emptyLabel) + "</div>";
+        return;
+      }
+      target.innerHTML = rows.map((row) => '<div class="item">' + formatter(row) + "</div>").join("");
+    }
+
+    function renderStatus(status) {
+      const workers = status?.workers ?? {};
+      const queues = status?.queues ?? {};
+      const runtime = status?.runtime ?? {};
+      const repo = status?.repo ?? {};
+      const llmUsage = status?.llmUsage ?? {};
+      const cards = [
+        { label: "Server uptime", value: Math.round((Number(runtime.uptimeMs ?? 0) / 60000)) + "m", sub: runtime.startedAt ?? "unknown" },
+        { label: "Workers online", value: String(workers.online ?? 0), sub: "busy " + String(workers.busy ?? 0) + " | idle " + String(workers.idle ?? 0) },
+        { label: "Pending requests", value: String(queues.requests?.pending ?? 0), sub: "claimed " + String(queues.requests?.claimed ?? 0) },
+        { label: "Pending jobs", value: String(queues.jobs?.pending ?? 0), sub: "claimed " + String(queues.jobs?.claimed ?? 0) },
+        { label: "Completions", value: String(queues.completions?.pending ?? 0), sub: "processed " + String(queues.completions?.processed ?? 0) },
+        { label: "LLM usage (24h)", value: String(llmUsage.totalTokens ?? 0), sub: "calls " + String(llmUsage.totalCalls ?? 0) }
+      ];
+      cardsEl.innerHTML = cards.map((card) => '<div class="card"><div class="label">' + esc(card.label) + '</div><div class="value">' + esc(card.value) + '</div><div class="sub">' + esc(card.sub) + '</div></div>').join("");
+      metaEl.innerHTML = [
+        '<span class="pill">server ' + esc(boot.serverUrl) + '</span>',
+        '<span class="pill">localbuddy ' + esc(boot.localAgentUrl) + '</span>',
+        '<span class="pill">session ' + esc(boot.sessionId) + '</span>',
+        '<span class="pill">repo ' + esc(repo?.root ?? repo?.remoteUrl ?? "current repo") + '</span>'
+      ].join("");
+    }
+
+    function render() {
+      Promise.all([
+        fetchJson('/api/status'),
+        fetchJson('/api/requests'),
+        fetchJson('/api/jobs'),
+        fetchJson('/api/completions')
+      ]).then(([status, requests, jobs, completions]) => {
+        renderStatus(status);
+        setList(requestsEl, requests?.requests?.slice(0, 8), 'No requests', (row) =>
+          '<strong>' + esc(row?.priority ?? 'request') + '</strong><div class="sub">' +
+          esc((row?.status ?? 'unknown') + ' | ' + (row?.id ?? '')) + '</div><div class="sub">' +
+          esc(String(row?.prompt ?? '').slice(0, 220)) + '</div>');
+        setList(jobsEl, jobs?.jobs?.slice(0, 8), 'No jobs', (row) =>
+          '<strong>' + esc(row?.kind ?? 'job') + '</strong><div class="sub">' +
+          esc((row?.status ?? 'unknown') + ' | worker ' + (row?.workerId ?? '--')) + '</div><div class="sub">' +
+          esc((row?.summary ?? row?.error ?? row?.id ?? '').slice(0, 220)) + '</div>');
+        setList(completionsEl, completions?.completions?.slice(0, 8), 'No completions', (row) =>
+          '<strong>' + esc(row?.status ?? 'completion') + '</strong><div class="sub">' +
+          esc((row?.jobId ?? '') + ' | ' + (row?.commitSha ?? '')) + '</div><div class="sub">' +
+          esc((row?.message ?? '').slice(0, 220)) + '</div>');
+      }).catch((err) => {
+        cardsEl.innerHTML = '<div class="card"><div class="label">Monitor error</div><div class="sub">' + esc(err?.message ?? err) + '</div></div>';
+      });
+    }
+
+    render();
+    setInterval(render, pollMs);
+  </script>
+</body>
+</html>`;
+}
+async function proxyMonitoringHubRequest(serverUrl, authToken, pathValue) {
+  const target = `${serverUrl}${pathValue}`;
+  const upstream = await fetchWithTimeout(target, { headers: authHeaders(authToken) }, 1e4);
+  const body = await upstream.text();
+  return new Response(body, {
+    status: upstream.status,
+    headers: {
+      "content-type": String(upstream.headers.get("content-type") ?? "application/json"),
+      "cache-control": "no-store"
+    }
+  });
+}
+async function startEmbeddedMonitoringHub(opts) {
+  const html = buildEmbeddedMonitoringHubHtml({
+    serverUrl: opts.serverUrl,
+    localAgentUrl: opts.localAgentUrl,
+    sessionId: opts.sessionId
+  });
+  const candidatePorts = Array.from({ length: MONITOR_SCAN_PORTS }, (_, index) => opts.preferredPort + index).concat(0);
+  for (const port of candidatePorts) {
+    try {
+      const server = Bun.serve({
+        port,
+        idleTimeout: 30,
+        fetch: async (req) => {
+          const url = new URL(req.url);
+          if (url.pathname === "/") {
+            return new Response(html, {
+              headers: {
+                "content-type": "text/html; charset=utf-8",
+                "cache-control": "no-store"
+              }
+            });
+          }
+          if (url.pathname === "/healthz") {
+            return Response.json({ ok: true, port, serverUrl: opts.serverUrl, sessionId: opts.sessionId });
+          }
+          if (url.pathname === "/api/status") {
+            return await proxyMonitoringHubRequest(opts.serverUrl, opts.authToken, "/system/status");
+          }
+          if (url.pathname === "/api/requests") {
+            return await proxyMonitoringHubRequest(opts.serverUrl, opts.authToken, "/requests?status=all&limit=20");
+          }
+          if (url.pathname === "/api/jobs") {
+            return await proxyMonitoringHubRequest(opts.serverUrl, opts.authToken, "/jobs?status=all&limit=20");
+          }
+          if (url.pathname === "/api/completions") {
+            return await proxyMonitoringHubRequest(opts.serverUrl, opts.authToken, "/completions?status=all&limit=20");
+          }
+          return new Response("Not found", { status: 404 });
+        }
+      });
+      return {
+        url: `http://127.0.0.1:${server.port}`,
+        port: Number(server.port),
+        embedded: true,
+        stop: () => server.stop(true)
+      };
+    } catch {}
+  }
+  return null;
+}
+async function resolveMonitoringHub(opts) {
+  const explicit = normalizeUrl(opts.preferredUrl);
+  if (explicit) {
+    if (await looksLikeMonitoringHub(explicit)) {
+      return { url: explicit, port: 0, stop: () => {}, embedded: false };
+    }
+    console.warn(`[pushpals] Preferred monitoring hub ${explicit} is unavailable; starting embedded monitor instead.`);
   }
-  return `http://localhost:${basePort}`;
+  for (let port = opts.fallbackPort;port < opts.fallbackPort + MONITOR_SCAN_PORTS; port++) {
+    const candidate = `http://127.0.0.1:${port}`;
+    if (await looksLikeMonitoringHub(candidate)) {
+      return { url: candidate, port, stop: () => {}, embedded: false };
+    }
+  }
+  const embedded = await startEmbeddedMonitoringHub(opts);
+  if (!embedded) {
+    console.warn("[pushpals] Embedded monitoring hub could not start on any expected local port.");
+  }
+  return embedded;
 }
 async function sendMessageToLocalBuddy(localAgentUrl, text) {
   let response;
@@ -1379,8 +1740,7 @@ async function runSessionStream(serverUrl, sessionId, authToken, print, signal)
 async function openMonitoringHub(url) {
   let cmd = null;
   if (process.platform === "win32") {
-    const escaped = url.replace(/'/g, "''");
-    cmd = ["powershell", "-NoProfile", "-Command", `Start-Process '${escaped}'`];
+    cmd = ["cmd", "/c", "start", "", url];
   } else if (process.platform === "darwin") {
     cmd = ["open", url];
   } else {
@@ -1395,7 +1755,9 @@ async function openMonitoringHub(url) {
   return code === 0;
 }
 async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
+  const argv = process.argv.slice(2);
+  logCliInvocation(argv);
+  const parsed = parseArgs(argv);
   if (!parsed)
     return;
   const config = loadPushPalsConfig();
@@ -1426,6 +1788,7 @@ async function main() {
         serverUrl,
         localAgentUrl,
         sourceControlManagerPort: config.sourceControlManager.port,
+        sourceControlManagerRemote: config.sourceControlManager.remote,
         authToken,
         runtimeRoot: parsed.runtimeRoot,
         runtimeTag: parsed.runtimeTag
@@ -1467,16 +1830,31 @@ async function main() {
   const saved = readCliState(statePath);
   const preferredHubUrl = normalizeUrl(parsed.monitoringHubUrl ?? process.env.PUSHPALS_MONITOR_URL ?? saved.monitoringHubUrl ?? "");
   const monitorPort = parsePositiveInt(process.env.PUSHPALS_CLIENT_PORT, DEFAULT_MONITOR_PORT);
-  const monitoringHubUrl = await resolveMonitoringHubUrl(preferredHubUrl, monitorPort);
+  const monitoringHub = await resolveMonitoringHub({
+    preferredUrl: preferredHubUrl,
+    fallbackPort: monitorPort,
+    serverUrl,
+    localAgentUrl,
+    sessionId: localBuddySessionId,
+    authToken
+  });
+  const monitoringHubUrl = monitoringHub?.url ?? "";
   writeCliState(statePath, {
-    monitoringHubUrl,
+    monitoringHubUrl: monitoringHubUrl || undefined,
     serverUrl,
     localAgentUrl,
     sessionId: localBuddySessionId,
     repoRoot
   });
   console.log("[pushpals] Connected.");
-  console.log(`monitoringHubUrl=${monitoringHubUrl}`);
+  if (monitoringHubUrl) {
+    console.log(`monitoringHubUrl=${monitoringHubUrl}`);
+    if (monitoringHub?.embedded) {
+      console.log("[pushpals] Embedded monitoring hub is running.");
+    }
+  } else {
+    console.log("monitoringHubUrl=unavailable");
+  }
   console.log(`serverUrl=${serverUrl}`);
   console.log(`localAgentUrl=${localAgentUrl}`);
   console.log(`sessionId=${localBuddySessionId}`);
@@ -1506,10 +1884,14 @@ ${line}
     streamAbort.abort();
     if (rl)
       rl.close();
+    try {
+      monitoringHub?.stop();
+    } catch {}
     stopAutoStartedServices();
   };
   process.once("SIGINT", requestStop);
   process.once("SIGTERM", requestStop);
+  process.once("exit", requestStop);
   rl = createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -1528,20 +1910,25 @@ ${line}
       break;
     }
     if (text === "/hub") {
-      console.log(`monitoringHubUrl=${monitoringHubUrl}`);
+      console.log(monitoringHubUrl ? `monitoringHubUrl=${monitoringHubUrl}` : "monitoringHubUrl=unavailable");
       rl.prompt();
       continue;
     }
     if (text === "/status") {
       console.log(`serverUrl=${serverUrl}`);
       console.log(`localAgentUrl=${localAgentUrl}`);
-      console.log(`sessionId=${sessionId}`);
+      console.log(`sessionId=${localBuddySessionId}`);
       console.log(`repoRoot=${repoRoot}`);
-      console.log(`monitoringHubUrl=${monitoringHubUrl}`);
+      console.log(monitoringHubUrl ? `monitoringHubUrl=${monitoringHubUrl}` : "monitoringHubUrl=unavailable");
       rl.prompt();
       continue;
     }
     if (text === "/open") {
+      if (!monitoringHubUrl) {
+        console.log("[pushpals] Monitoring hub is unavailable.");
+        rl.prompt();
+        continue;
+      }
       const opened = await openMonitoringHub(monitoringHubUrl);
       console.log(opened ? `[pushpals] Opened ${monitoringHubUrl}` : `[pushpals] Failed to open browser. Use this link: ${monitoringHubUrl}`);
       rl.prompt();
@@ -1556,7 +1943,14 @@ ${line}
   requestStop();
   await Promise.race([streamTask, Bun.sleep(2000)]);
 }
-main().catch((err) => {
-  console.error(`[pushpals] Fatal: ${String(err)}`);
-  process.exit(1);
-});
+if (import.meta.main) {
+  main().catch((err) => {
+    console.error(`[pushpals] Fatal: ${String(err)}`);
+    process.exit(1);
+  });
+}
+export {
+  startEmbeddedMonitoringHub,
+  buildEmbeddedRuntimeEnv,
+  buildEmbeddedMonitoringHubHtml
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushpalsdev/cli",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "PushPals terminal CLI for LocalBuddy -> RemoteBuddy orchestration",
   "license": "MIT",
   "repository": {