pendingyou 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.4.0
+
+- The next-message hook's reminder now names this folder's open cards still waiting on you, so a question you answer
+  in chat gets its card cancelled: `Pending You: anything you need from your person also goes on a card. Your open
+  cards here: "Which DNS host?" (req_…); … +2 more. If this message answers or settles one, cancel_request it with
+  answeredHere (or update_request if it changed).` At most 3 cards, newest first, titles cut to 50 characters; the
+  plain reminder when none are open. One small request per message while signed in (answers too while a hold is
+  outstanding), given up after 1.5 seconds; on any error, or against a server that doesn't list open cards yet, the
+  line is the plain reminder.
+- The Stop check no longer asks Claude Code to go on when its message says a card is coming ("you'll get a card to
+  publish it once it's merged", "I'll post a card", "I'll send you a card").
+
 ## 0.3.0
 
 - New Stop hook, `pendingyou stopcheck`: when Claude Code ends a turn with a question for you, a step only you can do

package/README.md

@@ -28,9 +28,13 @@ Deep into a long conversation, Claude Code tends to end a turn with a question f
 "Your part:" list, and not put it in Pending You. Two small things catch that while you're signed in:
 
 - Each message you send carries one line for Claude Code (about 18 tokens): *Pending You: anything you need from your
-  person also goes on a card.*
+  person also goes on a card.* While cards Claude Code posted from this folder are still waiting on you, the same line
+  names them (at most 3, newest first, about 20 tokens each) and asks it to `cancel_request` one with `answeredHere`
+  when your message answers it, so a question you answer in chat doesn't stay in your queue. That costs one small
+  request per message, given up after 1.5 seconds.
 - When Claude Code finishes a turn, `pendingyou stopcheck` looks at its last message. If it has something for you and
-  nothing was posted, updated or replied to in Pending You that turn (and the message doesn't say it's on a card),
+  nothing was posted, updated or replied to in Pending You that turn (and the message doesn't say it's on a card, or
+  that one is coming),
   Claude Code is asked to go on once (about 31 tokens): post them as cards, or say they don't need one. It never asks
   twice in a row.
 

package/dist/format.js

@@ -5,7 +5,7 @@ const MAX_ANSWER = 600;
 const MAX_MESSAGE = 400;
 const MAX_TITLE = 140;
 /** Cuts text to `max` characters on one line, and says so. */
-function clip(text, max) {
+export function clip(text, max) {
     const flat = text.replace(/\s+/g, ' ').trim();
     const chars = [...flat];
     if (chars.length <= max)

package/dist/pickup.js

@@ -3,19 +3,47 @@
 // - `pendingyou pickup` (SessionStart): a new or resumed session picks up answers that arrived while nothing was
 //   running, for questions asked from this folder.
 // - `pendingyou handoff` (UserPromptSubmit): your next message brings a waiting answer with it ("You answered in
-//   Pending You: …"). It only calls Pending You while a hold from this computer is outstanding, so an ordinary message
-//   costs no network call. While signed in, it also adds one short line (REMINDER) to every message, so an assistant
-//   deep in a long conversation still puts what it needs from the person on a card.
+//   Pending You: …"). While signed in, it also adds one short line (REMINDER) to every message, so an assistant
+//   deep in a long conversation still puts what it needs from the person on a card, and that line names this folder's
+//   cards still waiting on the person (openLine), so one they answer in chat gets cancelled with answeredHere. That's
+//   one small request per message (the open cards, and answers too while a hold from this computer is outstanding),
+//   time-boxed short; on any error, or from a server too old to list open cards, the line is the plain reminder.
 //
 // Whatever they print, Claude Code adds to the conversation. A hook must never get in the way: each is time-boxed,
 // prints nothing when there's nothing new, never repeats an answer it handed over, and always exits 0.
 import { getJson, SignInNeeded } from "./api.js";
 import { readCredential } from "./credentials.js";
-import { describe, isClosed } from "./format.js";
+import { clip, describe, isClosed } from "./format.js";
 import { markHanded, momentOf, waitingOn, wasHanded } from "./state.js";
-const TIME_BOX_MS = { pickup: 5000, handoff: 2500 };
+const TIME_BOX_MS = { pickup: 5000, handoff: 2500, open: 1500 };
 /** What every message carries while signed in (about 18 tokens). */
 export const REMINDER = 'Pending You: anything you need from your person also goes on a card.';
+/** The most open cards the line names, and how much of each title. */
+export const OPEN_SHOWN = 3;
+export const OPEN_TITLE = 50;
+/**
+ * The reminder, naming this folder's open cards still waiting on the person when there are any (about 45 tokens plus
+ * 20 a card): `… Your open cards here: "Which DNS host?" (req_…); … +2 more. If this message answers …`.
+ */
+export function openLine(open) {
+    if (typeof open !== 'object' || open === null)
+        return REMINDER;
+    const { requests, total } = open;
+    if (!Array.isArray(requests))
+        return REMINDER;
+    const cards = requests
+        .filter((card) => typeof card?.requestId === 'string' &&
+        /^req_[A-Za-z0-9-]{1,40}$/.test(card.requestId) &&
+        typeof card.title === 'string')
+        .slice(0, OPEN_SHOWN);
+    if (cards.length === 0)
+        return REMINDER;
+    const more = typeof total === 'number' && total > cards.length ? total - cards.length : 0;
+    const named = cards
+        .map((card) => `"${clip(card.title.replaceAll('"', "'"), OPEN_TITLE).text}" (${card.requestId})`)
+        .join('; ');
+    return `${REMINDER} Your open cards here: ${named}${more ? ` +${more} more` : ''}. If this message answers or settles one, cancel_request it with answeredHere (or update_request if it changed).`;
+}
 /** The folder Claude Code says the session is in (the hook's stdin), or where this runs. */
 async function sessionFolder(io) {
     const text = await io.readStdin(500).catch(() => '');
@@ -38,19 +66,28 @@ export function folderForms(cwd, home) {
 export async function pickup(io, options) {
     const { origin, mode } = options;
     let remind = false;
+    let line = REMINDER;
     try {
         const cwd = await sessionFolder(io);
+        // The hand-off hears answers only while a hold from this computer is outstanding; it always asks for open cards.
+        let answers = true;
         if (mode === 'handoff') {
             remind = (await readCredential(io, origin)) !== null;
-            if ((await waitingOn(io, origin)).length === 0)
+            if (!remind)
                 return 0;
+            answers = (await waitingOn(io, origin)).length > 0;
         }
         const query = new URLSearchParams([
             ...folderForms(cwd, io.home).map((form) => ['cwd', form]),
-            ['limit', '5'],
+            ['limit', answers ? '5' : '0'],
+            ...(mode === 'handoff' ? [['open', String(OPEN_SHOWN)]] : []),
         ]);
-        const { status, body } = await getJson(io, origin, `/mcp/cli/answers?${query}`, TIME_BOX_MS[mode], io.signal);
-        if (status !== 200 || !Array.isArray(body.requests))
+        const { status, body } = await getJson(io, origin, `/mcp/cli/answers?${query}`, answers ? TIME_BOX_MS[mode] : TIME_BOX_MS.open, io.signal);
+        if (status !== 200)
+            return 0;
+        if (mode === 'handoff')
+            line = openLine(body.open);
+        if (!answers || !Array.isArray(body.requests))
             return 0;
         const fresh = [];
         for (const heard of body.requests)
@@ -83,6 +120,6 @@ export async function pickup(io, options) {
     }
     finally {
         if (remind)
-            io.out(`${REMINDER}\n`);
+            io.out(`${line}\n`);
     }
 }

package/dist/stopcheck.js

@@ -14,8 +14,11 @@ const CHUNK = 64 * 1024;
 export const STOP_REASON = 'Items for your person are in chat but not in Pending You: post them as cards (ask in both places), or say they don’t need one.';
 /** Tools that put something in front of the person: Pending You's, under any MCP server name. */
 const POSTING_TOOL = /^mcp__.+__(post_request|update_request|reply_in_thread)$/;
-/** Text that says the items are already in Pending You. */
-const SAYS_POSTED = /\b(posted|put|added|raised|filed)\b[^.\n]{0,60}\b(cards?|pending ?you)\b|\bon (a|the|its|their|your|that|this) cards?\b|\b(in|to|through|via|on) pending ?you\b|\bpending ?you cards?\b/i;
+/**
+ * Text that says the items are already in Pending You, or will be: "you'll get a card to publish it once it's merged"
+ * announces a card to come, not a step left in chat.
+ */
+const SAYS_POSTED = /\b(posted|put|added|raised|filed)\b[^.\n]{0,60}\b(cards?|pending ?you)\b|\bon (a|the|its|their|your|that|this) cards?\b|\b(in|to|through|via|on) pending ?you\b|\bpending ?you cards?\b|\b(i|we|you)(?:(?:'|’)ll| will)\s+(?:\w+\s+)?(post|send|put|add|raise|file|get|see|find)\b[^.\n]{0,40}\bcards?\b/i;
 /** Steps only the person can take, said to them. */
 const STEPS_FOR_THEM = /\b(you(?:'|’)ll need to|you will need to|you(?:'|’)ll have to|you will have to|your (?:next )?steps?\b|can you|could you|would you mind|please (?:run|confirm|approve|check|add|set|sign|create|open|paste|reply|send|choose|pick|decide|let me know)|in your terminal|only you can|waiting on you|waiting for you|needs? you to|over to you|parked for you|when you(?:'|’)re ready|up to you|your call\b|is yours\b|say the word|let me know (?:which|whether)|tell me (?:which|whether)|needs? your (?:ok|okay|approval|decision|sign-?off|go-ahead))/i;
 /** A heading over a list of things for the person. */

package/dist/version.js

@@ -1,2 +1,2 @@
 // The command line's version, as published (package.json). A test keeps them the same.
-export const VERSION = '0.3.0';
+export const VERSION = '0.4.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pendingyou",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Pending You for Claude Code: hear your answers from Pending You in the background, and set Claude Code up in one command.",
   "license": "Apache-2.0",
   "homepage": "https://www.pendingyou.com",