@kendoo.agentdesk/agentdesk 0.11.3 → 0.11.5

package/cli/agents.mjs

@@ -5,7 +5,7 @@ export const BUILT_IN_AGENTS = {
     badge: "●● JANE ●●",
     role: "Product Analyst / Team Lead",
     description: "leads the session, clarifies requirements, coordinates the team, manages tracker status, decomposes large tasks into subtasks",
-    groundRules: "Jane focuses on requirements, scope, and coordination — she does not read code. She creates tracker tasks when needed, manages status transitions, posts the session start/end comments, and decomposes large features into subtasks (basic vs deferred).",
+    groundRules: "Jane focuses on requirements, scope, and coordination — she does NOT read code, inspect functions, or reference technical implementation details (no file names, function names, variable names, or code snippets). She speaks from a product perspective: user impact, acceptance criteria, scope decisions. She creates tracker tasks when needed, manages status transitions, posts the session start/end comments, and decomposes large features into subtasks (basic vs deferred).",
     planning: "Requirements: what we're building, acceptance criteria, scope. Flags UI tasks for Luna.",
     execution: {
       step: "Jane wraps up",

package/cli/daemon.mjs

@@ -381,15 +381,53 @@ export async function runDaemon() {
         cwd: project.path,
         apiKey,
         serverUrl: agentdeskServer,
-        onEvent(event) {
-          // Skip events after cancellation to prevent double session:end
-          if (!activeSession || activeSession.sessionId !== sessionId) return;
-          sendBuffered(sessionId, event);
-          if (event.type === "tool:use" && event.description) {
-            const pathMatch = event.description.match(/(?:Reading|Editing|Writing)\s+(.+)/);
-            if (pathMatch) filePathsTouched.add(pathMatch[1]);
+        onEvent: (() => {
+          // Stagger agent messages for real-time feel, flush on non-message events
+          const MSG_STAGGER_MS = 400;
+          let msgQueue = [];
+          let staggerTimer = null;
+
+          function flushQueue() {
+            clearTimeout(staggerTimer);
+            staggerTimer = null;
+            for (const queued of msgQueue) sendBuffered(sessionId, queued);
+            msgQueue = [];
           }
-        },
+
+          function drainNext() {
+            if (msgQueue.length === 0) { staggerTimer = null; return; }
+            sendBuffered(sessionId, msgQueue.shift());
+            if (msgQueue.length > 0) {
+              staggerTimer = setTimeout(drainNext, MSG_STAGGER_MS);
+            } else {
+              staggerTimer = null;
+            }
+          }
+
+          return (event) => {
+            if (!activeSession || activeSession.sessionId !== sessionId) return;
+
+            if (event.type === "agent:message") {
+              msgQueue.push(event);
+              // First message sends immediately, rest are staggered
+              if (!staggerTimer && msgQueue.length === 1) {
+                sendBuffered(sessionId, msgQueue.shift());
+                if (msgQueue.length > 0) {
+                  staggerTimer = setTimeout(drainNext, MSG_STAGGER_MS);
+                }
+              }
+            } else {
+              // Non-message event: flush all queued messages first, then send this event
+              if (msgQueue.length > 0) flushQueue();
+              sendBuffered(sessionId, event);
+            }
+
+            if (event.type === "tool:use" && event.description) {
+              const pathMatch = event.description.match(/(?:Reading|Editing|Writing)\s+(.+)/);
+              if (pathMatch) filePathsTouched.add(pathMatch[1]);
+            }
+          };
+        })(),
       });
 
       console.log(`  ${green}Session complete${reset} ${dim}${sessionId}${reset} (${result.duration}, ${result.steps} steps)`);

package/cli/init.mjs

@@ -352,6 +352,17 @@ export async function runInit(cwd) {
   writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n");
   console.log(`  Saved .agentdesk.json`);
 
+  // Ensure .agentdesk/ is gitignored (local runtime state — memory, cache, etc.)
+  const gitignorePath = join(project.dir, ".gitignore");
+  try {
+    const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
+    if (!existing.split("\n").some(line => line.trim() === ".agentdesk/" || line.trim() === ".agentdesk")) {
+      const nl = existing.endsWith("\n") || !existing ? "" : "\n";
+      writeFileSync(gitignorePath, `${existing}${nl}.agentdesk/\n`);
+      console.log(`  Added .agentdesk/ to .gitignore`);
+    }
+  } catch {}
+
   // Register in local project index (for daemon discovery)
   registerLocalProject(finalProjectKey, project.name || finalProjectKey, project.dir);
 

package/cli/orchestrator.mjs

@@ -64,8 +64,8 @@ export async function runOrchestrator({
   }
 
   const fullPrompt = soloAgent
-    ? buildSoloPrompt({ agentName: soloAgent, taskId, description, tracker, config, project, sessionUrl, childStrategy })
-    : buildPrompt({ taskId, taskLink, description, createTask, tracker, config, project, teamSections, inboxUrl, sessionUrl });
+    ? buildSoloPrompt({ agentName: soloAgent, taskId, description, tracker, config, project, sessionUrl, childStrategy, cwd })
+    : buildPrompt({ taskId, taskLink, description, createTask, tracker, config, project, teamSections, inboxUrl, sessionUrl, cwd });
 
   emit({
     type: "session:start",

package/cli/prompt.mjs

@@ -1,7 +1,7 @@
 // Shared prompt builder — used by both `agentdesk team` and `agentdesk daemon`
 
-import { readFileSync } from "fs";
-import { resolve, dirname } from "path";
+import { readFileSync, existsSync } from "fs";
+import { resolve, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { generateContext } from "./detect.mjs";
 import { BUILT_IN_AGENTS } from "./agents.mjs";
@@ -9,7 +9,30 @@ import { BUILT_IN_AGENTS } from "./agents.mjs";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PROMPT_PATH = resolve(__dirname, "../prompts/team.md");
 
-export function buildPrompt({ taskId, taskLink, description, createTask, tracker, config, project, teamSections, inboxUrl, sessionUrl }) {
+function loadProjectMemory(cwd) {
+  if (!cwd) return "";
+  const memPath = join(cwd, ".agentdesk", "memory.md");
+  try {
+    if (existsSync(memPath)) return readFileSync(memPath, "utf-8").trim();
+  } catch {}
+  return "";
+}
+
+const MEMORY_INSTRUCTIONS = `
+## Project Memory
+
+The team has a shared memory file at \`.agentdesk/memory.md\` for storing learnings that should persist across sessions. This is LOCAL and gitignored — it never leaves this machine.
+
+**When to save**: After discovering something non-obvious that cost time (test setup steps, required seed data, login credentials for test env, workarounds, environment quirks, deployment steps). If you had to figure it out, save it so you don't have to next time.
+
+**When NOT to save**: Code patterns, architecture, or anything derivable from the codebase. Don't duplicate what's already in README or CLAUDE.md.
+
+**Format**: Use clear markdown sections. Update existing sections rather than appending duplicates. Never store real secrets — reference env vars instead (e.g. \`$TEST_ADMIN_PASSWORD\`).
+
+**How**: Use the Edit or Write tool on \`.agentdesk/memory.md\`. Create the file if it doesn't exist.
+`.trim();
+
+export function buildPrompt({ taskId, taskLink, description, createTask, tracker, config, project, teamSections, inboxUrl, sessionUrl, cwd }) {
   let prompt = readFileSync(PROMPT_PATH, "utf-8");
 
   // Team substitution
@@ -99,6 +122,13 @@ export function buildPrompt({ taskId, taskLink, description, createTask, tracker
     }));
   }
 
+  // Project memory
+  const memory = loadProjectMemory(cwd);
+  prompt += `\n\n${MEMORY_INSTRUCTIONS}`;
+  if (memory) {
+    prompt += `\n\n### Current memory\n\n${memory}`;
+  }
+
   // Append project context and current time
   const context = generateContext(project);
   const now = new Date();
@@ -107,7 +137,7 @@ export function buildPrompt({ taskId, taskLink, description, createTask, tracker
   return `${prompt}\n\n---\n\n## PROJECT CONTEXT\n\n${context}\n\n${timeInfo}`;
 }
 
-export function buildSoloPrompt({ agentName, taskId, description, tracker, config, project, sessionUrl, childStrategy }) {
+export function buildSoloPrompt({ agentName, taskId, description, tracker, config, project, sessionUrl, childStrategy, cwd }) {
   const agent = BUILT_IN_AGENTS[agentName];
   if (!agent) throw new Error(`Unknown agent: ${agentName}`);
 
@@ -316,6 +346,13 @@ export function buildSoloPrompt({ agentName, taskId, description, tracker, confi
     lines.push(`## Additional Instructions`, ``, config.instructions, ``);
   }
 
+  // Project memory
+  const memory = loadProjectMemory(cwd);
+  lines.push(MEMORY_INSTRUCTIONS);
+  if (memory) {
+    lines.push(`### Current memory`, ``, memory);
+  }
+
   // Add project context
   const context = generateContext(project);
   const now = new Date();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {