@askexenow/exe-os 0.9.78 → 0.9.79

package/dist/bin/cli.js

@@ -10954,19 +10954,23 @@ import { mkdirSync as mkdirSync13, readFileSync as readFileSync14, unlinkSync as
 import path20 from "path";
 import { randomUUID as randomUUID4 } from "crypto";
 async function main4(argv = process.argv.slice(2)) {
-  const command = argv[0] && !argv[0].startsWith("--") ? argv[0] : "test";
+  const command = argv[0] && !argv[0].startsWith("--") ? argv[0] : "health";
   const json = argv.includes("--json");
   const project = getArg(argv, "--project") ?? "support-smoke";
+  if (command === "help" || argv.includes("--help") || argv.includes("-h")) {
+    printHelp();
+    return;
+  }
   if (command === "health") {
     const result = await runHealth();
-    output(result, json);
-    process.exitCode = result.some((row) => !row.ok) ? 1 : 0;
+    output(result, json, "health");
+    process.exitCode = hasFailures(result) ? 1 : 0;
     return;
   }
   if (command === "test") {
     const result = await runTest(project);
-    output(result, json);
-    process.exitCode = result.some((row) => !row.ok) ? 1 : 0;
+    output(result, json, "test");
+    process.exitCode = hasFailures(result) ? 1 : 0;
     return;
   }
   console.error("Usage: exe-os support health|test [--project <name>] [--json]");
@@ -10978,34 +10982,40 @@ async function runHealth() {
   checks.push(checkLocalWrite());
   checks.push({
     check: "license_key_present",
-    ok: Boolean(loadLicense()),
-    detail: loadLicense() ? "license.key found" : "missing ~/.exe-os/license.key; run exe-os setup or exe-os cloud setup"
+    level: loadLicense() ? "pass" : "fail",
+    detail: loadLicense() ? "license.key found" : "missing ~/.exe-os/license.key; run exe-os setup or exe-os cloud setup",
+    next: loadLicense() ? void 0 : "Run `exe-os setup` or ask AskExe for the customer license key."
   });
   checks.push({
     check: "license_token_cached",
-    ok: Boolean(readCachedLicenseToken()),
-    detail: readCachedLicenseToken() ? "cached license token found" : "no cached token yet; support can still use license.key"
+    level: readCachedLicenseToken() ? "pass" : "warn",
+    detail: readCachedLicenseToken() ? "cached license token found" : "no cached token yet; support can still use license.key",
+    next: readCachedLicenseToken() ? void 0 : "This is OK if license.key exists. It refreshes after cloud/license validation."
   });
   try {
     const res = await fetch(endpoints.healthEndpoint, { method: "GET", signal: AbortSignal.timeout(1e4) });
     const body = await safeJson2(res);
     checks.push({
       check: "support_health_endpoint",
-      ok: res.ok && body?.status !== "down",
-      detail: `${res.status} ${body?.status ?? res.statusText}`
+      level: res.ok && body?.status !== "down" ? "pass" : "fail",
+      detail: `${res.status} ${body?.status ?? res.statusText}`,
+      next: res.ok ? void 0 : "Check internet access, DNS, or AskExe support status."
     });
     for (const remote of body?.checks ?? []) {
+      const name = remote.name ?? "unknown";
       checks.push({
-        check: `server_${remote.name ?? "unknown"}`,
-        ok: remote.ok === true,
-        detail: remote.detail ?? (remote.ok ? "ok" : "failed")
+        check: `server_${name}`,
+        level: remote.ok === true ? "pass" : name === "admin_inbox_configured" ? "warn" : "fail",
+        detail: remote.detail ?? (remote.ok ? "ok" : "failed"),
+        next: remote.ok ? void 0 : "AskExe must fix this server-side."
       });
     }
   } catch (err) {
     checks.push({
       check: "support_health_endpoint",
-      ok: false,
-      detail: err instanceof Error ? err.message : String(err)
+      level: "fail",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Check internet access, then run `exe-os support health` again."
     });
   }
   return checks;
@@ -11018,9 +11028,14 @@ async function runTest(project) {
   const id = randomUUID4();
   const version = readPackageVersion();
   const reportPath = writeLocalTestReport(id, project, version);
-  checks.push({ check: "local_report_file", ok: true, detail: reportPath });
+  checks.push({ check: "local_report_file", level: "pass", detail: reportPath });
   if (!licenseKey && !licenseToken) {
-    checks.push({ check: "upstream_post", ok: false, detail: "missing license key/token" });
+    checks.push({
+      check: "upstream_post",
+      level: "fail",
+      detail: "not sent because this device has no license key/token",
+      next: "Run `exe-os setup` or ask AskExe to provision this customer device."
+    });
     return checks;
   }
   const payload = {
@@ -11053,14 +11068,20 @@ async function runTest(project) {
     const data = await safeJson2(res);
     checks.push({
       check: "upstream_post",
-      ok: res.ok,
-      detail: res.ok ? `sent id=${String(data?.id ?? id)}` : `${res.status} ${JSON.stringify(data)}`
+      level: res.ok ? "pass" : "fail",
+      detail: res.ok ? `sent id=${String(data?.id ?? id)}` : summarizeHttpFailure(res.status, data),
+      next: res.ok ? void 0 : nextForPostFailure(res.status)
     });
     if (res.ok) {
       checks.push(await maybeCloseAdmin(String(data?.id ?? id), endpoints.adminEndpoint, version));
     }
   } catch (err) {
-    checks.push({ check: "upstream_post", ok: false, detail: err instanceof Error ? err.message : String(err) });
+    checks.push({
+      check: "upstream_post",
+      level: "fail",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Check internet access, then run `exe-os support test` again."
+    });
   }
   return checks;
 }
@@ -11078,9 +11099,14 @@ function checkLocalWrite() {
     mkdirSync13(dir, { recursive: true, mode: 448 });
     writeFileSync13(testPath, "ok\n", { mode: 384 });
     unlinkSync7(testPath);
-    return { check: "local_bug_report_dir_writable", ok: true, detail: dir };
+    return { check: "local_bug_report_dir_writable", level: "pass", detail: dir };
   } catch (err) {
-    return { check: "local_bug_report_dir_writable", ok: false, detail: err instanceof Error ? err.message : String(err) };
+    return {
+      check: "local_bug_report_dir_writable",
+      level: "fail",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Fix permissions on ~/.exe-os or rerun setup on a writable user account."
+    };
   }
 }
 function writeLocalTestReport(id, project, version) {
@@ -11100,7 +11126,7 @@ Synthetic smoke test from \`exe-os support test\`. Safe to close.
 async function maybeCloseAdmin(id, adminEndpoint, version) {
   const token = process.env.ASKEXE_SUPPORT_ADMIN_TOKEN ?? process.env.EXE_SUPPORT_ADMIN_TOKEN;
   if (!token) {
-    return { check: "askexe_admin_autoclose", ok: true, detail: "skipped; admin token is AskExe-only" };
+    return { check: "askexe_admin_autoclose", level: "warn", detail: "skipped; admin token is AskExe-only" };
   }
   try {
     const res = await fetch(`${adminEndpoint}/${encodeURIComponent(id)}`, {
@@ -11113,9 +11139,19 @@ async function maybeCloseAdmin(id, adminEndpoint, version) {
       }),
       signal: AbortSignal.timeout(1e4)
     });
-    return { check: "askexe_admin_autoclose", ok: res.ok, detail: res.ok ? "closed" : `${res.status} ${await res.text()}` };
+    return {
+      check: "askexe_admin_autoclose",
+      level: res.ok ? "pass" : "warn",
+      detail: res.ok ? "closed" : `${res.status} ${await res.text()}`,
+      next: res.ok ? void 0 : "Report was sent; AskExe can close the smoke report manually."
+    };
   } catch (err) {
-    return { check: "askexe_admin_autoclose", ok: false, detail: err instanceof Error ? err.message : String(err) };
+    return {
+      check: "askexe_admin_autoclose",
+      level: "warn",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Report was sent; AskExe can close the smoke report manually."
+    };
   }
 }
 function readPackageVersion() {
@@ -11145,14 +11181,54 @@ function getArg(argv, name) {
   const found = argv.find((arg) => arg.startsWith(prefix));
   return found?.slice(prefix.length);
 }
-function output(rows, json) {
+function hasFailures(rows) {
+  return rows.some((row) => row.level === "fail");
+}
+function summarizeHttpFailure(status, data) {
+  const error = data?.error;
+  return `${status} ${error?.message ?? JSON.stringify(data)}`;
+}
+function nextForPostFailure(status) {
+  if (status === 401) return "License credentials were not sent. Run `exe-os support health` and check license_key_present.";
+  if (status === 403) return "License is valid locally but not accepted by support intake. AskExe must check server-side license provisioning.";
+  if (status >= 500) return "AskExe support intake is unhealthy server-side. Try again shortly and report the local file path.";
+  return "Run `exe-os support health`; if it passes, send this output to AskExe.";
+}
+function printHelp() {
+  console.log(`
+exe-os support
+
+Customer-safe diagnostics for AskExe bug-report intake.
+
+Commands:
+  exe-os support health              Check local setup + AskExe support server health
+  exe-os support test --project hygo Send a safe smoke report end-to-end
+
+What success means:
+  health = this device looks ready
+  test   = AskExe received a real report from this device
+`);
+}
+function output(rows, json, command) {
   if (json) {
-    console.log(JSON.stringify({ ok: rows.every((row) => row.ok), checks: rows }, null, 2));
+    console.log(JSON.stringify({ ok: !hasFailures(rows), checks: rows }, null, 2));
     return;
   }
-  console.log("\nexe-os support diagnostics\n");
+  console.log(`
+exe-os support ${command}
+`);
   for (const row of rows) {
-    console.log(`${row.ok ? "\u2705" : "\u274C"} ${row.check}: ${row.detail}`);
+    const icon = row.level === "pass" ? "\u2705" : row.level === "warn" ? "\u26A0\uFE0F " : "\u274C";
+    console.log(`${icon} ${row.check}: ${row.detail}`);
+    if (row.next) console.log(`   \u2192 ${row.next}`);
+  }
+  console.log("");
+  if (hasFailures(rows)) {
+    console.log("Result: not ready. Fix the failed item(s), then rerun this command.");
+  } else if (rows.some((row) => row.level === "warn")) {
+    console.log("Result: ready with warnings. Bug reports can be sent; warnings are informational unless AskExe asked for stricter validation.");
+  } else {
+    console.log(command === "test" ? "Result: ready. AskExe received the test report." : "Result: ready. Run `exe-os support test --project <customer>` for an end-to-end send test.");
   }
   console.log("");
 }
@@ -20172,7 +20248,7 @@ function parseArgs4(args2) {
     else if (arg === "--allow-breaking") opts.allowedBreakingChangeIds.push(...next().split(",").map((s) => s.trim()).filter(Boolean));
     else if (arg.startsWith("--allow-breaking=")) opts.allowedBreakingChangeIds.push(...arg.split("=")[1].split(",").map((s) => s.trim()).filter(Boolean));
     else if (arg === "--help" || arg === "-h") {
-      printHelp();
+      printHelp2();
       process.exit(0);
     } else {
       throw new Error(`Unknown option: ${arg}`);
@@ -20180,7 +20256,7 @@ function parseArgs4(args2) {
   }
   return opts;
 }
-function printHelp() {
+function printHelp2() {
   console.log(`exe-os stack-update \u2014 update a self-hosted Exe OS stack from a pinned manifest
 
 Usage:
@@ -20450,7 +20526,7 @@ var registry_proxy_exports = {};
 __export(registry_proxy_exports, {
   main: () => main8
 });
-function printHelp2() {
+function printHelp3() {
   console.log(`exe-os registry-proxy \u2014 authenticated pull-through proxy for AskExe customer images
 
 Environment:
@@ -20469,7 +20545,7 @@ Docker image shape for clients:
 }
 async function main8(args2 = process.argv.slice(2)) {
   if (args2.includes("--help") || args2.includes("-h")) {
-    printHelp2();
+    printHelp3();
     return;
   }
   await runRegistryProxy(registryProxyOptionsFromEnv());

package/dist/bin/exe-support.js

@@ -254,19 +254,23 @@ function readCachedLicenseToken() {
 var DEFAULT_BUG_ENDPOINT = "https://askexe.com/v1/support/bug-reports";
 var DEFAULT_ADMIN_ENDPOINT = "https://askexe.com/admin/support/bug-reports";
 async function main(argv = process.argv.slice(2)) {
-  const command = argv[0] && !argv[0].startsWith("--") ? argv[0] : "test";
+  const command = argv[0] && !argv[0].startsWith("--") ? argv[0] : "health";
   const json = argv.includes("--json");
   const project = getArg(argv, "--project") ?? "support-smoke";
+  if (command === "help" || argv.includes("--help") || argv.includes("-h")) {
+    printHelp();
+    return;
+  }
   if (command === "health") {
     const result = await runHealth();
-    output(result, json);
-    process.exitCode = result.some((row) => !row.ok) ? 1 : 0;
+    output(result, json, "health");
+    process.exitCode = hasFailures(result) ? 1 : 0;
     return;
   }
   if (command === "test") {
     const result = await runTest(project);
-    output(result, json);
-    process.exitCode = result.some((row) => !row.ok) ? 1 : 0;
+    output(result, json, "test");
+    process.exitCode = hasFailures(result) ? 1 : 0;
     return;
   }
   console.error("Usage: exe-os support health|test [--project <name>] [--json]");
@@ -278,34 +282,40 @@ async function runHealth() {
   checks.push(checkLocalWrite());
   checks.push({
     check: "license_key_present",
-    ok: Boolean(loadLicense()),
-    detail: loadLicense() ? "license.key found" : "missing ~/.exe-os/license.key; run exe-os setup or exe-os cloud setup"
+    level: loadLicense() ? "pass" : "fail",
+    detail: loadLicense() ? "license.key found" : "missing ~/.exe-os/license.key; run exe-os setup or exe-os cloud setup",
+    next: loadLicense() ? void 0 : "Run `exe-os setup` or ask AskExe for the customer license key."
   });
   checks.push({
     check: "license_token_cached",
-    ok: Boolean(readCachedLicenseToken()),
-    detail: readCachedLicenseToken() ? "cached license token found" : "no cached token yet; support can still use license.key"
+    level: readCachedLicenseToken() ? "pass" : "warn",
+    detail: readCachedLicenseToken() ? "cached license token found" : "no cached token yet; support can still use license.key",
+    next: readCachedLicenseToken() ? void 0 : "This is OK if license.key exists. It refreshes after cloud/license validation."
   });
   try {
     const res = await fetch(endpoints.healthEndpoint, { method: "GET", signal: AbortSignal.timeout(1e4) });
     const body = await safeJson(res);
     checks.push({
       check: "support_health_endpoint",
-      ok: res.ok && body?.status !== "down",
-      detail: `${res.status} ${body?.status ?? res.statusText}`
+      level: res.ok && body?.status !== "down" ? "pass" : "fail",
+      detail: `${res.status} ${body?.status ?? res.statusText}`,
+      next: res.ok ? void 0 : "Check internet access, DNS, or AskExe support status."
     });
     for (const remote of body?.checks ?? []) {
+      const name = remote.name ?? "unknown";
       checks.push({
-        check: `server_${remote.name ?? "unknown"}`,
-        ok: remote.ok === true,
-        detail: remote.detail ?? (remote.ok ? "ok" : "failed")
+        check: `server_${name}`,
+        level: remote.ok === true ? "pass" : name === "admin_inbox_configured" ? "warn" : "fail",
+        detail: remote.detail ?? (remote.ok ? "ok" : "failed"),
+        next: remote.ok ? void 0 : "AskExe must fix this server-side."
       });
     }
   } catch (err) {
     checks.push({
       check: "support_health_endpoint",
-      ok: false,
-      detail: err instanceof Error ? err.message : String(err)
+      level: "fail",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Check internet access, then run `exe-os support health` again."
     });
   }
   return checks;
@@ -318,9 +328,14 @@ async function runTest(project) {
   const id = randomUUID2();
   const version = readPackageVersion();
   const reportPath = writeLocalTestReport(id, project, version);
-  checks.push({ check: "local_report_file", ok: true, detail: reportPath });
+  checks.push({ check: "local_report_file", level: "pass", detail: reportPath });
   if (!licenseKey && !licenseToken) {
-    checks.push({ check: "upstream_post", ok: false, detail: "missing license key/token" });
+    checks.push({
+      check: "upstream_post",
+      level: "fail",
+      detail: "not sent because this device has no license key/token",
+      next: "Run `exe-os setup` or ask AskExe to provision this customer device."
+    });
     return checks;
   }
   const payload = {
@@ -353,14 +368,20 @@ async function runTest(project) {
     const data = await safeJson(res);
     checks.push({
       check: "upstream_post",
-      ok: res.ok,
-      detail: res.ok ? `sent id=${String(data?.id ?? id)}` : `${res.status} ${JSON.stringify(data)}`
+      level: res.ok ? "pass" : "fail",
+      detail: res.ok ? `sent id=${String(data?.id ?? id)}` : summarizeHttpFailure(res.status, data),
+      next: res.ok ? void 0 : nextForPostFailure(res.status)
     });
     if (res.ok) {
       checks.push(await maybeCloseAdmin(String(data?.id ?? id), endpoints.adminEndpoint, version));
     }
   } catch (err) {
-    checks.push({ check: "upstream_post", ok: false, detail: err instanceof Error ? err.message : String(err) });
+    checks.push({
+      check: "upstream_post",
+      level: "fail",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Check internet access, then run `exe-os support test` again."
+    });
   }
   return checks;
 }
@@ -378,9 +399,14 @@ function checkLocalWrite() {
     mkdirSync3(dir, { recursive: true, mode: 448 });
     writeFileSync2(testPath, "ok\n", { mode: 384 });
     unlinkSync(testPath);
-    return { check: "local_bug_report_dir_writable", ok: true, detail: dir };
+    return { check: "local_bug_report_dir_writable", level: "pass", detail: dir };
   } catch (err) {
-    return { check: "local_bug_report_dir_writable", ok: false, detail: err instanceof Error ? err.message : String(err) };
+    return {
+      check: "local_bug_report_dir_writable",
+      level: "fail",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Fix permissions on ~/.exe-os or rerun setup on a writable user account."
+    };
   }
 }
 function writeLocalTestReport(id, project, version) {
@@ -400,7 +426,7 @@ Synthetic smoke test from \`exe-os support test\`. Safe to close.
 async function maybeCloseAdmin(id, adminEndpoint, version) {
   const token = process.env.ASKEXE_SUPPORT_ADMIN_TOKEN ?? process.env.EXE_SUPPORT_ADMIN_TOKEN;
   if (!token) {
-    return { check: "askexe_admin_autoclose", ok: true, detail: "skipped; admin token is AskExe-only" };
+    return { check: "askexe_admin_autoclose", level: "warn", detail: "skipped; admin token is AskExe-only" };
   }
   try {
     const res = await fetch(`${adminEndpoint}/${encodeURIComponent(id)}`, {
@@ -413,9 +439,19 @@ async function maybeCloseAdmin(id, adminEndpoint, version) {
       }),
       signal: AbortSignal.timeout(1e4)
     });
-    return { check: "askexe_admin_autoclose", ok: res.ok, detail: res.ok ? "closed" : `${res.status} ${await res.text()}` };
+    return {
+      check: "askexe_admin_autoclose",
+      level: res.ok ? "pass" : "warn",
+      detail: res.ok ? "closed" : `${res.status} ${await res.text()}`,
+      next: res.ok ? void 0 : "Report was sent; AskExe can close the smoke report manually."
+    };
   } catch (err) {
-    return { check: "askexe_admin_autoclose", ok: false, detail: err instanceof Error ? err.message : String(err) };
+    return {
+      check: "askexe_admin_autoclose",
+      level: "warn",
+      detail: err instanceof Error ? err.message : String(err),
+      next: "Report was sent; AskExe can close the smoke report manually."
+    };
   }
 }
 function readPackageVersion() {
@@ -445,14 +481,54 @@ function getArg(argv, name) {
   const found = argv.find((arg) => arg.startsWith(prefix));
   return found?.slice(prefix.length);
 }
-function output(rows, json) {
+function hasFailures(rows) {
+  return rows.some((row) => row.level === "fail");
+}
+function summarizeHttpFailure(status, data) {
+  const error = data?.error;
+  return `${status} ${error?.message ?? JSON.stringify(data)}`;
+}
+function nextForPostFailure(status) {
+  if (status === 401) return "License credentials were not sent. Run `exe-os support health` and check license_key_present.";
+  if (status === 403) return "License is valid locally but not accepted by support intake. AskExe must check server-side license provisioning.";
+  if (status >= 500) return "AskExe support intake is unhealthy server-side. Try again shortly and report the local file path.";
+  return "Run `exe-os support health`; if it passes, send this output to AskExe.";
+}
+function printHelp() {
+  console.log(`
+exe-os support
+
+Customer-safe diagnostics for AskExe bug-report intake.
+
+Commands:
+  exe-os support health              Check local setup + AskExe support server health
+  exe-os support test --project hygo Send a safe smoke report end-to-end
+
+What success means:
+  health = this device looks ready
+  test   = AskExe received a real report from this device
+`);
+}
+function output(rows, json, command) {
   if (json) {
-    console.log(JSON.stringify({ ok: rows.every((row) => row.ok), checks: rows }, null, 2));
+    console.log(JSON.stringify({ ok: !hasFailures(rows), checks: rows }, null, 2));
     return;
   }
-  console.log("\nexe-os support diagnostics\n");
+  console.log(`
+exe-os support ${command}
+`);
   for (const row of rows) {
-    console.log(`${row.ok ? "\u2705" : "\u274C"} ${row.check}: ${row.detail}`);
+    const icon = row.level === "pass" ? "\u2705" : row.level === "warn" ? "\u26A0\uFE0F " : "\u274C";
+    console.log(`${icon} ${row.check}: ${row.detail}`);
+    if (row.next) console.log(`   \u2192 ${row.next}`);
+  }
+  console.log("");
+  if (hasFailures(rows)) {
+    console.log("Result: not ready. Fix the failed item(s), then rerun this command.");
+  } else if (rows.some((row) => row.level === "warn")) {
+    console.log("Result: ready with warnings. Bug reports can be sent; warnings are informational unless AskExe asked for stricter validation.");
+  } else {
+    console.log(command === "test" ? "Result: ready. AskExe received the test report." : "Result: ready. Run `exe-os support test --project <customer>` for an end-to-end send test.");
   }
   console.log("");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askexenow/exe-os",
-  "version": "0.9.78",
+  "version": "0.9.79",
   "description": "AI employee operating system — persistent memory, task management, and multi-agent coordination for Claude Code.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",