terminalhire 0.11.1 → 0.12.0

package/dist/bin/jpi-dispatch.js

@@ -13351,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");
@@ -13363,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.");
@@ -13394,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");
@@ -13414,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.");
@@ -13430,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.1",
+  "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 };