parawatch 0.3.6 → 0.3.7

package/README.md

@@ -167,6 +167,8 @@ An agent claims the project the work is for, not the folder it runs in, and clai
 
 An approval (`ask --action`) shows the exact command and the text it sends, with Do it and Don't, so the human can say yes without opening the session.
 
+The human can dismiss a card that no longer matters, with the x on the card in the app or `parawatch dismiss <card> -n "why"`. The card closes without an answer, and the agent that asked gets "dismissed by the human" at its next `wait` or `inbox`.
+
 `parawatch edit <card>` changes a card after the fact: its kind, wording, task, who asked or `--since`. `parawatch goto <card>` opens the session that asked in the Claude desktop app (`--copy` also puts a line about the card on the clipboard, to paste there); sessions outside the desktop app get the `claude --resume` command instead.
 
 `wait` prints the answers, and news on linked pull requests, and exits with code 0. Run from an agent session, it reads that session's own cards and pull requests, and the ones no session owns in the project it claimed, with a cursor of its own: four sessions in one project each wake only for their own news. `wait -p <project>` reads the whole project, for a lead. With `--timeout <seconds>` it exits with code 2 when nothing came. An answer given before `wait` starts is not lost: each consumer has its own cursor, and `wait` returns everything after it. While a `wait` runs, cards say an agent is waiting; when none does, an answered card says the answer is kept until the agent next checks.

package/dist/bin/cli.js

@@ -2,7 +2,7 @@
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import { Command } from "commander";
-import { UserError, addProject, answerCard, beatRun, claimSession, closeCard, commentCard, inboxScope, editCard, endRun, hideRun, unhideRun, linkPr, listeners, listenersFor, noteRun, openCard, prEvent, findCard, readInbox, readState, removeProject, startListening, startRun, unlinkPr, waitInbox, } from "../core/ops.js";
+import { UserError, addProject, answerCard, beatRun, claimSession, closeCard, dismissCard, commentCard, inboxScope, editCard, endRun, hideRun, unhideRun, linkPr, listeners, listenersFor, noteRun, openCard, prEvent, findCard, readInbox, readState, removeProject, startListening, startRun, unlinkPr, waitInbox, } from "../core/ops.js";
 import { githubConfig, readCache, resolvePrRef, syncGithub, prViews } from "../core/github.js";
 import { digest, digestText, localDate } from "../core/digest.js";
 import { everywhere, readEvents } from "../core/store.js";
@@ -183,6 +183,11 @@ program
     .description("close a card once it has been acted on")
     .option("-n, --note <text>", "what was done")
     .action((id, o) => closeCard(id, o.note));
+program
+    .command("dismiss <card>")
+    .description("close a card that no longer matters, without answering it; the agent that asked is told")
+    .option("-n, --note <text>", "why, for the agent")
+    .action((id, o) => dismissCard(id, o.note));
 program
     .command("show <card>")
     .description("show one card with its answers")

package/dist/core/format.js

@@ -187,6 +187,8 @@ export function inboxLine(i) {
     const head = `[${card.project}] ${card.id} "${card.title}"`;
     if (i.kind === "comment")
         return `${head} comment: ${i.comment}`;
+    if (i.kind === "dismissed")
+        return `${head} dismissed by the human: no longer needed, do not act on it${i.comment ? `; said: ${i.comment}` : ""}`;
     const parts = [];
     if (i.choice !== undefined)
         parts.push(`chose ${i.choice}${i.choiceText ? ` (${i.choiceText})` : ""}`);

package/dist/core/ops.js

@@ -224,6 +224,16 @@ export function closeCard(id, note) {
         return;
     appendEvent(() => ({ type: "card.close", card: card.id, note: note?.trim() || undefined }));
 }
+/**
+ * The human drops a card that no longer matters, without answering it. It closes, and the agent
+ * that asked reads that it was dismissed (a wait wakes for it), so nothing waits on it forever.
+ */
+export function dismissCard(id, note) {
+    const card = requireCard(id);
+    if (card.status === "closed")
+        throw new UserError(`card ${card.id} is already closed`);
+    appendEvent(() => ({ type: "card.close", card: card.id, note: note?.trim() || undefined, dismissed: true }));
+}
 export function startRun(r) {
     if (r.heartbeat !== undefined && (!Number.isFinite(r.heartbeat) || r.heartbeat <= 0))
         throw new UserError("--heartbeat must be a number of seconds above 0");
@@ -385,6 +395,18 @@ export function inboxFrom(events, after, filter, state = readState(events)) {
             out.push({ seq: ev.seq, dev: ev.dev, at: ev.ts, kind: "pr", by: ev.by ?? ev.source, pr: { ref: ev.pr, change: ev.change, title: ev.title, text: ev.text, project: link.project } });
             continue;
         }
+        if (ev.type === "card.close") {
+            // a card the human dismissed reaches the agent that asked, once
+            if (!ev.dismissed || !isAfter(ev, pos))
+                continue;
+            const card = state.cards.get(ev.card);
+            if (!card || !inScope(card.session, card.project, filter, ended))
+                continue;
+            if (filter.card && card.id !== filter.card)
+                continue;
+            out.push({ seq: ev.seq, dev: ev.dev, at: ev.ts, kind: "dismissed", card, by: HUMAN, comment: ev.note });
+            continue;
+        }
         if (ev.type !== "card.answer" && ev.type !== "card.comment")
             continue;
         let late = false;

package/dist/core/state.js

@@ -78,6 +78,8 @@ export function fold(events, map) {
                 c.status = "closed";
                 c.closedAt = ev.ts;
                 c.closeNote = ev.note;
+                if (ev.dismissed)
+                    c.dismissed = true;
                 break;
             }
             case "run.start":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "parawatch",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "A control tower for people running many AI coding agents in parallel: see what is running, what needs you, and wake the right agent when you answer.",
   "keywords": [
     "ai-agents",

package/skills/parawatch/SKILL.md

@@ -93,6 +93,8 @@ The output looks like `[project] c4 "Ship the top-box ending?" chose 2 (Top box)
 3. Close the card with what you did: `parawatch close c4 -n "Top box shipped in #212"`.
 4. If more cards are open, or a linked pull request is not merged yet, arm the wait again.
 
+A card can also come back as `[project] c4 "…" dismissed by the human: no longer needed, do not act on it`. The human closed it without answering. Drop that step, do not open the card again, and go on with the rest of the work.
+
 To add information to a card without waking anyone, use `parawatch comment <card> "<text>"`. Never answer a card yourself: `answer` is the human's.
 
 ## 6. Long jobs that leave no agent log