@hasna/todos 0.10.19 → 0.10.21

package/dist/index.js

@@ -746,6 +746,15 @@ var MIGRATIONS = [
   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);
   `
 ];
 var _db = null;
@@ -926,6 +935,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");
@@ -1043,6 +1053,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;
 }
 // src/types/index.ts
@@ -1484,6 +1504,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
+  };
+}
 
 // src/lib/recurrence.ts
 var DAY_NAMES = {
@@ -1762,8 +1808,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,
@@ -1793,7 +1839,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);
@@ -1902,6 +1949,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 {
@@ -2061,6 +2117,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) {
@@ -2130,8 +2190,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);
@@ -2139,7 +2199,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();
@@ -2877,9 +2937,26 @@ function deleteComment(id, db) {
   return result.changes > 0;
 }
 // src/db/agents.ts
-var AGENT_ACTIVE_WINDOW_MS = 30 * 60 * 1000;
+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()));
 }
@@ -2901,22 +2978,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()];
@@ -2961,6 +3035,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);
@@ -2981,6 +3081,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);
   }
@@ -2998,8 +3099,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 = ?");
@@ -4564,6 +4676,328 @@ function syncWithAgents(agents, taskListIdByAgent, projectId, direction = "both"
   }
   return { pushed, pulled, errors };
 }
+// src/lib/extract.ts
+import { readFileSync as readFileSync3, statSync as statSync2 } from "fs";
+import { relative, resolve as resolve2, join as join6 } from "path";
+var EXTRACT_TAGS = ["TODO", "FIXME", "HACK", "XXX", "BUG", "NOTE"];
+var 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"
+]);
+var SKIP_DIRS = new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  "out",
+  ".next",
+  ".turbo",
+  "coverage",
+  "__pycache__",
+  ".venv",
+  "venv",
+  "vendor",
+  "target",
+  ".cache",
+  ".parcel-cache"
+]);
+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 };
+}
+// src/lib/burndown.ts
+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(`
+`);
+}
+// src/lib/github.ts
+import { execSync } from "child_process";
+function parseGitHubUrl(url) {
+  const match = url.match(/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/);
+  if (!match)
+    return null;
+  return { owner: match[1], repo: match[2], number: parseInt(match[3], 10) };
+}
+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
+  };
+}
+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;
+    }
+  }
+  return {
+    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
+  };
+}
 export {
   uuid,
   updateTaskList,
@@ -4579,6 +5013,7 @@ export {
   unlockTask,
   unarchiveAgent,
   taskFromTemplate,
+  tagToPriority,
   syncWithAgents,
   syncWithAgent,
   syncKgEdges,
@@ -4598,10 +5033,12 @@ export {
   removeDependency,
   removeChecklistItem,
   releaseLock,
+  releaseAgent,
   registerAgent,
   redistributeStaleTasks,
   patrolTasks,
   parseRecurrenceRule,
+  parseGitHubUrl,
   now,
   nextTaskShortId,
   nextOccurrence,
@@ -4624,6 +5061,7 @@ export {
   listHandoffs,
   listComments,
   listAgents,
+  issueToTask,
   isValidRecurrenceRule,
   isAgentConflict,
   getWebhook,
@@ -4647,6 +5085,7 @@ export {
   getReviewQueue,
   getRelated,
   getRecentActivity,
+  getRecap,
   getProjectWithSources,
   getProjectByPath,
   getProject,
@@ -4667,6 +5106,7 @@ export {
   getChecklistStats,
   getChecklist,
   getCapableAgents,
+  getBurndown,
   getBlockingDeps,
   getAgentMetrics,
   getAgentByName,
@@ -4675,7 +5115,10 @@ export {
   findTasksByFile,
   findRelatedTaskIds,
   findPath,
+  fetchGitHubIssue,
   failTask,
+  extractTodos,
+  extractFromSource,
   ensureTaskList,
   ensureProject,
   dispatchWebhook,
@@ -4714,6 +5157,7 @@ export {
   bulkUpdateTasks,
   bulkCreateTasks,
   bulkAddTaskFiles,
+  autoReleaseStaleAgents,
   autoDetectFileRelationships,
   archiveAgent,
   addTaskRelationship,
@@ -4735,6 +5179,7 @@ export {
   PlanNotFoundError,
   PLAN_STATUSES,
   LockError,
+  EXTRACT_TAGS,
   DependencyCycleError,
   CompletionGuardError,
   AgentNotFoundError

package/dist/lib/burndown.d.ts

@@ -0,0 +1,18 @@
+import type { Database } from "bun:sqlite";
+export interface BurndownData {
+    total: number;
+    completed: number;
+    remaining: number;
+    days: {
+        date: string;
+        completed_cumulative: number;
+        ideal: number;
+    }[];
+    chart: string;
+}
+export declare function getBurndown(opts: {
+    plan_id?: string;
+    project_id?: string;
+    task_list_id?: string;
+}, db?: Database): BurndownData;
+//# sourceMappingURL=burndown.d.ts.map

package/dist/lib/burndown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burndown.d.ts","sourceRoot":"","sources":["../../src/lib/burndown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,CA8C/H"}