@birdybeep/cli 0.8.1 → 0.8.3

package/dist/bin.cjs

@@ -224,10 +224,164 @@ function surfaceRemedy(state, group) {
 // src/framework.ts
 var import_node_fs2 = require("fs");
 var import_agent_core2 = require("@birdybeep/agent-core");
+
+// src/presentation.ts
+var BIRD = [
+  "          \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "        \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "        \u2588\u2588\u2588\u2588\u2594\u2594\u2594\u2594\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "      \u2588\u2588\u2588\u2588\u2588\u2588 \u25AA  \u2588\u2588\u2588\u2588\u2588\u2588",
+  "\u2588\u2588    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588",
+  "      \u2588\u2588      \u2588\u2588",
+  "      \u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588"
+].join("\n");
+function presentation(output, env = process.env) {
+  const terminal = output.isTTY === true && env.TERM !== "dumb";
+  const color = terminal && !env.NO_COLOR;
+  const lime = (text) => {
+    if (!color) return text;
+    const code = /^(truecolor|24bit)$/.test(env.COLORTERM ?? "") ? "38;2;198;242;78" : (env.TERM ?? "").includes("256color") ? "38;5;191" : "92";
+    return `\x1B[${code}m${text}\x1B[0m`;
+  };
+  return {
+    lime,
+    banner: () => terminal ? `
+${lime(BIRD)}
+
+` : "",
+    help: (text) => text.split("\n").map((line, i) => i === 0 || line.endsWith(":") ? lime(line) : line).join("\n")
+  };
+}
+
+// src/bird-animation.ts
+function birdFrame(blink = false, lift = 0, pose = "rest") {
+  const rows = BIRD.split("\n");
+  if (pose === "inhale" || pose === "breathe") {
+    rows[8] = pose === "inhale" ? "   \u2580\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2580" : "  \u2580\u2580\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2580\u2580";
+  } else if (pose === "crouch" || pose === "land") {
+    rows.splice(7, 1);
+    rows.unshift("");
+    rows[7] = "  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[8] = "    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[9] = "      \u2588\u2588      \u2588\u2588";
+  } else if (pose === "stretch") {
+    rows[4] = "      \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[5] = "  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[6] = "    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[7] = "    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[9] = "      \u2588\u2588      \u2588\u2588";
+    rows[10] = "      \u2580\u2580      \u2580\u2580";
+  } else if (pose === "flight") {
+    rows[4] = "\u2588\u2588    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[5] = "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2572\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[6] = "  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2572\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[7] = "    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588";
+    rows[9] = "        \u2580\u2580  \u2580\u2580";
+    rows[10] = "";
+  }
+  if (blink)
+    rows[pose === "crouch" || pose === "land" ? 4 : 3] = rows[pose === "crouch" || pose === "land" ? 4 : 3].replace(" \u25AA  ", " \u2501  ");
+  return [...Array(2 - lift).fill(""), ...rows, ...Array(lift).fill("")].join("\n");
+}
+var HOP = [
+  { pose: "crouch", lift: 0, ms: 180 },
+  { pose: "stretch", lift: 1, ms: 80 },
+  { pose: "flight", lift: 2, ms: 130 },
+  { pose: "flight", lift: 2, ms: 110 },
+  { pose: "stretch", lift: 1, ms: 90 },
+  { pose: "land", lift: 0, ms: 140 },
+  { pose: "inhale", lift: 0, ms: 120 },
+  { pose: "rest", lift: 0, ms: 180 }
+];
+function createBirdAnimation(output, env = process.env) {
+  const allowed = () => output.isTTY === true && env.TERM !== "dumb" && !env.CI && env.BIRDYBEEP_ANIMATION !== "0" && (output.columns ?? 80) >= 26 && (output.rows ?? 40) >= 16;
+  const style = presentation(output, env);
+  let activeStop;
+  const begin = () => {
+    activeStop?.();
+    if (!allowed()) return void 0;
+    let stopped = false;
+    let timer;
+    const paint = (frame, rewind = false) => {
+      output.write(
+        (rewind ? "\x1B[13A" : "") + frame.split("\n").map((line) => `\r\x1B[2K${style.lime(line)}
+`).join("")
+      );
+    };
+    const finish = (clear) => {
+      if (stopped) return;
+      stopped = true;
+      if (timer) clearInterval(timer);
+      process.off("exit", stop);
+      process.stdout.off("resize", resize);
+      if (clear) output.write("\x1B[13A" + "\r\x1B[2K\n".repeat(13) + "\x1B[13A\r");
+      activeStop = void 0;
+    };
+    const stop = () => finish(true);
+    const resize = () => {
+      stopped = true;
+      if (timer) clearInterval(timer);
+      process.off("exit", stop);
+      process.stdout.off("resize", resize);
+      activeStop = void 0;
+    };
+    process.once("exit", stop);
+    process.stdout.once("resize", resize);
+    activeStop = stop;
+    paint(birdFrame());
+    return {
+      stop,
+      settle: () => finish(false),
+      draw: (frame) => {
+        if (!stopped) {
+          paint(frame, true);
+        }
+      },
+      repeat: (callback) => {
+        timer = setInterval(callback, 140);
+        timer.unref();
+      }
+    };
+  };
+  return {
+    wait: () => {
+      const canvas = begin();
+      if (!canvas) return () => {
+      };
+      let tick = 0;
+      canvas.repeat(() => {
+        tick += 1;
+        const phase = tick % 22;
+        const pose = phase >= 8 && phase <= 10 ? "breathe" : phase >= 6 && phase <= 12 ? "inhale" : "rest";
+        canvas.draw(birdFrame(phase === 18, 0, pose));
+      });
+      return canvas.stop;
+    },
+    celebrate: async () => {
+      const canvas = begin();
+      if (!canvas) return;
+      try {
+        for (const { pose, lift, ms } of HOP) {
+          canvas.draw(birdFrame(pose === "land", lift, pose));
+          await new Promise((resolve) => setTimeout(resolve, ms));
+        }
+      } finally {
+        canvas.settle();
+      }
+    }
+  };
+}
+
+// src/framework.ts
 var EXIT = { OK: 0, ERROR: 1, USAGE: 2 };
-function createIo(json, stdout, stderr) {
+function createIo(json, stdout, stderr, animate = false) {
   return {
     json,
+    ...!json && animate ? { bird: createBirdAnimation(stdout) } : {},
     line: (text) => {
       if (!json) stdout.write(`${text}
 `);
@@ -358,7 +512,8 @@ function renderCommandHelp(path, command) {
 }
 async function dispatch(argv, deps) {
   const { flags, rest } = parseGlobalFlags(argv);
-  const io = createIo(flags.json, deps.stdout, deps.stderr);
+  const io = createIo(flags.json, deps.stdout, deps.stderr, !flags.nonInteractive);
+  const style = presentation(deps.stdout);
   if (deps.ensureConfig !== false) {
     try {
       (0, import_node_fs2.mkdirSync)((0, import_agent_core2.birdyBeepConfigDir)(), { recursive: true, mode: 448 });
@@ -386,7 +541,7 @@ async function dispatch(argv, deps) {
     }
   }
   if (rest.length === 0 || flags.help && command === void 0) {
-    io.emit(renderRootHelp(deps.version, deps.commands), {
+    io.emit(style.banner() + style.help(renderRootHelp(deps.version, deps.commands)), {
       version: deps.version,
       commands: deps.commands.map((c) => ({
         name: c.name,
@@ -402,7 +557,7 @@ async function dispatch(argv, deps) {
   }
   const path = pathParts.join(" ");
   if (flags.help) {
-    io.emit(renderCommandHelp(path, command), {
+    io.emit(style.help(renderCommandHelp(path, command)), {
       name: path,
       summary: command.summary,
       usage: command.usage,
@@ -424,6 +579,10 @@ async function dispatch(argv, deps) {
   }
   let code;
   try {
+    if (!flags.nonInteractive && (path === "setup" || path === "pair")) {
+      const banner = style.banner();
+      if (banner) io.line(banner.trimEnd());
+    }
     code = await command.run({ args, flags, io });
   } catch (err) {
     if (err instanceof MissingInputError) {
@@ -813,6 +972,7 @@ var import_node_crypto = require("crypto");
 var import_node_fs4 = require("fs");
 var import_node_os2 = require("os");
 var import_node_path2 = require("path");
+var import_node_perf_hooks = require("perf_hooks");
 var import_agent_core5 = require("@birdybeep/agent-core");
 var import_claude_code4 = require("@birdybeep/claude-code");
 var import_codex3 = require("@birdybeep/codex");
@@ -833,6 +993,21 @@ var HOOK_HARNESSES = [
   "copilot"
 ];
 var STDIN_READ_TIMEOUT_MS = 3e3;
+var LEGACY_HOOK_RUNTIME_BUDGET_MS = 9e3;
+function hookRuntimeBudgetMs(configuredTimeoutSeconds) {
+  if (configuredTimeoutSeconds === void 0 || !Number.isFinite(configuredTimeoutSeconds) || configuredTimeoutSeconds <= 0) {
+    return LEGACY_HOOK_RUNTIME_BUDGET_MS;
+  }
+  const configuredBudgetMs = Math.max(1, Math.floor(configuredTimeoutSeconds * 1e3) - 1e3);
+  return Math.min(LEGACY_HOOK_RUNTIME_BUDGET_MS, configuredBudgetMs);
+}
+function configuredHookTimeoutSeconds(harness) {
+  if (harness === "claude") return (0, import_claude_code4.configuredClaudeHookTimeoutSeconds)();
+  if (harness === "codex") return (0, import_codex3.configuredCodexHookTimeoutSeconds)();
+  if (harness === "cursor") return (0, import_cursor4.configuredCursorHookTimeoutSeconds)();
+  if (harness === "copilot") return (0, import_copilot3.configuredCopilotHookTimeoutSeconds)();
+  return void 0;
+}
 function withTimeout(promise, ms, fallback) {
   return new Promise((resolve) => {
     let settled = false;
@@ -953,15 +1128,22 @@ function detachCodexNotifyWorker(payload) {
   }
 }
 function createHookCommand(deps = {}) {
-  const makeSender = deps.createSender ?? ((baseUrl) => (0, import_agent_core5.createSender)({ baseUrl }));
+  const makeSender = deps.createSender ?? ((baseUrl, budgetMs) => (0, import_agent_core5.createSender)({
+    baseUrl,
+    timeoutMs: Math.min(import_agent_core5.DEFAULT_SEND_TIMEOUT_MS, budgetMs),
+    totalBudgetMs: budgetMs
+  }));
   const readStdin = deps.readStdin ?? readStdinDefault;
   const stdinTimeoutMs = deps.stdinTimeoutMs ?? STDIN_READ_TIMEOUT_MS;
+  const now = deps.now ?? (() => import_node_perf_hooks.performance.now());
+  const readConfiguredHookTimeoutSeconds = deps.configuredHookTimeoutSeconds ?? configuredHookTimeoutSeconds;
   const detachCodexNotify = deps.detachCodexNotify ?? detachCodexNotifyWorker;
   return {
     name: "hook",
     summary: "Internal: normalize + send an event fired by a harness hook",
     usage: "birdybeep hook <claude|codex|opencode|cursor|copilot> [copilot-event]",
     run: async (ctx) => {
+      const hookStartedAt = now();
       const harness = ctx.args[0];
       if (!isHarnessName(harness)) {
         ctx.io.errline(`birdybeep hook: expected one of ${HOOK_HARNESSES.join("|")}`);
@@ -1027,7 +1209,10 @@ function createHookCommand(deps = {}) {
         );
         return EXIT.ERROR;
       }
-      const sender = makeSender(resolveApiUrl());
+      const runtimeBudgetMs = hookRuntimeBudgetMs(readConfiguredHookTimeoutSeconds(harness));
+      const elapsedMs = Math.max(0, now() - hookStartedAt);
+      const budgetMs = Math.max(1, Math.min(import_agent_core5.DEFAULT_TOTAL_BUDGET_MS, runtimeBudgetMs - elapsedMs));
+      const sender = makeSender(resolveApiUrl(), budgetMs);
       const result = await runHookCommand(harness, payload, sender, copilotEventName);
       ctx.io.result({
         harness: handler,
@@ -1188,7 +1373,7 @@ async function pairTokenPoll(apiUrl, deviceCode, fetchImpl, machineFingerprint,
 }
 
 // src/version.ts
-var CLI_VERSION = "0.8.1".length > 0 ? "0.8.1" : "0.0.0";
+var CLI_VERSION = "0.8.3".length > 0 ? "0.8.3" : "0.0.0";
 
 // src/commands/setup.ts
 var import_claude_code5 = require("@birdybeep/claude-code");
@@ -1741,32 +1926,39 @@ function createPairingCommand(verb, deps = {}) {
       let lastBeat = startedAt;
       let paired;
       let terminal;
-      for (; ; ) {
-        const nowMs = clock();
-        if (nowMs >= deadline) break;
-        await sleep(intervalMs);
-        const poll = await pairTokenPoll(
-          apiUrl,
-          start.device_code,
-          fetchImpl,
-          identity.fingerprintHash,
-          codeVerifier
-          // PKCE proof-of-possession (dgxd) — sent on every poll
-        );
-        if (poll.status === "paired") {
-          paired = poll;
-          break;
-        }
-        if (poll.status === "error" && !poll.retryable) {
-          terminal = poll;
-          break;
-        }
-        if (!ctx.flags.json && nowMs - lastBeat >= HEARTBEAT_MS) {
-          ctx.io.line(
-            poll.status === "error" ? `   Backend unavailable (${poll.message}); retrying.` : "   Waiting for approval in the BirdyBeep app."
+      let stopBird = ctx.io.bird?.wait();
+      try {
+        for (; ; ) {
+          const nowMs = clock();
+          if (nowMs >= deadline) break;
+          await sleep(intervalMs);
+          const poll = await pairTokenPoll(
+            apiUrl,
+            start.device_code,
+            fetchImpl,
+            identity.fingerprintHash,
+            codeVerifier
+            // PKCE proof-of-possession (dgxd) — sent on every poll
           );
-          lastBeat = nowMs;
+          if (poll.status === "paired") {
+            paired = poll;
+            break;
+          }
+          if (poll.status === "error" && !poll.retryable) {
+            terminal = poll;
+            break;
+          }
+          if (!ctx.flags.json && nowMs - lastBeat >= HEARTBEAT_MS) {
+            stopBird?.();
+            ctx.io.line(
+              poll.status === "error" ? `   Backend unavailable (${poll.message}); retrying.` : "   Waiting for approval in the BirdyBeep app."
+            );
+            lastBeat = nowMs;
+            stopBird = ctx.io.bird?.wait();
+          }
         }
+      } finally {
+        stopBird?.();
       }
       if (terminal !== void 0) {
         ctx.io.result({ paired: false, reason: terminal.code });
@@ -1814,6 +2006,7 @@ function createPairingCommand(verb, deps = {}) {
       const humanSuffix = approvedBy !== void 0 ? ` to ${approvedBy}` : "";
       const discardedSuffix = discarded > 0 ? ` Discarded ${discarded} event(s) queued before pairing. They will not produce notifications.` : "";
       const nextStep = chain === void 0 ? " Run `birdybeep setup` to install coding-agent hooks." : "";
+      await ctx.io.bird?.celebrate();
       ctx.io.line(`\u2713 Paired${humanSuffix}.${nextStep}${discardedSuffix}`);
       const report = chain !== void 0 ? await runSetupChain(ctx, setupDeps, pairFlags) : void 0;
       ctx.io.result({