@markus-global/cli 0.6.2 → 0.6.4

package/dist/markus.mjs

@@ -5184,12 +5184,45 @@ ${truncatedContent}
 `;
           }
           if (updated.length > MEMORY_MD_TOTAL_MAX_CHARS) {
-            log5.warn("MEMORY.md total size exceeds limit, refusing write", {
+            log5.warn("MEMORY.md total size exceeds limit, attempting compression", {
               key: key2,
               fileSize: updated.length,
               limit: MEMORY_MD_TOTAL_MAX_CHARS
             });
-            return;
+            const compressed = this.compressLongTermMemory();
+            if (compressed.charsAfter < updated.length) {
+              log5.info("Compression freed space, retrying write", {
+                key: key2,
+                charsFreed: updated.length - compressed.charsAfter
+              });
+              existing = readFileSync4(this.longTermFile, "utf-8");
+              if (existing.includes(sectionHeader)) {
+                const regex = new RegExp(`(## ${key2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")})\\n[\\s\\S]*?(?=\\n## |$)`);
+                updated = existing.replace(regex, `${sectionHeader}
+${truncatedContent}
+`);
+              } else {
+                updated = existing + `
+${sectionHeader}
+${truncatedContent}
+`;
+              }
+              if (updated.length > MEMORY_MD_TOTAL_MAX_CHARS) {
+                log5.warn("MEMORY.md still exceeds limit even after compression, refusing write", {
+                  key: key2,
+                  fileSize: updated.length,
+                  limit: MEMORY_MD_TOTAL_MAX_CHARS
+                });
+                return;
+              }
+            } else {
+              log5.warn("MEMORY.md still exceeds limit after compression, refusing write", {
+                key: key2,
+                fileSize: updated.length,
+                limit: MEMORY_MD_TOTAL_MAX_CHARS
+              });
+              return;
+            }
           }
           writeFileSync3(this.longTermFile, updated);
           log5.debug("Long-term memory updated", { key: key2, sectionChars: truncatedContent.length, totalChars: updated.length });
@@ -5365,6 +5398,62 @@ ${tail}`;
           this.saveDebounce = null;
         }, 1e3);
       }
+      /** Compress MEMORY.md — truncate oversized sections to prevent context bloat */
+      compressLongTermMemory() {
+        if (!existsSync6(this.longTermFile)) {
+          return { charsBefore: 0, charsAfter: 0, sectionsBefore: 0, sectionsAfter: 0, truncatedChunks: 0 };
+        }
+        const content = readFileSync4(this.longTermFile, "utf-8");
+        const charsBefore = content.length;
+        const lines = content.split("\n");
+        let i = 0;
+        const preambleLines = [];
+        while (i < lines.length && !lines[i].startsWith("## ")) {
+          preambleLines.push(lines[i]);
+          i++;
+        }
+        const sections = [];
+        let currentHeader = "";
+        let currentBody = [];
+        while (i < lines.length) {
+          const line = lines[i];
+          if (line.startsWith("## ")) {
+            if (currentHeader) {
+              sections.push({ headerLine: currentHeader, body: currentBody });
+            }
+            currentHeader = line;
+            currentBody = [];
+          } else {
+            currentBody.push(line);
+          }
+          i++;
+        }
+        if (currentHeader) {
+          sections.push({ headerLine: currentHeader, body: currentBody });
+        }
+        const sectionsBefore = sections.length;
+        let truncatedChunks = 0;
+        const outputLines = [...preambleLines];
+        for (const section4 of sections) {
+          const bodyStr = section4.body.join("\n");
+          if (bodyStr.length > MEMORY_MD_SECTION_MAX_CHARS) {
+            const truncatedBody = bodyStr.slice(0, MEMORY_MD_SECTION_MAX_CHARS);
+            outputLines.push(section4.headerLine, truncatedBody);
+            truncatedChunks++;
+          } else {
+            outputLines.push(section4.headerLine, bodyStr);
+          }
+        }
+        const compressed = outputLines.join("\n");
+        writeFileSync3(this.longTermFile, compressed);
+        return {
+          charsBefore,
+          charsAfter: compressed.length,
+          sectionsBefore,
+          sectionsAfter: sections.length,
+          truncatedChunks
+        };
+      }
     };
   }
 });
@@ -6455,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");
@@ -6480,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);
@@ -6506,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.');
@@ -6532,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.");
         }
@@ -43522,6 +43613,15 @@ var init_attention = __esm({
       clearPreemptionSignal() {
         this.criticalInterruptResolve = void 0;
       }
+      /**
+       * Clear the lastYieldDecision flag set by checkYieldPoint().
+       * Used by processing code that handles preemption internally (e.g. task
+       * execution delegates resumption to TaskService) so the attention loop
+       * completes the item normally instead of deferring it.
+       */
+      clearLastYieldDecision() {
+        this.lastYieldDecision = void 0;
+      }
       /**
        * Called from the Agent's tool loop at safe yield points (between LLM turns).
        * If an interrupt signal is pending, evaluates whether to continue or switch.
@@ -45629,11 +45729,19 @@ ${notification.stdoutTail}`);
             }
             case "task_status_update": {
               if (extra.triggerExecution && item.payload.taskId) {
+                if (typeof extra.onLog !== "function") {
+                  log17.info("Skipping resurfaced task execution item (closures lost)", {
+                    agentId: this.id,
+                    taskId: item.payload.taskId
+                  });
+                  resolveResponse("");
+                  return;
+                }
                 const taskId2 = item.payload.taskId;
                 const description = item.payload.content;
-                const onLog = extra.onLog ?? (() => {
-                });
+                const onLog = extra.onLog;
                 await this.executeTask(taskId2, description, onLog, extra.cancelToken, extra.taskProjectContext, extra.executionRound, item.payload.requirementId);
+                this.attentionController.clearLastYieldDecision();
                 resolveResponse("");
                 return;
               }
@@ -47127,6 +47235,12 @@ ${chatYield.item.payload.content}`;
         }
       }
       async handleMessageStream(userMessage, onEvent, senderId, senderInfo, cancelToken, images, fileNames) {
+        if (cancelToken?.cancelled) {
+          log17.info("Stream cancelled before processing started", { agentId: this.id });
+          if (this.activeTasks.size === 0)
+            this.setStatus("idle");
+          return "";
+        }
         if (this.activeTasks.size === 0) {
           this.setStatus("working");
         }
@@ -47248,10 +47362,11 @@ ${chatYield.item.payload.content}`;
             }
             if (cancelToken?.cancelled) {
               log17.info("Stream cancelled by user during tool loop", { agentId: this.id });
-              if (lastResponseContent && this.currentSessionId) {
+              if (this.currentSessionId) {
+                const content = lastResponseContent ? lastResponseContent + "\n\n[interrupted by user]" : "[interrupted by user]";
                 this.memory.appendMessage(this.currentSessionId, {
                   role: "assistant",
-                  content: lastResponseContent + "\n\n[interrupted by user]"
+                  content
                 });
               }
               if (streamChatActivityId)
@@ -47271,6 +47386,19 @@ ${chatYield.item.payload.content}`;
                 content: "[Continue from where you left off. Do not repeat what you already said.]"
               });
             } else {
+              if (cancelToken?.cancelled) {
+                log17.info("Stream cancelled before tool execution", { agentId: this.id });
+                this.memory.appendMessage(this.currentSessionId, {
+                  role: "assistant",
+                  content: response.content + "\n\n[interrupted by user]",
+                  reasoningContent: response.reasoningContent
+                });
+                if (streamChatActivityId)
+                  this.endActivity(streamChatActivityId);
+                if (this.activeTasks.size === 0)
+                  this.setStatus("idle");
+                return response.content || lastResponseContent || "";
+              }
               this.memory.appendMessage(this.currentSessionId, {
                 role: "assistant",
                 content: response.content,
@@ -47373,10 +47501,11 @@ ${streamYield.item.payload.content}`;
             const updatedMessages = preparedCont.messages;
             if (cancelToken?.cancelled) {
               log17.info("Stream cancelled before LLM re-call", { agentId: this.id });
-              if (lastResponseContent && this.currentSessionId) {
+              if (this.currentSessionId) {
+                const content = lastResponseContent ? lastResponseContent + "\n\n[interrupted by user]" : "[interrupted by user]";
                 this.memory.appendMessage(this.currentSessionId, {
                   role: "assistant",
-                  content: lastResponseContent + "\n\n[interrupted by user]"
+                  content
                 });
               }
               if (streamChatActivityId)
@@ -47433,11 +47562,12 @@ ${streamYield.item.payload.content}`;
           if (streamChatActivityId)
             this.endActivity(streamChatActivityId, { success: !cancelToken?.cancelled });
           if (cancelToken?.cancelled) {
-            if (lastResponseContent && this.currentSessionId) {
+            if (this.currentSessionId) {
               try {
+                const content = lastResponseContent ? lastResponseContent + "\n\n[interrupted by user]" : "[interrupted by user]";
                 this.memory.appendMessage(this.currentSessionId, {
                   role: "assistant",
-                  content: lastResponseContent + "\n\n[interrupted by user]"
+                  content
                 });
               } catch {
               }
@@ -48732,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 {
@@ -49049,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();
           }
@@ -49068,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) => {
@@ -49139,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),
@@ -49240,7 +49386,8 @@ ${promo.content}` : promo.content;
       }
       /**
        * Enforce MEMORY.md hygiene: remove daily-report sections (they belong in
-       * daily-logs/), strip leaked LLM <think> blocks, and enforce section size limits.
+       * daily-logs/), strip leaked LLM <think> blocks, and enforce section/total
+       * size limits via heuristic compression.
        */
       pruneMemoryMd() {
         const content = this.memory.getLongTermMemory();
@@ -49260,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) {
@@ -49280,6 +49473,15 @@ ${promo.content}` : promo.content;
           writeFileSync8(memoryMdPath, pruned + "\n");
           log17.info("Pruned MEMORY.md: removed daily-report sections and LLM artifacts", { agentId: this.id });
         }
+        const compressed = this.memory.compressLongTermMemory();
+        if (compressed.truncatedChunks > 0) {
+          log17.info("Compressed MEMORY.md during Dream Cycle", {
+            agentId: this.id,
+            charsBefore: compressed.charsBefore,
+            charsAfter: compressed.charsAfter,
+            sectionsTrimmed: compressed.truncatedChunks
+          });
+        }
       }
     };
   }
@@ -50572,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"]
@@ -50584,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,
@@ -51044,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.',
@@ -51064,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"];
@@ -51266,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: {
@@ -52395,16 +52616,23 @@ function createMemoryTools(ctx) {
             let entries2 = semResults.map((r) => r.entry);
             if (type)
               entries2 = entries2.filter((e) => e.type === type);
-            log24.debug("Semantic memory search", { agentId: ctx.agentId, query: query2, results: entries2.length });
-            return JSON.stringify({
-              results: entries2.map((e) => ({
-                id: e.id,
-                type: e.type,
-                content: e.content,
-                timestamp: e.timestamp,
-                similarity: semResults.find((r) => r.entry.id === e.id)?.similarity
-              })),
-              count: entries2.length
+            if (entries2.length > 0) {
+              log24.debug("Semantic memory search", { agentId: ctx.agentId, query: query2, results: entries2.length });
+              return JSON.stringify({
+                results: entries2.map((e) => ({
+                  id: e.id,
+                  type: e.type,
+                  content: e.content,
+                  timestamp: e.timestamp,
+                  similarity: semResults.find((r) => r.entry.id === e.id)?.similarity
+                })),
+                count: entries2.length,
+                searchMethod: "semantic"
+              });
+            }
+            log24.info("Semantic search returned 0 results, falling back to substring", {
+              agentId: ctx.agentId,
+              query: query2
             });
           } catch (err) {
             log24.warn("Semantic search failed, falling back to substring", { error: String(err) });
@@ -52423,7 +52651,8 @@ function createMemoryTools(ctx) {
             timestamp: e.timestamp,
             tags: e.metadata?.tags
           })),
-          count: results.length
+          count: results.length,
+          searchMethod: "substring"
         });
       }
     },
@@ -52496,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 });
+      }
     }
   ];
 }
@@ -53143,29 +53414,34 @@ var init_semantic_search = __esm({
           log27.warn("Failed to index memory entry", { id: entry.id, error: String(err) });
         }
       }
+      /**
+       * Search indexed memories by semantic similarity.
+       *
+       * Returns an empty array when the service is not enabled.
+       *
+       * @throws {Error} Propagates embedding or vector-store errors to the caller
+       *   so that callers (e.g. memory_search tool) can implement their own
+       *   fallback strategy. Contrast with {@link indexMemory}, which silently
+       *   swallows errors because indexing is best-effort.
+       */
       async search(query2, opts) {
         if (!this.enabled)
           return [];
-        try {
-          const queryEmbedding = await this.embedding.embed(query2);
-          const results = await this.vectorStore.search(queryEmbedding, {
-            topK: opts?.topK ?? 5,
-            agentId: opts?.agentId,
-            minSimilarity: opts?.minSimilarity ?? 0.3
-          });
-          return results.map((r) => ({
-            entry: {
-              id: r.id,
-              content: r.content,
-              type: r.type,
-              timestamp: ""
-            },
-            similarity: r.similarity
-          }));
-        } catch (err) {
-          log27.warn("Semantic search failed, returning empty results", { error: String(err) });
-          return [];
-        }
+        const queryEmbedding = await this.embedding.embed(query2);
+        const results = await this.vectorStore.search(queryEmbedding, {
+          topK: opts?.topK ?? 5,
+          agentId: opts?.agentId,
+          minSimilarity: opts?.minSimilarity ?? 0.3
+        });
+        return results.map((r) => ({
+          entry: {
+            id: r.id,
+            content: r.content,
+            type: r.type,
+            timestamp: ""
+          },
+          similarity: r.similarity
+        }));
       }
       async deleteMemory(id) {
         if (!this.enabled)
@@ -53711,6 +53987,25 @@ You are ${request.name}.`,
             "- [ ] Scan recent channel messages for anything requiring attention"
           ].join("\n"), "utf-8");
         }
+        const sessionsDir = join12(agentDataDir, "sessions");
+        const dailyLogsDir = join12(agentDataDir, "daily-logs");
+        const memoryPath = join12(agentDataDir, "MEMORY.md");
+        mkdirSync11(sessionsDir, { recursive: true });
+        mkdirSync11(dailyLogsDir, { recursive: true });
+        if (!existsSync17(memoryPath)) {
+          writeFileSync10(memoryPath, [
+            "# Agent Memory",
+            "",
+            "## Your Knowledge",
+            "",
+            "## procedures",
+            "",
+            "## architecture",
+            "",
+            "## lessons-learned",
+            ""
+          ].join("\n"), "utf-8");
+        }
         const config = {
           id,
           name: request.name,
@@ -62237,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")
@@ -62531,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,
@@ -62891,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) }));
@@ -63015,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;
@@ -64414,7 +64742,7 @@ var init_builder_service = __esm({
           const memberRole = member.role ?? "worker";
           const memberName = member.name ?? "Agent";
           const memberSkills = member.skills ?? [];
-          const memberFilesDir = this.findMemberDir(artDir, memberName, usedMemberDirs);
+          const memberFilesDir = this.findMemberDir(artDir, memberName, usedMemberDirs, member.roleName);
           const hasCustomRole = !!memberFilesDir && existsSync24(join20(memberFilesDir, "ROLE.md"));
           if (memberFilesDir)
             usedMemberDirs.add(memberFilesDir);
@@ -64459,14 +64787,24 @@ var init_builder_service = __esm({
        * Find the member directory under artDir/members/ by trying multiple slug strategies.
        * Returns the absolute path to the member directory, or null if not found.
        */
-      findMemberDir(artDir, memberName, usedDirs) {
+      findMemberDir(artDir, memberName, usedDirs, roleName) {
         const membersBase = join20(artDir, "members");
         if (!existsSync24(membersBase))
           return null;
-        const slug = kebab(memberName, "agent");
-        const exact = join20(membersBase, slug);
-        if (existsSync24(exact) && !usedDirs.has(exact))
-          return exact;
+        const nameSlug = kebab(memberName);
+        if (nameSlug && !/^pkg-/.test(nameSlug)) {
+          const exact = join20(membersBase, nameSlug);
+          if (existsSync24(exact) && !usedDirs.has(exact))
+            return exact;
+        }
+        if (roleName) {
+          const roleSlug = kebab(roleName);
+          if (roleSlug && !/^pkg-/.test(roleSlug)) {
+            const roleDir = join20(membersBase, roleSlug);
+            if (existsSync24(roleDir) && !usedDirs.has(roleDir))
+              return roleDir;
+          }
+        }
         try {
           for (const entry of readdirSync8(membersBase, { withFileTypes: true })) {
             if (!entry.isDirectory())
@@ -64480,8 +64818,12 @@ var init_builder_service = __esm({
             try {
               const content = readFileSync18(rolePath, "utf-8");
               const title = content.match(/^#\s+(.+)$/m)?.[1]?.trim();
-              if (title && title.toLowerCase() === memberName.toLowerCase())
-                return candidateDir;
+              if (title) {
+                const tLower = title.toLowerCase();
+                const nLower = memberName.toLowerCase();
+                if (tLower === nLower || tLower.includes(nLower) || nLower.includes(tLower))
+                  return candidateDir;
+              }
             } catch {
             }
           }
@@ -64997,6 +65339,9 @@ var init_sse_handler = __esm({
           } else if (this.options.isResume) {
             this.sessionId = this.options.sessionId ?? null;
           }
+          if (this.sessionId && this.sseBuffer && !this.sseDisconnected) {
+            this.sseBuffer.send({ type: "session_start", sessionId: this.sessionId });
+          }
           const reply = await this.options.agent.sendMessageStream(this.options.userText, (event) => this.handleStreamEvent(event), this.options.senderId, this.options.senderInfo, this.cancelToken, this.options.images, this.options.fileNames);
           const finalNow = (/* @__PURE__ */ new Date()).toISOString();
           let finalThinking;
@@ -65756,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}`
@@ -66326,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;
@@ -66435,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}`
@@ -66975,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}`
@@ -70309,9 +70674,9 @@ EXPLANATION_END`;
                 writeFileSync16(join22(artDir, "NORMS.md"), norms, "utf-8");
               }
               const rawMembers = Array.isArray(artifact.team?.members) ? artifact.team.members : Array.isArray(artifact.members) ? artifact.members : [];
-              for (const m of rawMembers) {
+              for (const [idx, m] of rawMembers.entries()) {
                 const mName = m.name ?? "Agent";
-                const slug = kebab(mName, "agent");
+                const slug = kebab(mName, "member-" + idx);
                 const memberDir = join22(artDir, "members", slug);
                 const roleContent = m.roleContent || m.role_md;
                 const policiesContent = m.policiesContent || m.policies_md;
@@ -71158,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);
@@ -72660,11 +73069,11 @@ EXPLANATION_END`;
           }
           const rolesRoot = rolesCandidates.find((d) => ex(d)) ?? rolesDir;
           const files = {};
-          for (const member of tpl.members) {
+          for (const [idx, member] of tpl.members.entries()) {
             const roleName = member.roleName;
             if (!roleName)
               continue;
-            const memberSlug = (member.name ?? roleName).toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
+            const memberSlug = kebab(member.name ?? roleName, "member-" + idx);
             const roleDir = resolve13(rolesRoot, roleName);
             if (!ex(roleDir))
               continue;
@@ -73793,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"),
@@ -74408,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",
@@ -75282,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);
@@ -75424,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);
@@ -75768,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({
@@ -76919,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 });
       }
@@ -82255,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);
@@ -83091,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));