@markus-global/cli 0.6.3 → 0.6.4

package/dist/markus.mjs

@@ -6544,10 +6544,11 @@ var init_context_engine = __esm({
           if (opts.assignedTasks && opts.assignedTasks.length > 0) {
             const priorityOrder = ["critical", "high", "medium", "low"];
             const byPriority = (a, b) => priorityOrder.indexOf(a.priority ?? "medium") - priorityOrder.indexOf(b.priority ?? "medium");
+            const CLOSED_STATUSES = /* @__PURE__ */ new Set(["completed", "cancelled", "failed", "archived", "rejected"]);
             const myTasks = opts.assignedTasks.filter((t) => t.assignedAgentId === opts.agentId);
             const otherTasks = opts.assignedTasks.filter((t) => t.assignedAgentId !== opts.agentId);
-            const myActive = myTasks.filter((t) => !["completed", "cancelled", "failed"].includes(t.status)).sort(byPriority);
-            const myDone = myTasks.filter((t) => ["completed", "cancelled", "failed"].includes(t.status));
+            const myActive = myTasks.filter((t) => !CLOSED_STATUSES.has(t.status)).sort(byPriority);
+            const myDone = myTasks.filter((t) => CLOSED_STATUSES.has(t.status));
             const MY_TASK_LIMIT = SYSTEM_MY_TASKS_MAX;
             const TEAM_TASK_LIMIT = SYSTEM_TEAM_TASKS_MAX;
             parts.push("\n## Task Board");
@@ -6569,8 +6570,8 @@ var init_context_engine = __esm({
               parts.push(`_(${myDone.length} completed/closed tasks)_`);
             }
             if (otherTasks.length > 0) {
-              const otherActive = otherTasks.filter((t) => !["completed", "cancelled", "failed"].includes(t.status)).sort(byPriority);
-              const otherDone = otherTasks.filter((t) => ["completed", "cancelled", "failed"].includes(t.status));
+              const otherActive = otherTasks.filter((t) => !CLOSED_STATUSES.has(t.status)).sort(byPriority);
+              const otherDone = otherTasks.filter((t) => CLOSED_STATUSES.has(t.status));
               if (otherActive.length > 0) {
                 parts.push("### Team Tasks (assigned to others):");
                 const shown = otherActive.slice(0, TEAM_TASK_LIMIT);
@@ -6595,7 +6596,7 @@ var init_context_engine = __esm({
           parts.push("");
           parts.push("**Requirements** (governance gate):");
           parts.push("- `requirement_propose` \u2192 pending human approval \u2192 approved \u2192 link tasks via `requirement_id`");
-          parts.push("- When governance requires it, every task MUST reference an approved `requirement_id`.");
+          parts.push("- Every task MUST reference an approved `requirement_id`. Use `requirement_propose` first if no requirement exists.");
           parts.push("");
           parts.push("**Task lifecycle** \u2014 Create \u2192 Execute \u2192 Review \u2192 Complete:");
           parts.push('- **Create**: `task_create` (REQUIRED: `assigned_agent_id`, `reviewer_id`; optional `reviewer_type`: "agent"|"human"). Check `task_list` first to avoid duplicates.');
@@ -6621,7 +6622,8 @@ var init_context_engine = __esm({
           parts.push("- `recall_activity` \u2014 query your own past execution logs by task or activity type. Use when you need to review what you did previously (e.g., to answer a follow-up question).");
           parts.push("");
           parts.push("**Communicating with other agents**:");
-          parts.push("- `agent_send_message` \u2014 send a direct message to a peer agent. Use for coordination, questions, sharing context, or instructions. The message enters their mailbox and they will process it.");
+          parts.push("- `agent_send_message` \u2014 send a direct message to a peer agent. **By default this is asynchronous (fire-and-forget)**: the message enters their mailbox and you continue working without waiting. Set `wait_for_reply: true` only when you need the answer before you can proceed (rare \u2014 prefer async).");
+          parts.push("- A2A messaging is inherently **non-blocking**. You send a message, the recipient processes it on their own schedule, and may reply later via their own `agent_send_message`. Do NOT spin-wait or poll for responses.");
           parts.push("- For substantial work requests, create a `task_create` assigned to the target agent instead of asking via message.");
           parts.push("- Do NOT use A2A messages for routine task status notifications \u2014 the system handles those automatically.");
         }
@@ -48860,6 +48862,19 @@ ${escalationReason}`;
       }
       async handleHeartbeat(ctx) {
         log17.info("Processing heartbeat check-in");
+        const queuedNonHeartbeat = this.mailbox.getQueuedItems().filter((i) => i.sourceType !== "heartbeat" && i.status === "queued").length;
+        const fingerprint = `q:${queuedNonHeartbeat}`;
+        if (fingerprint === this.lastHeartbeatFingerprint && queuedNonHeartbeat === 0) {
+          this.consecutiveIdleHeartbeats++;
+          log17.info("Heartbeat: no changes detected, skipping LLM call", {
+            consecutiveIdle: this.consecutiveIdleHeartbeats
+          });
+          this.state.lastHeartbeat = (/* @__PURE__ */ new Date()).toISOString();
+          this.metricsCollector.recordHeartbeat(true);
+          return;
+        }
+        this.lastHeartbeatFingerprint = fingerprint;
+        this.consecutiveIdleHeartbeats = 0;
         const activityId = this.startActivity("heartbeat", "Heartbeat check-in", {});
         let lastHeartbeatSummary = "";
         try {
@@ -49177,12 +49192,15 @@ ${todayLog.slice(0, HEARTBEAT_DAILY_LOG_CHARS)}
        * 2. Memory dream: prune, deduplicate, merge (once per day)
        */
       lastDreamDate = "";
+      lastHeartbeatFingerprint = "";
+      consecutiveIdleHeartbeats = 0;
       async consolidateMemory() {
         try {
           const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
           const entries2 = this.memory.getEntries();
-          if (entries2.length >= 50 && this.lastDreamDate !== today) {
-            this.lastDreamDate = today;
+          const dreamKey = entries2.length > 500 ? `${today}_${Math.floor(Date.now() / (6 * 36e5))}` : today;
+          if (entries2.length >= 50 && this.lastDreamDate !== dreamKey) {
+            this.lastDreamDate = dreamKey;
             await this.dreamConsolidateMemory(entries2);
             this.pruneMemoryMd();
           }
@@ -49196,7 +49214,7 @@ ${todayLog.slice(0, HEARTBEAT_DAILY_LOG_CHARS)}
        * outdated items, and merge opportunities. Apply changes programmatically.
        */
       async dreamConsolidateMemory(entries2) {
-        const MAX_ENTRIES_FOR_LLM = 200;
+        const MAX_ENTRIES_FOR_LLM = 500;
         const truncated = entries2.length > MAX_ENTRIES_FOR_LLM;
         const batch = truncated ? entries2.slice(-MAX_ENTRIES_FOR_LLM) : entries2;
         const entryList = batch.map((e, i) => {
@@ -49267,8 +49285,8 @@ ${knowledgePreview}
             return;
           }
           const rawPlan = JSON.parse(jsonMatch[0]);
-          const MAX_REMOVE_PER_CYCLE = 10;
-          const MAX_MERGE_PER_CYCLE = 5;
+          const MAX_REMOVE_PER_CYCLE = 50;
+          const MAX_MERGE_PER_CYCLE = 20;
           const entryIds = new Set(batch.map((e) => e.id));
           const plan = {
             remove: (rawPlan.remove ?? []).filter((id) => entryIds.has(id)).slice(0, MAX_REMOVE_PER_CYCLE),
@@ -49389,6 +49407,52 @@ ${promo.content}` : promo.content;
           if (!inDailyReport)
             afterSectionPrune.push(line);
         }
+        const sections = [];
+        let currentHeading = "";
+        let currentBody = [];
+        let sectionStart = 0;
+        for (let i = 0; i <= afterSectionPrune.length; i++) {
+          const line = i < afterSectionPrune.length ? afterSectionPrune[i] : void 0;
+          const isHeading = line !== void 0 && /^#{1,3}\s/.test(line);
+          if (isHeading || line === void 0) {
+            if (currentHeading || currentBody.length > 0) {
+              sections.push({
+                heading: currentHeading,
+                body: currentBody.join("\n").trim(),
+                startIdx: sectionStart
+              });
+            }
+            currentHeading = line ?? "";
+            currentBody = [];
+            sectionStart = i;
+          } else {
+            currentBody.push(line);
+          }
+        }
+        const headingLastIdx = /* @__PURE__ */ new Map();
+        const normalizeHeading = (h) => h.replace(/^#+\s*/, "").trim().toLowerCase();
+        for (let i = 0; i < sections.length; i++) {
+          const key2 = normalizeHeading(sections[i].heading);
+          if (key2)
+            headingLastIdx.set(key2, i);
+        }
+        const deduped = [];
+        for (let i = 0; i < sections.length; i++) {
+          const s = sections[i];
+          const key2 = normalizeHeading(s.heading);
+          if (key2 && headingLastIdx.get(key2) !== i && headingLastIdx.has(key2)) {
+            continue;
+          }
+          deduped.push(s);
+        }
+        afterSectionPrune.length = 0;
+        for (const s of deduped) {
+          if (s.heading)
+            afterSectionPrune.push(s.heading);
+          if (s.body)
+            afterSectionPrune.push(s.body);
+          afterSectionPrune.push("");
+        }
         const outputLines = [];
         let inThinkBlock = false;
         for (const line of afterSectionPrune) {
@@ -50710,7 +50774,7 @@ function createA2ATools(ctx) {
             type: "string",
             description: 'Required when scope="channel". The channel key (e.g., "group:<teamId>" for team chats, "dm:<id1>_<id2>" for DMs).'
           },
-          limit: { type: "number", description: "Number of items to fetch (default 30, max 50)." },
+          limit: { type: "number", description: "Number of items to fetch (default 80, max 200)." },
           before: { type: "string", description: "ISO timestamp \u2014 fetch items older than this for pagination. Omit for most recent." }
         },
         required: ["scope"]
@@ -50722,11 +50786,11 @@ function createA2ATools(ctx) {
           if (!channelKey) {
             return JSON.stringify({ status: "error", error: 'channel_key is required when scope="channel"' });
           }
-          const limit = Math.min(args["limit"] ?? 30, 50);
+          const limit = Math.min(args["limit"] ?? 80, 200);
           const before2 = args["before"];
           try {
             const result = await ctx.getChannelMessages(channelKey, limit, before2);
-            const formatted = result.messages.map((m) => `[${m.createdAt}] ${m.senderType === "agent" ? `[agent] ${m.senderName}` : `[human] ${m.senderName}`}: ${m.text.slice(0, 500)}`);
+            const formatted = result.messages.map((m) => `[${m.createdAt}] ${m.senderType === "agent" ? `[agent] ${m.senderName}` : `[human] ${m.senderName}`}: ${m.text.slice(0, 2e3)}`);
             return JSON.stringify({
               messages: formatted,
               count: result.messages.length,
@@ -51182,6 +51246,15 @@ function createAgentTaskTools(ctx) {
             items: { type: "string" },
             description: "Update the list of task IDs that block this task. Only the task creator can modify this field. Pass an empty array to clear all blockers."
           },
+          reviewer_id: {
+            type: "string",
+            description: "New reviewer agent or human ID. Only the task creator or a manager can change the reviewer."
+          },
+          reviewer_type: {
+            type: "string",
+            enum: ["agent", "human"],
+            description: "Whether the new reviewer is an agent or a human user. Required when changing reviewer_id."
+          },
           schedule: {
             type: "object",
             description: 'Update the schedule for a scheduled (recurring) task. Only works on tasks with taskType "scheduled". Set either "every" OR "cron", not both.',
@@ -51202,20 +51275,30 @@ function createAgentTaskTools(ctx) {
           const note = args["note"];
           const description = args["description"];
           const blockedBy = args["blocked_by"];
-          if (blockedBy !== void 0) {
+          const reviewerId = args["reviewer_id"];
+          const reviewerType = args["reviewer_type"];
+          if (blockedBy !== void 0 || reviewerId !== void 0) {
             const existing = ctx.getTask ? await ctx.getTask(taskId2) : null;
             const createdBy = existing?.["createdBy"];
-            if (createdBy && createdBy !== ctx.agentId) {
+            if (blockedBy !== void 0 && createdBy && createdBy !== ctx.agentId) {
               return JSON.stringify({
                 status: "denied",
                 error: "Only the task creator can modify blocked_by. You are not the creator of this task."
               });
             }
+            if (reviewerId !== void 0 && createdBy && createdBy !== ctx.agentId) {
+              return JSON.stringify({
+                status: "denied",
+                error: "Only the task creator or a manager can change the reviewer."
+              });
+            }
           }
-          if ((description !== void 0 || blockedBy !== void 0) && ctx.updateTaskFields) {
+          if ((description !== void 0 || blockedBy !== void 0 || reviewerId !== void 0) && ctx.updateTaskFields) {
             await ctx.updateTaskFields(taskId2, {
               ...description !== void 0 ? { description } : {},
-              ...blockedBy !== void 0 ? { blockedBy } : {}
+              ...blockedBy !== void 0 ? { blockedBy } : {},
+              ...reviewerId !== void 0 ? { reviewerId } : {},
+              ...reviewerType !== void 0 ? { reviewerType } : {}
             });
           }
           const schedule = args["schedule"];
@@ -51404,7 +51487,7 @@ function createAgentTaskTools(ctx) {
     ...ctx.addTaskNote ? [
       {
         name: "task_note",
-        description: "Add a progress note or comment to a task without changing its status. Use this to log intermediate findings, decisions, or observations while working on a task.",
+        description: "Add a one-way progress note to a task's timeline log without changing its status. Use this to record intermediate findings, decisions, or milestones. For interactive discussion with other agents or humans, use task_comment instead.",
         inputSchema: {
           type: "object",
           properties: {
@@ -52642,6 +52725,48 @@ ${content}` : content;
         log24.info("Agent updated long-term memory", { agentId: ctx.agentId, section: section4, mode, contentLen: content.length });
         return JSON.stringify({ status: "updated", section: section4, mode });
       }
+    },
+    {
+      name: "memory_delete",
+      description: "Delete specific entries from your memory buffer (memories.json). Use this to clean up outdated, incorrect, or redundant observations. Provide either a list of entry IDs (from memory_list/memory_search) or a tag to remove all entries with that tag. Maximum 20 entries per call.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ids: {
+            type: "array",
+            items: { type: "string" },
+            description: "Array of memory entry IDs to delete. Use memory_list or memory_search to find IDs."
+          },
+          tag: {
+            type: "string",
+            description: "Delete all entries with this tag. Alternative to specifying individual IDs."
+          }
+        }
+      },
+      async execute(args) {
+        const ids = args["ids"];
+        const tag = args["tag"];
+        if (!ids?.length && !tag) {
+          return JSON.stringify({ status: "error", error: "Provide either ids or tag to delete." });
+        }
+        const MAX_DELETE = 20;
+        let removed = 0;
+        if (ids?.length) {
+          const capped = ids.slice(0, MAX_DELETE);
+          removed = ctx.memory.removeEntries(capped);
+          if (ctx.semanticSearch?.isEnabled()) {
+            for (const id of capped) {
+              ctx.semanticSearch.deleteMemory(id).catch((err) => {
+                log24.warn("Failed to remove memory from semantic index", { error: String(err) });
+              });
+            }
+          }
+        } else if (tag) {
+          removed = ctx.memory.removeEntriesByTag(tag);
+        }
+        log24.info("Agent deleted memories", { agentId: ctx.agentId, removed, byTag: tag ?? null });
+        return JSON.stringify({ status: "deleted", removed });
+      }
     }
   ];
 }
@@ -62407,14 +62532,15 @@ ${c.content}`;
           reviewer: task.reviewerId
         });
         if (this.hitlService && request.creatorRole !== "human" && task.status === "pending") {
-          const creatorName = request.createdBy ?? "unknown agent";
+          const creatorId = request.createdBy ?? "system";
+          const creatorName = this.resolveActorName(creatorId, "agent") ?? creatorId;
           this.hitlService.requestApprovalAndWait({
-            agentId: request.createdBy ?? "system",
+            agentId: creatorId,
             agentName: creatorName,
             type: "custom",
-            title: `Task approval: ${task.title}`,
+            title: task.title,
             description: `Agent "${creatorName}" wants to create task "${task.title}" (priority: ${task.priority}).`,
-            details: { taskId: task.id, priority: task.priority }
+            details: { taskId: task.id, priority: task.priority, subType: "task" }
           }).then((result) => {
             const current = this.tasks.get(task.id);
             if (!current || current.status !== "pending")
@@ -62701,9 +62827,10 @@ ${c.content}`;
 Deliverables:
 ${deliverablesSummary}` : ""
         ].filter(Boolean).join("\n");
+        const assigneeName = this.resolveActorName(task.assignedAgentId, "agent") ?? task.assignedAgentId;
         this.hitlService.requestApprovalAndWait({
           agentId: task.assignedAgentId,
-          agentName: task.assignedAgentId,
+          agentName: assigneeName,
           type: "custom",
           title: `Review: ${task.title}`,
           description,
@@ -63061,6 +63188,12 @@ Action: ${guidance}` : ""
         if (data.reviewerType !== void 0)
           task.reviewerType = data.reviewerType;
         if (data.blockedBy !== void 0) {
+          if (data.blockedBy.length > 0) {
+            const cycle = this.detectBlockedByCycle(id, data.blockedBy);
+            if (cycle) {
+              throw new Error(`Circular dependency detected: ${cycle.join(" \u2192 ")}. Cannot set blocked_by \u2014 this would create a deadlock.`);
+            }
+          }
           task.blockedBy = data.blockedBy;
           if (this.taskRepo && "updateBlockedBy" in this.taskRepo) {
             this.taskRepo.updateBlockedBy(id, data.blockedBy).catch((err) => log50.warn("Failed to persist blockedBy to DB", { error: String(err) }));
@@ -63185,6 +63318,31 @@ Action: ${guidance}` : ""
           this.cascadeCancelDependents(task);
         }
       }
+      /**
+       * Detect cycles in blocked_by dependencies using BFS.
+       * Returns the cycle path if found, or null if no cycle exists.
+       */
+      detectBlockedByCycle(taskId2, proposedBlockers) {
+        for (const blockerId of proposedBlockers) {
+          const visited = /* @__PURE__ */ new Set();
+          const queue = [{ id: blockerId, path: [taskId2, blockerId] }];
+          while (queue.length > 0) {
+            const { id: current, path } = queue.shift();
+            if (current === taskId2)
+              return path;
+            if (visited.has(current))
+              continue;
+            visited.add(current);
+            const blockerTask = this.tasks.get(current);
+            if (blockerTask?.blockedBy) {
+              for (const nextId of blockerTask.blockedBy) {
+                queue.push({ id: nextId, path: [...path, nextId] });
+              }
+            }
+          }
+        }
+        return null;
+      }
       areBlockersSatisfied(task) {
         if (!task.blockedBy?.length)
           return true;
@@ -65943,7 +66101,7 @@ var init_api_server = __esm({
                 let channelContext = [];
                 if (this.storage) {
                   try {
-                    const recent = await this.storage.channelMessageRepo.getMessages(channelKey, 20);
+                    const recent = await this.storage.channelMessageRepo.getMessages(channelKey, 80);
                     channelContext = (recent.messages ?? []).map((m) => ({
                       role: m.senderType === "agent" ? "assistant" : "user",
                       content: m.senderType === "agent" ? stripInternalBlocks(m.text) : `[${m.senderName}]: ${m.text}`
@@ -66513,13 +66671,33 @@ ${cleanText}`,
             toolEventCollector: toolEvents,
             waitForReply: isA2A ? true : void 0
           });
+          const emitNoResponse = () => {
+            const evt = {
+              type: "chat:agent_no_response",
+              payload: { channel, agentId: agentId2 },
+              timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            };
+            if (channel.startsWith("dm:") || channel.startsWith("notes:")) {
+              const parts = channel.startsWith("notes:") ? [channel.slice(6)] : channel.slice(3).split(":");
+              this.ws.sendToUsers(parts, evt);
+            } else {
+              const humanIds = this.resolveChannelHumanIds(channel);
+              if (humanIds.length > 0)
+                this.ws.sendToUsers(humanIds, evt);
+              else
+                this.ws.broadcast(evt);
+            }
+          };
           if (!reply || !reply.trim() || reply.includes("[NO_RESPONSE]")) {
+            emitNoResponse();
             return;
           }
           const { thinking, clean: rawClean } = extractThinkBlocks(reply);
           const cleanReply = rawClean.replace(/\[NO_RESPONSE\]/gi, "").trim();
-          if (!cleanReply)
+          if (!cleanReply) {
+            emitNoResponse();
             return;
+          }
           const metadata = {};
           if (thinking.length > 0)
             metadata["thinking"] = thinking;
@@ -66622,7 +66800,7 @@ ${cleanText}`,
         let channelContext = [];
         if (this.storage) {
           try {
-            const recent = await this.storage.channelMessageRepo.getMessages(channel, 20);
+            const recent = await this.storage.channelMessageRepo.getMessages(channel, 80);
             channelContext = (recent.messages ?? []).map((m) => ({
               role: m.senderType === "agent" ? "assistant" : "user",
               content: m.senderType === "agent" ? stripInternalBlocks(m.text) : `[${m.senderName}]: ${m.text}`
@@ -67162,7 +67340,7 @@ ${cleanText}`,
             if (!this.storage)
               return [];
             try {
-              const recent = await this.storage.channelMessageRepo.getMessages(channel, 20);
+              const recent = await this.storage.channelMessageRepo.getMessages(channel, 80);
               return (recent.messages ?? []).map((m) => ({
                 role: m.senderType === "agent" ? "assistant" : "user",
                 content: m.senderType === "agent" ? stripInternalBlocks(m.text) : `[${m.senderName}]: ${m.text}`
@@ -71345,6 +71523,50 @@ EXPLANATION_END`;
           this.json(res, 200, { success: read ?? false });
           return;
         }
+        if (path === "/api/activity" && req.method === "GET") {
+          const authUser = await this.requireAuth(req, res);
+          if (!authUser)
+            return;
+          const userId2 = authUser.userId;
+          const limit = Math.min(parseInt(url.searchParams.get("limit") ?? "50", 10), 200);
+          const typeFilter = url.searchParams.get("type") ?? void 0;
+          const items = [];
+          if (!typeFilter || typeFilter === "notification") {
+            const notifications = this.hitlService?.listNotifications(userId2, false, { limit }) ?? [];
+            for (const n of notifications) {
+              items.push({
+                id: n.id,
+                type: n.type,
+                title: n.title,
+                body: n.body,
+                timestamp: n.createdAt,
+                source: "notification",
+                metadata: n.metadata
+              });
+            }
+          }
+          if ((!typeFilter || typeFilter === "task_comment") && this.storage?.taskCommentRepo) {
+            try {
+              const recentComments = this.storage.taskCommentRepo.listRecent?.(limit) ?? [];
+              for (const c of recentComments) {
+                items.push({
+                  id: c.id,
+                  type: "task_comment",
+                  title: `Comment on task ${c.taskId}`,
+                  body: typeof c.body === "string" ? c.body.slice(0, 300) : String(c.body ?? ""),
+                  timestamp: c.createdAt,
+                  source: "task_comment",
+                  metadata: { taskId: c.taskId, authorId: c.authorId, authorName: c.authorName }
+                });
+              }
+            } catch {
+            }
+          }
+          items.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+          const page = items.slice(0, limit);
+          this.json(res, 200, { items: page, totalCount: items.length });
+          return;
+        }
         if (path === "/api/usage" && req.method === "GET") {
           const orgId2 = url.searchParams.get("orgId") ?? "default";
           const plan = this.billingService?.getOrgPlan(orgId2);
@@ -73980,6 +74202,8 @@ EXPLANATION_END`;
           exact("/api/notifications", "GET"),
           exact("/api/notifications/mark-all-read", "POST"),
           startsWith("/api/notifications/", "POST"),
+          // ── Activity feed ─────────────────────────────────────────────────
+          exact("/api/activity", "GET"),
           // ── Users ────────────────────────────────────────────────────────────
           exact("/api/users", "GET", "POST"),
           regex(/^\/api\/users\/[^/]+$/, "PATCH"),
@@ -74595,7 +74819,7 @@ var init_hitl_service = __esm({
         this.notify({
           targetUserId: opts.targetUserId ?? "all",
           type: "approval_request",
-          title: `Approval needed: ${opts.title}`,
+          title: opts.title,
           body: opts.description,
           priority: "high",
           actionType: "navigate",
@@ -75469,13 +75693,14 @@ var init_requirement_service = __esm({
         }
         this.broadcast("requirement:created", req);
         if (this.hitlService && req.source === "agent") {
+          const creatorName = this.resolveAgentName(req.createdBy);
           this.hitlService.requestApprovalAndWait({
             agentId: req.createdBy,
-            agentName: req.createdBy,
+            agentName: creatorName,
             type: "custom",
-            title: `Requirement approval: ${req.title}`,
-            description: `Agent "${req.createdBy}" proposed requirement "${req.title}" (priority: ${req.priority}).`,
-            details: { requirementId: req.id, priority: req.priority },
+            title: req.title,
+            description: `Agent "${creatorName}" proposed requirement "${req.title}" (priority: ${req.priority}).`,
+            details: { requirementId: req.id, priority: req.priority, subType: "requirement" },
             targetUserId: "all"
           }).then((result) => {
             const current = this.requirements.get(req.id);
@@ -75611,13 +75836,14 @@ var init_requirement_service = __esm({
         this.broadcast("requirement:resubmitted", req);
         log61.info("Requirement resubmitted for review", { id, hasUpdates: !!updates });
         if (this.hitlService && req.source === "agent") {
+          const creatorName = this.resolveAgentName(req.createdBy);
           this.hitlService.requestApprovalAndWait({
             agentId: req.createdBy,
-            agentName: req.createdBy,
+            agentName: creatorName,
             type: "custom",
-            title: `Requirement approval (resubmitted): ${req.title}`,
-            description: `Agent "${req.createdBy}" resubmitted requirement "${req.title}" (priority: ${req.priority}).`,
-            details: { requirementId: req.id, priority: req.priority },
+            title: req.title,
+            description: `Agent "${creatorName}" resubmitted requirement "${req.title}" (priority: ${req.priority}).`,
+            details: { requirementId: req.id, priority: req.priority, subType: "requirement_resubmit" },
             targetUserId: "all"
           }).then((result) => {
             const current = this.requirements.get(req.id);
@@ -75955,6 +76181,17 @@ var init_requirement_service = __esm({
           });
         }
       }
+      resolveAgentName(agentId2) {
+        if (this.agentManager) {
+          try {
+            const agent = this.agentManager.getAgent(agentId2);
+            if (agent)
+              return agent.config?.name ?? agent.name ?? agentId2;
+          } catch {
+          }
+        }
+        return agentId2;
+      }
       broadcast(type, data) {
         if (this.ws) {
           this.ws.broadcast({
@@ -77106,13 +77343,19 @@ var init_stale_detector = __esm({
       taskService;
       config;
       scanInterval;
-      constructor(taskService, config) {
+      onStaleItems;
+      constructor(taskService, config, onStaleItems) {
         this.taskService = taskService;
         this.config = { ...DEFAULT_CONFIG4, ...config };
+        this.onStaleItems = onStaleItems;
       }
       start(intervalMs = 36e5) {
         this.scanInterval = setInterval(() => {
-          this.scan().catch((err) => log68.warn("Stale scan failed", { error: String(err) }));
+          this.scan().then((items) => {
+            if (items.length > 0 && this.onStaleItems) {
+              this.onStaleItems(items);
+            }
+          }).catch((err) => log68.warn("Stale scan failed", { error: String(err) }));
         }, intervalMs);
         log68.info("Stale detector started", { intervalMs });
       }
@@ -82442,6 +82685,21 @@ async function startServer(config, values) {
   const archiveService = new ArchiveService(taskService, projectService);
   archiveService.setRequirementService(requirementService);
   archiveService.start();
+  const staleDetector = new StaleDetector(taskService, void 0, (items) => {
+    for (const item of items) {
+      hitlService.notify({
+        targetUserId: "all",
+        type: "system",
+        title: item.type === "review_stale" ? "Stale review" : item.type === "stuck_task" ? "Stuck task" : "Unstarted task",
+        body: item.message,
+        priority: item.type === "review_stale" ? "high" : "normal",
+        actionType: item.taskId ? "navigate" : "none",
+        actionTarget: item.taskId ? JSON.stringify({ path: `/work?openTask=${item.taskId}` }) : void 0,
+        metadata: { taskId: item.taskId, agentId: item.agentId, staleType: item.type }
+      });
+    }
+  });
+  staleDetector.start();
   apiServer.setLLMRouter(llmRouter);
   apiServer.setConfigPath(values["config"] ?? getDefaultConfigPath());
   if (config.hub?.url) apiServer.setHubUrl(config.hub.url);
@@ -83278,6 +83536,7 @@ ${reason}`;
     closeStartupLogger();
     closeRuntimeLogger();
     archiveService.stop();
+    staleDetector.stop();
     scheduledTaskRunner.stop();
     apiServer.stop();
     agentManager.shutdown().then(() => messageRouter.disconnectAll()).then(() => process.exit(0)).catch(() => process.exit(1));