copilot-hub 0.1.12 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilot-hub",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Copilot Hub CLI and runtime bundle",
   "license": "MIT",
   "repository": {

package/scripts/dist/daemon.mjs

@@ -3,6 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { spawn, spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -11,6 +12,7 @@ const runtimeDir = path.join(repoRoot, ".copilot-hub");
 const pidsDir = path.join(runtimeDir, "pids");
 const logsDir = path.join(repoRoot, "logs");
 const daemonStatePath = path.join(pidsDir, "daemon.json");
+const lastStartupErrorPath = path.join(runtimeDir, "last-startup-error.json");
 const daemonLogPath = path.join(logsDir, "service-daemon.log");
 const controlPlaneLogPath = path.join(logsDir, "control-plane.log");
 const agentEngineLogPath = path.join(logsDir, "agent-engine.log");
@@ -106,6 +108,7 @@ async function runDaemonLoop() {
     while (!state.stopping) {
         const ensureResult = runSupervisor("ensure", { allowFailure: true });
         if (ensureResult.ok) {
+            clearLastStartupError();
             if (failureCount > 0) {
                 console.log("[daemon] workers recovered.");
             }
@@ -115,10 +118,15 @@ async function runDaemonLoop() {
         }
         const fatal = detectFatalStartupError(ensureResult);
         if (fatal) {
+            writeLastStartupError(fatal);
             console.error(`[daemon] fatal startup error: ${fatal.reason}`);
             console.error(`[daemon] action required: ${fatal.action}`);
             state.stopping = true;
-            await shutdownDaemon(state, { reason: "fatal-configuration", exitCode: 1 });
+            await shutdownDaemon(state, {
+                reason: "fatal-configuration",
+                exitCode: 1,
+                pauseBeforeExit: true,
+            });
             return;
         }
         failureCount += 1;
@@ -158,6 +166,7 @@ function showDaemonStatus() {
     console.log(`running: ${running ? "yes" : "no"}`);
     console.log(`pid: ${running ? String(pid) : "-"}`);
     console.log(`logFile: ${daemonLogPath}`);
+    printLastStartupError();
     if (!fs.existsSync(supervisorScriptPath)) {
         console.log("\n(worker status unavailable: supervisor script missing)");
         return;
@@ -187,7 +196,7 @@ function setupSignalHandlers(state) {
         void shutdownDaemon(state, { reason: "unhandled-rejection", exitCode: 1 });
     });
 }
-async function shutdownDaemon(state, { reason, exitCode }) {
+async function shutdownDaemon(state, { reason, exitCode, pauseBeforeExit = false }) {
     if (state.shuttingDown) {
         return;
     }
@@ -195,6 +204,9 @@ async function shutdownDaemon(state, { reason, exitCode }) {
     console.log(`[daemon] stopping (${reason})...`);
     runSupervisor("down", { allowFailure: true });
     removeDaemonState();
+    if (pauseBeforeExit) {
+        await maybePauseWindowBeforeExit();
+    }
     process.exit(exitCode);
 }
 function ensureScripts() {
@@ -394,21 +406,50 @@ function getErrorMessage(error) {
     }
     return String(error ?? "Unknown error.");
 }
+async function maybePauseWindowBeforeExit() {
+    if (!shouldPauseBeforeExit()) {
+        return;
+    }
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        console.log("");
+        await rl.question("[daemon] Press Enter to close this window.");
+    }
+    catch {
+        // Ignore pause errors and exit anyway.
+    }
+    finally {
+        rl.close();
+    }
+}
+function shouldPauseBeforeExit() {
+    if (process.platform !== "win32") {
+        return false;
+    }
+    if (!process.stdin || !process.stdout) {
+        return false;
+    }
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return false;
+    }
+    return true;
+}
 function detectFatalStartupError(ensureResult) {
-    const evidence = [
+    const evidenceChunks = [
         String(ensureResult?.combinedOutput ?? ""),
         readLogTail(controlPlaneLogPath, 120),
         readLogTail(agentEngineLogPath, 120),
-    ]
-        .map((chunk) => String(chunk ?? "").trim())
-        .filter(Boolean)
-        .join("\n")
-        .toLowerCase();
-    const missingHubToken = evidence.includes("hub telegram token is missing") && evidence.includes("hub_telegram_token");
+    ].map((chunk) => String(chunk ?? "").trim());
+    const missingHubTokenLine = findLineContaining(evidenceChunks, (line) => line.includes("hub telegram token is missing") && line.includes("hub_telegram_token"));
+    const missingHubToken = Boolean(missingHubTokenLine);
     if (missingHubToken) {
         return {
-            reason: "Hub Telegram token is missing (HUB_TELEGRAM_TOKEN).",
-            action: "Run 'copilot-hub configure', set the token, then run 'copilot-hub start'.",
+            reason: missingHubTokenLine || "Hub Telegram token is missing (HUB_TELEGRAM_TOKEN).",
+            action: "Run 'copilot-hub start' in a terminal (it will guide setup), then retry service.",
+            detectedAt: new Date().toISOString(),
         };
     }
     return null;
@@ -426,6 +467,68 @@ function readLogTail(filePath, maxLines = 120) {
         return "";
     }
 }
+function findLineContaining(chunks, predicate) {
+    const lines = chunks
+        .flatMap((chunk) => String(chunk ?? "").split(/\r?\n/))
+        .map((line) => String(line ?? "").trim())
+        .filter(Boolean);
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        const line = lines[index];
+        if (predicate(line.toLowerCase())) {
+            return line;
+        }
+    }
+    return "";
+}
+function writeLastStartupError(value) {
+    try {
+        fs.mkdirSync(runtimeDir, { recursive: true });
+        fs.writeFileSync(lastStartupErrorPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    }
+    catch {
+        // Best effort only.
+    }
+}
+function readLastStartupError() {
+    if (!fs.existsSync(lastStartupErrorPath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(lastStartupErrorPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function clearLastStartupError() {
+    if (!fs.existsSync(lastStartupErrorPath)) {
+        return;
+    }
+    try {
+        fs.rmSync(lastStartupErrorPath, { force: true });
+    }
+    catch {
+        // Best effort only.
+    }
+}
+function printLastStartupError() {
+    const issue = readLastStartupError();
+    if (!issue) {
+        return;
+    }
+    console.log("\n=== last startup error ===");
+    if (issue.detectedAt) {
+        console.log(`detectedAt: ${String(issue.detectedAt)}`);
+    }
+    if (issue.reason) {
+        console.log(`reason: ${String(issue.reason)}`);
+    }
+    if (issue.action) {
+        console.log(`action: ${String(issue.action)}`);
+    }
+}
 function printUsage() {
     console.log("Usage: node scripts/dist/daemon.mjs <start|run|stop|status|help>");
 }

package/scripts/src/daemon.mts

@@ -3,6 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { spawn, spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -14,6 +15,7 @@ const pidsDir = path.join(runtimeDir, "pids");
 const logsDir = path.join(repoRoot, "logs");
 
 const daemonStatePath = path.join(pidsDir, "daemon.json");
+const lastStartupErrorPath = path.join(runtimeDir, "last-startup-error.json");
 const daemonLogPath = path.join(logsDir, "service-daemon.log");
 const controlPlaneLogPath = path.join(logsDir, "control-plane.log");
 const agentEngineLogPath = path.join(logsDir, "agent-engine.log");
@@ -125,6 +127,7 @@ async function runDaemonLoop() {
   while (!state.stopping) {
     const ensureResult = runSupervisor("ensure", { allowFailure: true });
     if (ensureResult.ok) {
+      clearLastStartupError();
       if (failureCount > 0) {
         console.log("[daemon] workers recovered.");
       }
@@ -135,10 +138,15 @@ async function runDaemonLoop() {
 
     const fatal = detectFatalStartupError(ensureResult);
     if (fatal) {
+      writeLastStartupError(fatal);
       console.error(`[daemon] fatal startup error: ${fatal.reason}`);
       console.error(`[daemon] action required: ${fatal.action}`);
       state.stopping = true;
-      await shutdownDaemon(state, { reason: "fatal-configuration", exitCode: 1 });
+      await shutdownDaemon(state, {
+        reason: "fatal-configuration",
+        exitCode: 1,
+        pauseBeforeExit: true,
+      });
       return;
     }
 
@@ -191,6 +199,7 @@ function showDaemonStatus() {
   console.log(`running: ${running ? "yes" : "no"}`);
   console.log(`pid: ${running ? String(pid) : "-"}`);
   console.log(`logFile: ${daemonLogPath}`);
+  printLastStartupError();
 
   if (!fs.existsSync(supervisorScriptPath)) {
     console.log("\n(worker status unavailable: supervisor script missing)");
@@ -227,7 +236,7 @@ function setupSignalHandlers(state) {
   });
 }
 
-async function shutdownDaemon(state, { reason, exitCode }) {
+async function shutdownDaemon(state, { reason, exitCode, pauseBeforeExit = false }) {
   if (state.shuttingDown) {
     return;
   }
@@ -236,6 +245,9 @@ async function shutdownDaemon(state, { reason, exitCode }) {
   console.log(`[daemon] stopping (${reason})...`);
   runSupervisor("down", { allowFailure: true });
   removeDaemonState();
+  if (pauseBeforeExit) {
+    await maybePauseWindowBeforeExit();
+  }
 
   process.exit(exitCode);
 }
@@ -465,23 +477,58 @@ function getErrorMessage(error) {
   return String(error ?? "Unknown error.");
 }
 
+async function maybePauseWindowBeforeExit() {
+  if (!shouldPauseBeforeExit()) {
+    return;
+  }
+
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  try {
+    console.log("");
+    await rl.question("[daemon] Press Enter to close this window.");
+  } catch {
+    // Ignore pause errors and exit anyway.
+  } finally {
+    rl.close();
+  }
+}
+
+function shouldPauseBeforeExit() {
+  if (process.platform !== "win32") {
+    return false;
+  }
+
+  if (!process.stdin || !process.stdout) {
+    return false;
+  }
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return false;
+  }
+
+  return true;
+}
+
 function detectFatalStartupError(ensureResult) {
-  const evidence = [
+  const evidenceChunks = [
     String(ensureResult?.combinedOutput ?? ""),
     readLogTail(controlPlaneLogPath, 120),
     readLogTail(agentEngineLogPath, 120),
-  ]
-    .map((chunk) => String(chunk ?? "").trim())
-    .filter(Boolean)
-    .join("\n")
-    .toLowerCase();
-
-  const missingHubToken =
-    evidence.includes("hub telegram token is missing") && evidence.includes("hub_telegram_token");
+  ].map((chunk) => String(chunk ?? "").trim());
+
+  const missingHubTokenLine = findLineContaining(
+    evidenceChunks,
+    (line) => line.includes("hub telegram token is missing") && line.includes("hub_telegram_token"),
+  );
+  const missingHubToken = Boolean(missingHubTokenLine);
   if (missingHubToken) {
     return {
-      reason: "Hub Telegram token is missing (HUB_TELEGRAM_TOKEN).",
-      action: "Run 'copilot-hub configure', set the token, then run 'copilot-hub start'.",
+      reason: missingHubTokenLine || "Hub Telegram token is missing (HUB_TELEGRAM_TOKEN).",
+      action: "Run 'copilot-hub start' in a terminal (it will guide setup), then retry service.",
+      detectedAt: new Date().toISOString(),
     };
   }
 
@@ -502,6 +549,71 @@ function readLogTail(filePath, maxLines = 120) {
   }
 }
 
+function findLineContaining(chunks, predicate) {
+  const lines = chunks
+    .flatMap((chunk) => String(chunk ?? "").split(/\r?\n/))
+    .map((line) => String(line ?? "").trim())
+    .filter(Boolean);
+  for (let index = lines.length - 1; index >= 0; index -= 1) {
+    const line = lines[index];
+    if (predicate(line.toLowerCase())) {
+      return line;
+    }
+  }
+  return "";
+}
+
+function writeLastStartupError(value) {
+  try {
+    fs.mkdirSync(runtimeDir, { recursive: true });
+    fs.writeFileSync(lastStartupErrorPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+  } catch {
+    // Best effort only.
+  }
+}
+
+function readLastStartupError() {
+  if (!fs.existsSync(lastStartupErrorPath)) {
+    return null;
+  }
+  try {
+    const raw = fs.readFileSync(lastStartupErrorPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function clearLastStartupError() {
+  if (!fs.existsSync(lastStartupErrorPath)) {
+    return;
+  }
+  try {
+    fs.rmSync(lastStartupErrorPath, { force: true });
+  } catch {
+    // Best effort only.
+  }
+}
+
+function printLastStartupError() {
+  const issue = readLastStartupError();
+  if (!issue) {
+    return;
+  }
+
+  console.log("\n=== last startup error ===");
+  if (issue.detectedAt) {
+    console.log(`detectedAt: ${String(issue.detectedAt)}`);
+  }
+  if (issue.reason) {
+    console.log(`reason: ${String(issue.reason)}`);
+  }
+  if (issue.action) {
+    console.log(`action: ${String(issue.action)}`);
+  }
+}
+
 function printUsage() {
   console.log("Usage: node scripts/dist/daemon.mjs <start|run|stop|status|help>");
 }