@integrity-labs/agt-cli 0.28.466 → 0.28.467

package/dist/bin/agt.js

@@ -40,7 +40,7 @@ import {
   success,
   table,
   warn
-} from "../chunk-CL24G4D3.js";
+} from "../chunk-P5NFIZI4.js";
 import {
   AnchorSessionClient,
   CHANNEL_REGISTRY,
@@ -4830,7 +4830,7 @@ import { execFileSync, execSync } from "child_process";
 import { existsSync as existsSync10, realpathSync as realpathSync2 } from "fs";
 import chalk18 from "chalk";
 import ora16 from "ora";
-var cliVersion = true ? "0.28.466" : "dev";
+var cliVersion = true ? "0.28.467" : "dev";
 async function fetchLatestVersion() {
   const host2 = getHost();
   if (!host2) return null;
@@ -6002,7 +6002,7 @@ function handleError(err) {
 }
 
 // src/bin/agt.ts
-var cliVersion2 = true ? "0.28.466" : "dev";
+var cliVersion2 = true ? "0.28.467" : "dev";
 var program = new Command();
 program.name("agt").description("Augmented CLI \u2014 agent provisioning and management").version(cliVersion2).option("--json", "Emit machine-readable JSON output (suppress spinners and colors)").option("--skip-update-check", "Skip the automatic update check on startup");
 program.hook("preAction", async (thisCommand, actionCommand) => {

package/dist/{chunk-CL24G4D3.js → chunk-P5NFIZI4.js}

@@ -4911,7 +4911,7 @@ function requireHost() {
 }
 
 // src/lib/api-client.ts
-var agtCliVersion = true ? "0.28.466" : "dev";
+var agtCliVersion = true ? "0.28.467" : "dev";
 var lastConfigHash = null;
 function setConfigHash(hash) {
   lastConfigHash = hash && hash.length > 0 ? hash : null;
@@ -7595,4 +7595,4 @@ export {
   managerInstallSystemUnitCommand,
   managerUninstallSystemUnitCommand
 };
-//# sourceMappingURL=chunk-CL24G4D3.js.map
+//# sourceMappingURL=chunk-P5NFIZI4.js.map

package/dist/lib/manager-worker.js

@@ -42,7 +42,7 @@ import {
   resolveEffectivePinRaw,
   safeWriteJsonAtomic,
   setConfigHash
-} from "../chunk-CL24G4D3.js";
+} from "../chunk-P5NFIZI4.js";
 import {
   getProjectDir as getProjectDir2,
   getReadyTasks,
@@ -9976,7 +9976,7 @@ var agentRestartTimezoneInputs = /* @__PURE__ */ new Map();
 var lastVersionCheckAt = 0;
 var VERSION_CHECK_INTERVAL_MS = 5 * 60 * 1e3;
 var lastResponsivenessProbeAt = 0;
-var agtCliVersion = true ? "0.28.466" : "dev";
+var agtCliVersion = true ? "0.28.467" : "dev";
 function resolveBrewPath(execFileSync2) {
   try {
     const out = execFileSync2("which", ["brew"], { timeout: 5e3 }).toString().trim();

package/dist/mcp/index.js

@@ -21057,6 +21057,9 @@ function kanbanStatusLabel(status) {
 function kanbanPriorityLabel(priority) {
   return priority === 1 ? "HIGH" : priority === 3 ? "LOW" : "MED";
 }
+function isHumanAssigned(item) {
+  return item.assignee_type !== void 0 && item.assignee_type !== "agent";
+}
 function groupKanbanByStatus(items) {
   const groups = {};
   for (const item of items) {
@@ -21064,9 +21067,18 @@ function groupKanbanByStatus(items) {
   }
   return groups;
 }
+function renderKanbanItemLine(item) {
+  const pri = kanbanPriorityLabel(item.priority);
+  const est = item.estimated_minutes ? ` ~${item.estimated_minutes}min` : "";
+  const del = item.deliverable ? ` \u2192 ${item.deliverable}` : "";
+  const res = item.result ? ` \u2713 ${item.result}` : "";
+  return `- [${pri}] ${item.title}${est}${del}${res} (id: ${item.id})`;
+}
 function renderKanbanList(items) {
   if (!items.length) return "Board is empty.";
-  const grouped = groupKanbanByStatus(items);
+  const humanAssigned = items.filter(isHumanAssigned);
+  const mine = items.filter((i) => !isHumanAssigned(i));
+  const grouped = groupKanbanByStatus(mine);
   const lines = [];
   const known = new Set(KANBAN_LIST_DISPLAY_ORDER);
   const unknown2 = Object.keys(grouped).filter((s) => !known.has(s));
@@ -21076,16 +21088,92 @@ function renderKanbanList(items) {
     if (!group?.length) continue;
     lines.push(`
 ## ${kanbanStatusLabel(status)} (${group.length})`);
-    for (const item of group) {
-      const pri = kanbanPriorityLabel(item.priority);
-      const est = item.estimated_minutes ? ` ~${item.estimated_minutes}min` : "";
-      const del = item.deliverable ? ` \u2192 ${item.deliverable}` : "";
-      const res = item.result ? ` \u2713 ${item.result}` : "";
-      lines.push(`- [${pri}] ${item.title}${est}${del}${res} (id: ${item.id})`);
+    for (const item of group) lines.push(renderKanbanItemLine(item));
+  }
+  if (humanAssigned.length) {
+    lines.push(`
+## ${HUMAN_ASSIGNED_SECTION_HEADING} (${humanAssigned.length})`);
+    lines.push(HUMAN_ASSIGNED_SECTION_NOTE);
+    for (const item of humanAssigned) {
+      const who = item.assignee_name ? ` [with ${item.assignee_name}]` : "";
+      lines.push(`${renderKanbanItemLine(item)}${who}`);
     }
   }
   return lines.join("\n");
 }
+var HUMAN_ASSIGNED_SECTION_HEADING = "Assigned to a person (not yours to action)";
+var HUMAN_ASSIGNED_SECTION_NOTE = "_These belong to a person, not to you. You cannot move, note or complete them \u2014 every kanban write is refused. If the work is finished (or was never really theirs), use `kanban_recall` to pull the card back onto your board, then close it as normal._";
+
+// src/kanban-write-outcome.ts
+function describeKanbanWriteFailure(failure, label) {
+  if (!failure) return null;
+  switch (failure.reason) {
+    case "assigned_to_human": {
+      const who = failure.assignee_name ? ` (${failure.assignee_name})` : "";
+      return `Can't touch "${label}" \u2014 that card is assigned to a person${who}, not to you, so every kanban write to it is refused. It still shows on your board for visibility. If the work is done (or should come back to you), call kanban_recall with this id first, then move or complete it as normal.`;
+    }
+    case "ambiguous_match": {
+      const candidates = failure.candidates ?? [];
+      if (candidates.length === 0) {
+        return `"${label}" matched more than one card. Retry with the card's id.`;
+      }
+      const listed = candidates.map((c) => `  - ${c.title} [${c.status}] (id: ${c.id})`).join("\n");
+      return `"${label}" matched ${candidates.length} cards. Retry with one of these ids:
+${listed}`;
+    }
+    case "invalid_transition":
+      return `Can't move "${label}" from ${failure.from ?? "its current status"} to ${failure.to ?? "that status"} \u2014 closed cards are not reopened this way. Add a new card if the work has genuinely restarted.`;
+    case "not_found":
+      return null;
+    // The caller's existing "not found" message is correct here.
+    default:
+      return `Couldn't update "${label}": ${failure.reason}.`;
+  }
+}
+function selectKanbanFailure(data, match) {
+  const failures = data?.failed_updates ?? [];
+  if (failures.length === 0) return void 0;
+  const exact = failures.find(
+    (f) => match.id !== void 0 && f.id === match.id || match.title !== void 0 && f.title === match.title
+  );
+  if (exact) return exact;
+  return failures.length === 1 ? failures[0] : void 0;
+}
+function describeKanbanWriteOutcome(data, match, label, onSuccess) {
+  if ((data?.updated ?? 0) > 0) return { text: onSuccess(), isError: false };
+  const explained = describeKanbanWriteFailure(selectKanbanFailure(data, match), label);
+  return { text: explained ?? `Item "${label}" not found.`, isError: true };
+}
+function describeKanbanRecallResult(data, requestedId) {
+  if (!data) {
+    return {
+      text: `Recall of ${requestedId} returned nothing. The card is still with the person it was assigned to.`,
+      isError: true
+    };
+  }
+  if (data.ok !== true) {
+    if (data.reason === "not_found") {
+      return {
+        text: `No card with id ${requestedId} on your board. You can only recall a card you assigned yourself - check the id against kanban_list.`,
+        isError: true
+      };
+    }
+    return {
+      text: `Recall of ${requestedId} was refused${data.reason ? `: ${data.reason}` : ""}. The card is still with the person it was assigned to.`,
+      isError: true
+    };
+  }
+  if (data.reason === "already_agent_assigned") {
+    return {
+      text: `"${data.title ?? requestedId}" is already on your board - nothing to recall. You can act on it directly.`,
+      isError: false
+    };
+  }
+  return {
+    text: `Recalled "${data.title ?? requestedId}" onto your board (status: ${data.status ?? "unchanged"}). It is yours to act on now - close it with kanban_done and a result if the work is finished.`,
+    isError: false
+  };
+}
 
 // src/token-refresh-selection.ts
 var REFRESH_WINDOW_MS = 10 * 6e4;
@@ -21479,9 +21567,13 @@ function buildKanbanLogUpdate(params) {
   if (params.title) update.title = params.title;
   return { update };
 }
-function formatKanbanLogResult(label, data) {
+function formatKanbanLogResult(label, data, match = {}) {
   if (data.updated < 1) {
-    return { text: `Item "${label}" not found.`, isError: true };
+    const explained = describeKanbanWriteFailure(
+      selectKanbanFailure(data, match),
+      label ?? ""
+    );
+    return { text: explained ?? `Item "${label}" not found.`, isError: true };
   }
   const trimmed = data.updated_items?.some((i) => i.notes_truncated) ?? false;
   return {
@@ -21922,14 +22014,16 @@ server.tool(
         }
       ]
     });
-    const label = params.id ?? params.title;
+    const label = params.id ?? params.title ?? "";
+    const outcome = describeKanbanWriteOutcome(
+      data,
+      { id: params.id, title: params.title },
+      label,
+      () => `Moved "${label}" \u2192 ${params.status}.`
+    );
     return {
-      content: [
-        {
-          type: "text",
-          text: data.updated > 0 ? `Moved "${label}" \u2192 ${params.status}.` : `Item "${label}" not found.`
-        }
-      ]
+      content: [{ type: "text", text: outcome.text }],
+      ...outcome.isError ? { isError: true } : {}
     };
   }
 );
@@ -21963,6 +22057,18 @@ server.tool(
         isError: true
       };
     }
+    if (isHumanAssigned(match)) {
+      const who = match.assignee_name ? ` (${match.assignee_name})` : "";
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Can't update "${match.title}" \u2014 that card is assigned to a person${who}, not to you. Call kanban_recall with id ${match.id} to bring it back onto your board first.`
+          }
+        ],
+        isError: true
+      };
+    }
     const data = await apiPost("/host/kanban", {
       agent_id: AGT_AGENT_ID,
       update: [
@@ -21974,13 +22080,15 @@ server.tool(
         }
       ]
     });
+    const outcome = describeKanbanWriteOutcome(
+      data,
+      { id: match.id },
+      match.title,
+      () => `Updated "${match.title}".`
+    );
     return {
-      content: [
-        {
-          type: "text",
-          text: data.updated > 0 ? `Updated "${match.title}".` : "Update failed."
-        }
-      ]
+      content: [{ type: "text", text: outcome.text }],
+      ...outcome.isError ? { isError: true } : {}
     };
   }
 );
@@ -22008,7 +22116,10 @@ server.tool(
     );
     const { text, isError } = formatKanbanLogResult(
       params.id ?? params.title,
-      data
+      data,
+      // ENG-8281: pass the match so a refusal can be attributed and explained
+      // (e.g. "assigned to a person — recall it first") instead of "not found".
+      { id: params.id, title: params.title }
     );
     return { content: [{ type: "text", text }], ...isError ? { isError: true } : {} };
   }
@@ -22040,14 +22151,16 @@ server.tool(
         }
       ]
     });
-    const label = params.id ?? params.title;
+    const label = params.id ?? params.title ?? "";
+    const outcome = describeKanbanWriteOutcome(
+      data,
+      { id: params.id, title: params.title },
+      label,
+      () => params.step.trim().length > 0 ? `Progress on "${label}": ${params.step}` : `Cleared progress step on "${label}".`
+    );
     return {
-      content: [
-        {
-          type: "text",
-          text: data.updated > 0 ? params.step.trim().length > 0 ? `Progress on "${label}": ${params.step}` : `Cleared progress step on "${label}".` : `Item "${label}" not found.`
-        }
-      ]
+      content: [{ type: "text", text: outcome.text }],
+      ...outcome.isError ? { isError: true } : {}
     };
   }
 );
@@ -22090,15 +22203,17 @@ server.tool(
         }
       ]
     });
-    const label = params.id ?? params.title;
+    const label = params.id ?? params.title ?? "";
     const deliveryNote = params.suppress_delivery === true ? " Delivery suppressed (recorded on the card only)." : params.suppress_delivery === false ? " Delivery asserted." : "";
+    const outcome = describeKanbanWriteOutcome(
+      data,
+      { id: params.id, title: params.title },
+      label,
+      () => `Marked "${label}" as done.${params.result ? ` Result: ${params.result}` : ""}${deliveryNote}`
+    );
     return {
-      content: [
-        {
-          type: "text",
-          text: data.updated > 0 ? `Marked "${label}" as done.${params.result ? ` Result: ${params.result}` : ""}${deliveryNote}` : `Item "${label}" not found.`
-        }
-      ]
+      content: [{ type: "text", text: outcome.text }],
+      ...outcome.isError ? { isError: true } : {}
     };
   }
 );
@@ -22281,6 +22396,33 @@ server.tool(
     }
   }
 );
+server.tool(
+  "kanban_recall",
+  'Pull a card you assigned to a HUMAN teammate back onto your own board. Use this when a card shows under "Assigned to a person" in kanban_list and you need to act on it - typically because the person finished the work (or it is no longer needed) and the card has to be closed. While a card is assigned to a person, every kanban write to it is refused; recall makes it yours again so kanban_move / kanban_done / kanban_log work. Recall does NOT complete the card - after recalling, close it yourself with kanban_done and a result. You can only recall a card you assigned.',
+  {
+    id: external_exports.string().describe('The card id, exactly as kanban_list shows it under "Assigned to a person".'),
+    reason: external_exports.string().optional().describe(
+      `Short note on why you are taking it back (e.g. "Brad confirmed the merge, closing it out"). Recorded in the audit trail - the card leaves a person's queue, so say why.`
+    )
+  },
+  async (params) => {
+    try {
+      const data = await apiPost("/host/kanban/recall", {
+        agent_id: AGT_AGENT_ID,
+        id: params.id,
+        reason: params.reason
+      });
+      const { text, isError } = describeKanbanRecallResult(data, params.id);
+      return { content: [{ type: "text", text }], ...isError ? { isError: true } : {} };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: `Could not recall card ${params.id}: ${msg}` }],
+        isError: true
+      };
+    }
+  }
+);
 server.tool(
   "status_standup",
   "Submit a daily standup update with yesterday, today, and blockers.",
@@ -23709,6 +23851,9 @@ var LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
   "kanban_assign",
   "kanban_reassign",
   "assign_kanban_to_human",
+  // ENG-8281: the inverse of assign_kanban_to_human — take a human-assigned
+  // card back so the agent can finally close it.
+  "kanban_recall",
   // ENG-6953: agent + people directory lookup (always registered locally).
   "directory_lookup",
   "status_standup",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integrity-labs/agt-cli",
-  "version": "0.28.466",
+  "version": "0.28.467",
   "description": "Augmented Team CLI — agent provisioning and management",
   "type": "module",
   "engines": {