pendingyou 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.19.0 (2026-10-06)
+
+- The Stop check lets a turn end on a recap of cards already waiting on you. It asked the agent to go on whenever its
+  last message had something for you and the turn posted no card, so a closing line like “Two cards are waiting on
+  you: CLI 0.18.0 (publish it) and the Herdr check (does the amber title show in the sidebar?).” was asked to go on,
+  and Claude Code showed each of those as a “Stop hook error”. Now:
+  - A recap counts as posted, for what it says: a sentence that says its cards wait on you (“Two cards are waiting on
+    you: …”, “the card is still open for your answer”, “both cards are in your queue”, “… (both cards).”), or a heading
+    that does, or names your cards (“**Cards waiting for you:**”, “Your open cards:”), with the list under it.
+    Anything else in the message for you is checked as before, so a new ask beside a recap still goes on a card. Cards
+    that aren't said to wait on you (“the two cards line up”, “add a credit card”) are no recap.
+  - So does a card said to be coming, or one an item already is: “a card is coming”, “there'll be a card”, “I'll
+    create a card”, “that one is already a card”, as “I'll send you a card” and “it's on a card” already did.
+  - Anything else for you, in a message that talks about cards (not a credit card, a SIM card or a card number), is
+    taken as a recap while this folder has a card waiting on you: one request (this folder's open cards, the one the
+    next-message hook makes), made only for such a message and given up after 1.5 seconds. None open: the agent is
+    asked to go on, as before. A permission prompt's card doesn't count. When Pending You can't say (offline, slow, an
+    older server), the turn ends.
+  - Everything else is as before: an ask to type something here, a question handed to the agent, once a turn at most,
+    quiet when not signed in, silent on any error, the 3-second deadline. Codex's, OpenCode's and Pi's Stop checks do
+    the same, each asking for its own app's cards.
+- Hooks run the copy `init` installed: run `npx pendingyou@latest init` once to switch.
+
 ## 0.18.0 (2026-10-05)
 
 - Presence says which terminal: in a Herdr pane (`HERDR_ENV=1` with `HERDR_BIN_PATH` and `HERDR_PANE_ID`), every

package/README.md

@@ -205,6 +205,13 @@ can", "waiting on you" and the like; or a list under a heading like "Your part",
 you" or "Left for you". It lets the turn end when the message says nothing needs a card ("No card needed.", "Nothing
 needs your attention.", "There's nothing waiting on you.").
 
+Since 0.19.0 it also lets the turn end on a recap of cards already waiting on you. A sentence that says its cards wait
+on you ("Two cards are waiting on you: …", "… (both cards).") covers what it asks, and so does a heading that does
+("Cards waiting for you:") over its list; anything else for you in the message is checked as before, so a new ask
+beside a recap still goes on a card. And anything else for you, in a message that talks about cards, is taken as a
+recap while this folder has a card waiting on you: only such a message costs a request (this folder's open cards,
+given up after 1.5 seconds), and when Pending You can't say, the turn ends.
+
 Since 0.9.0 it also catches a message asking you to type or reply something in Claude Code's own chat ("Reply “yes,
 erase disk12” here", "To confirm, type `yes`", "Confirm here"). Some steps an agent takes only on your own words in
 its conversation, never on a card answer; that's fine, but then a card has to send you there. Unless a card posted in

package/dist/stopcheck.js

@@ -5,17 +5,35 @@ import { APP_NAMES, DEFAULT_APP } from "./apps/ids.js";
 import { asksToTypeHere, cardFits, confirmReason, sessionLink } from "./confirm.js";
 import { readCredential } from "./credentials.js";
 import { isHandedWake } from "./format.js";
-import { isPromptApp, settlePrompts, subagentsRunning } from "./permission.js";
+import { isPermissionCard, isPromptApp, settlePrompts, subagentsRunning } from "./permission.js";
 import { folderForms } from "./pickup.js";
 export const READ_CAP = 4 * 1024 * 1024;
 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.';
 export const DELEGATED_REASON = 'Your person handed you that question to answer, not to ask them back: answer_delegated if you know, or hand_back with what you checked, unless you already did. Never post it as a card of your own.';
 const POSTING_TOOL = /^mcp__.+__(post_request|update_request|reply_in_thread|answer_delegated|hand_back)$/;
-const OPEN_TIME_BOX_MS = 1500;
+export const OPEN_TIME_BOX_MS = 1500;
 const OPEN_CARDS = 5;
 const CARD_TEXT = 20_000;
-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;
+const SAYS_POSTED = new RegExp([
+    String.raw `\b(posted|put|added|raised|filed)\b[^.\n]{0,60}\b(cards?|pending ?you)\b`,
+    String.raw `\bon (a|the|its|their|your|that|this) cards?\b`,
+    String.raw `\b(in|to|through|via|on) pending ?you\b`,
+    String.raw `\bpending ?you cards?\b`,
+    String.raw `\b(i|we|you)(?:(?:'|’)ll| will)\s+(?:\w+\s+)?(post|send|put|add|raise|file|get|see|find|make|create|open)\b[^.\n]{0,40}\bcards?\b`,
+    String.raw `\balready (?:a |on (?:a )?)?cards?\b`,
+    String.raw `\bcards? (?:is|are|will be) (?:coming|on (?:its|their|the) way)\b(?! (?:together|along))`,
+    String.raw `\bcards? (?:will|to) follow\b`,
+    String.raw `\bthere(?:(?:'|’)ll| will) be (?:a |another |one )?cards?\b`,
+].join('|'), 'i');
+const RECAP = new RegExp([
+    String.raw `\bcards?\b[^.!?\n]{0,40}?\b(?:(?:waiting|pending|open|parked|queued|left)\b[^.!?\n]{0,20}?\b(?:on|for)\s+your?|in\s+your\s+queue)\b`,
+    String.raw `\b(?:waiting|pending|parked)\s+(?:on|for)\s+you\b[^.!?\n]{0,30}?\b(?:as|in)\s+(?:(?:a|two|both|three|its|their|the|separate)\s+)?cards?\b`,
+    String.raw `\((?:(?:both|all|two|three|each)\s+)?(?:(?:are|is|on|as)\s+)?(?:a\s+|(?:its|their)\s+own\s+)?cards?(?:\s+(?:already|too))?\)`,
+].join('|'), 'i');
+const CARDS_HEADING = /\b(?:your|open|pending|waiting)\s+(?:(?:open|pending|waiting)\s+)?cards\b/i;
+const SENTENCE_END = /(?<=[.!?])\s+/;
+const OTHER_CARDS = /\b(?:credit|debit|payment|gift|sim|sd|business|graphics|video|sound|network|memory|smart)\s+cards?\b|\bcards?\s+(?:numbers?|readers?|details|holders?)\b/gi;
 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|(?<!\b(?:no|nothing|none|not)\b[^.,;:!?\n]{0,40})waiting (?:on|for) you|(?<!\bif (?:it|he|she|they|that|this|anything|something|someone|anyone|one) )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;
 const SAYS_NO_CARD = /\bno (?:new |more |further )?cards? (?:is |are )?(?:needed|necessary|required)\b|\b(?:doesn(?:'|’)t|don(?:'|’)t|does not|do not|won(?:'|’)t|will not) need (?:a |any )?(?:new )?cards?\b|\bnothing (?:here |else |more |now )?(?:needs|requires) your (?:attention|input|action|answer)\b|\b(?:nothing|no cards?)\b[^.,;:!?\n]{0,40}\b(?:waiting|pending) (?:on|for) you\b/i;
 const FOR_THEM_HEADING = /\b(your part|your steps?|your to-?dos?|your turn|your call|for you|waiting on you|left for you|parked for you|needs you|over to you|what you need to do|you(?:'|’)ll need)\b/i;
@@ -47,8 +65,7 @@ function headingOf(line) {
         return null;
     return /^\s*#/.test(line) || bare.endsWith(':') || /^\s*\*\*.+\*\*\s*$/.test(line) ? bare : null;
 }
-export function itemsForPerson(text) {
-    const plain = plainText(text);
+function itemsIn(plain) {
     const lines = plain.split('\n');
     for (let index = 0; index < lines.length; index++) {
         const heading = headingOf(lines[index]);
@@ -65,8 +82,50 @@ export function itemsForPerson(text) {
             return 'question';
     return null;
 }
+export function itemsForPerson(text) {
+    return itemsIn(plainText(text));
+}
+function listEnd(lines, index) {
+    let end = index;
+    for (let next = index + 1; next < lines.length; next++) {
+        const line = lines[next];
+        if (!line.trim()) {
+            if (end === index && next - index >= 3)
+                return index;
+        }
+        else if (LIST_ITEM.test(line) || (end > index && /^\s/.test(line)))
+            end = next;
+        else
+            break;
+    }
+    return end;
+}
+function withoutRecaps(plain) {
+    const lines = plain.split('\n');
+    const kept = [];
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        const heading = headingOf(line);
+        if (heading && (RECAP.test(heading) || CARDS_HEADING.test(heading))) {
+            const end = listEnd(lines, index);
+            if (end > index) {
+                index = end;
+                continue;
+            }
+        }
+        kept.push(line
+            .split(SENTENCE_END)
+            .filter((sentence) => !RECAP.test(sentence))
+            .join(' '));
+    }
+    return kept.join('\n');
+}
+export function itemsOutsideRecaps(text) {
+    return itemsIn(withoutRecaps(plainText(text)));
+}
 export const saysPosted = (text) => SAYS_POSTED.test(plainText(text));
 export const saysNoCard = (text) => SAYS_NO_CARD.test(plainText(text));
+export const mentionsCards = (text) => /\bcards?\b/i.test(plainText(text).replace(OTHER_CARDS, ''));
 function wordsIn(value, max = CARD_TEXT) {
     const found = [];
     let left = max;
@@ -306,18 +365,23 @@ export async function stopcheck(io, options) {
                 return 0;
             return asksToTypeHere(text) || itemsForPerson(text) ? block(DELEGATED_REASON) : 0;
         }
+        const cwd = typeof input.cwd === 'string' && input.cwd ? input.cwd : io.cwd;
         const ask = asksToTypeHere(text);
         if (ask) {
             if (saysNoCard(text) || turn.cards.some((card) => cardFits(card, ask.words, 'posted')))
                 return 0;
-            const cwd = typeof input.cwd === 'string' && input.cwd ? input.cwd : io.cwd;
             const open = await openTitles(io, options.origin, cwd, app);
             if (open ? open.some((title) => cardFits(title, ask.words, 'open')) : saysPosted(text))
                 return 0;
             return block(confirmReason(ask.words, sessionLink(io.env), APP_NAMES[app]));
         }
-        if (turn.posted || saysPosted(text) || saysNoCard(text) || !itemsForPerson(text))
+        if (turn.posted || saysPosted(text) || saysNoCard(text) || !itemsOutsideRecaps(text))
             return 0;
+        if (mentionsCards(text)) {
+            const open = await openTitles(io, options.origin, cwd, app);
+            if (open === null || open.some((title) => !isPermissionCard(title)))
+                return 0;
+        }
         return block(STOP_REASON);
     }
     catch {

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.18.0';
+export const VERSION = '0.19.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pendingyou",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Pending You for your coding agents: one command sets up Claude Code, Codex, OpenCode and Pi to ask you through Pending You and hear your answers, even while they sit idle.",
   "license": "Apache-2.0",
   "homepage": "https://www.pendingyou.com",