@birdybeep/cli 0.8.1 → 0.8.3

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-J45QGUDO.js";
+} from "./chunk-NSHPZ3RX.js";
 
 // src/node-check.ts
 var MIN_NODE_MAJOR = 20;

package/dist/{chunk-J45QGUDO.js → chunk-NSHPZ3RX.js}

@@ -1,10 +1,164 @@
 // src/framework.ts
 import { mkdirSync } from "fs";
 import { birdyBeepConfigDir } from "@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}
 `);
@@ -140,7 +294,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 {
       mkdirSync(birdyBeepConfigDir(), { recursive: true, mode: 448 });
@@ -168,7 +323,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,
@@ -184,7 +339,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,
@@ -206,6 +361,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) {
@@ -227,7 +386,7 @@ async function dispatch(argv, deps) {
 }
 
 // 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/agent.ts
 import { claudeCodeAdapter } from "@birdybeep/claude-code";
@@ -820,18 +979,35 @@ import { randomBytes } from "crypto";
 import { closeSync, openSync, rmSync, writeFileSync as writeFileSync2 } from "fs";
 import { tmpdir } from "os";
 import { basename, dirname, join as join2 } from "path";
+import { performance } from "perf_hooks";
 import {
   createSender as defaultCreateSender2,
+  DEFAULT_SEND_TIMEOUT_MS,
+  DEFAULT_TOTAL_BUDGET_MS,
   resolveOnPath
 } from "@birdybeep/agent-core";
-import { isClaudeCodeHookPayload, runClaudeHook } from "@birdybeep/claude-code";
-import { isCodexHookPayload, runCodexHook } from "@birdybeep/codex";
 import {
+  configuredClaudeHookTimeoutSeconds,
+  isClaudeCodeHookPayload,
+  runClaudeHook
+} from "@birdybeep/claude-code";
+import {
+  configuredCodexHookTimeoutSeconds,
+  isCodexHookPayload,
+  runCodexHook
+} from "@birdybeep/codex";
+import {
+  configuredCopilotHookTimeoutSeconds,
   isCopilotHookEventName,
   isCopilotHookPayload,
   runCopilotHook
 } from "@birdybeep/copilot";
-import { isCursorHookEventName, isCursorHookPayload, runCursorHook } from "@birdybeep/cursor";
+import {
+  configuredCursorHookTimeoutSeconds,
+  isCursorHookEventName,
+  isCursorHookPayload,
+  runCursorHook
+} from "@birdybeep/cursor";
 import { isOpenCodeEventPayload, runOpenCodeHook } from "@birdybeep/opencode";
 var RUNNERS = {
   claude: runClaudeHook,
@@ -847,6 +1023,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 configuredClaudeHookTimeoutSeconds();
+  if (harness === "codex") return configuredCodexHookTimeoutSeconds();
+  if (harness === "cursor") return configuredCursorHookTimeoutSeconds();
+  if (harness === "copilot") return configuredCopilotHookTimeoutSeconds();
+  return void 0;
+}
 function withTimeout(promise, ms, fallback) {
   return new Promise((resolve) => {
     let settled = false;
@@ -967,15 +1158,22 @@ function detachCodexNotifyWorker(payload) {
   }
 }
 function createHookCommand(deps = {}) {
-  const makeSender = deps.createSender ?? ((baseUrl) => defaultCreateSender2({ baseUrl }));
+  const makeSender = deps.createSender ?? ((baseUrl, budgetMs) => defaultCreateSender2({
+    baseUrl,
+    timeoutMs: Math.min(DEFAULT_SEND_TIMEOUT_MS, budgetMs),
+    totalBudgetMs: budgetMs
+  }));
   const readStdin = deps.readStdin ?? readStdinDefault;
   const stdinTimeoutMs = deps.stdinTimeoutMs ?? STDIN_READ_TIMEOUT_MS;
+  const now = deps.now ?? (() => 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("|")}`);
@@ -1041,7 +1239,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(DEFAULT_TOTAL_BUDGET_MS, runtimeBudgetMs - elapsedMs));
+      const sender = makeSender(resolveApiUrl(), budgetMs);
       const result = await runHookCommand(harness, payload, sender, copilotEventName);
       ctx.io.result({
         harness: handler,
@@ -1770,32 +1971,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 });
@@ -1843,6 +2051,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({
@@ -2262,4 +2471,4 @@ export {
   buildCommands,
   runCli
 };
-//# sourceMappingURL=chunk-J45QGUDO.js.map
+//# sourceMappingURL=chunk-NSHPZ3RX.js.map