@popoverinstall/cli 0.4.1 → 0.6.0

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}

package/dist/welcome.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The first screen anyone sees: what the installer hands off to the moment it finishes.
+ *
+ * The aardvark, a box saying what this is, and a single question — log in? — that Enter
+ * answers. Everything past that point is the existing device flow in `login.ts`; this
+ * module owns the framing and the one keypress, not the protocol.
+ *
+ * Two things it must never do:
+ *
+ * 1. **Block a non-interactive install.** The installer only hands off when it has a
+ *    terminal, but `popover welcome` is a real command and can be piped or run in CI. With no
+ *    TTY it prints the same next steps the installer used to print and exits 0.
+ * 2. **Fail the install.** A machine with popover on it and no login is a fine outcome — the
+ *    user runs `popover login` later. Every exit here is 0 unless the login itself was
+ *    attempted and failed.
+ */
+/** Re-exported from where they now live, alongside the send-off that uses them. */
+export { BRAND, TAGLINE, TAGLINE_SECONDARY } from "./next-steps.js";
+export interface WelcomeOptions {
+    apiUrl: string;
+}
+export declare function welcome({ apiUrl }: WelcomeOptions): Promise<number>;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../src/welcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,mFAAmF;AACnF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDzE"}

package/dist/welcome.js

@@ -0,0 +1,128 @@
+/**
+ * The first screen anyone sees: what the installer hands off to the moment it finishes.
+ *
+ * The aardvark, a box saying what this is, and a single question — log in? — that Enter
+ * answers. Everything past that point is the existing device flow in `login.ts`; this
+ * module owns the framing and the one keypress, not the protocol.
+ *
+ * Two things it must never do:
+ *
+ * 1. **Block a non-interactive install.** The installer only hands off when it has a
+ *    terminal, but `popover welcome` is a real command and can be piped or run in CI. With no
+ *    TTY it prints the same next steps the installer used to print and exits 0.
+ * 2. **Fail the install.** A machine with popover on it and no login is a fine outcome — the
+ *    user runs `popover login` later. Every exit here is 0 unless the login itself was
+ *    attempted and failed.
+ */
+import { loadCredentials } from "@popoverinstall/shared";
+import { aardvarkLines } from "./aardvark.js";
+import { sceneLines } from "./scene.js";
+import { login } from "./login.js";
+import { BRAND, TAGLINE, TAGLINE_SECONDARY, nextSteps } from "./next-steps.js";
+import { badge, box, glyph, line, step, style, trunk, wrap } from "./theme.js";
+/** Re-exported from where they now live, alongside the send-off that uses them. */
+export { BRAND, TAGLINE, TAGLINE_SECONDARY } from "./next-steps.js";
+export async function welcome({ apiUrl }) {
+    const alreadyConnected = Boolean(loadCredentials());
+    console.log("");
+    // The full scene where there is room for it, the aardvark on its own where there is not.
+    for (const row of sceneLines() ?? aardvarkLines())
+        console.log(row);
+    // Wrapped before styling, and to the window rather than to a fixed number: the second
+    // line is long enough that an 80-column terminal is the tight case, not the roomy one.
+    const room = Math.max(28, (process.stdout.columns ?? 80) - 8);
+    box({
+        title: badge(`Welcome to ${BRAND}`),
+        lines: [
+            "",
+            ...wrap(TAGLINE, room).map(style.bold),
+            ...wrap(TAGLINE_SECONDARY, room).map(style.dim),
+            "",
+        ],
+        // Keeps the box at least as wide as the aardvark above it, so the two read as one block.
+        minWidth: 36,
+    });
+    if (alreadyConnected) {
+        trunk();
+        step("This machine is already connected.");
+        nextSteps();
+        return 0;
+    }
+    // No terminal to ask into: say what to run and get out of the way.
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        trunk();
+        step(`Log in to ${BRAND}:`);
+        line(style.bold("popover login"));
+        nextSteps();
+        return 0;
+    }
+    trunk();
+    const answer = await ask(`Log in to ${BRAND} ${style.dim("(opens browser)")}`);
+    trunk();
+    if (answer === "skip") {
+        step("Skipped. Run this when you are ready:");
+        line(style.bold("popover login"));
+        nextSteps();
+        return 0;
+    }
+    const code = await login(apiUrl, { framed: true });
+    if (code === 0)
+        nextSteps();
+    return code;
+}
+/**
+ * The one question in the flow.
+ *
+ * Enter is the answer — the prompt is phrased as the action rather than a yes/no, so a bare
+ * Enter means "do it". `s`, `n` and `q` skip, which covers "skip", "no" and "quit" without a
+ * menu. Ctrl-C, Escape and a closed stdin all resolve to a skip rather than throwing,
+ * because the installer is the parent process and a half-finished login is not a failure.
+ *
+ * Read raw rather than through readline, for two reasons. A single keypress is what "just
+ * hit enter" means — with readline, `s` would need an Enter after it. And readline owns the
+ * cursor on the line it prompted on: it repositions after the echoed newline, so the next
+ * thing printed lands on the prompt line instead of below it.
+ */
+function ask(question) {
+    step(style.bold(question));
+    // The one instruction on screen, so it is the one thing not dimmed: bright white against a
+    // flow that is otherwise deliberately quiet.
+    const hint = `${style.white("press enter")}${style.dim(" to continue")}` +
+        `${style.dim(`   ${glyph.dot}   s to skip`)}`;
+    process.stdout.write(`${style.dim(glyph.trunk)}  ${hint}  `);
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            stdin.removeListener("data", onData);
+            stdin.removeListener("end", onEnd);
+            stdin.setRawMode?.(wasRaw ?? false);
+            stdin.pause();
+            // Raw mode swallowed the echo of whatever ended this, so close the line ourselves.
+            console.log("");
+            resolve(result);
+        };
+        const onData = (chunk) => {
+            for (const key of chunk) {
+                if (key === "\r" || key === "\n")
+                    return done("go");
+                // Ctrl-C, Ctrl-D and Escape: in raw mode these arrive as bytes, not as signals.
+                if (key === "\x03" || key === "\x04" || key === "\x1b")
+                    return done("skip");
+                if (/[nsq]/i.test(key))
+                    return done("skip");
+            }
+        };
+        const onEnd = () => done("skip");
+        stdin.setRawMode?.(true);
+        stdin.setEncoding("utf8");
+        stdin.resume();
+        stdin.on("data", onData);
+        stdin.on("end", onEnd);
+    });
+}
+//# sourceMappingURL=welcome.js.map

package/dist/welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../src/welcome.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popoverinstall/cli",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "See your teammates' active Claude Code agents and ask them questions.",
   "keywords": [
     "claude",
@@ -33,14 +33,15 @@
     "dist",
     "plugin",
     ".claude-plugin",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -b",
     "prepack": "node ../../scripts/stage-plugin.mjs && tsc -b"
   },
   "dependencies": {
-    "@popoverinstall/daemon": "0.4.1",
-    "@popoverinstall/shared": "0.4.1"
+    "@popoverinstall/daemon": "0.6.0",
+    "@popoverinstall/shared": "0.6.0"
   }
 }

package/plugin/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "popover",
   "displayName": "Popover",
   "description": "See your teammates' active Claude Code agents and ask them questions. A read-only fork answers from the agent's full context without interrupting your teammate.",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "author": {
     "name": "Quolabs"
   },

package/plugin/README.md

@@ -5,12 +5,22 @@ Installed into Claude Code; see the repo root README for the whole system.
 ```
 .claude-plugin/plugin.json   metadata only
 commands/team.md             the /team command
+commands/fork.md             the /fork command
 hooks/hooks.json             status feed (auto-discovered)
 .mcp.json                    bundled MCP server (auto-discovered)
-mcp/index.mjs                team_list + team_ask, zero dependencies
+mcp/index.mjs                team_list + team_ask + team_tell, zero dependencies
 scripts/                     hook handlers, zero dependencies
 ```
 
+`/team` reaches the daemon through the MCP server. `/fork` deliberately does not: it shells
+out to the `popover` binary instead, because opening a fork has to work for someone who is
+not signed in and may have no daemon running at all. That also means it adds nothing to the
+IPC protocol, and cannot regress asks, tells, or the roster.
+
+It is the one command that needs to know which session it is in, which it gets from
+`${CLAUDE_SESSION_ID}` — substituted into the command body by Claude Code, so there is no
+guessing at "the newest transcript in this directory".
+
 ## Three things that will bite you
 
 **Do not declare `hooks` or `mcpServers` in `plugin.json`.** Both `hooks/hooks.json` and

package/plugin/commands/fork.md

@@ -0,0 +1,118 @@
+---
+description: Share this conversation as a fork a teammate can carry on, or open one you were sent
+# Quoted because an unquoted value starting with `[` is parsed as a YAML flow sequence,
+# which fails and silently drops EVERY field here, allowed-tools included.
+argument-hint: "[create|open] [code]"
+allowed-tools: Bash(popover fork *), AskUserQuestion
+---
+
+# Fork this conversation
+
+The user ran `/popover:fork`. Arguments, which may be empty: **$ARGUMENTS**
+
+This session's id is `${CLAUDE_SESSION_ID}`. You will need it for `create`.
+
+A fork is not an ask. An ask sends a teammate's question to a read-only copy of someone's
+session and brings back one answer. A fork hands over **the whole conversation**, frozen at
+the moment it was made, and the person who opens it gets their own local chat that continues
+from there. Nothing they do in it comes back here.
+
+The first word of the arguments chooses what to do. Follow exactly one of these paths.
+
+## 1. `create` — freeze this conversation and get a code
+
+Run:
+
+```
+popover fork create --session ${CLAUDE_SESSION_ID} --json
+```
+
+On `ok: true`, show the user the code on its own line so it is easy to copy, then tell them,
+briefly and in this order:
+
+- Who it is for and how they open it: `popover fork open <code>`, or
+  `npx @popoverinstall/cli fork open <code>` if they do not have popover yet.
+- That the code stops working in 24 hours, but a chat someone has already opened does not —
+  it is theirs from then on.
+- That it is frozen at `last_turn_at`, so nothing said after this point is included. If they
+  keep working and want the newer state shared, they run `create` again for a new code.
+- That this sends the entire conversation, including the contents of every file read into
+  it. Say it plainly, once. It is a much larger disclosure than an ask and the user should
+  make it deliberately.
+
+On `ok: false`, relay `message` and the `hints` verbatim. Do not retry with different flags.
+
+## 2. `open <code>` — take delivery of a fork
+
+Run:
+
+```
+popover fork open <the code they typed> --json
+```
+
+On `ok: false`, relay `message` and `hints` and stop.
+
+On `ok: true`, tell them what arrived: who shared it, the title if there is one,
+`entry_count` messages, when it was frozen, and which repo it came from. Then surface
+whatever the output flags:
+
+- `repo_match: "different"` — say which repo it came from and which one they are in, and
+  that the conversation will refer to files they may not have.
+- `repo_match: "unknown"` — they are not in a git repository, so paths in it may not resolve.
+- `version_skew` — relay it as a note, not a blocker.
+- `claude_problem` — this one *is* a blocker. Relay it and stop.
+
+Then explain why this needs a window of its own, and offer the choice.
+
+**A fork cannot open inside this chat.** A running Claude Code session cannot become a
+different session — one chat holds one conversation, and this one already has its own. So
+the fork starts as a second session in a new window. If this conversation has real context
+in it already, say that plainly; if the user only just started here, one short line is
+enough.
+
+Then call `AskUserQuestion` with exactly these two options, so Esc cancels:
+
+- **Open a new window** — "Start the fork in its own terminal window"
+- **Print the command** — "Show the command and let me run it myself"
+
+If they choose to open a new window, run:
+
+```
+popover fork launch <stage_id> --json
+```
+
+Then report what happened: `opened: true` means a window is on its way, and it is worth
+adding that the fork may take a moment to appear. `opened: false` is not a failure — it
+happens over SSH, in a container, and anywhere there is no window to open — so show them
+`command` and the `cwd` to run it in.
+
+If they choose to print the command, run the same thing with `--here` instead of no flag,
+and show them the `command` it prints. `--here` writes the fork without trying to open
+anything.
+
+If they press Esc, stop. Nothing has been written to their machine yet, and there is nothing
+to clean up.
+
+## 3. No arguments, or anything else
+
+Say what the two halves do in two lines, and stop:
+
+`/popover:fork create` · `/popover:fork open PQRS-2345-BCDF-7892`
+
+Do not create a fork on the user's behalf just because they ran the command with no
+arguments. Sharing a conversation is a disclosure, and it should always be something they
+asked for in as many words.
+
+## Rules
+
+- Never invent or guess at a code. If what they typed is rejected, relay that and let them
+  paste it again — a code is 16 characters in four groups and is easy to truncate.
+- Never print a code the user has not seen; it is the entire credential and the decryption
+  key for the conversation behind it.
+- A fork is one-way. If the user seems to want an answer rather than to hand over the whole
+  conversation, say that `/popover:team ask` is the cheaper thing and offer it instead.
+- Do not run `create` and then immediately `open` the result to "test" it. Every open counts
+  against what the sharer sees, and the fork is already verified by the command exiting
+  cleanly.
+- `popover fork revoke <code>` destroys a snapshot early. It cannot recall a copy someone
+  has already opened; if the user is worried about that, say so rather than reassuring them.

package/plugin/commands/team.md

@@ -1,9 +1,9 @@
 ---
-description: See your team's active Claude Code agents in this repo and ask one of them a question
+description: See your team's active Claude Code agents in this repo, ask one a question, or tell one something
 # Quoted because an unquoted value starting with `[` is parsed as a YAML flow sequence,
 # which fails and silently drops EVERY field here, allowed-tools included.
-argument-hint: "[agent-handle] [question]"
-allowed-tools: mcp__plugin_popover_popover__team_list, mcp__plugin_popover_popover__team_ask, AskUserQuestion
+argument-hint: "[ask|tell] [agent-handle] [question or message]"
+allowed-tools: mcp__plugin_popover_popover__team_list, mcp__plugin_popover_popover__team_ask, mcp__plugin_popover_popover__team_tell, AskUserQuestion
 ---
 
 # Team agents
@@ -11,25 +11,24 @@ allowed-tools: mcp__plugin_popover_popover__team_list, mcp__plugin_popover_popov
 The user ran `/popover:team`. Arguments, which may be empty: **$ARGUMENTS**
 
 Only agents working in **this repo** are visible. A teammate running Claude Code in a
-different repository is neither listed nor askable, so an empty roster means nobody else is
+different repository is neither listed nor reachable, so an empty roster means nobody else is
 working *here* — not that the team is idle. Say it that way if it comes up.
 
-Follow exactly one of these three paths.
+The first word of the arguments chooses what to do. Follow exactly one of these paths.
 
 ## 1. No arguments — show the roster
 
 Call `mcp__plugin_popover_popover__team_list`, then print what it returns **verbatim** in a
 fenced block. Do not reformat it, re-sort it, or add agents that are not in it.
 
-Then add one short line telling the user they can ask any of these agents a question, e.g.
-`/popover:team B1 why did you rule out redis?`
+Then add one short line showing both forms:
+`/popover:team ask B1 why did you rule out redis?` · `/popover:team tell B1 the migration is applied`
 
-Stop there. Do not ask a question on the user's behalf.
+Stop there. Do not ask or tell anything on the user's behalf.
 
-## 2. A handle and a question — ask it
+## 2. `ask <handle> <question>` — ask it and wait
 
-If the arguments name an agent (a handle like `B1`, a person's name, or a repo) followed
-by a question, call `mcp__plugin_popover_popover__team_ask` with:
+Call `mcp__plugin_popover_popover__team_ask` with:
 
 - `target`: the handle or name they used, exactly as typed
 - `question`: the rest of their message, as a self-contained question — the answering
@@ -43,21 +42,46 @@ When the answer comes back, show it clearly attributed:
 Then say how it bears on what you are working on, if it does. If the tool returns an
 error, relay it plainly — do not retry a different agent unless the user asks.
 
-## 3. A question with no clear target — pick one
+## 3. `tell <handle> <message>` — send it, expect nothing back
+
+Call `mcp__plugin_popover_popover__team_tell` with:
+
+- `target`: the handle or name they used, exactly as typed
+- `message`: the rest of their message, made self-contained the same way — it arrives with
+  no context of its own, so name the thing rather than referring to it
+
+There is no answer. Confirm what was sent and to whom, in one line, and stop:
+
+> Told **B1** (Bob Chen): the repo_keys migration is applied on prod.
+
+A tell is for facts about shared state that would otherwise cause a collision. If the user
+is trying to give another agent instructions or hand it work, say that a tell does not do
+that — the receiving agent is told to treat it as information rather than a directive — and
+offer to ask instead.
+
+## 4. A question or message with no clear target — pick one
 
 Call `mcp__plugin_popover_popover__team_list` first. Then:
 
-- If exactly one agent plausibly fits, ask it and say which one you chose and why.
+- If exactly one agent plausibly fits, use it and say which one you chose and why.
 - If several fit, call `AskUserQuestion` with up to 4 of them as options (label = the
-  handle, description = owner, repo, and what it is doing). Then ask the chosen one.
+  handle, description = owner, repo, and what it is doing). Then use the chosen one.
 - If none fit, say so and show the roster instead.
 
+If it is unclear whether the user meant to ask or to tell, prefer **ask** — it interrupts
+nobody and costs only the answering machine some tokens, whereas a tell puts text into a
+colleague's context and notifies them.
+
 ## Rules
 
 - Never invent a handle. Only use ones `team_list` returned. A handle from earlier in this
-  conversation may since have gone out of scope; if `team_ask` says it does not match,
-  relay that rather than guessing at another agent.
-- Asking costs the *teammate* money and runs on *their* machine. One question per
-  request; do not fan out to several agents unless explicitly asked.
-- The answer comes from a read-only copy of their session. Their live session is not
-  interrupted and cannot be modified by this.
+  conversation may since have gone out of scope; if the tool says it does not match, relay
+  that rather than guessing at another agent.
+- Asking costs the *teammate* money and runs on *their* machine. Telling costs their
+  attention and notifies them. One per request either way; do not fan out to several agents
+  unless explicitly asked.
+- An answer comes from a read-only copy of their session. Their live session is not
+  interrupted and cannot be modified by an ask.
+- A tell **is** delivered into their live session, before its next prompt. That is the one
+  thing in popover that reaches a running agent, so treat it as something the user should have
+  meant to do.

package/plugin/hooks/hooks.json

@@ -23,6 +23,12 @@
             "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/emit-event.mjs"],
             "async": true,
             "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/deliver-messages.mjs"],
+            "timeout": 5
           }
         ]
       }

package/plugin/mcp/index.mjs

@@ -23,6 +23,7 @@ const SERVER_INFO = {
   ).version,
 };
 
+
 const TOOLS = [
   {
     name: "team_list",
@@ -73,6 +74,40 @@ const TOOLS = [
     },
     annotations: { readOnlyHint: true, openWorldHint: true, title: "Ask a teammate's agent" },
   },
+  {
+    name: "team_tell",
+    description:
+      "Send a short heads-up to a teammate's agent working in this repo. Unlike team_ask " +
+      "there is no answer: the message is delivered into that agent's context before its " +
+      "next prompt, and nothing comes back. Use it for facts about shared state that would " +
+      "otherwise cause a collision — \"the migration is applied on prod\", \"I am rewriting " +
+      "globals.css, leave it alone\". Do not use it to give another agent instructions or " +
+      "assign it work: the receiving agent is told to treat your message as information " +
+      "from outside its conversation, not as a directive, and its user is notified that you " +
+      "sent it. Only agents in the same repository can be told, and you are limited to 10 " +
+      "messages an hour to any one agent.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        target: {
+          type: "string",
+          description:
+            "Which agent to tell: a handle from team_list such as 'B1', or a teammate's " +
+            "name, or a repo name.",
+        },
+        message: {
+          type: "string",
+          description:
+            "The heads-up, in one or two sentences. It arrives with no context of its own, " +
+            "so name the thing you are talking about rather than referring to it.",
+        },
+      },
+      required: ["target", "message"],
+      additionalProperties: false,
+    },
+    // Not read-only: this writes into someone else's context and notifies a person.
+    annotations: { readOnlyHint: false, openWorldHint: true, title: "Tell a teammate's agent" },
+  },
 ];
 
 // ---------------------------------------------------------------------------
@@ -157,6 +192,39 @@ async function callTeamAsk(args) {
   return text(`Answer from ${attribution}:\n\n${answer.answer}${cost}`);
 }
 
+async function callTeamTell(args) {
+  const target = typeof args?.target === "string" ? args.target.trim() : "";
+  const message = typeof args?.message === "string" ? args.message.trim() : "";
+
+  if (!target) return errorText("`target` is required — call team_list to see the options.");
+  if (!message) return errorText("`message` is required.");
+
+  const reply = await request(
+    {
+      t: "tell",
+      id: rpcId(),
+      req: {
+        target,
+        message,
+        ...(callerSessionId() ? { fromSessionId: callerSessionId() } : {}),
+      },
+      cwd: process.cwd(),
+    },
+    { timeoutMs: 15000 },
+  );
+
+  if (!reply) return errorText(daemonDownMessage());
+  if (reply.t === "error") return errorText(explain(reply));
+  if (reply.t !== "tell.ok") return errorText("The popover daemon returned an unexpected response.");
+
+  // Says delivered-to, never read-by: a sender is deliberately told nothing about what
+  // happened to their message afterwards.
+  return text(
+    `Sent to ${reply.handle} (${reply.ownerName}). It will reach that agent before its next ` +
+      `prompt; there is no reply.`,
+  );
+}
+
 function explain(errorReply) {
   switch (errorReply.code) {
     // The daemon knows whether credentials are missing or merely unusable; relaying its
@@ -247,6 +315,7 @@ async function handle(message) {
       try {
         if (name === "team_list") return reply(id, await callTeamList());
         if (name === "team_ask") return reply(id, await callTeamAsk(params?.arguments ?? {}));
+        if (name === "team_tell") return reply(id, await callTeamTell(params?.arguments ?? {}));
         return replyError(id, -32602, `Unknown tool: ${name}`);
       } catch (err) {
         // A thrown handler must not kill the server; report it as a failed tool call.

package/plugin/scripts/deliver-messages.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+// Delivers tells into a live session.
+//
+// This is the one hook in the plugin that writes to stdout on purpose. Every other one is
+// registered `async: true` and forbidden from printing, because for UserPromptSubmit stdout
+// is injected into the model's context — see the header of emit-event.mjs. That is precisely
+// the channel a tell needs, so this hook is synchronous and its output is the message.
+//
+// Which makes it the riskiest script here, and it is written accordingly:
+//
+//   - It runs before every prompt the user submits, so it must be fast and must fail open.
+//     A missed heads-up is survivable; a prompt that hangs waiting on a dead daemon is not.
+//   - It prints only what the daemon hands back. The envelope is rendered on this machine
+//     from columns the database filled in, so a sender can neither forge the attribution nor
+//     strip the framing off their own message.
+//   - It stays silent inside a fork. Forks run the plugin's hooks like any other session, and
+//     a fork answering a teammate's question must never be handed a third party's text — its
+//     output goes back to whoever asked.
+
+import { callerSessionId, request } from "./_ipc.mjs";
+
+// The fork runner sets this when it spawns a read-only answer session.
+if (process.env.CLAUDE_CODE_ENTRYPOINT === "popover-fork") process.exit(0);
+
+try {
+  // The payload carries session_id; the environment is the fallback, and one of the two is
+  // always present in a real session. Without a session there is no inbox to drain.
+  let sessionId = callerSessionId();
+  try {
+    const raw = await readStdinQuickly();
+    if (raw) sessionId = JSON.parse(raw)?.session_id || sessionId;
+  } catch {
+    // A malformed payload is not a reason to skip delivery; the env var still identifies us.
+  }
+
+  if (sessionId) {
+    const reply = await request(
+      { t: "pending", id: "hook", fromSessionId: sessionId, limit: 3 },
+      { timeoutMs: 300 },
+    );
+
+    if (reply?.t === "pending.ok" && reply.rendered) {
+      // The whole point of the script. Everything above exists to make this line safe.
+      process.stdout.write(`${reply.rendered}\n`);
+    }
+  }
+} catch {
+  // Fail open, always. Whatever went wrong, the user's prompt must still go through.
+}
+
+process.exit(0);
+
+/**
+ * Read the hook payload, but never wait long for it.
+ *
+ * `readStdin` in _ipc.mjs allows two seconds, which is right for a fire-and-forget reporter
+ * and far too long for something sitting between a keystroke and the model.
+ */
+function readStdinQuickly(timeoutMs = 150) {
+  return new Promise((resolve) => {
+    let data = "";
+    const timer = setTimeout(() => resolve(data), timeoutMs);
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      data += chunk;
+    });
+    process.stdin.on("end", () => {
+      clearTimeout(timer);
+      resolve(data);
+    });
+    process.stdin.on("error", () => {
+      clearTimeout(timer);
+      resolve(data);
+    });
+  });
+}