vibedate 0.2.1 → 0.3.1

package/dist/{chunk-6NWF2VD7.js → chunk-3VT4EOBX.js}

@@ -432,6 +432,115 @@ function grantLiveConsent(dir = defaultStateDir()) {
 function canShareLive(dir = defaultStateDir()) {
   return createLedger(dir).allows(LIVE_CONSENT_SCOPE);
 }
+var HANDLE_FILE = "handle.json";
+var DEFAULT_HANDLE = "@you";
+var MAX_HANDLE_LEN = 32;
+function handleFilePath(dir) {
+  return path2.join(dir, HANDLE_FILE);
+}
+function stripLeadingAt(handle) {
+  return handle.replace(/^@+/, "");
+}
+function sameHandle(a, b) {
+  return stripLeadingAt(a) === stripLeadingAt(b);
+}
+function normalizeHandle(input) {
+  if (typeof input !== "string") return null;
+  const trimmed = input.trim();
+  if (trimmed.length === 0) return null;
+  const body = stripLeadingAt(trimmed);
+  if (body.length === 0) return null;
+  if (/\s/.test(body) || /[\x00-\x1f\x7f]/.test(body)) return null;
+  const canonical = "@" + body;
+  if (canonical.length > MAX_HANDLE_LEN) return null;
+  return canonical;
+}
+function loadHandle(dir = defaultStateDir()) {
+  try {
+    const raw = readFileSync(handleFilePath(dir), "utf8");
+    const data = JSON.parse(raw);
+    if (typeof data["handle"] !== "string") return DEFAULT_HANDLE;
+    return normalizeHandle(data["handle"]) ?? DEFAULT_HANDLE;
+  } catch {
+    return DEFAULT_HANDLE;
+  }
+}
+function saveHandle(handle, dir = defaultStateDir()) {
+  const canonical = normalizeHandle(handle);
+  if (canonical === null) {
+    throw new Error(
+      `invalid handle: use 1-${MAX_HANDLE_LEN} chars (optional leading '@'), no whitespace`
+    );
+  }
+  mkdirSync(dir, { recursive: true });
+  writeFileSync2(handleFilePath(dir), JSON.stringify({ handle: canonical }, null, 2) + "\n", "utf8");
+  const existing = loadProfile(dir);
+  if (existing !== null) {
+    writeFileSync2(
+      profilePath(dir),
+      JSON.stringify({ ...existing, handle: canonical }, null, 2) + "\n",
+      "utf8"
+    );
+  }
+  return canonical;
+}
+function resolveHandle(dir = defaultStateDir()) {
+  const env = process.env["VIBEDATING_HANDLE"];
+  if (env !== void 0 && env.trim() !== "") {
+    const canonical = normalizeHandle(env);
+    if (canonical !== null) return canonical;
+  }
+  return loadHandle(dir);
+}
+var BLOCKLIST_FILE = "blocklist.json";
+function blocklistPath(dir) {
+  return path2.join(dir, BLOCKLIST_FILE);
+}
+function persistBlocklist(blocked, dir) {
+  mkdirSync(dir, { recursive: true });
+  writeFileSync2(blocklistPath(dir), JSON.stringify({ blocked }, null, 2) + "\n", "utf8");
+}
+function loadBlocklist(dir = defaultStateDir()) {
+  try {
+    const raw = readFileSync(blocklistPath(dir), "utf8");
+    const data = JSON.parse(raw);
+    if (!Array.isArray(data["blocked"])) return [];
+    return data["blocked"].filter((h) => typeof h === "string");
+  } catch {
+    return [];
+  }
+}
+function isBlocked(handle, dir = defaultStateDir()) {
+  const want = stripLeadingAt(handle);
+  if (want === "") return false;
+  return loadBlocklist(dir).some((entry) => stripLeadingAt(entry) === want);
+}
+function addBlock(handle, dir = defaultStateDir()) {
+  const canonical = normalizeHandle(handle);
+  if (canonical === null) {
+    throw new Error(
+      `invalid handle: use 1-${MAX_HANDLE_LEN} chars (optional leading '@'), no whitespace`
+    );
+  }
+  const list = loadBlocklist(dir);
+  if (list.some((e) => sameHandle(e, canonical))) return { blocked: list, changed: false };
+  const blocked = [...list, canonical];
+  persistBlocklist(blocked, dir);
+  return { blocked, changed: true };
+}
+function removeBlock(handle, dir = defaultStateDir()) {
+  const canonical = normalizeHandle(handle);
+  if (canonical === null) {
+    throw new Error(
+      `invalid handle: use 1-${MAX_HANDLE_LEN} chars (optional leading '@'), no whitespace`
+    );
+  }
+  const list = loadBlocklist(dir);
+  const blocked = list.filter((e) => !sameHandle(e, canonical));
+  if (blocked.length === list.length) return { blocked: list, changed: false };
+  persistBlocklist(blocked, dir);
+  return { blocked, changed: true };
+}
 
 // src/p2p.ts
 var TOPIC_PREFIX = "vibedate:";
@@ -439,7 +548,7 @@ function leagueTopic(leagueName) {
   return createHash("sha256").update(`${TOPIC_PREFIX}${leagueName}`, "utf8").digest();
 }
 var LIVE_NOTICE = "live discovery: sharing only your handle + league + harness (never raw usage) with same-league peers on the public DHT";
-var MAX_HANDLE_LEN = 64;
+var MAX_HANDLE_LEN2 = 64;
 var MAX_LEAGUE_LEN = 32;
 var MAX_HARNESS_LEN = 64;
 var MAX_HANDSHAKE_LEN = 4096;
@@ -464,7 +573,7 @@ function parseHandshake(raw) {
   const rec = data;
   const handle = rec["handle"];
   const league2 = rec["league"];
-  if (typeof handle !== "string" || handle.length === 0 || handle.length > MAX_HANDLE_LEN) {
+  if (typeof handle !== "string" || handle.length === 0 || handle.length > MAX_HANDLE_LEN2) {
     return null;
   }
   if (typeof league2 !== "string" || league2.length === 0 || league2.length > MAX_LEAGUE_LEN) {
@@ -511,7 +620,9 @@ function recordPeer(hello, dir = defaultStateDir(), now = /* @__PURE__ */ new Da
 }
 async function startDiscovery(opts) {
   const { hello, stateDir = defaultStateDir(), onPeer, onLink, notify = vibeCoreNotify } = opts;
-  const topic = opts.topic ?? leagueTopic(hello.league);
+  const isBlocked2 = opts.isBlocked;
+  const topics = opts.topics ? [...opts.topics] : opts.topic !== void 0 ? [opts.topic] : [leagueTopic(hello.league)];
+  const acceptLeague = opts.acceptLeague ?? ((l) => l === hello.league);
   const { default: Hyperswarm } = await import("hyperswarm");
   const swarm = new Hyperswarm(opts.bootstrap === void 0 ? {} : { bootstrap: opts.bootstrap });
   await swarm.dht.fullyBootstrapped();
@@ -539,7 +650,8 @@ async function startDiscovery(opts) {
           league: frame.league,
           harness: frame.harness
         };
-        if (peer.league !== hello.league) continue;
+        if (!acceptLeague(peer.league)) continue;
+        if (isBlocked2 !== void 0 && isBlocked2(peer.handle)) continue;
         peers.set(remoteKey, peer);
         const { isNew } = recordPeer(peer, stateDir);
         if (isNew) {
@@ -570,17 +682,22 @@ async function startDiscovery(opts) {
     socket.on("error", () => {
     });
   });
-  const discovery = swarm.join(topic, { server: true, client: true });
-  const ready = discovery.flushed().catch(() => void 0);
+  const discoveries = topics.map((t) => swarm.join(t, { server: true, client: true }));
+  const ready = Promise.all(
+    discoveries.map((d) => d.flushed().catch(() => void 0))
+  );
   await ready;
   const refresher = setInterval(() => {
-    void discovery.refresh({ server: true, client: true }).catch(() => {
+    for (const d of discoveries) void d.refresh({ server: true, client: true }).catch(() => {
     });
   }, REFRESH_INTERVAL_MS);
   refresher.unref();
   let closed = false;
   return {
-    topic,
+    topic: topics[0],
+    // primary (first) — kept for back-compat / display
+    topics,
+    // every joined topic (primary first)
     hello,
     peers,
     ready,
@@ -588,9 +705,11 @@ async function startDiscovery(opts) {
       if (closed) return;
       closed = true;
       clearInterval(refresher);
-      try {
-        await swarm.leave(topic);
-      } catch {
+      for (const t of topics) {
+        try {
+          await swarm.leave(t);
+        } catch {
+        }
       }
       await swarm.destroy();
     }
@@ -619,6 +738,22 @@ function leagueIndex(name) {
   if (name === BELOW_LEAGUE) return -1;
   return LEAGUES.findIndex((l) => l.name === name);
 }
+function allLeagueNames() {
+  return [BELOW_LEAGUE, ...LEAGUES.map((l) => l.name)];
+}
+function leaguesWithin(name, width) {
+  const w = Math.max(0, Math.trunc(width));
+  if (name === BELOW_LEAGUE) {
+    return [BELOW_LEAGUE, ...LEAGUES.slice(0, w).map((l) => l.name)];
+  }
+  const center = leagueIndex(name);
+  if (center < 0) return [];
+  const lo = Math.max(0, center - w);
+  const hi = Math.min(LEAGUES.length - 1, center + w);
+  const out = [];
+  for (let i = lo; i <= hi; i++) out.push(LEAGUES[i].name);
+  return out;
+}
 var TOKENS_ENV = "VIBEDATING_TOKENS";
 var DEMO_TOTAL_TOKENS = 234e5;
 var MS_PER_DAY = 864e5;
@@ -721,6 +856,14 @@ export {
   loadProfile,
   grantLiveConsent,
   canShareLive,
+  sameHandle,
+  normalizeHandle,
+  saveHandle,
+  resolveHandle,
+  loadBlocklist,
+  isBlocked,
+  addBlock,
+  removeBlock,
   TOPIC_PREFIX,
   leagueTopic,
   LIVE_NOTICE,
@@ -733,6 +876,8 @@ export {
   BELOW_LEAGUE,
   league,
   leagueIndex,
+  allLeagueNames,
+  leaguesWithin,
   TOKENS_ENV,
   DEMO_TOTAL_TOKENS,
   readUsage,

package/dist/{chunk-5ZJIPMU6.js → chunk-OVO2CQ7X.js}

@@ -2,7 +2,7 @@ import {
   CANDIDATES,
   loadProfile,
   matches
-} from "./chunk-6NWF2VD7.js";
+} from "./chunk-3VT4EOBX.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /** Recognized top-level commands, plus the synthetic help/version. */
-type Command = 'connect' | 'matches' | 'discover' | 'open' | 'live' | 'mcp' | 'help' | 'version' | null;
+type Command = 'connect' | 'matches' | 'discover' | 'open' | 'live' | 'find' | 'handle' | 'block' | 'unblock' | 'blocklist' | 'mcp' | 'help' | 'version' | null;
 interface ParsedArgs {
     readonly command: Command;
     /** Port for `open --port`; undefined means "let the OS pick". */
@@ -9,6 +9,12 @@ interface ParsedArgs {
     readonly live: boolean;
     /** `live --dating`: pick-a-handle mode vs omegle auto-pair. Default false. */
     readonly dating: boolean;
+    /** `discover --any` / `live --any`: match every league (not just ±1). Default false. */
+    readonly any: boolean;
+    /** Positional argument for `handle`/`find` (e.g. `@name`). */
+    readonly arg: string | undefined;
+    /** `live --to <@handle>`: targeted match — auto-open that specific peer. */
+    readonly to: string | undefined;
 }
 /**
  * Parse argv (the slice AFTER the program name) into a command + options.

package/dist/cli.js

@@ -1,23 +1,34 @@
 #!/usr/bin/env node
 import {
   runMcp
-} from "./chunk-5ZJIPMU6.js";
+} from "./chunk-OVO2CQ7X.js";
 import {
   CANDIDATES,
   LIVE_NOTICE,
   TOPIC_PREFIX,
+  addBlock,
+  allLeagueNames,
   canShareLive,
   connectProfile,
   grantLiveConsent,
+  isBlocked,
   league,
   leagueIndex,
+  leagueTopic,
+  leaguesWithin,
+  loadBlocklist,
   loadPeers,
   loadProfile,
   matches,
+  normalizeHandle,
   parseFrame,
   readUsage,
+  removeBlock,
+  resolveHandle,
+  sameHandle,
+  saveHandle,
   startDiscovery
-} from "./chunk-6NWF2VD7.js";
+} from "./chunk-3VT4EOBX.js";
 
 // src/cli.ts
 import readline from "readline";
@@ -1387,26 +1398,54 @@ async function handle(req, res, opts) {
 }
 
 // src/cli.ts
-var VERSION = "0.2.1";
+var VERSION = "0.3.1";
 function parsePort(raw) {
   const n = Number(raw);
   if (!Number.isInteger(n) || n < 1 || n > 65535) return void 0;
   return n;
 }
 function parseArgs(argv) {
-  let out = { command: null, port: void 0, live: false, dating: false };
+  let out = {
+    command: null,
+    port: void 0,
+    live: false,
+    dating: false,
+    any: false,
+    arg: void 0,
+    to: void 0
+  };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--version" || a === "-v") {
-      return { command: "version", port: void 0, live: false, dating: false };
+      return {
+        command: "version",
+        port: void 0,
+        live: false,
+        dating: false,
+        any: false,
+        arg: void 0,
+        to: void 0
+      };
     }
     if (a === "--help" || a === "-h") {
-      return { command: "help", port: void 0, live: false, dating: false };
+      return {
+        command: "help",
+        port: void 0,
+        live: false,
+        dating: false,
+        any: false,
+        arg: void 0,
+        to: void 0
+      };
     }
     if (a === "--live") {
       out = { ...out, live: true };
       continue;
     }
+    if (a === "--any") {
+      out = { ...out, any: true };
+      continue;
+    }
     if (a === "--dating") {
       out = { ...out, dating: true };
       continue;
@@ -1425,10 +1464,24 @@ function parseArgs(argv) {
       if (p !== void 0) out = { ...out, port: p };
       continue;
     }
+    if (a === "--to") {
+      const next = argv[i + 1];
+      if (next !== void 0) {
+        out = { ...out, to: next };
+        i++;
+      }
+      continue;
+    }
+    if (a.startsWith("--to=")) {
+      out = { ...out, to: a.slice("--to=".length) };
+      continue;
+    }
     if (a.startsWith("-")) continue;
-    const known = a === "connect" || a === "matches" || a === "discover" || a === "open" || a === "live" || a === "mcp" || a === "help" ? a : null;
+    const known = a === "connect" || a === "matches" || a === "discover" || a === "open" || a === "live" || a === "find" || a === "handle" || a === "block" || a === "unblock" || a === "blocklist" || a === "mcp" || a === "help" ? a : null;
     if (known !== null && out.command === null) {
       out = { ...out, command: known };
+    } else if (out.arg === void 0) {
+      out = { ...out, arg: a };
     }
   }
   return out;
@@ -1436,9 +1489,30 @@ function parseArgs(argv) {
 function leagueLabel(name) {
   return name === "below-1M" ? "below 1M (not yet in a league)" : `${name} League`;
 }
+function discoveryScope(myLeague, any) {
+  const names = any ? allLeagueNames() : leaguesWithin(myLeague, 1);
+  const ordered = [myLeague, ...names.filter((n) => n !== myLeague)];
+  if (any) {
+    return { topics: ordered.map(leagueTopic), acceptLeague: () => true };
+  }
+  const accepted = new Set(names);
+  return {
+    topics: ordered.map(leagueTopic),
+    acceptLeague: (peerLeague) => accepted.has(peerLeague)
+  };
+}
+function blockedChecker() {
+  return (handle2) => isBlocked(handle2);
+}
+function peerDirection(myLeague, peerLeague, sameBullet = "+") {
+  const d = leagueIndex(peerLeague) - leagueIndex(myLeague);
+  if (d > 0) return { bullet: "\u2191", qual: " \xB7 higher league" };
+  if (d < 0) return { bullet: "\u2193", qual: " \xB7 lower league" };
+  return { bullet: sameBullet, qual: "" };
+}
 async function cmdConnect() {
   const harness = process2.env["VIBEDATING_HARNESS"] ?? "claude-code";
-  const handle2 = process2.env["VIBEDATING_HANDLE"] ?? "@you";
+  const handle2 = resolveHandle();
   const snapshot = await readUsage(harness);
   const profile = connectProfile(snapshot, handle2);
   const lg = league(snapshot.totalTokens);
@@ -1455,6 +1529,28 @@ async function cmdConnect() {
   process2.stdout.write("  \u2022 raw usage stays local \xB7 only league shared\n\n");
   return 0;
 }
+async function cmdHandle(arg) {
+  if (arg === void 0 || arg.trim() === "") {
+    const handle2 = resolveHandle();
+    process2.stdout.write(`${handle2}
+`);
+    const env = process2.env["VIBEDATING_HANDLE"];
+    if (env !== void 0 && env.trim() !== "" && normalizeHandle(env) !== null) {
+      process2.stdout.write("  (env VIBEDATING_HANDLE overrides the persisted handle for this run)\n");
+    }
+    return 0;
+  }
+  try {
+    const canonical = saveHandle(arg);
+    process2.stdout.write(`  handle set \u2192 ${canonical}  (saved to ~/.vibedating/handle.json)
+`);
+    return 0;
+  } catch (err) {
+    process2.stderr.write(`${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
 async function cmdMatches(live) {
   const profile = loadProfile();
   if (!profile) {
@@ -1508,7 +1604,7 @@ async function cmdMatches(live) {
   process2.stdout.write("\n");
   return 0;
 }
-async function cmdDiscover(live) {
+async function cmdDiscover(live, any) {
   const profile = loadProfile();
   if (!profile) {
     process2.stderr.write("Not connected yet. Run `vibedating connect` first.\n");
@@ -1522,27 +1618,39 @@ async function cmdDiscover(live) {
     return 1;
   }
   const hello = {
-    handle: profile.handle,
+    handle: resolveHandle(),
     league: profile.league,
     harness: profile.harness
   };
   process2.stdout.write("\n");
   process2.stdout.write(`  ${LIVE_NOTICE}
 `);
+  const { topics, acceptLeague } = discoveryScope(profile.league, any);
   const session = await startDiscovery({
     hello,
+    topics,
+    acceptLeague,
+    isBlocked: blockedChecker(),
     onPeer: (peer, isNew) => {
+      const { bullet, qual } = peerDirection(profile.league, peer.league);
       process2.stdout.write(
-        `  + ${peer.handle} (${peer.league} \xB7 ${peer.harness})${isNew ? "  \u2190 new match" : ""}
+        `  ${bullet} ${peer.handle} (${peer.league}${qual} \xB7 ${peer.harness})${isNew ? "  \u2190 new match" : ""}
 `
       );
     }
   });
   process2.stdout.write(
-    `  topic: ${TOPIC_PREFIX}${profile.league} \u2192 ${session.topic.toString("hex").slice(0, 12)}\u2026
+    `  topic: ${TOPIC_PREFIX}${profile.league} \u2192 ${session.topic.toString("hex").slice(0, 12)}\u2026${topics.length > 1 ? ` (+${topics.length - 1} more)` : ""}
 `
   );
-  process2.stdout.write("  listening for same-league peers\u2026 (Ctrl+C to stop)\n\n");
+  if (!any && session.peers.size === 0) {
+    process2.stdout.write(
+      "  no one in your league yet \u2014 also listening to adjacent leagues (use --any to match anyone)\n"
+    );
+  }
+  process2.stdout.write(
+    any ? "  listening for ANY league peers\u2026 (Ctrl+C to stop)\n\n" : "  listening for same + adjacent-league peers\u2026 (Ctrl+C to stop)\n\n"
+  );
   await new Promise((resolve) => {
     process2.once("SIGINT", () => resolve());
     process2.once("SIGTERM", () => resolve());
@@ -1570,11 +1678,11 @@ async function cmdOpen(port) {
   ${LIVE_NOTICE}
 `);
     const hello = {
-      handle: profile.handle,
+      handle: resolveHandle(),
       league: profile.league,
       harness: profile.harness
     };
-    void startDiscovery({ hello, onLink: (link) => live.addLink(link) }).then((s) => {
+    void startDiscovery({ hello, isBlocked: blockedChecker(), onLink: (link) => live.addLink(link) }).then((s) => {
       session = s;
     }).catch(() => {
     });
@@ -1598,19 +1706,25 @@ async function cmdOpen(port) {
   await new Promise((resolve) => started.server.close(() => resolve()));
   return 0;
 }
-async function cmdLive(dating) {
+async function cmdLive(dating, any, to) {
   const profile = loadProfile();
   if (!profile) {
     process2.stderr.write("Not connected yet. Run `vibedating connect` first.\n");
     return 1;
   }
+  const target = to !== void 0 ? normalizeHandle(to) : null;
+  if (to !== void 0 && target === null) {
+    process2.stderr.write(`invalid target handle: ${to}
+`);
+    return 1;
+  }
   if (!canShareLive()) grantLiveConsent();
   if (!canShareLive()) {
     process2.stderr.write("Could not enable live discovery. Try `vibedating discover --live`.\n");
     return 1;
   }
   const hello = {
-    handle: profile.handle,
+    handle: resolveHandle(),
     league: profile.league,
     harness: profile.harness
   };
@@ -1618,7 +1732,8 @@ async function cmdLive(dating) {
   process2.stdout.write(`  ${LIVE_NOTICE}
 `);
   process2.stdout.write(
-    dating ? "  dating mode \u2014 /open <handle> to pick a peer\n" : "  omegle mode \u2014 /next to roll a new peer\n"
+    target !== null ? `  targeted \u2014 auto-opening ${target} when they connect (/quit to stop)
+` : dating ? "  dating mode \u2014 /open <handle> to pick a peer\n" : "  omegle mode \u2014 /next to roll a new peer\n"
   );
   const pairing = createPairing();
   pairing.onMatch((link) => {
@@ -1626,8 +1741,9 @@ async function cmdLive(dating) {
       process2.stdout.write("  \xB7 idle \u2014 no peer right now\n");
       return;
     }
+    const { qual } = peerDirection(profile.league, link.hello.league);
     process2.stdout.write(
-      `  \xB7 matched ${link.hello.handle} (${link.hello.league} \xB7 ${link.hello.harness})
+      `  \xB7 matched ${link.hello.handle} (${link.hello.league}${qual} \xB7 ${link.hello.harness})
 `
     );
     link.onMessage((m) => {
@@ -1635,12 +1751,31 @@ async function cmdLive(dating) {
 `);
     });
   });
+  const { topics, acceptLeague } = discoveryScope(profile.league, any);
   const session = await startDiscovery({
     hello,
-    onLink: (link) => pairing.add(link)
+    topics,
+    acceptLeague,
+    isBlocked: blockedChecker(),
+    onLink: (link) => {
+      if (target !== null && !sameHandle(link.hello.handle, target)) {
+        const { qual } = peerDirection(profile.league, link.hello.league);
+        process2.stdout.write(
+          `  + ${link.hello.handle} (${link.hello.league}${qual}) \u2014 not your target
+`
+        );
+        link.close();
+        return;
+      }
+      if (target !== null) {
+        process2.stdout.write(`  \u2605 found ${link.hello.handle} \u2014 auto-opening
+`);
+      }
+      pairing.add(link);
+    }
   });
   process2.stdout.write(
-    `  topic: ${TOPIC_PREFIX}${profile.league} \u2192 ${session.topic.toString("hex").slice(0, 12)}\u2026
+    `  topic: ${TOPIC_PREFIX}${profile.league} \u2192 ${session.topic.toString("hex").slice(0, 12)}\u2026${topics.length > 1 ? ` (+${topics.length - 1} more)` : ""}
 `
   );
   process2.stdout.write("  type to chat \xB7 /next \xB7 /open <handle> \xB7 /quit\n");
@@ -1683,13 +1818,144 @@ async function cmdLive(dating) {
   process2.stdout.write("\n");
   return 0;
 }
+async function cmdFind(targetArg, any) {
+  if (targetArg === void 0 || targetArg.trim() === "") {
+    process2.stderr.write("usage: vibedating find <@handle> [--any]\n");
+    return 1;
+  }
+  const target = normalizeHandle(targetArg);
+  if (target === null) {
+    process2.stderr.write(`invalid handle: ${targetArg}
+`);
+    return 1;
+  }
+  const profile = loadProfile();
+  if (!profile) {
+    process2.stderr.write("Not connected yet. Run `vibedating connect` first.\n");
+    return 1;
+  }
+  if (!canShareLive()) grantLiveConsent();
+  if (!canShareLive()) {
+    process2.stderr.write("Could not enable live discovery. Try `vibedating discover --live`.\n");
+    return 1;
+  }
+  const hello = {
+    handle: resolveHandle(),
+    league: profile.league,
+    harness: profile.harness
+  };
+  process2.stdout.write("\n");
+  process2.stdout.write(`  ${LIVE_NOTICE}
+`);
+  process2.stdout.write(
+    `  looking for ${target} in your league${any ? " (+ every league)" : " + adjacent"}\u2026
+`
+  );
+  let found = false;
+  const { topics, acceptLeague } = discoveryScope(profile.league, any);
+  const session = await startDiscovery({
+    hello,
+    topics,
+    acceptLeague,
+    isBlocked: blockedChecker(),
+    onPeer: (peer) => {
+      const { qual } = peerDirection(profile.league, peer.league);
+      if (sameHandle(peer.handle, target)) {
+        found = true;
+        process2.stdout.write(`  \u2605 found ${peer.handle} (${peer.league}${qual} \xB7 ${peer.harness})
+`);
+      } else {
+        process2.stdout.write(`  + ${peer.handle} (${peer.league}${qual}) \u2014 not your target
+`);
+      }
+    }
+  });
+  process2.stdout.write(
+    `  topic: ${TOPIC_PREFIX}${profile.league} \u2192 ${session.topic.toString("hex").slice(0, 12)}\u2026${topics.length > 1 ? ` (+${topics.length - 1} more)` : ""}
+`
+  );
+  process2.stdout.write("  (Ctrl+C to stop)\n\n");
+  await new Promise((resolve) => {
+    process2.once("SIGINT", () => resolve());
+    process2.once("SIGTERM", () => resolve());
+  });
+  process2.stdout.write("\n  leaving the swarm\u2026\n");
+  await session.close();
+  if (!found) {
+    process2.stdout.write(`  \u2717 ${target} was not found this session
+
+`);
+  } else {
+    process2.stdout.write("\n");
+  }
+  return 0;
+}
+async function cmdBlock(arg) {
+  if (arg === void 0 || arg.trim() === "") {
+    process2.stderr.write("usage: vibedating block <@handle>\n");
+    return 1;
+  }
+  const canonical = normalizeHandle(arg);
+  if (canonical === null) {
+    process2.stderr.write(`invalid handle: ${arg}
+`);
+    return 1;
+  }
+  const { blocked, changed } = addBlock(canonical);
+  process2.stdout.write(
+    changed ? `  blocked ${canonical} (saved to ~/.vibedating/blocklist.json)
+` : `  ${canonical} is already blocked
+`
+  );
+  process2.stdout.write(`  ${blocked.length} handle${blocked.length === 1 ? "" : "s"} blocked
+`);
+  return 0;
+}
+async function cmdUnblock(arg) {
+  if (arg === void 0 || arg.trim() === "") {
+    process2.stderr.write("usage: vibedating unblock <@handle>\n");
+    return 1;
+  }
+  const canonical = normalizeHandle(arg);
+  if (canonical === null) {
+    process2.stderr.write(`invalid handle: ${arg}
+`);
+    return 1;
+  }
+  const { blocked, changed } = removeBlock(canonical);
+  process2.stdout.write(
+    changed ? `  unblocked ${canonical}
+` : `  ${canonical} was not blocked
+`
+  );
+  process2.stdout.write(`  ${blocked.length} handle${blocked.length === 1 ? "" : "s"} blocked
+`);
+  return 0;
+}
+async function cmdBlocklist() {
+  const blocked = loadBlocklist();
+  if (blocked.length === 0) {
+    process2.stdout.write("  (blocklist is empty)\n");
+    return 0;
+  }
+  process2.stdout.write(`  ${blocked.length} blocked handle${blocked.length === 1 ? "" : "s"}:
+`);
+  for (const h of blocked) process2.stdout.write(`  ${h}
+`);
+  return 0;
+}
 var HELP = `vibedating ${VERSION} \u2014 dating by tokens (local-first)
 
 Usage:
   vibedating connect            Read your usage, compute + print your league
   vibedating matches [--live]   List candidates in your league (live peers if any)
-  vibedating discover [--live]  Find live same-league peers over the DHT (opt-in)
-  vibedating live [--dating]    Live chat with same-league peers (omegle /next, or --dating pick)
+  vibedating discover [--live] [--any]  Find live peers over the DHT (your league + adjacent; --any = everyone)
+  vibedating live [--dating] [--any] [--to @handle]  Live chat (your league + adjacent; --any = everyone; /next or --dating pick; --to targets one peer)
+  vibedating find <@handle> [--any]  Search the DHT for one specific handle (\u2605 highlights a match)
+  vibedating handle [@name]     Print or set your handle (persisted; a leading '@' is optional)
+  vibedating block <@handle>    Block a handle \u2014 their hello is dropped (never recorded/paired)
+  vibedating unblock <@handle>  Remove a handle from the blocklist
+  vibedating blocklist          List blocked handles
   vibedating open [--port N]    Serve the local web app (default: random port)
                                 + live A/V video with connected same-league peers
   vibedating mcp                Run the stdio MCP server (profile, matches)
@@ -1701,10 +1967,15 @@ Privacy:
   bucket is ever shared. Live discovery (off by default) shares ONLY your
   handle + league + harness with same-league peers \u2014 opt in with --live.
 
+Matching:
+  discover/live match your league + adjacent (\xB11) tiers by default, so thin
+  leagues and cross-league friends still connect. --any matches every league.
+  find / live --to look for one specific handle instead of the first random peer.
+
 Env:
   VIBEDATING_TOKENS=<n>   Self-report a token count (e.g. 23400000 or 12M)
   VIBEDATING_HARNESS=<h>  Harness id (claude-code, codex, \u2026)
-  VIBEDATING_HANDLE=<@id> Display handle
+  VIBEDATING_HANDLE=<@id> Display handle (one-off override; not persisted)
 `;
 async function main(argv) {
   const parsed = parseArgs(argv);
@@ -1719,14 +1990,24 @@ async function main(argv) {
       return 0;
     case "connect":
       return cmdConnect();
+    case "handle":
+      return cmdHandle(parsed.arg);
+    case "block":
+      return cmdBlock(parsed.arg);
+    case "unblock":
+      return cmdUnblock(parsed.arg);
+    case "blocklist":
+      return cmdBlocklist();
     case "matches":
       return cmdMatches(parsed.live);
     case "discover":
-      return cmdDiscover(parsed.live);
+      return cmdDiscover(parsed.live, parsed.any);
     case "open":
       return cmdOpen(parsed.port);
     case "live":
-      return cmdLive(parsed.dating);
+      return cmdLive(parsed.dating, parsed.any, parsed.to);
+    case "find":
+      return cmdFind(parsed.arg, parsed.any);
     case "mcp":
       await runMcp();
       return 0;

package/dist/index.d.ts

@@ -142,9 +142,31 @@ interface DiscoveryOptions {
     readonly hello: PeerHello;
     /**
      * Override the joined topic (tests pass a random one on an isolated DHT).
-     * Defaults to {@link leagueTopic}`(hello.league)`.
+     * Defaults to {@link leagueTopic}`(hello.league)`. Ignored when {@link topics}
+     * is set.
      */
     readonly topic?: Buffer;
+    /**
+     * ALL topics to join on the one swarm (e.g. your league + adjacent leagues),
+     * so thin pools and cross-league friends still connect. Every topic is
+     * joined, refreshed, and left on close. Defaults to `[topic]` — i.e. a single
+     * own-league topic (the legacy behavior).
+     */
+    readonly topics?: readonly Buffer[];
+    /**
+     * Predicate over an incoming peer's advertised league. Defaults to EXACT
+     * match against `hello.league` — the same privacy invariant as before. Widen
+     * it (e.g. ±1 adjacency via {@link leaguesWithin}) to accept cross-league
+     * peers that arrive on a shared topic.
+     */
+    readonly acceptLeague?: (peerLeague: string) => boolean;
+    /**
+     * Predicate over an incoming peer's advertised handle. A blocked peer's hello
+     * is DROPPED exactly like a wrong-league one — never recorded to peers.json,
+     * never notified, never handed to `onLink`/pairing. Default: nothing blocked.
+     * The CLI passes one backed by the persisted blocklist (~/.vibedating).
+     */
+    readonly isBlocked?: (handle: string) => boolean;
     /** DHT bootstrap nodes; omit for the public DHT. Tests pass a local testnet. */
     readonly bootstrap?: ReadonlyArray<{
         readonly host: string;
@@ -165,15 +187,17 @@ interface DiscoveryOptions {
     readonly notify?: NotifySink;
 }
 interface DiscoverySession {
-    /** The 32-byte topic actually joined. */
+    /** The primary (first) joined topic. See {@link topics} for the full set. */
     readonly topic: Buffer;
+    /** Every topic this session joined (primary first). */
+    readonly topics: readonly Buffer[];
     /** What we broadcast on every connection. */
     readonly hello: PeerHello;
     /** Live peer set, keyed by the remote's public key (hex). */
     readonly peers: ReadonlyMap<string, PeerHello>;
-    /** Resolves when the first DHT announce/lookup round for the topic completes. */
+    /** Resolves when the first DHT announce/lookup round for every topic completes. */
     readonly ready: Promise<unknown>;
-    /** Leave the topic and destroy the node. Idempotent. */
+    /** Leave every topic and destroy the node. Idempotent. */
     close(): Promise<void>;
 }
 /**
@@ -222,6 +246,29 @@ declare function league(totalTokens: number): {
 };
 /** Index of a league name in {@link LEAGUES}; {@link BELOW_LEAGUE} → -1. */
 declare function leagueIndex(name: string): number;
+/**
+ * Every league name on the ladder: {@link BELOW_LEAGUE} first (it sits just
+ * below the 1M tier), then each {@link LEAGUES} name in ascending order.
+ * Pure; returns a fresh array each call.
+ */
+declare function allLeagueNames(): string[];
+/**
+ * League names whose index is within ±`width` of `name`'s index on the ladder,
+ * clamped to the array bounds. Ascending (index order), de-duplicated.
+ *
+ * Edge-case decisions:
+ *   - **{@link BELOW_LEAGUE}** is treated as "index -1" — it sits just below the
+ *     1M tier, so `width` extends ONLY upward into the ladder
+ *     (`leaguesWithin('below-1M', 1) → ['below-1M', '1M']`). This mirrors the
+ *     existing `matches()` rule that below-1M is adjacent only to 1M.
+ *   - **Unknown league names** (not in {@link LEAGUES}, not {@link BELOW_LEAGUE})
+ *     return `[]` — we can't place them on the ladder, so they have no
+ *     neighborhood.
+ *   - **Negative width** is clamped to 0 (self only); non-integer width is
+ *     truncated.
+ *   - **Width larger than the ladder** is clamped to the bounds (whole ladder).
+ */
+declare function leaguesWithin(name: string, width: number): string[];
 /** Env var that holds a self-reported total token count (e.g. `23400000`). */
 declare const TOKENS_ENV = "VIBEDATING_TOKENS";
 /**
@@ -277,4 +324,4 @@ declare const CANDIDATES: readonly Candidate[];
  */
 declare function matches(myLeague: string, candidates?: readonly Candidate[]): Candidate[];
 
-export { BELOW_LEAGUE, CANDIDATES, type Candidate, DEMO_TOTAL_TOKENS, type DiscoveryOptions, type DiscoverySession, LEAGUES, LIVE_NOTICE, type League, type PeerHello, type StoredPeer, TOKENS_ENV, TOPIC_PREFIX, league, leagueIndex, leagueTopic, loadPeers, matches, parseHandshake, parseTokensEnv, readUsage, recordPeer, serializeHandshake, startDiscovery, tryReadVerifiedUsage };
+export { BELOW_LEAGUE, CANDIDATES, type Candidate, DEMO_TOTAL_TOKENS, type DiscoveryOptions, type DiscoverySession, LEAGUES, LIVE_NOTICE, type League, type PeerHello, type StoredPeer, TOKENS_ENV, TOPIC_PREFIX, allLeagueNames, league, leagueIndex, leagueTopic, leaguesWithin, loadPeers, matches, parseHandshake, parseTokensEnv, readUsage, recordPeer, serializeHandshake, startDiscovery, tryReadVerifiedUsage };

package/dist/index.js

@@ -6,10 +6,12 @@ import {
   LIVE_NOTICE,
   TOKENS_ENV,
   TOPIC_PREFIX,
+  allLeagueNames,
   createConsentLedger,
   league,
   leagueIndex,
   leagueTopic,
+  leaguesWithin,
   loadPeers,
   matches,
   parseHandshake,
@@ -19,7 +21,7 @@ import {
   serializeHandshake,
   startDiscovery,
   tryReadVerifiedUsage
-} from "./chunk-6NWF2VD7.js";
+} from "./chunk-3VT4EOBX.js";
 export {
   BELOW_LEAGUE,
   CANDIDATES,
@@ -28,10 +30,12 @@ export {
   LIVE_NOTICE,
   TOKENS_ENV,
   TOPIC_PREFIX,
+  allLeagueNames,
   createConsentLedger,
   league,
   leagueIndex,
   leagueTopic,
+  leaguesWithin,
   loadPeers,
   matches,
   parseHandshake,

package/dist/mcp.js

@@ -1,7 +1,7 @@
 import {
   runMcp
-} from "./chunk-5ZJIPMU6.js";
-import "./chunk-6NWF2VD7.js";
+} from "./chunk-OVO2CQ7X.js";
+import "./chunk-3VT4EOBX.js";
 export {
   runMcp
 };

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "vibedate",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Dating by tokens — matched by usage league across agentic CLIs. Raw usage stays local; only your league is shared. CLI + local web app + MCP. Local-first.",
   "type": "module",
   "license": "MIT",
   "author": "Pooria Arab",
   "bin": {
-    "vibedating": "./dist/cli.js"
+    "vibedate": "./dist/cli.js",
+    "vibedating": "./dist/cli.js",
+    "vibedate-mcp": "./dist/mcp.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -35,7 +37,8 @@
     "hyperdht": "^6.33.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.0",
+    "werift": "^0.24.1"
   },
   "homepage": "https://github.com/pooriaarab/vibedating#readme",
   "repository": {