terminalhire 0.11.0 → 0.12.0

package/dist/bin/jpi-chat-read.js

@@ -4278,6 +4278,35 @@ async function defaultListPendingInvites(deps = {}) {
   const invites = listed.intros.filter((it) => it && it.role === "incoming" && it.status === "pending" && it.counterpartyLogin).map((it) => ({ login: it.counterpartyLogin }));
   return { status: "ok", invites };
 }
+function relativeTime(then, now = /* @__PURE__ */ new Date()) {
+  const t = new Date(then).getTime();
+  if (Number.isNaN(t)) return "";
+  const deltaMs = Math.max(0, now.getTime() - t);
+  const sec = Math.floor(deltaMs / 1e3);
+  if (sec < 60) return "just now";
+  const min = Math.floor(sec / 60);
+  if (min < 60) return `${Math.max(1, min)}m ago`;
+  const hr = Math.floor(min / 60);
+  if (hr < 24) return `${hr}h ago`;
+  const day = Math.floor(hr / 24);
+  if (day < 7) return `${day}d ago`;
+  const wk = Math.floor(day / 7);
+  if (wk < 5) return `${wk}w ago`;
+  return "a while ago";
+}
+function formatPresence(presence, now = /* @__PURE__ */ new Date()) {
+  if (!presence) return "\u25CB not on chat yet";
+  const share = presence.shareActivity === true;
+  const seenMs = share && presence.lastSeen ? new Date(presence.lastSeen).getTime() : NaN;
+  const hasSeen = !Number.isNaN(seenMs);
+  const fresh = hasSeen && now.getTime() - seenMs <= ACTIVE_WINDOW_MS;
+  if (share && presence.optin === true && fresh) return "\u25CF active now";
+  if (share && hasSeen) {
+    const rel = relativeTime(presence.lastSeen, now);
+    return rel ? `\u25D0 reachable \xB7 seen ${rel}` : "\u25D0 reachable";
+  }
+  return "\u25D0 reachable";
+}
 var CHAT_BASE2, GH_SESSION_COOKIE2, ANSI_CSI, ANSI_OSC, ANSI_OTHER, C0_C1_DEL, CHAT_DISCLOSURE, CHAT_AT_REST, CHAT_CODE_OF_CONDUCT, CHAT_MIN_AGE, ACTIVE_WINDOW_MS;
 var init_jpi_chat = __esm({
   "bin/jpi-chat.js"() {
@@ -4404,7 +4433,7 @@ function renderInbox(items, invites = []) {
     lines.push("  (no accepted connections yet \u2014 request one: terminalhire intro <login>)");
   } else {
     for (const it of items) {
-      const dot = it.online ? "\u25CF" : "\u25CB";
+      const dot = formatPresence(it.presence).charAt(0);
       const unread = it.unread > 0 ? `\u2709 ${it.unread}` : "\u2014";
       const login = `@${sanitizeLine(it.login)}`;
       const stamp = sanitizeLine(it.lastStamp || "");
@@ -4419,13 +4448,12 @@ function renderInbox(items, invites = []) {
   return lines.join("\n") + "\n";
 }
 function renderThread(state) {
-  const { peerLogin, online, safety, messages, total } = state;
+  const { peerLogin, presence, safety, messages, total } = state;
   const safePeer = sanitizeLine(peerLogin);
-  const dot = online ? "\u25CF" : "\u25CB";
-  const presence = online ? "online" : "offline";
+  const status = formatPresence(presence);
   const lines = [];
   lines.push(
-    `  @${safePeer}  ${dot} ${presence}` + (safety ? `  \xB7 safety# ${sanitizeLine(safety)}` : "")
+    `  @${safePeer}  ${status}` + (safety ? `  \xB7 safety# ${sanitizeLine(safety)}` : "")
   );
   lines.push("  " + "\u2500".repeat(64));
   if (!messages || messages.length === 0) {
@@ -4475,21 +4503,6 @@ function writeProblem(output, result, target) {
       return "error";
   }
 }
-async function readPresence(client, peerLogin) {
-  if (typeof client.getPeerPresence !== "function") return false;
-  try {
-    return await client.getPeerPresence(peerLogin) != null;
-  } catch {
-    return false;
-  }
-}
-async function clearPresence(client) {
-  if (typeof client.heartbeat !== "function") return;
-  try {
-    await client.heartbeat(false);
-  } catch {
-  }
-}
 async function gateDisclosure(ensureDisclosure, input, output) {
   const ack = await ensureDisclosure({ input, output });
   if (!ack.acknowledged) {
@@ -4537,16 +4550,14 @@ async function runInbox(opts = {}) {
       (m) => m.senderLogin === conn.peerLogin && (!cursor || m.createdAt > cursor)
     ).length;
     const last = messages.length > 0 ? messages[messages.length - 1] : null;
-    const online = await readPresence(client, conn.peerLogin);
     items.push({
       login: conn.peerLogin,
-      online,
+      presence: REACHABLE_DISPLAY,
       unread,
       lastStamp: last ? formatStamp(last.createdAt) : "",
       preview: last ? last.plaintext : ""
     });
   }
-  await clearPresence(client);
   output.write(renderInbox(items, invites));
   return { ok: true, count: items.length, invites: invites.length };
 }
@@ -4589,7 +4600,6 @@ async function runReadThread(opts = {}) {
   }
   const total = messages.length;
   const shownMessages = all ? messages : messages.slice(Math.max(0, total - limit));
-  const online = await readPresence(client, peerLogin);
   let safety = "";
   if (typeof client.getSafetyNumber === "function") {
     try {
@@ -4598,8 +4608,7 @@ async function runReadThread(opts = {}) {
       safety = "";
     }
   }
-  await clearPresence(client);
-  output.write(renderThread({ peerLogin, online, safety, messages: shownMessages, total }));
+  output.write(renderThread({ peerLogin, presence: REACHABLE_DISPLAY, safety, messages: shownMessages, total }));
   if (total > 0) {
     const newest = messages[total - 1];
     if (newest && newest.createdAt) {
@@ -4672,7 +4681,7 @@ async function runSend(opts = {}) {
   );
   return { ok: true };
 }
-var CHAT_BASE3, GH_SESSION_COOKIE3, TERMINALHIRE_DIR5, READS_FILE, INDEX_CACHE_FILE;
+var CHAT_BASE3, GH_SESSION_COOKIE3, TERMINALHIRE_DIR5, READS_FILE, INDEX_CACHE_FILE, REACHABLE_DISPLAY;
 var init_jpi_chat_read = __esm({
   "bin/jpi-chat-read.js"() {
     init_chat_client();
@@ -4683,6 +4692,7 @@ var init_jpi_chat_read = __esm({
     TERMINALHIRE_DIR5 = join8(homedir7(), ".terminalhire");
     READS_FILE = join8(TERMINALHIRE_DIR5, "chat-reads.json");
     INDEX_CACHE_FILE = join8(TERMINALHIRE_DIR5, "index-cache.json");
+    REACHABLE_DISPLAY = { shareActivity: false, optin: false, lastSeen: null };
   }
 });
 init_jpi_chat_read();

package/dist/bin/jpi-chat.js

@@ -4558,7 +4558,7 @@ function renderInbox(items, invites = []) {
     lines.push("  (no accepted connections yet \u2014 request one: terminalhire intro <login>)");
   } else {
     for (const it of items) {
-      const dot = it.online ? "\u25CF" : "\u25CB";
+      const dot = formatPresence(it.presence).charAt(0);
       const unread = it.unread > 0 ? `\u2709 ${it.unread}` : "\u2014";
       const login = `@${sanitizeLine(it.login)}`;
       const stamp = sanitizeLine(it.lastStamp || "");
@@ -4573,13 +4573,12 @@ function renderInbox(items, invites = []) {
   return lines.join("\n") + "\n";
 }
 function renderThread(state) {
-  const { peerLogin, online, safety, messages, total } = state;
+  const { peerLogin, presence, safety, messages, total } = state;
   const safePeer = sanitizeLine(peerLogin);
-  const dot = online ? "\u25CF" : "\u25CB";
-  const presence = online ? "online" : "offline";
+  const status = formatPresence(presence);
   const lines = [];
   lines.push(
-    `  @${safePeer}  ${dot} ${presence}` + (safety ? `  \xB7 safety# ${sanitizeLine(safety)}` : "")
+    `  @${safePeer}  ${status}` + (safety ? `  \xB7 safety# ${sanitizeLine(safety)}` : "")
   );
   lines.push("  " + "\u2500".repeat(64));
   if (!messages || messages.length === 0) {
@@ -4629,21 +4628,6 @@ function writeProblem(output, result, target) {
       return "error";
   }
 }
-async function readPresence(client, peerLogin) {
-  if (typeof client.getPeerPresence !== "function") return false;
-  try {
-    return await client.getPeerPresence(peerLogin) != null;
-  } catch {
-    return false;
-  }
-}
-async function clearPresence(client) {
-  if (typeof client.heartbeat !== "function") return;
-  try {
-    await client.heartbeat(false);
-  } catch {
-  }
-}
 async function gateDisclosure(ensureDisclosure, input, output) {
   const ack = await ensureDisclosure({ input, output });
   if (!ack.acknowledged) {
@@ -4691,16 +4675,14 @@ async function runInbox(opts = {}) {
       (m) => m.senderLogin === conn.peerLogin && (!cursor || m.createdAt > cursor)
     ).length;
     const last = messages.length > 0 ? messages[messages.length - 1] : null;
-    const online = await readPresence(client, conn.peerLogin);
     items.push({
       login: conn.peerLogin,
-      online,
+      presence: REACHABLE_DISPLAY,
       unread,
       lastStamp: last ? formatStamp(last.createdAt) : "",
       preview: last ? last.plaintext : ""
     });
   }
-  await clearPresence(client);
   output.write(renderInbox(items, invites));
   return { ok: true, count: items.length, invites: invites.length };
 }
@@ -4743,7 +4725,6 @@ async function runReadThread(opts = {}) {
   }
   const total = messages.length;
   const shownMessages = all ? messages : messages.slice(Math.max(0, total - limit));
-  const online = await readPresence(client, peerLogin);
   let safety = "";
   if (typeof client.getSafetyNumber === "function") {
     try {
@@ -4752,8 +4733,7 @@ async function runReadThread(opts = {}) {
       safety = "";
     }
   }
-  await clearPresence(client);
-  output.write(renderThread({ peerLogin, online, safety, messages: shownMessages, total }));
+  output.write(renderThread({ peerLogin, presence: REACHABLE_DISPLAY, safety, messages: shownMessages, total }));
   if (total > 0) {
     const newest = messages[total - 1];
     if (newest && newest.createdAt) {
@@ -4826,7 +4806,7 @@ async function runSend(opts = {}) {
   );
   return { ok: true };
 }
-var CHAT_BASE2, GH_SESSION_COOKIE2, TERMINALHIRE_DIR6, READS_FILE, INDEX_CACHE_FILE;
+var CHAT_BASE2, GH_SESSION_COOKIE2, TERMINALHIRE_DIR6, READS_FILE, INDEX_CACHE_FILE, REACHABLE_DISPLAY;
 var init_jpi_chat_read = __esm({
   "bin/jpi-chat-read.js"() {
     "use strict";
@@ -4838,6 +4818,7 @@ var init_jpi_chat_read = __esm({
     TERMINALHIRE_DIR6 = join8(homedir7(), ".terminalhire");
     READS_FILE = join8(TERMINALHIRE_DIR6, "chat-reads.json");
     INDEX_CACHE_FILE = join8(TERMINALHIRE_DIR6, "index-cache.json");
+    REACHABLE_DISPLAY = { shareActivity: false, optin: false, lastSeen: null };
   }
 });
 

package/dist/bin/jpi-dispatch.js

@@ -10689,7 +10689,7 @@ function renderInbox(items, invites = []) {
     lines.push("  (no accepted connections yet \u2014 request one: terminalhire intro <login>)");
   } else {
     for (const it of items) {
-      const dot = it.online ? "\u25CF" : "\u25CB";
+      const dot = formatPresence(it.presence).charAt(0);
       const unread = it.unread > 0 ? `\u2709 ${it.unread}` : "\u2014";
       const login = `@${sanitizeLine(it.login)}`;
       const stamp = sanitizeLine(it.lastStamp || "");
@@ -10704,13 +10704,12 @@ function renderInbox(items, invites = []) {
   return lines.join("\n") + "\n";
 }
 function renderThread(state) {
-  const { peerLogin, online, safety, messages, total } = state;
+  const { peerLogin, presence, safety, messages, total } = state;
   const safePeer = sanitizeLine(peerLogin);
-  const dot = online ? "\u25CF" : "\u25CB";
-  const presence = online ? "online" : "offline";
+  const status = formatPresence(presence);
   const lines = [];
   lines.push(
-    `  @${safePeer}  ${dot} ${presence}` + (safety ? `  \xB7 safety# ${sanitizeLine(safety)}` : "")
+    `  @${safePeer}  ${status}` + (safety ? `  \xB7 safety# ${sanitizeLine(safety)}` : "")
   );
   lines.push("  " + "\u2500".repeat(64));
   if (!messages || messages.length === 0) {
@@ -10760,21 +10759,6 @@ function writeProblem(output, result, target) {
       return "error";
   }
 }
-async function readPresence(client, peerLogin) {
-  if (typeof client.getPeerPresence !== "function") return false;
-  try {
-    return await client.getPeerPresence(peerLogin) != null;
-  } catch {
-    return false;
-  }
-}
-async function clearPresence(client) {
-  if (typeof client.heartbeat !== "function") return;
-  try {
-    await client.heartbeat(false);
-  } catch {
-  }
-}
 async function gateDisclosure(ensureDisclosure, input, output) {
   const ack = await ensureDisclosure({ input, output });
   if (!ack.acknowledged) {
@@ -10822,16 +10806,14 @@ async function runInbox(opts = {}) {
       (m) => m.senderLogin === conn.peerLogin && (!cursor || m.createdAt > cursor)
     ).length;
     const last = messages.length > 0 ? messages[messages.length - 1] : null;
-    const online = await readPresence(client, conn.peerLogin);
     items.push({
       login: conn.peerLogin,
-      online,
+      presence: REACHABLE_DISPLAY,
       unread,
       lastStamp: last ? formatStamp(last.createdAt) : "",
       preview: last ? last.plaintext : ""
     });
   }
-  await clearPresence(client);
   output.write(renderInbox(items, invites));
   return { ok: true, count: items.length, invites: invites.length };
 }
@@ -10874,7 +10856,6 @@ async function runReadThread(opts = {}) {
   }
   const total = messages.length;
   const shownMessages = all ? messages : messages.slice(Math.max(0, total - limit));
-  const online = await readPresence(client, peerLogin);
   let safety = "";
   if (typeof client.getSafetyNumber === "function") {
     try {
@@ -10883,8 +10864,7 @@ async function runReadThread(opts = {}) {
       safety = "";
     }
   }
-  await clearPresence(client);
-  output.write(renderThread({ peerLogin, online, safety, messages: shownMessages, total }));
+  output.write(renderThread({ peerLogin, presence: REACHABLE_DISPLAY, safety, messages: shownMessages, total }));
   if (total > 0) {
     const newest = messages[total - 1];
     if (newest && newest.createdAt) {
@@ -10957,7 +10937,7 @@ async function runSend(opts = {}) {
   );
   return { ok: true };
 }
-var CHAT_BASE2, GH_SESSION_COOKIE4, TERMINALHIRE_DIR13, READS_FILE, INDEX_CACHE_FILE5;
+var CHAT_BASE2, GH_SESSION_COOKIE4, TERMINALHIRE_DIR13, READS_FILE, INDEX_CACHE_FILE5, REACHABLE_DISPLAY;
 var init_jpi_chat_read = __esm({
   "bin/jpi-chat-read.js"() {
     "use strict";
@@ -10969,6 +10949,7 @@ var init_jpi_chat_read = __esm({
     TERMINALHIRE_DIR13 = join17(homedir16(), ".terminalhire");
     READS_FILE = join17(TERMINALHIRE_DIR13, "chat-reads.json");
     INDEX_CACHE_FILE5 = join17(TERMINALHIRE_DIR13, "index-cache.json");
+    REACHABLE_DISPLAY = { shareActivity: false, optin: false, lastSeen: null };
   }
 });
 
@@ -13370,6 +13351,13 @@ function resolveInstallJs() {
   if (existsSync18(fromBin)) return fromBin;
   return fromBin;
 }
+function resolveStatuslineInstallJs() {
+  const fromDist = resolve(join24(__dirname3, "..", "..", "statusline-install.js"));
+  const fromBin = resolve(join24(__dirname3, "..", "statusline-install.js"));
+  if (existsSync18(fromDist)) return fromDist;
+  if (existsSync18(fromBin)) return fromBin;
+  return fromBin;
+}
 async function run17() {
   console.log("");
   console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
@@ -13382,10 +13370,12 @@ async function run17() {
   console.log("  2. Seed your local job cache (anonymous index download)");
   console.log("  3. Enable the ambient spinner job surface in ~/.claude/settings.json");
   console.log("     (with backup + your explicit consent before any file is touched)");
+  console.log("  4. Optionally show connection notifications in your statusLine");
+  console.log("     (\u{1F4AC} unread + intro requests only \u2014 never job ads; separate consent)");
   console.log("");
   console.log('You can stop at any step. Nothing is changed until you say "yes".');
   console.log("");
-  console.log("Step 1/3 \u2014 GitHub sign-in (optional but recommended)");
+  console.log("Step 1/4 \u2014 GitHub sign-in (optional but recommended)");
   console.log("");
   console.log("  Scope: read:user \u2014 public profile + public repos only.");
   console.log("  Your token is encrypted at ~/.terminalhire/github-token.enc.");
@@ -13413,7 +13403,7 @@ async function run17() {
     console.log("  Sign in any time with: terminalhire login");
   }
   console.log("");
-  console.log("Step 2/3 \u2014 Seeding local job cache");
+  console.log("Step 2/4 \u2014 Seeding local job cache");
   console.log("");
   console.log("  Fetching anonymous job index (no dev data sent)...");
   const jobsScript = resolveScript("jpi-jobs");
@@ -13433,7 +13423,7 @@ async function run17() {
     console.log("  Run `terminalhire jobs` after a few Claude Code sessions to populate it.");
   }
   console.log("");
-  console.log("Step 3/3 \u2014 Enable the ambient spinner job surface in ~/.claude/settings.json");
+  console.log("Step 3/4 \u2014 Enable the ambient spinner job surface in ~/.claude/settings.json");
   console.log("");
   console.log("  This is the only step that modifies a system file.");
   console.log("  A timestamped backup is created before any change.");
@@ -13449,6 +13439,24 @@ async function run17() {
     console.log("  Hook installation did not complete. Run manually: node install.js");
   }
   console.log("");
+  console.log("Step 4/4 \u2014 Connection notifications in your statusLine (optional)");
+  console.log("");
+  console.log("  A statusLine that shows ONLY personal connection signals \u2014 \u{1F4AC} unread");
+  console.log("  messages and inbound intro requests. Never job ads (those stay in the");
+  console.log("  spinner). Local cache read, zero network. Separate consent + backup;");
+  console.log("  it stays current across plugin updates and preserves any existing");
+  console.log("  statusLine you have. Remove any time: node statusline-install.js --uninstall");
+  console.log("");
+  const statuslineInstallJs = resolveStatuslineInstallJs();
+  const statuslineChild = spawnSync(process.execPath, [statuslineInstallJs], {
+    stdio: ["inherit", "inherit", "inherit"],
+    env: process.env
+  });
+  if (statuslineChild.status !== 0) {
+    console.log("");
+    console.log("  statusLine setup did not complete. Run manually: node statusline-install.js");
+  }
+  console.log("");
   console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
   console.log("\u2502  terminalhire init complete!                                    \u2502");
   console.log("\u2502                                                                  \u2502");

package/dist/bin/jpi-init.js

@@ -29,6 +29,13 @@ function resolveInstallJs() {
   if (existsSync(fromBin)) return fromBin;
   return fromBin;
 }
+function resolveStatuslineInstallJs() {
+  const fromDist = resolve(join(__dirname, "..", "..", "statusline-install.js"));
+  const fromBin = resolve(join(__dirname, "..", "statusline-install.js"));
+  if (existsSync(fromDist)) return fromDist;
+  if (existsSync(fromBin)) return fromBin;
+  return fromBin;
+}
 async function run() {
   console.log("");
   console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
@@ -41,10 +48,12 @@ async function run() {
   console.log("  2. Seed your local job cache (anonymous index download)");
   console.log("  3. Enable the ambient spinner job surface in ~/.claude/settings.json");
   console.log("     (with backup + your explicit consent before any file is touched)");
+  console.log("  4. Optionally show connection notifications in your statusLine");
+  console.log("     (\u{1F4AC} unread + intro requests only \u2014 never job ads; separate consent)");
   console.log("");
   console.log('You can stop at any step. Nothing is changed until you say "yes".');
   console.log("");
-  console.log("Step 1/3 \u2014 GitHub sign-in (optional but recommended)");
+  console.log("Step 1/4 \u2014 GitHub sign-in (optional but recommended)");
   console.log("");
   console.log("  Scope: read:user \u2014 public profile + public repos only.");
   console.log("  Your token is encrypted at ~/.terminalhire/github-token.enc.");
@@ -72,7 +81,7 @@ async function run() {
     console.log("  Sign in any time with: terminalhire login");
   }
   console.log("");
-  console.log("Step 2/3 \u2014 Seeding local job cache");
+  console.log("Step 2/4 \u2014 Seeding local job cache");
   console.log("");
   console.log("  Fetching anonymous job index (no dev data sent)...");
   const jobsScript = resolveScript("jpi-jobs");
@@ -92,7 +101,7 @@ async function run() {
     console.log("  Run `terminalhire jobs` after a few Claude Code sessions to populate it.");
   }
   console.log("");
-  console.log("Step 3/3 \u2014 Enable the ambient spinner job surface in ~/.claude/settings.json");
+  console.log("Step 3/4 \u2014 Enable the ambient spinner job surface in ~/.claude/settings.json");
   console.log("");
   console.log("  This is the only step that modifies a system file.");
   console.log("  A timestamped backup is created before any change.");
@@ -108,6 +117,24 @@ async function run() {
     console.log("  Hook installation did not complete. Run manually: node install.js");
   }
   console.log("");
+  console.log("Step 4/4 \u2014 Connection notifications in your statusLine (optional)");
+  console.log("");
+  console.log("  A statusLine that shows ONLY personal connection signals \u2014 \u{1F4AC} unread");
+  console.log("  messages and inbound intro requests. Never job ads (those stay in the");
+  console.log("  spinner). Local cache read, zero network. Separate consent + backup;");
+  console.log("  it stays current across plugin updates and preserves any existing");
+  console.log("  statusLine you have. Remove any time: node statusline-install.js --uninstall");
+  console.log("");
+  const statuslineInstallJs = resolveStatuslineInstallJs();
+  const statuslineChild = spawnSync(process.execPath, [statuslineInstallJs], {
+    stdio: ["inherit", "inherit", "inherit"],
+    env: process.env
+  });
+  if (statuslineChild.status !== 0) {
+    console.log("");
+    console.log("  statusLine setup did not complete. Run manually: node statusline-install.js");
+  }
+  console.log("");
   console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
   console.log("\u2502  terminalhire init complete!                                    \u2502");
   console.log("\u2502                                                                  \u2502");

package/dist/bin/jpi-statusline-launch.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+// bin/jpi-statusline-launch.js
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { spawnSync } from "child_process";
+import { pathToFileURL } from "url";
+var TH_DIR = join(homedir(), ".terminalhire");
+var POINTER = join(TH_DIR, "engine-path");
+var FOREIGN = join(TH_DIR, "statusline-foreign.json");
+function firstLine(buf) {
+  if (!buf || !buf.length) return "";
+  const s = Buffer.isBuffer(buf) ? buf.toString("utf8") : String(buf);
+  const nl = s.indexOf("\n");
+  return (nl === -1 ? s : s.slice(0, nl)).replace(/\s+$/u, "");
+}
+async function renderOurs(input) {
+  let engine = "";
+  try {
+    if (!existsSync(POINTER)) return "";
+    engine = readFileSync(POINTER, "utf8").trim();
+  } catch {
+    return "";
+  }
+  if (!engine || !existsSync(engine)) return "";
+  try {
+    const line = await Promise.race([
+      import(pathToFileURL(engine).href).then(
+        (mod) => mod && typeof mod.render === "function" ? firstLine(mod.render()) : null
+      ),
+      new Promise((resolve) => setTimeout(() => resolve(void 0), 30))
+    ]);
+    if (typeof line === "string") return line;
+  } catch {
+  }
+  try {
+    const r = spawnSync(process.execPath, [engine], { input, timeout: 800 });
+    return firstLine(r.stdout);
+  } catch {
+    return "";
+  }
+}
+function renderForeign(input) {
+  try {
+    if (!existsSync(FOREIGN)) return "";
+    const saved = JSON.parse(readFileSync(FOREIGN, "utf8"));
+    const cmd = saved && saved.statusLine && saved.statusLine.command;
+    if (!cmd) return "";
+    const r = spawnSync(cmd, { shell: true, input, timeout: 4e3 });
+    return firstLine(r.stdout);
+  } catch {
+    return "";
+  }
+}
+try {
+  let input = Buffer.alloc(0);
+  try {
+    if (!process.stdin.isTTY) input = readFileSync(0);
+  } catch {
+  }
+  const segments = [];
+  const foreign = renderForeign(input);
+  if (foreign) segments.push(foreign);
+  const ours = await renderOurs(input);
+  if (ours) segments.push(ours);
+  if (segments.length > 0) process.stdout.write(segments.join("  \xB7  ") + "\n");
+  process.exit(0);
+} catch {
+  process.exit(0);
+}

package/dist/bin/jpi-statusline.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+// bin/jpi-statusline.js
+import { readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { pathToFileURL } from "url";
+var INDEX_CACHE_FILE = join(homedir(), ".terminalhire", "index-cache.json");
+var INDEX_CACHE_TTL_MS = 15 * 60 * 1e3;
+function readFreshCache() {
+  try {
+    const entry = JSON.parse(readFileSync(INDEX_CACHE_FILE, "utf8"));
+    if (typeof entry.ts !== "number" || Date.now() - entry.ts > INDEX_CACHE_TTL_MS) return null;
+    return entry;
+  } catch {
+    return null;
+  }
+}
+function unreadChatCount(entry) {
+  const n = entry && entry.unreadChat && entry.unreadChat.count;
+  return typeof n === "number" && n > 0 ? n : 0;
+}
+function incomingCount(entry) {
+  const n = entry && entry.incomingPending && entry.incomingPending.count;
+  return typeof n === "number" && n > 0 ? n : 0;
+}
+function sessionStale(entry) {
+  return !!entry && entry.sessionStale === true;
+}
+function render() {
+  try {
+    const entry = readFreshCache();
+    if (!entry) return "";
+    const unread = unreadChatCount(entry);
+    const incoming = incomingCount(entry);
+    const stale = sessionStale(entry) && unread === 0 && incoming === 0;
+    const parts = [];
+    if (unread > 0) parts.push(`\u{1F4AC} ${unread} unread`);
+    if (incoming > 0) parts.push(`\u2709 ${incoming} waiting to connect`);
+    if (parts.length > 0) {
+      let line = parts.join("  \xB7  ");
+      line += unread > 0 ? " \u2014 run: terminalhire chat" : " \u2014 run: terminalhire intro --list";
+      return line;
+    }
+    if (stale) {
+      return "\u26A0 terminalhire session expired \u2014 run: terminalhire link";
+    }
+    return "";
+  } catch {
+    return "";
+  }
+}
+try {
+  const isMain = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+  if (isMain) {
+    const line = render();
+    if (line) process.stdout.write(line + "\n");
+    process.exit(0);
+  }
+} catch {
+  process.exit(0);
+}
+export {
+  render
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminalhire",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Local-first job matching for developers — ambient job matches in the Claude Code spinner. Matching runs on your machine; your profile never leaves it.",
   "repository": {
     "type": "git",
@@ -22,13 +22,14 @@
     "dist",
     "fixtures",
     "install.js",
+    "statusline-install.js",
     "postinstall.js",
     "README.md"
   ],
   "scripts": {
     "test": "for f in test/*.test.js; do echo \"# $f\"; node \"$f\" || exit 1; done",
     "build": "tsup",
-    "bundle:plugin": "npm run build && rm -rf ../../plugins/terminalhire/dist && cp -R dist ../../plugins/terminalhire/dist && cp package.json ../../plugins/terminalhire/dist/package.json && cp install.js ../../plugins/terminalhire/dist/install.js && cp postinstall.js ../../plugins/terminalhire/dist/postinstall.js",
+    "bundle:plugin": "npm run build && rm -rf ../../plugins/terminalhire/dist && cp -R dist ../../plugins/terminalhire/dist && cp package.json ../../plugins/terminalhire/dist/package.json && cp install.js ../../plugins/terminalhire/dist/install.js && cp statusline-install.js ../../plugins/terminalhire/dist/statusline-install.js && cp postinstall.js ../../plugins/terminalhire/dist/postinstall.js",
     "prepublishOnly": "npm run build",
     "install-hook": "node install.js",
     "postinstall": "node ./postinstall.js"

package/statusline-install.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+/**
+ * statusline-install.js — consent-gated installer for the CONNECTION-ONLY statusLine
+ * (feature 002 / ADR-002). Companion to install.js (which is spinner-only and, by its
+ * binding rule, NEVER writes settings.statusLine). This file is the ONLY writer of
+ * settings.statusLine, and it writes ONLY the self-updating launcher command — the
+ * statusLine it enables carries personal connection notifications, never job ads
+ * (the entire justification for re-opening the demoted statusLine surface).
+ *
+ * Guardrails (CONSTITUTION Rule 12 / ~/.claude/rules/safety.md):
+ *   - Explicit typed "yes" BEFORE touching any system file (no-consent → settings.json
+ *     byte-for-byte unchanged, no backup churn — V-4).
+ *   - Timestamped backup of ~/.claude/settings.json before any write.
+ *   - settings.statusLine.command is ZERO-VOLATILE: `node ~/.terminalhire/statusline-launch.js`
+ *     — a stable, version-agnostic path (V-1). All version logic lives behind the
+ *     hook-written engine-path pointer, so this artifact is written once and never
+ *     re-stamped → it cannot recreate the stale-wrapper bug.
+ *   - Chain-never-clobber: a pre-existing FOREIGN statusLine is saved verbatim to a
+ *     sidecar and run FIRST by the launcher; uninstall restores it byte-for-byte (V-5),
+ *     and it still renders when our part is empty (V-8).
+ *   - Legacy re-point (Q4): an old terminalhire wrapper (npm-pinned .sh) is detected and,
+ *     with a targeted yes, replaced by the self-updating launcher — never silently.
+ *
+ * Usage:
+ *   node statusline-install.js
+ *   node statusline-install.js --uninstall
+ */
+
+import {
+  readFileSync, writeFileSync, copyFileSync, existsSync, mkdirSync, rmSync,
+} from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { createInterface } from 'node:readline';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+
+const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+const SETTINGS_DIR = dirname(SETTINGS_PATH);
+const TERMINALHIRE_DIR = join(homedir(), '.terminalhire');
+const STABLE_LAUNCHER = join(TERMINALHIRE_DIR, 'statusline-launch.js');
+const FOREIGN_SIDECAR = join(TERMINALHIRE_DIR, 'statusline-foreign.json');
+const LEGACY_WRAPPER = join(TERMINALHIRE_DIR, 'statusline-wrapper.sh');
+
+// The exact command written to settings.statusLine — stable, version-agnostic (V-1).
+const LAUNCHER_COMMAND = `node ${STABLE_LAUNCHER}`;
+
+const UNINSTALL = process.argv.includes('--uninstall');
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(res => {
+    rl.question(question, answer => {
+      rl.close();
+      res(answer.trim().toLowerCase());
+    });
+  });
+}
+
+function backupSettings() {
+  if (!existsSync(SETTINGS_PATH)) return null;
+  const ts = new Date().toISOString().replace(/[:.]/g, '-');
+  const backupPath = `${SETTINGS_PATH}.terminalhire-backup-${ts}`;
+  copyFileSync(SETTINGS_PATH, backupPath);
+  console.log(`  Backed up settings to: ${backupPath}`);
+  return backupPath;
+}
+
+function readSettings() {
+  try {
+    if (existsSync(SETTINGS_PATH)) return JSON.parse(readFileSync(SETTINGS_PATH, 'utf8'));
+  } catch { /* fall through to empty */ }
+  return {};
+}
+
+function writeSettings(settings) {
+  mkdirSync(SETTINGS_DIR, { recursive: true });
+  writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+}
+
+// Resolve the launcher SOURCE (bundled dist preferred; bin fallback for the dev workspace).
+function resolveLauncherSource() {
+  const candidates = [
+    resolve(join(__dirname, 'dist', 'bin', 'jpi-statusline-launch.js')),
+    resolve(join(__dirname, 'bin', 'jpi-statusline-launch.js')),
+  ];
+  for (const c of candidates) if (existsSync(c)) return c;
+  return null;
+}
+
+// Classify an existing statusLine command:
+//   'ours'    — already the self-updating launcher (idempotent)
+//   'legacy'  — an OLD terminalhire wrapper (npm-pinned .sh / dispatch) → offer re-point
+//   'foreign' — someone else's statusLine → chain-wrap + preserve
+//   'none'    — no command
+function classifyExisting(statusLine) {
+  const cmd = statusLine && typeof statusLine.command === 'string' ? statusLine.command : '';
+  if (!cmd) return 'none';
+  if (cmd.includes('statusline-launch.js')) return 'ours';
+  if (
+    cmd.includes('statusline-wrapper.sh') ||
+    existsSync(LEGACY_WRAPPER) && cmd.includes('.terminalhire') ||
+    cmd.includes('jpi-dispatch') ||
+    /terminalhire|\bjpi\b|jpi-/.test(cmd)
+  ) {
+    return 'legacy';
+  }
+  return 'foreign';
+}
+
+// ── Install ───────────────────────────────────────────────────────────────────
+
+async function install() {
+  console.log('');
+  console.log('┌─────────────────────────────────────────────────────────────────┐');
+  console.log('│   terminalhire — connection notifications in your statusLine     │');
+  console.log('│      Personal connection signals only. Never job ads.            │');
+  console.log('└─────────────────────────────────────────────────────────────────┘');
+  console.log('');
+  console.log('DISCLOSURE — read before enabling');
+  console.log('');
+  console.log('WHAT THIS ENABLES:');
+  console.log('  A Claude Code statusLine that shows ONLY personal connection signals:');
+  console.log('    • 💬 N unread   — messages from developers you accepted an intro with');
+  console.log('    • ✉ N waiting to connect — inbound intro requests awaiting your reply');
+  console.log('    • ⚠ session expired — a re-link hint when your linked session lapses');
+  console.log('  It NEVER shows job matches, role %-scores, or any advert — those stay in');
+  console.log('  the ambient spinner. The line is a LOCAL cache read: zero network calls.');
+  console.log('');
+  console.log('HOW IT STAYS CURRENT (no manual re-install ever):');
+  console.log('  settings.json gets a stable command:  ' + LAUNCHER_COMMAND);
+  console.log('  On every session the plugin refreshes a pointer to its current engine, so');
+  console.log('  the statusLine follows plugin auto-updates automatically.');
+  console.log('');
+  console.log('WHAT THIS CHANGES:');
+  console.log('  • ~/.claude/settings.json — sets statusLine to the launcher above.');
+  console.log('  • A timestamped backup is created before any change.');
+  console.log('  • Any statusLine you already have is PRESERVED (run first) — never replaced.');
+  console.log('');
+  console.log('HOW TO REMOVE:');
+  console.log('  • node statusline-install.js --uninstall   (restores your prior statusLine)');
+  console.log('');
+
+  const answer = await ask('Enable the connection-notification statusLine? Type "yes" to continue: ');
+  if (answer !== 'yes') {
+    console.log('\nAborted — nothing was changed.');
+    process.exit(0);
+  }
+
+  const src = resolveLauncherSource();
+  if (!src) {
+    console.log('\n  Could not locate the statusLine launcher — nothing was changed.');
+    console.log('  Rebuild the package (npm run build) and try again.');
+    process.exit(1);
+  }
+
+  const settings = readSettings();
+  const existing = settings.statusLine;
+  const kind = classifyExisting(existing);
+
+  // Legacy re-point (Q4) — consent-gated, never silent.
+  if (kind === 'legacy') {
+    console.log('');
+    console.log('  Found an older terminalhire statusLine (npm-pinned — can go stale).');
+    const rp = await ask('  Replace it with the self-updating launcher? Type "yes": ');
+    if (rp !== 'yes') {
+      console.log('\n  Left your existing statusLine as-is — nothing was changed.');
+      process.exit(0);
+    }
+    // It is our own legacy artifact → do NOT preserve it as "foreign".
+  }
+
+  // Only NOW (post-consent) do we touch the filesystem — V-4.
+  console.log('');
+  mkdirSync(TERMINALHIRE_DIR, { recursive: true });
+
+  // Copy the launcher to its stable, version-agnostic home.
+  copyFileSync(src, STABLE_LAUNCHER);
+
+  // Chain-wrap a genuinely FOREIGN statusLine: save it verbatim so the launcher runs it
+  // first and uninstall can restore it byte-for-byte (V-5/V-8).
+  if (kind === 'foreign') {
+    writeFileSync(FOREIGN_SIDECAR, JSON.stringify({ statusLine: existing }, null, 2) + '\n', 'utf8');
+    console.log('  Preserved your existing statusLine — it will render alongside ours.');
+  } else if (kind === 'ours' && existsSync(FOREIGN_SIDECAR)) {
+    // Idempotent re-run: keep any previously-saved foreign statusLine sidecar.
+  }
+
+  const backupPath = backupSettings();
+
+  settings.statusLine = { type: 'command', command: LAUNCHER_COMMAND };
+  writeSettings(settings);
+
+  console.log('  statusLine: ENABLED');
+  console.log(`    Command: ${LAUNCHER_COMMAND}`);
+  if (backupPath) console.log(`    Backup:  ${backupPath}`);
+  console.log('');
+  console.log('Done. Restart Claude Code to see connection notifications in your statusLine.');
+  console.log('  Remove any time: node statusline-install.js --uninstall');
+  console.log('');
+}
+
+// ── Uninstall ─────────────────────────────────────────────────────────────────
+
+async function uninstall() {
+  console.log('');
+  console.log('terminalhire — remove the connection-notification statusLine');
+  console.log('');
+  console.log('  This restores whatever statusLine you had before (byte-for-byte), or');
+  console.log('  removes the statusLine entirely if terminalhire added it fresh.');
+  console.log('');
+
+  const answer = await ask('Remove the terminalhire statusLine? Type "yes" to continue: ');
+  if (answer !== 'yes') {
+    console.log('\nAborted — nothing was changed.');
+    process.exit(0);
+  }
+
+  console.log('');
+  const settings = readSettings();
+  const isOurs = settings.statusLine
+    && typeof settings.statusLine.command === 'string'
+    && settings.statusLine.command.includes('statusline-launch.js');
+
+  // Only mutate settings if the current statusLine is ours (never clobber a foreign one
+  // the user re-added after install).
+  if (isOurs) {
+    const backupPath = backupSettings();
+    if (existsSync(FOREIGN_SIDECAR)) {
+      try {
+        const saved = JSON.parse(readFileSync(FOREIGN_SIDECAR, 'utf8'));
+        if (saved && saved.statusLine) settings.statusLine = saved.statusLine; // byte-for-byte (V-5)
+        else delete settings.statusLine;
+      } catch {
+        delete settings.statusLine;
+      }
+      console.log('  Restored your previous statusLine.');
+    } else {
+      delete settings.statusLine;
+      console.log('  Removed the terminalhire statusLine.');
+    }
+    writeSettings(settings);
+    if (backupPath) console.log(`    Backup: ${backupPath}`);
+  } else {
+    console.log('  No terminalhire statusLine is currently active — settings.json left unchanged.');
+  }
+
+  // Clean up our stable artifacts (the pointer is re-written harmlessly by the hook).
+  try { if (existsSync(FOREIGN_SIDECAR)) rmSync(FOREIGN_SIDECAR); } catch { /* best-effort */ }
+  try { if (existsSync(STABLE_LAUNCHER)) rmSync(STABLE_LAUNCHER); } catch { /* best-effort */ }
+
+  console.log('');
+  console.log('Done. Restart Claude Code to apply.');
+  console.log('');
+}
+
+// ── Entry ─────────────────────────────────────────────────────────────────────
+
+const isMain = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isMain) {
+  const run = UNINSTALL ? uninstall : install;
+  run().catch(err => {
+    console.error(`${UNINSTALL ? 'Uninstall' : 'Install'} error:`, err.message);
+    process.exit(1);
+  });
+}
+
+export { install as installStatusline, uninstall as uninstallStatusline, LAUNCHER_COMMAND };