@hasna/todos 0.10.19 → 0.10.21

package/dist/mcp/index.js

@@ -391,6 +391,7 @@ function ensureSchema(db) {
   ensureColumn("tasks", "spawned_from_session", "TEXT");
   ensureColumn("tasks", "assigned_by", "TEXT");
   ensureColumn("tasks", "assigned_from_project", "TEXT");
+  ensureColumn("tasks", "started_at", "TEXT");
   ensureColumn("agents", "role", "TEXT DEFAULT 'agent'");
   ensureColumn("agents", "permissions", `TEXT DEFAULT '["*"]'`);
   ensureColumn("agents", "reports_to", "TEXT");
@@ -508,6 +509,16 @@ function resolvePartialId(db, table, partialId) {
       return shortIdRows[0].id;
     }
   }
+  if (table === "task_lists") {
+    const slugRow = db.query("SELECT id FROM task_lists WHERE slug = ?").get(partialId);
+    if (slugRow)
+      return slugRow.id;
+  }
+  if (table === "projects") {
+    const nameRow = db.query("SELECT id FROM projects WHERE lower(name) = ?").get(partialId.toLowerCase());
+    if (nameRow)
+      return nameRow.id;
+  }
   return null;
 }
 var LOCK_EXPIRY_MINUTES = 30, MIGRATIONS, _db = null;
@@ -986,6 +997,15 @@ var init_database = __esm(() => {
   CREATE INDEX IF NOT EXISTS idx_file_locks_agent ON file_locks(agent_id);
   CREATE INDEX IF NOT EXISTS idx_file_locks_expires ON file_locks(expires_at);
   INSERT OR IGNORE INTO _migrations (id) VALUES (33);
+  `,
+    `
+  ALTER TABLE tasks ADD COLUMN started_at TEXT;
+  INSERT OR IGNORE INTO _migrations (id) VALUES (34);
+  `,
+    `
+  ALTER TABLE tasks ADD COLUMN task_type TEXT;
+  CREATE INDEX IF NOT EXISTS idx_tasks_task_type ON tasks(task_type);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (35);
   `
   ];
 });
@@ -1273,7 +1293,8 @@ var exports_audit = {};
 __export(exports_audit, {
   logTaskChange: () => logTaskChange,
   getTaskHistory: () => getTaskHistory,
-  getRecentActivity: () => getRecentActivity
+  getRecentActivity: () => getRecentActivity,
+  getRecap: () => getRecap
 });
 function logTaskChange(taskId, action, field, oldValue, newValue, agentId, db) {
   const d = db || getDatabase();
@@ -1291,6 +1312,32 @@ function getRecentActivity(limit = 50, db) {
   const d = db || getDatabase();
   return d.query("SELECT * FROM task_history ORDER BY created_at DESC LIMIT ?").all(limit);
 }
+function getRecap(hours = 8, projectId, db) {
+  const d = db || getDatabase();
+  const since = new Date(Date.now() - hours * 60 * 60 * 1000).toISOString();
+  const staleWindow = new Date(Date.now() - 30 * 60 * 1000).toISOString();
+  const pf = projectId ? " AND project_id = ?" : "";
+  const tpf = projectId ? " AND t.project_id = ?" : "";
+  const completed = projectId ? d.query(`SELECT id, short_id, title, assigned_to, completed_at, started_at FROM tasks WHERE status = 'completed' AND completed_at > ?${pf} ORDER BY completed_at DESC`).all(since, projectId) : d.query(`SELECT id, short_id, title, assigned_to, completed_at, started_at FROM tasks WHERE status = 'completed' AND completed_at > ? ORDER BY completed_at DESC`).all(since);
+  const created = projectId ? d.query(`SELECT id, short_id, title, agent_id, created_at FROM tasks WHERE created_at > ?${pf} ORDER BY created_at DESC`).all(since, projectId) : d.query(`SELECT id, short_id, title, agent_id, created_at FROM tasks WHERE created_at > ? ORDER BY created_at DESC`).all(since);
+  const in_progress = projectId ? d.query(`SELECT id, short_id, title, assigned_to, started_at FROM tasks WHERE status = 'in_progress' AND project_id = ? ORDER BY updated_at DESC`).all(projectId) : d.query(`SELECT id, short_id, title, assigned_to, started_at FROM tasks WHERE status = 'in_progress' ORDER BY updated_at DESC`).all();
+  const blocked = projectId ? d.query(`SELECT DISTINCT t.id, t.short_id, t.title, t.assigned_to FROM tasks t JOIN task_dependencies td ON td.task_id = t.id JOIN tasks dep ON dep.id = td.depends_on AND dep.status NOT IN ('completed','cancelled') WHERE t.status = 'pending'${tpf}`).all(projectId) : d.query(`SELECT DISTINCT t.id, t.short_id, t.title, t.assigned_to FROM tasks t JOIN task_dependencies td ON td.task_id = t.id JOIN tasks dep ON dep.id = td.depends_on AND dep.status NOT IN ('completed','cancelled') WHERE t.status = 'pending'`).all();
+  const stale = projectId ? d.query(`SELECT id, short_id, title, assigned_to, updated_at FROM tasks WHERE status = 'in_progress' AND updated_at < ? AND project_id = ? ORDER BY updated_at ASC`).all(staleWindow, projectId) : d.query(`SELECT id, short_id, title, assigned_to, updated_at FROM tasks WHERE status = 'in_progress' AND updated_at < ? ORDER BY updated_at ASC`).all(staleWindow);
+  const agents = projectId ? d.query(`SELECT a.name, a.last_seen_at, (SELECT COUNT(*) FROM tasks t WHERE (t.assigned_to = a.id OR t.agent_id = a.id) AND t.status = 'completed' AND t.completed_at > ?${tpf}) as completed_count, (SELECT COUNT(*) FROM tasks t WHERE (t.assigned_to = a.id OR t.agent_id = a.id) AND t.status = 'in_progress'${tpf}) as in_progress_count FROM agents a WHERE a.status = 'active' AND a.last_seen_at > ? ORDER BY completed_count DESC`).all(since, projectId, projectId, since) : d.query(`SELECT a.name, a.last_seen_at, (SELECT COUNT(*) FROM tasks t WHERE (t.assigned_to = a.id OR t.agent_id = a.id) AND t.status = 'completed' AND t.completed_at > ?) as completed_count, (SELECT COUNT(*) FROM tasks t WHERE (t.assigned_to = a.id OR t.agent_id = a.id) AND t.status = 'in_progress') as in_progress_count FROM agents a WHERE a.status = 'active' AND a.last_seen_at > ? ORDER BY completed_count DESC`).all(since, since);
+  return {
+    hours,
+    since,
+    completed: completed.map((r) => ({
+      ...r,
+      duration_minutes: r.started_at && r.completed_at ? Math.round((new Date(r.completed_at).getTime() - new Date(r.started_at).getTime()) / 60000) : null
+    })),
+    created,
+    in_progress,
+    blocked,
+    stale,
+    agents
+  };
+}
 var init_audit = __esm(() => {
   init_database();
 });
@@ -1619,8 +1666,8 @@ function createTask(input, db) {
   const title = shortId ? `${shortId}: ${input.title}` : input.title;
   const assignedBy = input.assigned_by || input.agent_id;
   const assignedFromProject = input.assigned_from_project || null;
-  d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, assigned_from_project)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+  d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, assigned_from_project, task_type)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
     shortId,
     input.project_id || null,
@@ -1650,7 +1697,8 @@ function createTask(input, db) {
     input.reason || null,
     input.spawned_from_session || null,
     assignedBy || null,
-    assignedFromProject || null
+    assignedFromProject || null,
+    input.task_type || null
   ]);
   if (tags.length > 0) {
     insertTaskTags(id, tags, d);
@@ -1759,6 +1807,15 @@ function listTasks(filter = {}, db) {
   } else if (filter.has_recurrence === false) {
     conditions.push("recurrence_rule IS NULL");
   }
+  if (filter.task_type) {
+    if (Array.isArray(filter.task_type)) {
+      conditions.push(`task_type IN (${filter.task_type.map(() => "?").join(",")})`);
+      params.push(...filter.task_type);
+    } else {
+      conditions.push("task_type = ?");
+      params.push(filter.task_type);
+    }
+  }
   const PRIORITY_RANK = `CASE priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 END`;
   if (filter.cursor) {
     try {
@@ -1918,6 +1975,10 @@ function updateTask(id, input, db) {
     sets.push("recurrence_rule = ?");
     params.push(input.recurrence_rule);
   }
+  if (input.task_type !== undefined) {
+    sets.push("task_type = ?");
+    params.push(input.task_type ?? null);
+  }
   params.push(id, input.version);
   const result = d.run(`UPDATE tasks SET ${sets.join(", ")} WHERE id = ? AND version = ?`, params);
   if (result.changes === 0) {
@@ -1987,8 +2048,8 @@ function startTask(id, agentId, db) {
   }
   const cutoff = lockExpiryCutoff();
   const timestamp = now();
-  const result = d.run(`UPDATE tasks SET status = 'in_progress', assigned_to = ?, locked_by = ?, locked_at = ?, version = version + 1, updated_at = ?
-     WHERE id = ? AND (locked_by IS NULL OR locked_by = ? OR locked_at < ?)`, [agentId, agentId, timestamp, timestamp, id, agentId, cutoff]);
+  const result = d.run(`UPDATE tasks SET status = 'in_progress', assigned_to = ?, locked_by = ?, locked_at = ?, started_at = COALESCE(started_at, ?), version = version + 1, updated_at = ?
+     WHERE id = ? AND (locked_by IS NULL OR locked_by = ? OR locked_at < ?)`, [agentId, agentId, timestamp, timestamp, timestamp, id, agentId, cutoff]);
   if (result.changes === 0) {
     if (task.locked_by && task.locked_by !== agentId && !isLockExpired(task.locked_at)) {
       throw new LockError(id, task.locked_by);
@@ -1996,7 +2057,7 @@ function startTask(id, agentId, db) {
   }
   logTaskChange(id, "start", "status", "pending", "in_progress", agentId, d);
   dispatchWebhook("task.started", { id, agent_id: agentId, title: task.title }, d).catch(() => {});
-  return { ...task, status: "in_progress", assigned_to: agentId, locked_by: agentId, locked_at: timestamp, version: task.version + 1, updated_at: timestamp };
+  return { ...task, status: "in_progress", assigned_to: agentId, locked_by: agentId, locked_at: timestamp, started_at: task.started_at || timestamp, version: task.version + 1, updated_at: timestamp };
 }
 function completeTask(id, agentId, db, options) {
   const d = db || getDatabase();
@@ -2647,6 +2708,7 @@ __export(exports_agents, {
   updateAgentActivity: () => updateAgentActivity,
   updateAgent: () => updateAgent,
   unarchiveAgent: () => unarchiveAgent,
+  releaseAgent: () => releaseAgent,
   registerAgent: () => registerAgent,
   matchCapabilities: () => matchCapabilities,
   listAgents: () => listAgents,
@@ -2658,10 +2720,29 @@ __export(exports_agents, {
   getAgentByName: () => getAgentByName,
   getAgent: () => getAgent,
   deleteAgent: () => deleteAgent,
+  autoReleaseStaleAgents: () => autoReleaseStaleAgents,
   archiveAgent: () => archiveAgent
 });
+function getActiveWindowMs() {
+  const env = process.env["TODOS_AGENT_TIMEOUT_MS"];
+  if (env) {
+    const parsed = parseInt(env, 10);
+    if (!isNaN(parsed) && parsed > 0)
+      return parsed;
+  }
+  return 30 * 60 * 1000;
+}
+function autoReleaseStaleAgents(db) {
+  if (process.env["TODOS_AGENT_AUTO_RELEASE"] !== "true")
+    return 0;
+  const d = db || getDatabase();
+  const cutoff = new Date(Date.now() - getActiveWindowMs()).toISOString();
+  const result = d.run("UPDATE agents SET session_id = NULL WHERE status = 'active' AND session_id IS NOT NULL AND last_seen_at < ?", [cutoff]);
+  return result.changes;
+}
 function getAvailableNamesFromPool(pool, db) {
-  const cutoff = new Date(Date.now() - AGENT_ACTIVE_WINDOW_MS).toISOString();
+  autoReleaseStaleAgents(db);
+  const cutoff = new Date(Date.now() - getActiveWindowMs()).toISOString();
   const activeNames = new Set(db.query("SELECT name FROM agents WHERE status = 'active' AND last_seen_at > ?").all(cutoff).map((r) => r.name.toLowerCase()));
   return pool.filter((name) => !activeNames.has(name.toLowerCase()));
 }
@@ -2683,22 +2764,19 @@ function registerAgent(input, db) {
   const existing = getAgentByName(normalizedName, d);
   if (existing) {
     const lastSeenMs = new Date(existing.last_seen_at).getTime();
-    const isActive = Date.now() - lastSeenMs < AGENT_ACTIVE_WINDOW_MS;
+    const activeWindowMs = getActiveWindowMs();
+    const isActive = Date.now() - lastSeenMs < activeWindowMs;
     const sameSession = input.session_id && existing.session_id && input.session_id === existing.session_id;
     const differentSession = input.session_id && existing.session_id && input.session_id !== existing.session_id;
-    if (isActive && differentSession) {
-      const minutesAgo = Math.round((Date.now() - lastSeenMs) / 60000);
-      const suggestions = input.pool ? getAvailableNamesFromPool(input.pool, d) : [];
-      return {
-        conflict: true,
-        existing_id: existing.id,
-        existing_name: existing.name,
-        last_seen_at: existing.last_seen_at,
-        session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
-        working_dir: existing.working_dir,
-        suggestions: suggestions.slice(0, 5),
-        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session \u2026${existing.session_id?.slice(-4)}, dir: ${existing.working_dir ?? "unknown"}). Cannot reclaim an active agent \u2014 choose a different name, or wait for the session to go stale.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
-      };
+    const callerHasNoSession = !input.session_id;
+    const existingHasActiveSession = existing.session_id && isActive;
+    if (!input.force) {
+      if (isActive && differentSession) {
+        return buildConflictError(existing, lastSeenMs, input.pool, d);
+      }
+      if (callerHasNoSession && existingHasActiveSession) {
+        return buildConflictError(existing, lastSeenMs, input.pool, d);
+      }
     }
     const updates = ["last_seen_at = ?", "status = 'active'"];
     const params = [now()];
@@ -2743,6 +2821,32 @@ function registerAgent(input, db) {
 function isAgentConflict(result) {
   return result.conflict === true;
 }
+function buildConflictError(existing, lastSeenMs, pool, d) {
+  const minutesAgo = Math.round((Date.now() - lastSeenMs) / 60000);
+  const suggestions = pool ? getAvailableNamesFromPool(pool, d) : [];
+  return {
+    conflict: true,
+    existing_id: existing.id,
+    existing_name: existing.name,
+    last_seen_at: existing.last_seen_at,
+    session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
+    working_dir: existing.working_dir,
+    suggestions: suggestions.slice(0, 5),
+    message: `Agent "${existing.name}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id ? "\u2026" + existing.session_id.slice(-4) : "none"}, dir: ${existing.working_dir ?? "unknown"}). Pass force: true to take over, or choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
+  };
+}
+function releaseAgent(id, session_id, db) {
+  const d = db || getDatabase();
+  const agent = getAgent(id, d);
+  if (!agent)
+    return false;
+  if (session_id && agent.session_id && agent.session_id !== session_id) {
+    return false;
+  }
+  const epoch = new Date(0).toISOString();
+  d.run("UPDATE agents SET session_id = NULL, last_seen_at = ? WHERE id = ?", [epoch, id]);
+  return true;
+}
 function getAgent(id, db) {
   const d = db || getDatabase();
   const row = d.query("SELECT * FROM agents WHERE id = ?").get(id);
@@ -2763,6 +2867,7 @@ function listAgents(opts, db) {
     includeArchived = opts?.include_archived ?? false;
     d = db || getDatabase();
   }
+  autoReleaseStaleAgents(d);
   if (includeArchived) {
     return d.query("SELECT * FROM agents ORDER BY name").all().map(rowToAgent);
   }
@@ -2780,8 +2885,19 @@ function updateAgent(id, input, db) {
   const sets = ["last_seen_at = ?"];
   const params = [now()];
   if (input.name !== undefined) {
+    const newName = input.name.trim().toLowerCase();
+    const holder = getAgentByName(newName, d);
+    if (holder && holder.id !== id) {
+      const lastSeenMs = new Date(holder.last_seen_at).getTime();
+      const isActive = Date.now() - lastSeenMs < getActiveWindowMs();
+      if (isActive && holder.status === "active") {
+        throw new Error(`Cannot rename: name "${newName}" is held by active agent ${holder.id} (last seen ${Math.round((Date.now() - lastSeenMs) / 60000)}m ago)`);
+      }
+      const evictedName = `${holder.name}__evicted_${holder.id}`;
+      d.run("UPDATE agents SET name = ? WHERE id = ?", [evictedName, holder.id]);
+    }
     sets.push("name = ?");
-    params.push(input.name.trim().toLowerCase());
+    params.push(newName);
   }
   if (input.description !== undefined) {
     sets.push("description = ?");
@@ -2878,10 +2994,8 @@ function getCapableAgents(capabilities, opts, db) {
   })).filter((entry) => entry.score >= minScore).sort((a, b) => b.score - a.score);
   return opts?.limit ? scored.slice(0, opts.limit) : scored;
 }
-var AGENT_ACTIVE_WINDOW_MS;
 var init_agents = __esm(() => {
   init_database();
-  AGENT_ACTIVE_WINDOW_MS = 30 * 60 * 1000;
 });
 
 // src/db/task-commits.ts
@@ -2928,160 +3042,63 @@ var init_task_commits = __esm(() => {
   init_database();
 });
 
-// src/lib/auto-assign.ts
-var exports_auto_assign = {};
-__export(exports_auto_assign, {
-  findBestAgent: () => findBestAgent,
-  autoAssignTask: () => autoAssignTask
+// src/lib/github.ts
+var exports_github = {};
+__export(exports_github, {
+  parseGitHubUrl: () => parseGitHubUrl,
+  issueToTask: () => issueToTask,
+  fetchGitHubIssue: () => fetchGitHubIssue
 });
-function findBestAgent(_task, db) {
-  const d = db || getDatabase();
-  const agents = listAgents(d).filter((a) => (a.role || "agent") === "agent");
-  if (agents.length === 0)
+import { execSync } from "child_process";
+function parseGitHubUrl(url) {
+  const match = url.match(/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/);
+  if (!match)
     return null;
-  const inProgressTasks = listTasks({ status: "in_progress" }, d);
-  const load = new Map;
-  for (const a of agents)
-    load.set(a.name, 0);
-  for (const t of inProgressTasks) {
-    const name = t.assigned_to || t.agent_id;
-    if (name && load.has(name)) {
-      load.set(name, (load.get(name) || 0) + 1);
-    }
-  }
-  let bestAgent = agents[0].name;
-  let bestLoad = load.get(bestAgent) ?? 0;
-  for (const a of agents) {
-    const l = load.get(a.name) ?? 0;
-    if (l < bestLoad) {
-      bestAgent = a.name;
-      bestLoad = l;
-    }
-  }
-  return bestAgent;
+  return { owner: match[1], repo: match[2], number: parseInt(match[3], 10) };
 }
-function getAgentWorkloads(d) {
-  const rows = d.query("SELECT assigned_to, COUNT(*) as count FROM tasks WHERE status = 'in_progress' AND assigned_to IS NOT NULL GROUP BY assigned_to").all();
-  return new Map(rows.map((r) => [r.assigned_to, r.count]));
-}
-function buildPrompt(task, agents) {
-  const agentList = agents.map((a) => `- ${a.name} (role: ${a.role}, caps: [${a.capabilities.join(", ")}], active_tasks: ${a.in_progress_tasks})`).join(`
-`);
-  return `You are a task routing assistant. Given a task and available agents, choose the SINGLE best agent.
-
-TASK:
-Title: ${task.title}
-Priority: ${task.priority}
-Tags: ${task.tags.join(", ") || "none"}
-Description: ${task.description?.slice(0, 300) || "none"}
-
-AVAILABLE AGENTS:
-${agentList}
-
-Rules:
-- Match task tags/content to agent capabilities
-- Prefer agents with fewer active tasks
-- Prefer agents whose role fits the task (lead for critical, developer for features, qa for testing)
-- If no clear match, pick the agent with fewest active tasks
-
-Respond with ONLY a JSON object: {"agent_name": "<name>", "reason": "<one sentence>"}`;
-}
-async function callCerebras(prompt, apiKey) {
-  try {
-    const resp = await fetch(CEREBRAS_API_URL, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
-      body: JSON.stringify({
-        model: CEREBRAS_MODEL,
-        messages: [{ role: "user", content: prompt }],
-        max_tokens: 150,
-        temperature: 0
-      }),
-      signal: AbortSignal.timeout(1e4)
-    });
-    if (!resp.ok)
-      return null;
-    const data = await resp.json();
-    const content = data?.choices?.[0]?.message?.content?.trim();
-    if (!content)
-      return null;
-    const match = content.match(/\{[^}]+\}/s);
-    if (!match)
-      return null;
-    return JSON.parse(match[0]);
-  } catch {
-    return null;
-  }
+function fetchGitHubIssue(owner, repo, number) {
+  const json = execSync(`gh api repos/${owner}/${repo}/issues/${number}`, { encoding: "utf-8", timeout: 15000 });
+  const data = JSON.parse(json);
+  return {
+    number: data.number,
+    title: data.title,
+    body: data.body,
+    labels: (data.labels || []).map((l) => l.name),
+    state: data.state,
+    assignee: data.assignee?.login || null,
+    url: data.html_url
+  };
 }
-async function autoAssignTask(taskId, db) {
-  const d = db || getDatabase();
-  const task = getTask(taskId, d);
-  if (!task)
-    throw new Error(`Task ${taskId} not found`);
-  const agents = listAgents(d).filter((a) => a.status === "active");
-  if (agents.length === 0) {
-    return { task_id: taskId, assigned_to: null, agent_name: null, method: "no_agents" };
-  }
-  const workloads = getAgentWorkloads(d);
-  const apiKey = process.env["CEREBRAS_API_KEY"];
-  let selectedAgent = null;
-  let method = "capability_match";
-  let reason;
-  if (apiKey) {
-    const agentData = agents.map((a) => ({
-      id: a.id,
-      name: a.name,
-      role: a.role || "agent",
-      capabilities: a.capabilities || [],
-      in_progress_tasks: workloads.get(a.id) ?? 0
-    }));
-    const result = await callCerebras(buildPrompt({
-      title: task.title,
-      description: task.description,
-      priority: task.priority,
-      tags: task.tags || []
-    }, agentData), apiKey);
-    if (result?.agent_name) {
-      selectedAgent = agents.find((a) => a.name === result.agent_name) ?? null;
-      if (selectedAgent) {
-        method = "cerebras";
-        reason = result.reason;
-      }
-    }
-  }
-  if (!selectedAgent) {
-    const taskTags = task.tags || [];
-    const capable = getCapableAgents(taskTags, { min_score: 0, limit: 10 }, d);
-    if (capable.length > 0) {
-      const sorted = capable.sort((a, b) => {
-        if (b.score !== a.score)
-          return b.score - a.score;
-        return (workloads.get(a.agent.id) ?? 0) - (workloads.get(b.agent.id) ?? 0);
-      });
-      selectedAgent = sorted[0].agent;
-      reason = `Capability match (score: ${sorted[0].score.toFixed(2)})`;
-    } else {
-      selectedAgent = agents.slice().sort((a, b) => (workloads.get(a.id) ?? 0) - (workloads.get(b.id) ?? 0))[0];
-      reason = `Least busy agent (${workloads.get(selectedAgent.id) ?? 0} active tasks)`;
+function issueToTask(issue, opts) {
+  const labelToPriority = {
+    critical: "critical",
+    "priority:critical": "critical",
+    high: "high",
+    "priority:high": "high",
+    urgent: "high",
+    low: "low",
+    "priority:low": "low"
+  };
+  let priority = "medium";
+  for (const label of issue.labels) {
+    const mapped = labelToPriority[label.toLowerCase()];
+    if (mapped) {
+      priority = mapped;
+      break;
     }
   }
-  if (selectedAgent) {
-    updateTask(taskId, { assigned_to: selectedAgent.id, version: task.version }, d);
-  }
   return {
-    task_id: taskId,
-    assigned_to: selectedAgent?.id ?? null,
-    agent_name: selectedAgent?.name ?? null,
-    method,
-    reason
+    title: `[GH#${issue.number}] ${issue.title}`,
+    description: issue.body ? issue.body.slice(0, 4000) : undefined,
+    tags: issue.labels.slice(0, 10),
+    priority,
+    metadata: { github_url: issue.url, github_number: issue.number, github_state: issue.state },
+    project_id: opts?.project_id,
+    task_list_id: opts?.task_list_id,
+    agent_id: opts?.agent_id
   };
 }
-var CEREBRAS_API_URL = "https://api.cerebras.ai/v1/chat/completions", CEREBRAS_MODEL = "llama-3.3-70b";
-var init_auto_assign = __esm(() => {
-  init_database();
-  init_tasks();
-  init_agents();
-});
+var init_github = () => {};
 
 // src/db/task-files.ts
 var exports_task_files = {};
@@ -3241,12 +3258,254 @@ function bulkAddTaskFiles(taskId, paths, agentId, db) {
     for (const path of paths) {
       results.push(addTaskFile({ task_id: taskId, path, agent_id: agentId }, d));
     }
-  });
-  tx();
-  return results;
+  });
+  tx();
+  return results;
+}
+var init_task_files = __esm(() => {
+  init_database();
+});
+
+// src/lib/burndown.ts
+var exports_burndown = {};
+__export(exports_burndown, {
+  getBurndown: () => getBurndown
+});
+function getBurndown(opts, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (opts.plan_id) {
+    conditions.push("plan_id = ?");
+    params.push(opts.plan_id);
+  }
+  if (opts.project_id) {
+    conditions.push("project_id = ?");
+    params.push(opts.project_id);
+  }
+  if (opts.task_list_id) {
+    conditions.push("task_list_id = ?");
+    params.push(opts.task_list_id);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const total = d.query(`SELECT COUNT(*) as c FROM tasks ${where}`).get(...params).c;
+  const completed = d.query(`SELECT COUNT(*) as c FROM tasks ${where}${where ? " AND" : " WHERE"} status = 'completed'`).get(...params).c;
+  const completions = d.query(`SELECT DATE(completed_at) as date, COUNT(*) as count FROM tasks ${where}${where ? " AND" : " WHERE"} status = 'completed' AND completed_at IS NOT NULL GROUP BY DATE(completed_at) ORDER BY date`).all(...params);
+  const firstTask = d.query(`SELECT MIN(created_at) as min_date FROM tasks ${where}`).get(...params);
+  const startDate = firstTask?.min_date ? new Date(firstTask.min_date) : new Date;
+  const endDate = new Date;
+  const days = [];
+  const totalDays = Math.max(1, Math.ceil((endDate.getTime() - startDate.getTime()) / (24 * 60 * 60 * 1000)));
+  let cumulative = 0;
+  const completionMap = new Map(completions.map((c) => [c.date, c.count]));
+  const current = new Date(startDate);
+  for (let i = 0;i <= totalDays; i++) {
+    const dateStr = current.toISOString().slice(0, 10);
+    cumulative += completionMap.get(dateStr) || 0;
+    days.push({
+      date: dateStr,
+      completed_cumulative: cumulative,
+      ideal: Math.round(total / totalDays * i)
+    });
+    current.setDate(current.getDate() + 1);
+  }
+  const chart = renderBurndownChart(total, days);
+  return { total, completed, remaining: total - completed, days, chart };
+}
+function renderBurndownChart(total, days) {
+  const height = 12;
+  const width = Math.min(60, days.length);
+  const step = Math.max(1, Math.floor(days.length / width));
+  const sampled = days.filter((_, i) => i % step === 0 || i === days.length - 1).slice(0, width);
+  const lines = [];
+  lines.push(`  ${total} \u2524`);
+  for (let row = height - 1;row >= 0; row--) {
+    const threshold = Math.round(total / height * row);
+    let line = "";
+    for (const day of sampled) {
+      const remaining = total - day.completed_cumulative;
+      const idealRemaining = total - day.ideal;
+      if (remaining >= threshold && remaining > threshold - Math.round(total / height)) {
+        line += "\u2588";
+      } else if (idealRemaining >= threshold && idealRemaining > threshold - Math.round(total / height)) {
+        line += "\xB7";
+      } else {
+        line += " ";
+      }
+    }
+    const label = String(threshold).padStart(4);
+    lines.push(`${label} \u2524${line}`);
+  }
+  lines.push(`   0 \u2524${"\u2500".repeat(sampled.length)}`);
+  lines.push(`     \u2514${"\u2500".repeat(sampled.length)}`);
+  if (sampled.length > 0) {
+    const first = sampled[0].date.slice(5);
+    const last = sampled[sampled.length - 1].date.slice(5);
+    const pad = sampled.length - first.length - last.length;
+    lines.push(`      ${first}${" ".repeat(Math.max(1, pad))}${last}`);
+  }
+  lines.push("");
+  lines.push(`  \u2588 actual remaining  \xB7 ideal burndown`);
+  return lines.join(`
+`);
+}
+var init_burndown = __esm(() => {
+  init_database();
+});
+
+// src/lib/auto-assign.ts
+var exports_auto_assign = {};
+__export(exports_auto_assign, {
+  findBestAgent: () => findBestAgent,
+  autoAssignTask: () => autoAssignTask
+});
+function findBestAgent(_task, db) {
+  const d = db || getDatabase();
+  const agents = listAgents(d).filter((a) => (a.role || "agent") === "agent");
+  if (agents.length === 0)
+    return null;
+  const inProgressTasks = listTasks({ status: "in_progress" }, d);
+  const load = new Map;
+  for (const a of agents)
+    load.set(a.name, 0);
+  for (const t of inProgressTasks) {
+    const name = t.assigned_to || t.agent_id;
+    if (name && load.has(name)) {
+      load.set(name, (load.get(name) || 0) + 1);
+    }
+  }
+  let bestAgent = agents[0].name;
+  let bestLoad = load.get(bestAgent) ?? 0;
+  for (const a of agents) {
+    const l = load.get(a.name) ?? 0;
+    if (l < bestLoad) {
+      bestAgent = a.name;
+      bestLoad = l;
+    }
+  }
+  return bestAgent;
+}
+function getAgentWorkloads(d) {
+  const rows = d.query("SELECT assigned_to, COUNT(*) as count FROM tasks WHERE status = 'in_progress' AND assigned_to IS NOT NULL GROUP BY assigned_to").all();
+  return new Map(rows.map((r) => [r.assigned_to, r.count]));
+}
+function buildPrompt(task, agents) {
+  const agentList = agents.map((a) => `- ${a.name} (role: ${a.role}, caps: [${a.capabilities.join(", ")}], active_tasks: ${a.in_progress_tasks})`).join(`
+`);
+  return `You are a task routing assistant. Given a task and available agents, choose the SINGLE best agent.
+
+TASK:
+Title: ${task.title}
+Priority: ${task.priority}
+Tags: ${task.tags.join(", ") || "none"}
+Description: ${task.description?.slice(0, 300) || "none"}
+
+AVAILABLE AGENTS:
+${agentList}
+
+Rules:
+- Match task tags/content to agent capabilities
+- Prefer agents with fewer active tasks
+- Prefer agents whose role fits the task (lead for critical, developer for features, qa for testing)
+- If no clear match, pick the agent with fewest active tasks
+
+Respond with ONLY a JSON object: {"agent_name": "<name>", "reason": "<one sentence>"}`;
+}
+async function callCerebras(prompt, apiKey) {
+  try {
+    const resp = await fetch(CEREBRAS_API_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
+      body: JSON.stringify({
+        model: CEREBRAS_MODEL,
+        messages: [{ role: "user", content: prompt }],
+        max_tokens: 150,
+        temperature: 0
+      }),
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!resp.ok)
+      return null;
+    const data = await resp.json();
+    const content = data?.choices?.[0]?.message?.content?.trim();
+    if (!content)
+      return null;
+    const match = content.match(/\{[^}]+\}/s);
+    if (!match)
+      return null;
+    return JSON.parse(match[0]);
+  } catch {
+    return null;
+  }
+}
+async function autoAssignTask(taskId, db) {
+  const d = db || getDatabase();
+  const task = getTask(taskId, d);
+  if (!task)
+    throw new Error(`Task ${taskId} not found`);
+  const agents = listAgents(d).filter((a) => a.status === "active");
+  if (agents.length === 0) {
+    return { task_id: taskId, assigned_to: null, agent_name: null, method: "no_agents" };
+  }
+  const workloads = getAgentWorkloads(d);
+  const apiKey = process.env["CEREBRAS_API_KEY"];
+  let selectedAgent = null;
+  let method = "capability_match";
+  let reason;
+  if (apiKey) {
+    const agentData = agents.map((a) => ({
+      id: a.id,
+      name: a.name,
+      role: a.role || "agent",
+      capabilities: a.capabilities || [],
+      in_progress_tasks: workloads.get(a.id) ?? 0
+    }));
+    const result = await callCerebras(buildPrompt({
+      title: task.title,
+      description: task.description,
+      priority: task.priority,
+      tags: task.tags || []
+    }, agentData), apiKey);
+    if (result?.agent_name) {
+      selectedAgent = agents.find((a) => a.name === result.agent_name) ?? null;
+      if (selectedAgent) {
+        method = "cerebras";
+        reason = result.reason;
+      }
+    }
+  }
+  if (!selectedAgent) {
+    const taskTags = task.tags || [];
+    const capable = getCapableAgents(taskTags, { min_score: 0, limit: 10 }, d);
+    if (capable.length > 0) {
+      const sorted = capable.sort((a, b) => {
+        if (b.score !== a.score)
+          return b.score - a.score;
+        return (workloads.get(a.agent.id) ?? 0) - (workloads.get(b.agent.id) ?? 0);
+      });
+      selectedAgent = sorted[0].agent;
+      reason = `Capability match (score: ${sorted[0].score.toFixed(2)})`;
+    } else {
+      selectedAgent = agents.slice().sort((a, b) => (workloads.get(a.id) ?? 0) - (workloads.get(b.id) ?? 0))[0];
+      reason = `Least busy agent (${workloads.get(selectedAgent.id) ?? 0} active tasks)`;
+    }
+  }
+  if (selectedAgent) {
+    updateTask(taskId, { assigned_to: selectedAgent.id, version: task.version }, d);
+  }
+  return {
+    task_id: taskId,
+    assigned_to: selectedAgent?.id ?? null,
+    agent_name: selectedAgent?.name ?? null,
+    method,
+    reason
+  };
 }
-var init_task_files = __esm(() => {
+var CEREBRAS_API_URL = "https://api.cerebras.ai/v1/chat/completions", CEREBRAS_MODEL = "llama-3.3-70b";
+var init_auto_assign = __esm(() => {
   init_database();
+  init_tasks();
+  init_agents();
 });
 
 // src/db/file-locks.ts
@@ -4041,6 +4300,212 @@ var init_agent_metrics = __esm(() => {
   init_database();
 });
 
+// src/lib/extract.ts
+var exports_extract = {};
+__export(exports_extract, {
+  tagToPriority: () => tagToPriority,
+  extractTodos: () => extractTodos,
+  extractFromSource: () => extractFromSource,
+  EXTRACT_TAGS: () => EXTRACT_TAGS
+});
+import { readFileSync as readFileSync3, statSync as statSync2 } from "fs";
+import { relative, resolve as resolve2, join as join6 } from "path";
+function tagToPriority(tag) {
+  switch (tag) {
+    case "BUG":
+    case "FIXME":
+      return "high";
+    case "HACK":
+    case "XXX":
+      return "medium";
+    case "TODO":
+      return "medium";
+    case "NOTE":
+      return "low";
+  }
+}
+function buildTagRegex(tags) {
+  const tagPattern = tags.join("|");
+  return new RegExp(`(?:^|\\s)(?:\\/\\/|\\/\\*|#|\\*|--|;;|%|<!--|\\{-)\\s*(?:@?)(${tagPattern})\\s*[:(]?\\s*(.*)$`, "i");
+}
+function extractFromSource(source, filePath, tags = [...EXTRACT_TAGS]) {
+  const regex = buildTagRegex(tags);
+  const results = [];
+  const lines = source.split(`
+`);
+  for (let i = 0;i < lines.length; i++) {
+    const line = lines[i];
+    const match = line.match(regex);
+    if (match) {
+      const tag = match[1].toUpperCase();
+      let message = match[2].trim();
+      message = message.replace(/\s*\*\/\s*$/, "").replace(/\s*-->\s*$/, "").replace(/\s*-\}\s*$/, "").trim();
+      if (message) {
+        results.push({
+          tag,
+          message,
+          file: filePath,
+          line: i + 1,
+          raw: line
+        });
+      }
+    }
+  }
+  return results;
+}
+function collectFiles(basePath, extensions) {
+  const stat = statSync2(basePath);
+  if (stat.isFile()) {
+    return [basePath];
+  }
+  const glob = new Bun.Glob("**/*");
+  const files = [];
+  for (const entry of glob.scanSync({ cwd: basePath, onlyFiles: true, dot: false })) {
+    const parts = entry.split("/");
+    if (parts.some((p) => SKIP_DIRS.has(p)))
+      continue;
+    const dotIdx = entry.lastIndexOf(".");
+    if (dotIdx === -1)
+      continue;
+    const ext = entry.slice(dotIdx);
+    if (!extensions.has(ext))
+      continue;
+    files.push(entry);
+  }
+  return files.sort();
+}
+function extractTodos(options, db) {
+  const basePath = resolve2(options.path);
+  const tags = options.patterns || [...EXTRACT_TAGS];
+  const extensions = options.extensions ? new Set(options.extensions.map((e) => e.startsWith(".") ? e : `.${e}`)) : DEFAULT_EXTENSIONS;
+  const files = collectFiles(basePath, extensions);
+  const allComments = [];
+  for (const file of files) {
+    const fullPath = statSync2(basePath).isFile() ? basePath : join6(basePath, file);
+    try {
+      const source = readFileSync3(fullPath, "utf-8");
+      const relPath = statSync2(basePath).isFile() ? relative(resolve2(basePath, ".."), fullPath) : file;
+      const comments = extractFromSource(source, relPath, tags);
+      allComments.push(...comments);
+    } catch {}
+  }
+  if (options.dry_run) {
+    return { comments: allComments, tasks: [], skipped: 0 };
+  }
+  const tasks = [];
+  let skipped = 0;
+  const existingTasks = options.project_id ? listTasks({ project_id: options.project_id, tags: ["extracted"] }, db) : listTasks({ tags: ["extracted"] }, db);
+  const existingKeys = new Set;
+  for (const t of existingTasks) {
+    const meta = t.metadata;
+    if (meta?.["source_file"] && meta?.["source_line"]) {
+      existingKeys.add(`${meta["source_file"]}:${meta["source_line"]}`);
+    }
+  }
+  for (const comment of allComments) {
+    const dedupKey = `${comment.file}:${comment.line}`;
+    if (existingKeys.has(dedupKey)) {
+      skipped++;
+      continue;
+    }
+    const taskTags = ["extracted", comment.tag.toLowerCase(), ...options.tags || []];
+    const task = createTask({
+      title: `[${comment.tag}] ${comment.message}`,
+      description: `Extracted from code comment in \`${comment.file}\` at line ${comment.line}:
+\`\`\`
+${comment.raw.trim()}
+\`\`\``,
+      priority: tagToPriority(comment.tag),
+      project_id: options.project_id,
+      task_list_id: options.task_list_id,
+      assigned_to: options.assigned_to,
+      agent_id: options.agent_id,
+      tags: taskTags,
+      metadata: {
+        source: "code_comment",
+        comment_type: comment.tag,
+        source_file: comment.file,
+        source_line: comment.line
+      }
+    }, db);
+    addTaskFile({
+      task_id: task.id,
+      path: comment.file,
+      note: `Line ${comment.line}: ${comment.tag} comment`
+    }, db);
+    tasks.push(task);
+    existingKeys.add(dedupKey);
+  }
+  return { comments: allComments, tasks, skipped };
+}
+var EXTRACT_TAGS, DEFAULT_EXTENSIONS, SKIP_DIRS;
+var init_extract = __esm(() => {
+  init_tasks();
+  init_task_files();
+  EXTRACT_TAGS = ["TODO", "FIXME", "HACK", "XXX", "BUG", "NOTE"];
+  DEFAULT_EXTENSIONS = new Set([
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".py",
+    ".rb",
+    ".go",
+    ".rs",
+    ".c",
+    ".cpp",
+    ".h",
+    ".hpp",
+    ".java",
+    ".kt",
+    ".swift",
+    ".cs",
+    ".php",
+    ".sh",
+    ".bash",
+    ".zsh",
+    ".lua",
+    ".sql",
+    ".r",
+    ".R",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".css",
+    ".scss",
+    ".less",
+    ".vue",
+    ".svelte",
+    ".ex",
+    ".exs",
+    ".erl",
+    ".hs",
+    ".ml",
+    ".mli",
+    ".clj",
+    ".cljs"
+  ]);
+  SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    "out",
+    ".next",
+    ".turbo",
+    "coverage",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "vendor",
+    "target",
+    ".cache",
+    ".parcel-cache"
+  ]);
+});
+
 // src/mcp/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -8828,14 +9293,14 @@ init_config();
 init_database();
 init_checklists();
 init_types();
-import { readFileSync as readFileSync3 } from "fs";
-import { join as join6, dirname as dirname2 } from "path";
+import { readFileSync as readFileSync4 } from "fs";
+import { join as join7, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
 function getMcpVersion() {
   try {
     const __dir = dirname2(fileURLToPath(import.meta.url));
-    const pkgPath = join6(__dir, "..", "package.json");
-    return JSON.parse(readFileSync3(pkgPath, "utf-8")).version || "0.0.0";
+    const pkgPath = join7(__dir, "..", "package.json");
+    return JSON.parse(readFileSync4(pkgPath, "utf-8")).version || "0.0.0";
   } catch {
     return "0.0.0";
   }
@@ -8857,7 +9322,8 @@ var MINIMAL_TOOLS = new Set([
   "get_next_task",
   "bootstrap",
   "get_tasks_changed_since",
-  "heartbeat"
+  "heartbeat",
+  "release_agent"
 ]);
 var STANDARD_EXCLUDED = new Set([
   "rename_agent",
@@ -9018,7 +9484,8 @@ if (shouldRegisterTool("create_task")) {
     spawns_template_id: exports_external.string().optional().describe("Template ID to auto-create as next task when this task is completed (pipeline/handoff chains)"),
     reason: exports_external.string().optional().describe("Why this task exists \u2014 context for agents picking it up"),
     spawned_from_session: exports_external.string().optional().describe("Session ID that created this task (for tracing task lineage)"),
-    assigned_from_project: exports_external.string().optional().describe("Override: project ID the assigning agent is working from. Auto-detected from agent focus if omitted.")
+    assigned_from_project: exports_external.string().optional().describe("Override: project ID the assigning agent is working from. Auto-detected from agent focus if omitted."),
+    task_type: exports_external.string().optional().describe("Task type: bug, feature, chore, improvement, docs, test, security, or any custom string")
   }, async (params) => {
     try {
       if (!params.agent_id) {
@@ -9064,6 +9531,7 @@ if (shouldRegisterTool("list_tasks")) {
     has_recurrence: exports_external.boolean().optional(),
     due_today: exports_external.boolean().optional(),
     overdue: exports_external.boolean().optional(),
+    task_type: exports_external.union([exports_external.string(), exports_external.array(exports_external.string())]).optional().describe("Filter by task type: bug, feature, chore, improvement, docs, test, security, or custom"),
     limit: exports_external.number().optional(),
     offset: exports_external.number().optional(),
     summary_only: exports_external.boolean().optional().describe("When true, return only id, short_id, title, status, priority \u2014 minimal tokens for navigation"),
@@ -9198,11 +9666,17 @@ if (shouldRegisterTool("update_task")) {
     tags: exports_external.array(exports_external.string()).optional(),
     metadata: exports_external.record(exports_external.unknown()).optional(),
     plan_id: exports_external.string().optional(),
-    task_list_id: exports_external.string().optional()
+    task_list_id: exports_external.string().optional(),
+    task_type: exports_external.string().nullable().optional().describe("Task type: bug, feature, chore, improvement, docs, test, security, or custom. null to clear.")
   }, async ({ id, ...rest }) => {
     try {
       const resolvedId = resolveId(id);
-      const task = updateTask(resolvedId, rest);
+      const resolved = { ...rest };
+      if (resolved.task_list_id)
+        resolved.task_list_id = resolveId(resolved.task_list_id, "task_lists");
+      if (resolved.plan_id)
+        resolved.plan_id = resolveId(resolved.plan_id, "plans");
+      const task = updateTask(resolvedId, resolved);
       return { content: [{ type: "text", text: `updated: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
@@ -9842,11 +10316,12 @@ if (shouldRegisterTool("register_agent")) {
     description: exports_external.string().optional(),
     capabilities: exports_external.array(exports_external.string()).optional().describe("Agent capabilities/skills for task routing (e.g. ['typescript', 'testing', 'devops'])"),
     session_id: exports_external.string().optional().describe("Unique ID for this coding session (e.g. process PID + timestamp, or env var). Used to detect name collisions across sessions. Store it and pass on every register_agent call."),
-    working_dir: exports_external.string().optional().describe("Working directory of this session \u2014 used to look up the project's agent pool and identify who holds the name in a conflict")
-  }, async ({ name, description, capabilities, session_id, working_dir }) => {
+    working_dir: exports_external.string().optional().describe("Working directory of this session \u2014 used to look up the project's agent pool and identify who holds the name in a conflict"),
+    force: exports_external.boolean().optional().describe("Force takeover of an active agent's name. Use with caution \u2014 only when you know the previous session is dead.")
+  }, async ({ name, description, capabilities, session_id, working_dir, force }) => {
     try {
       const pool = getAgentPoolForProject(working_dir);
-      const result = registerAgent({ name, description, capabilities, session_id, working_dir, pool: pool || undefined });
+      const result = registerAgent({ name, description, capabilities, session_id, working_dir, force, pool: pool || undefined });
       if (isAgentConflict(result)) {
         const suggestLine = result.suggestions && result.suggestions.length > 0 ? `
 Available names: ${result.suggestions.join(", ")}` : "";
@@ -10065,6 +10540,31 @@ if (shouldRegisterTool("heartbeat")) {
     }
   });
 }
+if (shouldRegisterTool("release_agent")) {
+  server.tool("release_agent", "Explicitly release/logout an agent \u2014 clears session binding and makes the name immediately available. Call this when your session ends instead of waiting for the 30-minute stale timeout.", {
+    agent_id: exports_external.string().describe("Your agent ID or name."),
+    session_id: exports_external.string().optional().describe("Your session ID \u2014 if provided, release only succeeds if it matches (prevents other sessions from releasing your agent).")
+  }, async ({ agent_id, session_id }) => {
+    try {
+      const agent = getAgent(agent_id) || getAgentByName(agent_id);
+      if (!agent) {
+        return { content: [{ type: "text", text: `Agent not found: ${agent_id}` }], isError: true };
+      }
+      const released = releaseAgent(agent.id, session_id);
+      if (!released) {
+        return { content: [{ type: "text", text: `Release denied: session_id does not match agent's current session.` }], isError: true };
+      }
+      return {
+        content: [{
+          type: "text",
+          text: `Agent released: ${agent.name} (${agent.id}) \u2014 session cleared, name is now available.`
+        }]
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("create_task_list")) {
   server.tool("create_task_list", "Create a task list container for organizing tasks.", {
     name: exports_external.string(),
@@ -10223,6 +10723,178 @@ ${text}` }] };
     }
   });
 }
+if (shouldRegisterTool("recap")) {
+  server.tool("recap", "Get a summary of what happened in the last N hours \u2014 completed tasks with duration, new tasks, in-progress work, blockers, stale tasks, and agent activity. Great for session start or standup prep.", {
+    hours: exports_external.number().optional().describe("Look back N hours (default: 8)"),
+    project_id: exports_external.string().optional().describe("Filter to a specific project")
+  }, async ({ hours, project_id }) => {
+    try {
+      const { getRecap: getRecap2 } = await Promise.resolve().then(() => (init_audit(), exports_audit));
+      const recap = getRecap2(hours || 8, project_id);
+      const lines = [`Recap \u2014 last ${recap.hours}h (since ${recap.since})`];
+      if (recap.completed.length > 0) {
+        lines.push(`
+Completed (${recap.completed.length}):`);
+        for (const t of recap.completed) {
+          const dur = t.duration_minutes != null ? ` (${t.duration_minutes}m)` : "";
+          lines.push(`  \u2713 ${t.short_id || t.id.slice(0, 8)} ${t.title}${dur}${t.assigned_to ? ` \u2014 ${t.assigned_to}` : ""}`);
+        }
+      }
+      if (recap.in_progress.length > 0) {
+        lines.push(`
+In Progress (${recap.in_progress.length}):`);
+        for (const t of recap.in_progress)
+          lines.push(`  \u2192 ${t.short_id || t.id.slice(0, 8)} ${t.title}${t.assigned_to ? ` \u2014 ${t.assigned_to}` : ""}`);
+      }
+      if (recap.blocked.length > 0) {
+        lines.push(`
+Blocked (${recap.blocked.length}):`);
+        for (const t of recap.blocked)
+          lines.push(`  \u2717 ${t.short_id || t.id.slice(0, 8)} ${t.title}`);
+      }
+      if (recap.stale.length > 0) {
+        lines.push(`
+Stale (${recap.stale.length}):`);
+        for (const t of recap.stale)
+          lines.push(`  ! ${t.short_id || t.id.slice(0, 8)} ${t.title} \u2014 updated ${t.updated_at}`);
+      }
+      if (recap.agents.length > 0) {
+        lines.push(`
+Agents:`);
+        for (const a of recap.agents)
+          lines.push(`  ${a.name}: ${a.completed_count} done, ${a.in_progress_count} active (seen ${a.last_seen_at})`);
+      }
+      lines.push(`
+Created: ${recap.created.length} new tasks`);
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("standup")) {
+  server.tool("standup", "Generate standup notes \u2014 completed tasks since yesterday grouped by agent, in-progress work, and blockers. Copy-paste ready.", {
+    hours: exports_external.number().optional().describe("Look back N hours (default: 24)"),
+    project_id: exports_external.string().optional()
+  }, async ({ hours, project_id }) => {
+    try {
+      const { getRecap: getRecap2 } = await Promise.resolve().then(() => (init_audit(), exports_audit));
+      const recap = getRecap2(hours || 24, project_id);
+      const lines = [`Standup \u2014 last ${recap.hours}h`];
+      const byAgent = new Map;
+      for (const t of recap.completed) {
+        const agent = t.assigned_to || "unassigned";
+        if (!byAgent.has(agent))
+          byAgent.set(agent, []);
+        byAgent.get(agent).push(t);
+      }
+      if (byAgent.size > 0) {
+        lines.push(`
+Done:`);
+        for (const [agent, tasks] of byAgent) {
+          lines.push(`  ${agent}:`);
+          for (const t of tasks) {
+            const dur = t.duration_minutes != null ? ` (${t.duration_minutes}m)` : "";
+            lines.push(`    \u2713 ${t.short_id || t.id.slice(0, 8)} ${t.title}${dur}`);
+          }
+        }
+      } else {
+        lines.push(`
+Nothing completed.`);
+      }
+      if (recap.in_progress.length > 0) {
+        lines.push(`
+In Progress:`);
+        for (const t of recap.in_progress)
+          lines.push(`  \u2192 ${t.short_id || t.id.slice(0, 8)} ${t.title}${t.assigned_to ? ` \u2014 ${t.assigned_to}` : ""}`);
+      }
+      if (recap.blocked.length > 0) {
+        lines.push(`
+Blocked:`);
+        for (const t of recap.blocked)
+          lines.push(`  \u2717 ${t.short_id || t.id.slice(0, 8)} ${t.title}`);
+      }
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("import_github_issue")) {
+  server.tool("import_github_issue", "Import a GitHub issue as a task. Requires gh CLI installed and authenticated.", {
+    url: exports_external.string().describe("GitHub issue URL (e.g. https://github.com/owner/repo/issues/42)"),
+    project_id: exports_external.string().optional(),
+    task_list_id: exports_external.string().optional()
+  }, async ({ url, project_id, task_list_id }) => {
+    try {
+      const { parseGitHubUrl: parseGitHubUrl2, fetchGitHubIssue: fetchGitHubIssue2, issueToTask: issueToTask2 } = await Promise.resolve().then(() => (init_github(), exports_github));
+      const parsed = parseGitHubUrl2(url);
+      if (!parsed)
+        return { content: [{ type: "text", text: "Invalid GitHub issue URL." }], isError: true };
+      const issue = fetchGitHubIssue2(parsed.owner, parsed.repo, parsed.number);
+      const input = issueToTask2(issue, { project_id, task_list_id });
+      const task = createTask(input);
+      return { content: [{ type: "text", text: `Imported GH#${issue.number}: ${issue.title}
+Task: ${task.short_id || task.id} [${task.priority}]
+Labels: ${issue.labels.join(", ") || "none"}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("blame")) {
+  server.tool("blame", "Show which tasks and agents touched a file \u2014 combines task_files and task_commits data.", {
+    path: exports_external.string().describe("File path to look up")
+  }, async ({ path }) => {
+    try {
+      const { findTasksByFile: findTasksByFile2 } = await Promise.resolve().then(() => (init_task_files(), exports_task_files));
+      const db = getDatabase();
+      const taskFiles = findTasksByFile2(path, db);
+      const commitRows = db.query("SELECT tc.*, t.title, t.short_id FROM task_commits tc JOIN tasks t ON t.id = tc.task_id WHERE tc.files_changed LIKE ? ORDER BY tc.committed_at DESC").all(`%${path}%`);
+      const lines = [`Blame: ${path}`];
+      if (taskFiles.length > 0) {
+        lines.push(`
+Task File Links (${taskFiles.length}):`);
+        for (const tf of taskFiles) {
+          const task = getTask(tf.task_id, db);
+          lines.push(`  ${task?.short_id || tf.task_id.slice(0, 8)} ${task?.title || "?"} \u2014 ${tf.role || "file"}`);
+        }
+      }
+      if (commitRows.length > 0) {
+        lines.push(`
+Commit Links (${commitRows.length}):`);
+        for (const c of commitRows)
+          lines.push(`  ${c.sha?.slice(0, 7)} ${c.short_id || c.task_id.slice(0, 8)} ${c.title || ""} \u2014 ${c.author || ""}`);
+      }
+      if (taskFiles.length === 0 && commitRows.length === 0) {
+        lines.push("No task or commit links found.");
+      }
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("burndown")) {
+  server.tool("burndown", "ASCII burndown chart showing actual vs ideal progress for a plan, project, or task list.", {
+    plan_id: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
+    task_list_id: exports_external.string().optional()
+  }, async ({ plan_id, project_id, task_list_id }) => {
+    try {
+      const { getBurndown: getBurndown2 } = await Promise.resolve().then(() => (init_burndown(), exports_burndown));
+      const data = getBurndown2({ plan_id, project_id, task_list_id });
+      return { content: [{ type: "text", text: `Burndown: ${data.completed}/${data.total} done, ${data.remaining} remaining
+
+${data.chart}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("create_webhook")) {
   server.tool("create_webhook", "Register a webhook for task change events.", {
     url: exports_external.string(),
@@ -11028,6 +11700,91 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
     }
   });
 }
+if (shouldRegisterTool("task_context")) {
+  server.tool("task_context", "Full orientation for a specific task \u2014 details, description, dependencies (with blocked status), files, commits, comments, checklist. Use when starting work on a task.", {
+    id: exports_external.string().describe("Task ID, short_id, or partial ID")
+  }, async ({ id }) => {
+    try {
+      const resolvedId = resolveId(id, "tasks");
+      const task = getTaskWithRelations(resolvedId);
+      if (!task)
+        return { content: [{ type: "text", text: `Task not found: ${id}` }], isError: true };
+      const lines = [];
+      const sid = task.short_id || task.id.slice(0, 8);
+      lines.push(`${sid} [${task.status}] [${task.priority}] ${task.title}`);
+      if (task.description)
+        lines.push(`
+Description:
+${task.description}`);
+      if (task.assigned_to)
+        lines.push(`Assigned: ${task.assigned_to}`);
+      if (task.started_at)
+        lines.push(`Started: ${task.started_at}`);
+      if (task.completed_at) {
+        lines.push(`Completed: ${task.completed_at}`);
+        if (task.started_at) {
+          const dur = Math.round((new Date(task.completed_at).getTime() - new Date(task.started_at).getTime()) / 60000);
+          lines.push(`Duration: ${dur}m`);
+        }
+      }
+      if (task.tags.length > 0)
+        lines.push(`Tags: ${task.tags.join(", ")}`);
+      if (task.dependencies.length > 0) {
+        lines.push(`
+Depends on (${task.dependencies.length}):`);
+        for (const dep of task.dependencies) {
+          const blocked = dep.status !== "completed" && dep.status !== "cancelled";
+          lines.push(`  ${blocked ? "\u2717" : "\u2713"} ${dep.short_id || dep.id.slice(0, 8)} [${dep.status}] ${dep.title}`);
+        }
+        const unfinished = task.dependencies.filter((d) => d.status !== "completed" && d.status !== "cancelled");
+        if (unfinished.length > 0)
+          lines.push(`\u26A0 BLOCKED by ${unfinished.length} unfinished dep(s)`);
+      }
+      if (task.blocked_by.length > 0) {
+        lines.push(`
+Blocks (${task.blocked_by.length}):`);
+        for (const b of task.blocked_by)
+          lines.push(`  ${b.short_id || b.id.slice(0, 8)} [${b.status}] ${b.title}`);
+      }
+      if (task.subtasks.length > 0) {
+        lines.push(`
+Subtasks (${task.subtasks.length}):`);
+        for (const st of task.subtasks)
+          lines.push(`  ${st.short_id || st.id.slice(0, 8)} [${st.status}] ${st.title}`);
+      }
+      try {
+        const { listTaskFiles: listTaskFiles2 } = await Promise.resolve().then(() => (init_task_files(), exports_task_files));
+        const files = listTaskFiles2(task.id);
+        if (files.length > 0) {
+          lines.push(`
+Files (${files.length}):`);
+          for (const f of files)
+            lines.push(`  ${f.role || "file"}: ${f.path}`);
+        }
+      } catch {}
+      try {
+        const { getTaskCommits: getTaskCommits2 } = await Promise.resolve().then(() => (init_task_commits(), exports_task_commits));
+        const commits = getTaskCommits2(task.id);
+        if (commits.length > 0) {
+          lines.push(`
+Commits (${commits.length}):`);
+          for (const c of commits)
+            lines.push(`  ${c.commit_hash?.slice(0, 7)} ${c.message || ""}`);
+        }
+      } catch {}
+      if (task.comments.length > 0) {
+        lines.push(`
+Comments (${task.comments.length}):`);
+        for (const c of task.comments)
+          lines.push(`  [${c.agent_id || "?"}] ${c.created_at}: ${c.content}`);
+      }
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("get_context")) {
   server.tool("get_context", "Get a compact task summary for agent prompt injection. Returns formatted text.", {
     agent_id: exports_external.string().optional(),
@@ -11290,6 +12047,7 @@ if (shouldRegisterTool("search_tools")) {
       "delete_agent",
       "unarchive_agent",
       "heartbeat",
+      "release_agent",
       "get_my_tasks",
       "get_org_chart",
       "set_reports_to",
@@ -11306,6 +12064,12 @@ if (shouldRegisterTool("search_tools")) {
       "claim_next_task",
       "get_task_history",
       "get_recent_activity",
+      "recap",
+      "task_context",
+      "standup",
+      "burndown",
+      "blame",
+      "import_github_issue",
       "create_webhook",
       "list_webhooks",
       "delete_webhook",
@@ -11430,8 +12194,8 @@ if (shouldRegisterTool("describe_tools")) {
       suggest_agent_name: `Check available agent names before registering. Shows active agents and, if a pool is configured, which pool names are free.
   Params: working_dir(string \u2014 your working directory, used to look up project pool from config)
   Example: {working_dir: '/workspace/platform'}`,
-      register_agent: `Register an agent. Any name is allowed \u2014 pool is advisory. Returns CONFLICT if name is held by a recently-active agent.
-  Params: name(string, req), description(string), capabilities(string[]), session_id(string \u2014 unique per session), working_dir(string \u2014 used to determine project pool)
+      register_agent: `Register an agent. Any name is allowed \u2014 pool is advisory. Returns CONFLICT if name is held by a recently-active agent. Use force:true to take over.
+  Params: name(string, req), description(string), capabilities(string[]), session_id(string \u2014 unique per session), working_dir(string \u2014 used to determine project pool), force(boolean \u2014 skip conflict check)
   Example: {name: 'my-agent', session_id: 'abc123-1741952000', working_dir: '/workspace/platform'}`,
       list_agents: `List all registered agents (active by default). Set include_archived: true to see archived agents.
   Params: include_archived(boolean, optional)
@@ -11451,6 +12215,9 @@ if (shouldRegisterTool("describe_tools")) {
       heartbeat: `Update last_seen_at timestamp to signal you're still active. Call periodically during long tasks.
   Params: agent_id(string, req \u2014 your agent ID or name)
   Example: {agent_id: 'maximus'}`,
+      release_agent: `Explicitly release/logout an agent \u2014 clears session binding and makes name immediately available. Call when session ends.
+  Params: agent_id(string, req), session_id(string \u2014 only releases if matching)
+  Example: {agent_id: 'maximus', session_id: 'my-session-123'}`,
       get_my_tasks: `Get all tasks assigned to/created by an agent, with stats (pending/active/done/rate).
   Params: agent_name(string, req)
   Example: {agent_name: 'maximus'}`,
@@ -11511,6 +12278,24 @@ if (shouldRegisterTool("describe_tools")) {
       get_recent_activity: `Get recent task changes across all tasks \u2014 global activity feed.
   Params: limit(number, default:50)
   Example: {limit: 20}`,
+      recap: `Summary of what happened in the last N hours \u2014 completed tasks with durations, new tasks, in-progress, blocked, stale, agent activity.
+  Params: hours(number, default:8), project_id(string)
+  Example: {hours: 4}`,
+      task_context: `Full orientation for a specific task \u2014 description, dependencies with blocked status, files, commits, comments, checklist, duration. Use before starting work.
+  Params: id(string, req)
+  Example: {id: 'OPE-00042'}`,
+      standup: `Generate standup notes \u2014 completed tasks grouped by agent, in-progress, blocked. Copy-paste ready.
+  Params: hours(number, default:24), project_id(string)
+  Example: {hours: 24}`,
+      import_github_issue: `Import a GitHub issue as a task. Requires gh CLI.
+  Params: url(string, req), project_id(string), task_list_id(string)
+  Example: {url: 'https://github.com/owner/repo/issues/42'}`,
+      blame: `Show which tasks/agents touched a file \u2014 combines task_files and task_commits.
+  Params: path(string, req)
+  Example: {path: 'src/db/agents.ts'}`,
+      burndown: `ASCII burndown chart \u2014 actual vs ideal progress for a plan, project, or task list.
+  Params: plan_id(string), project_id(string), task_list_id(string)
+  Example: {plan_id: 'abc123'}`,
       create_webhook: `Register a webhook for task change events.
   Params: url(string, req), events(string[] \u2014 empty=all), secret(string \u2014 HMAC signing)
   Example: {url: 'https://example.com/hook', events: ['task.created', 'task.completed']}`,
@@ -12292,6 +13077,48 @@ ${lines.join(`
     }
   });
 }
+if (shouldRegisterTool("extract_todos")) {
+  server.tool("extract_todos", "Scan source files for TODO/FIXME/HACK/BUG/XXX/NOTE comments and create tasks from them. Deduplicates on re-runs.", {
+    path: exports_external.string().describe("Directory or file path to scan"),
+    project_id: exports_external.string().optional().describe("Project to assign tasks to"),
+    task_list_id: exports_external.string().optional().describe("Task list to add tasks to"),
+    patterns: exports_external.array(exports_external.enum(["TODO", "FIXME", "HACK", "XXX", "BUG", "NOTE"])).optional().describe("Tags to search for (default: all)"),
+    tags: exports_external.array(exports_external.string()).optional().describe("Extra tags to add to created tasks"),
+    assigned_to: exports_external.string().optional().describe("Agent to assign tasks to"),
+    agent_id: exports_external.string().optional().describe("Agent performing the extraction"),
+    dry_run: exports_external.boolean().optional().describe("If true, return found comments without creating tasks"),
+    extensions: exports_external.array(exports_external.string()).optional().describe("File extensions to scan (e.g. ['ts', 'py'])")
+  }, async (params) => {
+    try {
+      const { extractTodos: extractTodos2 } = (init_extract(), __toCommonJS(exports_extract));
+      const resolved = { ...params };
+      if (resolved["project_id"])
+        resolved["project_id"] = resolveId(resolved["project_id"], "projects");
+      if (resolved["task_list_id"])
+        resolved["task_list_id"] = resolveId(resolved["task_list_id"], "task_lists");
+      const result = extractTodos2(resolved);
+      if (params.dry_run) {
+        const lines = result.comments.map((c) => `[${c.tag}] ${c.message} \u2014 ${c.file}:${c.line}`);
+        return { content: [{ type: "text", text: `Found ${result.comments.length} comment(s):
+${lines.join(`
+`)}` }] };
+      }
+      const summary = [
+        `Created ${result.tasks.length} task(s)`,
+        result.skipped > 0 ? `Skipped ${result.skipped} duplicate(s)` : null,
+        `Total comments found: ${result.comments.length}`
+      ].filter(Boolean).join(`
+`);
+      const taskLines = result.tasks.map((t) => formatTask(t));
+      return { content: [{ type: "text", text: `${summary}
+
+${taskLines.join(`
+`)}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 server.resource("task-lists", "todos://task-lists", { description: "All task lists", mimeType: "application/json" }, async () => {
   const lists = listTaskLists();
   return { contents: [{ uri: "todos://task-lists", text: JSON.stringify(lists, null, 2), mimeType: "application/json" }] };