election-vibe 0.1.0 → 0.1.1

package/README.md

@@ -9,7 +9,7 @@ Unofficial results for the US general election of November 3, 2026, in your term
 You need Node 22 or later.
 
 ```bash
-npm i -g election-vibe     # installs the `elections` command
+npm i -g election-vibe     # installs the `elections` command (also as `election-vibe`)
 elections collect          # the collector: leave it running in its own terminal
 ```
 
@@ -310,6 +310,8 @@ To remove it all, in this order (the plugin lives inside the package's folder, s
 
 **Which Claude Code version?** The plugin was tested with Claude Code 2.1.316. To update: update the package, restart the collector, then `/reload-plugins`. To remove: the plugin before the package (see above).
 
+**Does it work behind a corporate proxy?** It connects to the sources directly and does not use a proxy (`HTTPS_PROXY` is not read). On a network that inspects HTTPS or blocks direct connections, the reads fail, and `elections sources` says why for each source (for example "the connection's certificate is not trusted").
+
 **How do I pick the display time zone?** `--tz <IANA zone>` on any command, or `ELECTIONS_TZ`. The default is your computer's zone.
 
 **How much disk does it use?** A few megabytes for the snapshots, plus one log line per collector cycle.

package/dist/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { appendFileSync } from "fs";
+import { appendFileSync, realpathSync } from "fs";
+import { fileURLToPath } from "url";
 
 // src/store.ts
 import { randomBytes } from "crypto";
@@ -215,7 +216,7 @@ var REHEARSAL_SENTENCE = {
 
 // src/http.ts
 import { gunzipSync } from "zlib";
-var USER_AGENT = `ElectionsCompanion/${"0.1.0"} (unofficial results reader; local, no telemetry)`;
+var USER_AGENT = `ElectionsCompanion/${"0.1.1"} (unofficial results reader; local, no telemetry)`;
 function retryAfterMs(header, nowMs) {
   if (!header) return void 0;
   const t = header.trim();
@@ -295,6 +296,9 @@ async function fetchDocument(url, opts) {
       }
     }
     if (res.status === 401 || res.status === 403) return { kind: "denied", status: res.status, fetchedAt: stamp() };
+    if (res.status === 407) {
+      return { kind: "client-error", status: 407, fetchedAt: stamp(), detail: "HTTP 407: a proxy asks for credentials; this tool connects directly and does not use a proxy" };
+    }
     if (res.status >= 500) return { kind: "server-error", status: res.status, fetchedAt: stamp() };
     if (res.status !== 200) return { kind: "client-error", status: res.status, fetchedAt: stamp() };
     let body = opts.method === "HEAD" ? Buffer.alloc(0) : await readBounded2(res, maxBytes);
@@ -319,11 +323,23 @@ async function fetchDocument(url, opts) {
   } catch (err) {
     if (err instanceof BodyTooLargeError) return { kind: "too-large", status: err.status, fetchedAt: stamp(), detail: "captured body over bound" };
     const aborted = err.name === "AbortError";
-    return { kind: aborted ? "timeout" : "network", fetchedAt: stamp(), detail: aborted ? void 0 : String(err.message ?? err).slice(0, 120) };
+    return { kind: aborted ? "timeout" : "network", fetchedAt: stamp(), detail: aborted ? void 0 : networkWords(err) };
   } finally {
     clearTimeout(timer);
   }
 }
+function networkWords(err) {
+  const raw = err?.cause?.code;
+  const code = typeof raw === "string" && /^[A-Z][A-Z0-9_]{1,39}$/.test(raw) ? raw : "";
+  if (/^(SELF_SIGNED_CERT_IN_CHAIN|DEPTH_ZERO_SELF_SIGNED_CERT|UNABLE_TO_(GET_ISSUER_CERT(_LOCALLY)?|VERIFY_LEAF_SIGNATURE)|CERT_[A-Z_]+|ERR_TLS_[A-Z_]+)$/.test(code)) {
+    return `the connection's certificate is not trusted (${code}): a network that inspects HTTPS, such as a corporate proxy, causes this; this tool connects directly`;
+  }
+  if (/^(ECONNREFUSED|ECONNRESET|ETIMEDOUT|EHOSTUNREACH|ENETUNREACH|UND_ERR_CONNECT_TIMEOUT|UND_ERR_SOCKET)$/.test(code)) {
+    return `the connection was refused or cut off (${code}): no network, or a firewall or proxy that blocks direct connections`;
+  }
+  if (code === "ENOTFOUND" || code === "EAI_AGAIN") return `the source's name could not be resolved (${code}): no network, or a network that blocks the name`;
+  return code ? `the connection failed (${code})` : "the connection failed";
+}
 function jsonOf(body) {
   try {
     return JSON.parse(body.toString("utf8"));
@@ -46269,7 +46285,7 @@ function storeOf(p) {
 }
 async function main(argv, io) {
   if (argv[0] === "--version" || argv[0] === "version") {
-    io.out("0.1.0");
+    io.out("0.1.1");
     return 0;
   }
   const p = parseArgs(argv);
@@ -46476,6 +46492,8 @@ ${renderRace(v, { nowMs, zone, width, color, partisan, pollsClose })}`);
             disabled: cfg.disabledSources.includes(s.id),
             approved: approvals[s.id] ?? null,
             lastOutcome: st?.lastOutcome ?? null,
+            // Why the last read failed, in words (a blocked network names what blocks it); null after a success.
+            lastOutcomeDetail: st?.lastOutcome && st.lastOutcome !== "ok" && st.lastOutcome !== "not-modified" && st.lastOutcomeDetail ? humanLabel(st.lastOutcomeDetail, 300) : null,
             lastSuccessAt: st?.lastSuccessAt ?? null,
             cooldownUntil: st?.cooldownUntil ?? null,
             deniedAt: st?.deniedAt ?? null,
@@ -46492,7 +46510,7 @@ ${renderRace(v, { nowMs, zone, width, color, partisan, pollsClose })}`);
           const lines = rows.map(
             (r) => [
               `${r.name} (${r.id}) \xB7 ledger ${r.ledger} \xB7 admission ${r.admission}${r.disabled ? " \xB7 DISABLED locally" : ""}`,
-              `  last: ${r.lastOutcome ?? "never read"}${r.lastSuccessAt ? ` \xB7 last success ${formatAge(r.lastSuccessAt, nowMs)} ago` : ""}${r.cooldownUntil && Date.parse(r.cooldownUntil) > nowMs ? ` \xB7 cooling down until ${formatInstant(r.cooldownUntil, zone)}` : ""}${r.deniedAt ? " \xB7 ACCESS DENIED: stopped pending diagnosis" : ""}`,
+              `  last: ${r.lastOutcome ?? "never read"}${r.lastOutcomeDetail ? `: ${r.lastOutcomeDetail}` : ""}${r.lastSuccessAt ? ` \xB7 last success ${formatAge(r.lastSuccessAt, nowMs)} ago` : ""}${r.cooldownUntil && Date.parse(r.cooldownUntil) > nowMs ? ` \xB7 cooling down until ${formatInstant(r.cooldownUntil, zone)}` : ""}${r.deniedAt ? " \xB7 ACCESS DENIED: stopped pending diagnosis" : ""}`,
               `  revision: ${r.lastRevision ? `${localizeTimes(r.lastRevision.label, zone)} (hash ${r.lastRevision.hash})` : "none"} \xB7 production: ${r.approved ? `approved from ${approvalPoint(r.id, r.approved.revisionOrder, zone)}, at ${formatInstant(r.approved.approvedAt, zone)}` : r.admission === "operator" ? "awaiting production approval" : "admitted by source tag after poll close"}`,
               `  requests this hour: ${r.requestsThisHour} \xB7 ${r.officialLink ? `official results: ${r.officialLink}` : `not an official source (aggregator): ${r.site}`}`
             ].join("\n")
@@ -46720,8 +46738,15 @@ function approvalPoint(sourceId, order, zone) {
   const src = sourceById(sourceId);
   return src && orderIsTime(src) ? `the report of ${formatInstant(new Date(order).toISOString(), zone)}` : `revision ${order}`;
 }
-var isEntry = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("/elections") || process.argv[1]?.endsWith("cli.js");
-if (isEntry) {
+function isEntryPath(launched, moduleUrl) {
+  if (!launched) return false;
+  try {
+    return realpathSync(launched) === realpathSync(fileURLToPath(moduleUrl));
+  } catch {
+    return false;
+  }
+}
+if (isEntryPath(process.argv[1], import.meta.url)) {
   main(process.argv.slice(2), {
     out: (s) => process.stdout.write(`${s}
 `),
@@ -46751,6 +46776,7 @@ function exitWhenFlushed(code) {
   process.stderr.write("", done);
 }
 export {
+  isEntryPath,
   main,
   parseArgs
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "election-vibe",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "US election night, Nov 3, 2026, in your terminal and in Claude Code: unofficial results from official free sources and civicAPI, kept on your machine. Never calls a race. Unofficial results. Not an election authority. Not affiliated with any government, campaign, or party.",
   "keywords": [
     "election",
@@ -19,7 +19,8 @@
     "node": ">=22"
   },
   "bin": {
-    "elections": "./dist/cli.js"
+    "elections": "./dist/cli.js",
+    "election-vibe": "./dist/cli.js"
   },
   "files": [
     "dist",