copilot-hub 0.1.11 → 0.1.13

package/package.json

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

package/scripts/dist/daemon.mjs

@@ -11,7 +11,10 @@ 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");
 const daemonScriptPath = path.join(repoRoot, "scripts", "dist", "daemon.mjs");
 const supervisorScriptPath = path.join(repoRoot, "scripts", "dist", "supervisor.mjs");
 const nodeBin = process.execPath;
@@ -104,6 +107,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.");
             }
@@ -111,6 +115,15 @@ async function runDaemonLoop() {
             await sleepInterruptible(BASE_CHECK_MS, () => state.stopping);
             continue;
         }
+        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 });
+            return;
+        }
         failureCount += 1;
         const delay = computeBackoffDelay(failureCount);
         const reason = firstLine(ensureResult.combinedOutput) ||
@@ -148,6 +161,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;
@@ -384,6 +398,98 @@ function getErrorMessage(error) {
     }
     return String(error ?? "Unknown error.");
 }
+function detectFatalStartupError(ensureResult) {
+    const evidenceChunks = [
+        String(ensureResult?.combinedOutput ?? ""),
+        readLogTail(controlPlaneLogPath, 120),
+        readLogTail(agentEngineLogPath, 120),
+    ].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: 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;
+}
+function readLogTail(filePath, maxLines = 120) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return "";
+        }
+        const content = fs.readFileSync(filePath, "utf8");
+        const lines = content.split(/\r?\n/);
+        return lines.slice(-maxLines).join("\n").trim();
+    }
+    catch {
+        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

@@ -14,7 +14,10 @@ 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");
 const daemonScriptPath = path.join(repoRoot, "scripts", "dist", "daemon.mjs");
 const supervisorScriptPath = path.join(repoRoot, "scripts", "dist", "supervisor.mjs");
 const nodeBin = process.execPath;
@@ -123,6 +126,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.");
       }
@@ -131,6 +135,16 @@ async function runDaemonLoop() {
       continue;
     }
 
+    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 });
+      return;
+    }
+
     failureCount += 1;
     const delay = computeBackoffDelay(failureCount);
     const reason =
@@ -180,6 +194,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)");
@@ -454,6 +469,108 @@ function getErrorMessage(error) {
   return String(error ?? "Unknown error.");
 }
 
+function detectFatalStartupError(ensureResult) {
+  const evidenceChunks = [
+    String(ensureResult?.combinedOutput ?? ""),
+    readLogTail(controlPlaneLogPath, 120),
+    readLogTail(agentEngineLogPath, 120),
+  ].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: 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;
+}
+
+function readLogTail(filePath, maxLines = 120) {
+  try {
+    if (!fs.existsSync(filePath)) {
+      return "";
+    }
+
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split(/\r?\n/);
+    return lines.slice(-maxLines).join("\n").trim();
+  } catch {
+    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>");
 }