@hasna/todos 0.9.74 → 0.9.76

package/dist/cli/index.js

@@ -2079,6 +2079,19 @@ var require_commander = __commonJS((exports) => {
 });
 
 // src/db/database.ts
+var exports_database = {};
+__export(exports_database, {
+  uuid: () => uuid,
+  resolvePartialId: () => resolvePartialId,
+  resetDatabase: () => resetDatabase,
+  now: () => now,
+  lockExpiryCutoff: () => lockExpiryCutoff,
+  isLockExpired: () => isLockExpired,
+  getDatabase: () => getDatabase,
+  closeDatabase: () => closeDatabase,
+  clearExpiredLocks: () => clearExpiredLocks,
+  LOCK_EXPIRY_MINUTES: () => LOCK_EXPIRY_MINUTES
+});
 import { Database } from "bun:sqlite";
 import { existsSync, mkdirSync } from "fs";
 import { dirname, join, resolve } from "path";
@@ -2247,6 +2260,28 @@ function ensureSchema(db) {
       metadata TEXT DEFAULT '{}',
       created_at TEXT NOT NULL DEFAULT (datetime('now'))
     )`);
+  ensureTable("task_checklists", `
+    CREATE TABLE task_checklists (
+      id TEXT PRIMARY KEY,
+      task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+      position INTEGER NOT NULL DEFAULT 0,
+      text TEXT NOT NULL,
+      checked INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )`);
+  ensureTable("project_sources", `
+    CREATE TABLE project_sources (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      type TEXT NOT NULL,
+      name TEXT NOT NULL,
+      uri TEXT NOT NULL,
+      description TEXT,
+      metadata TEXT DEFAULT '{}',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )`);
   ensureColumn("projects", "task_list_id", "TEXT");
   ensureColumn("projects", "task_prefix", "TEXT");
   ensureColumn("projects", "task_counter", "INTEGER NOT NULL DEFAULT 0");
@@ -2291,6 +2326,9 @@ function ensureSchema(db) {
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_history_agent ON task_history(agent_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_recurrence_parent ON tasks(recurrence_parent_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_recurrence_rule ON tasks(recurrence_rule) WHERE recurrence_rule IS NOT NULL");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_checklists_task ON task_checklists(task_id)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_project ON project_sources(project_id)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_type ON project_sources(type)");
 }
 function backfillTaskTags(db) {
   try {
@@ -2321,6 +2359,15 @@ function backfillTaskTags(db) {
     }
   } catch {}
 }
+function closeDatabase() {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}
+function resetDatabase() {
+  _db = null;
+}
 function now() {
   return new Date().toISOString();
 }
@@ -2668,6 +2715,49 @@ var init_database = __esm(() => {
   ALTER TABLE tasks ADD COLUMN reason TEXT;
   ALTER TABLE tasks ADD COLUMN spawned_from_session TEXT;
   INSERT OR IGNORE INTO _migrations (id) VALUES (19);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS handoffs (
+    id TEXT PRIMARY KEY,
+    agent_id TEXT,
+    project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+    summary TEXT NOT NULL,
+    completed TEXT,
+    in_progress TEXT,
+    blockers TEXT,
+    next_steps TEXT,
+    created_at TEXT NOT NULL
+  );
+  INSERT OR IGNORE INTO _migrations (id) VALUES (20);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS task_checklists (
+    id TEXT PRIMARY KEY,
+    task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+    position INTEGER NOT NULL DEFAULT 0,
+    text TEXT NOT NULL,
+    checked INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_task_checklists_task ON task_checklists(task_id);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (21);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS project_sources (
+    id TEXT PRIMARY KEY,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    type TEXT NOT NULL,
+    name TEXT NOT NULL,
+    uri TEXT NOT NULL,
+    description TEXT,
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_project_sources_project ON project_sources(project_id);
+  CREATE INDEX IF NOT EXISTS idx_project_sources_type ON project_sources(type);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (22);
   `
   ];
 });
@@ -2782,13 +2872,17 @@ var exports_projects = {};
 __export(exports_projects, {
   updateProject: () => updateProject,
   slugify: () => slugify,
+  removeProjectSource: () => removeProjectSource,
   nextTaskShortId: () => nextTaskShortId,
   listProjects: () => listProjects,
+  listProjectSources: () => listProjectSources,
+  getProjectWithSources: () => getProjectWithSources,
   getProjectByPath: () => getProjectByPath,
   getProject: () => getProject,
   ensureProject: () => ensureProject,
   deleteProject: () => deleteProject,
-  createProject: () => createProject
+  createProject: () => createProject,
+  addProjectSource: () => addProjectSource
 });
 function slugify(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
@@ -2865,6 +2959,48 @@ function deleteProject(id, db) {
   const result = d.run("DELETE FROM projects WHERE id = ?", [id]);
   return result.changes > 0;
 }
+function rowToSource(row) {
+  return {
+    ...row,
+    metadata: row.metadata ? JSON.parse(row.metadata) : {}
+  };
+}
+function addProjectSource(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO project_sources (id, project_id, type, name, uri, description, metadata, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.project_id,
+    input.type,
+    input.name,
+    input.uri,
+    input.description || null,
+    JSON.stringify(input.metadata || {}),
+    timestamp,
+    timestamp
+  ]);
+  return rowToSource(d.query("SELECT * FROM project_sources WHERE id = ?").get(id));
+}
+function removeProjectSource(id, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM project_sources WHERE id = ?", [id]);
+  return result.changes > 0;
+}
+function listProjectSources(projectId, db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM project_sources WHERE project_id = ? ORDER BY name").all(projectId);
+  return rows.map(rowToSource);
+}
+function getProjectWithSources(id, db) {
+  const d = db || getDatabase();
+  const project = getProject(id, d);
+  if (!project)
+    return null;
+  project.sources = listProjectSources(id, d);
+  return project;
+}
 function nextTaskShortId(projectId, db) {
   const d = db || getDatabase();
   const project = getProject(projectId, d);
@@ -3320,6 +3456,52 @@ var init_templates = __esm(() => {
   init_database();
 });
 
+// src/db/checklists.ts
+function rowToItem(row) {
+  return { ...row, checked: !!row.checked };
+}
+function getChecklist(taskId, db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM task_checklists WHERE task_id = ? ORDER BY position, created_at").all(taskId);
+  return rows.map(rowToItem);
+}
+function addChecklistItem(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  let position = input.position;
+  if (position === undefined) {
+    const maxRow = d.query("SELECT MAX(position) as max_pos FROM task_checklists WHERE task_id = ?").get(input.task_id);
+    position = (maxRow?.max_pos ?? -1) + 1;
+  }
+  d.run("INSERT INTO task_checklists (id, task_id, position, text, checked, created_at, updated_at) VALUES (?, ?, ?, ?, 0, ?, ?)", [id, input.task_id, position, input.text, timestamp, timestamp]);
+  return rowToItem(d.query("SELECT * FROM task_checklists WHERE id = ?").get(id));
+}
+function checkChecklistItem(id, checked, db) {
+  const d = db || getDatabase();
+  const timestamp = now();
+  const result = d.run("UPDATE task_checklists SET checked = ?, updated_at = ? WHERE id = ?", [checked ? 1 : 0, timestamp, id]);
+  if (result.changes === 0)
+    return null;
+  return rowToItem(d.query("SELECT * FROM task_checklists WHERE id = ?").get(id));
+}
+function updateChecklistItemText(id, text, db) {
+  const d = db || getDatabase();
+  const timestamp = now();
+  const result = d.run("UPDATE task_checklists SET text = ?, updated_at = ? WHERE id = ?", [text, timestamp, id]);
+  if (result.changes === 0)
+    return null;
+  return rowToItem(d.query("SELECT * FROM task_checklists WHERE id = ?").get(id));
+}
+function removeChecklistItem(id, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM task_checklists WHERE id = ?", [id]);
+  return result.changes > 0;
+}
+var init_checklists = __esm(() => {
+  init_database();
+});
+
 // src/db/tasks.ts
 var exports_tasks = {};
 __export(exports_tasks, {
@@ -3342,6 +3524,7 @@ __export(exports_tasks, {
   getTask: () => getTask,
   getStatus: () => getStatus,
   getStaleTasks: () => getStaleTasks,
+  getOverdueTasks: () => getOverdueTasks,
   getNextTask: () => getNextTask,
   getBlockingDeps: () => getBlockingDeps,
   getActiveWork: () => getActiveWork,
@@ -3449,13 +3632,15 @@ function getTaskWithRelations(id, db) {
   const blocked_by = blockedByRows.map(rowToTask);
   const comments = d.query("SELECT * FROM task_comments WHERE task_id = ? ORDER BY created_at").all(id);
   const parent = task.parent_id ? getTask(task.parent_id, d) : null;
+  const checklist = getChecklist(id, d);
   return {
     ...task,
     subtasks,
     dependencies,
     blocked_by,
     comments,
-    parent
+    parent,
+    checklist
   };
 }
 function listTasks(filter = {}, db) {
@@ -4380,6 +4565,19 @@ function bulkUpdateTasks(taskIds, updates, db) {
   tx();
   return { updated, failed };
 }
+function getOverdueTasks(projectId, db) {
+  const d = db || getDatabase();
+  const nowStr = new Date().toISOString();
+  let query = `SELECT * FROM tasks WHERE due_at IS NOT NULL AND due_at < ? AND status NOT IN ('completed', 'cancelled', 'failed')`;
+  const params = [nowStr];
+  if (projectId) {
+    query += ` AND project_id = ?`;
+    params.push(projectId);
+  }
+  query += ` ORDER BY due_at ASC`;
+  const rows = d.query(query).all(...params);
+  return rows.map(rowToTask);
+}
 var init_tasks = __esm(() => {
   init_types();
   init_database();
@@ -4389,6 +4587,7 @@ var init_tasks = __esm(() => {
   init_recurrence();
   init_webhooks();
   init_templates();
+  init_checklists();
 });
 
 // src/db/agents.ts
@@ -9368,6 +9567,77 @@ var init_zod = __esm(() => {
   init_external();
 });
 
+// src/db/handoffs.ts
+var exports_handoffs = {};
+__export(exports_handoffs, {
+  listHandoffs: () => listHandoffs,
+  getLatestHandoff: () => getLatestHandoff,
+  createHandoff: () => createHandoff
+});
+function createHandoff(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO handoffs (id, agent_id, project_id, summary, completed, in_progress, blockers, next_steps, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.agent_id || null,
+    input.project_id || null,
+    input.summary,
+    input.completed ? JSON.stringify(input.completed) : null,
+    input.in_progress ? JSON.stringify(input.in_progress) : null,
+    input.blockers ? JSON.stringify(input.blockers) : null,
+    input.next_steps ? JSON.stringify(input.next_steps) : null,
+    timestamp
+  ]);
+  return {
+    id,
+    agent_id: input.agent_id || null,
+    project_id: input.project_id || null,
+    summary: input.summary,
+    completed: input.completed || null,
+    in_progress: input.in_progress || null,
+    blockers: input.blockers || null,
+    next_steps: input.next_steps || null,
+    created_at: timestamp
+  };
+}
+function rowToHandoff(row) {
+  return {
+    ...row,
+    completed: row.completed ? JSON.parse(row.completed) : null,
+    in_progress: row.in_progress ? JSON.parse(row.in_progress) : null,
+    blockers: row.blockers ? JSON.parse(row.blockers) : null,
+    next_steps: row.next_steps ? JSON.parse(row.next_steps) : null
+  };
+}
+function listHandoffs(projectId, limit = 10, db) {
+  const d = db || getDatabase();
+  if (projectId) {
+    return d.query("SELECT * FROM handoffs WHERE project_id = ? ORDER BY rowid DESC LIMIT ?").all(projectId, limit).map(rowToHandoff);
+  }
+  return d.query("SELECT * FROM handoffs ORDER BY rowid DESC LIMIT ?").all(limit).map(rowToHandoff);
+}
+function getLatestHandoff(agentId, projectId, db) {
+  const d = db || getDatabase();
+  let query = "SELECT * FROM handoffs WHERE 1=1";
+  const params = [];
+  if (agentId) {
+    query += " AND agent_id = ?";
+    params.push(agentId);
+  }
+  if (projectId) {
+    query += " AND project_id = ?";
+    params.push(projectId);
+  }
+  query += " ORDER BY rowid DESC LIMIT 1";
+  const row = d.query(query).get(...params);
+  return row ? rowToHandoff(row) : null;
+}
+var init_handoffs = __esm(() => {
+  init_database();
+});
+
 // src/mcp/index.ts
 var exports_mcp = {};
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -9502,6 +9772,7 @@ var init_mcp = __esm(() => {
   init_sync();
   init_config();
   init_database();
+  init_checklists();
   init_types();
   server = new McpServer({
     name: "todos",
@@ -9700,6 +9971,14 @@ Comments (${task.comments.length}):`);
           parts.push(`
 Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
         }
+        if (task.checklist.length > 0) {
+          const done = task.checklist.filter((i) => i.checked).length;
+          parts.push(`
+Checklist (${done}/${task.checklist.length}):`);
+          for (const item of task.checklist) {
+            parts.push(`  ${item.position + 1}. [${item.checked ? "x" : " "}] ${item.text}  (${item.id.slice(0, 8)})`);
+          }
+        }
         return { content: [{ type: "text", text: parts.join(`
 `) }] };
       } catch (e) {
@@ -9929,6 +10208,171 @@ ${text}` }] };
       }
     });
   }
+  if (shouldRegisterTool("add_project_source")) {
+    server.tool("add_project_source", "Add a data source to a project (S3 bucket, Google Drive folder, local path, GitHub repo, Notion page, etc.). Sources are revealed to agents when they load the project.", {
+      project_id: exports_external.string().describe("Project ID"),
+      type: exports_external.string().describe("Source type: 's3', 'gdrive', 'local', 'github', 'notion', 'http', or any custom label"),
+      name: exports_external.string().describe("Human-readable label for this source"),
+      uri: exports_external.string().describe("The source URI (bucket path, folder URL, local path, repo URL, etc.)"),
+      description: exports_external.string().optional().describe("What this source contains or how agents should use it"),
+      metadata: exports_external.record(exports_external.unknown()).optional().describe("Extra config (e.g. region, access role, subfolder)")
+    }, async (params) => {
+      try {
+        const resolvedProjectId = resolveId(params.project_id, "projects");
+        const source = addProjectSource({ ...params, project_id: resolvedProjectId });
+        return {
+          content: [{
+            type: "text",
+            text: `Source added: ${source.id.slice(0, 8)} | [${source.type}] ${source.name} \u2192 ${source.uri}`
+          }]
+        };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("remove_project_source")) {
+    server.tool("remove_project_source", "Remove a data source from a project by source ID.", {
+      source_id: exports_external.string().describe("Source ID to remove")
+    }, async ({ source_id }) => {
+      try {
+        const db = getDatabase();
+        const row = db.query("SELECT * FROM project_sources WHERE id LIKE ?").get(`${source_id}%`);
+        if (!row)
+          return { content: [{ type: "text", text: `Source not found: ${source_id}` }], isError: true };
+        removeProjectSource(row.id);
+        return { content: [{ type: "text", text: `Source removed: ${row.name}` }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("list_project_sources")) {
+    server.tool("list_project_sources", "List all data sources attached to a project.", {
+      project_id: exports_external.string().describe("Project ID")
+    }, async ({ project_id }) => {
+      try {
+        const resolvedId = resolveId(project_id, "projects");
+        const sources = listProjectSources(resolvedId);
+        if (sources.length === 0) {
+          return { content: [{ type: "text", text: "No sources configured for this project." }] };
+        }
+        const lines = sources.map((s) => `${s.id.slice(0, 8)} | [${s.type}] ${s.name} \u2192 ${s.uri}${s.description ? `
+  ${s.description}` : ""}`);
+        return { content: [{ type: "text", text: `${sources.length} source(s):
+${lines.join(`
+`)}` }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("add_checklist_item")) {
+    server.tool("add_checklist_item", "Add a checklist item to a task. Items are numbered and individually checkable.", {
+      task_id: exports_external.string().describe("Task ID"),
+      text: exports_external.string().describe("Checklist item text"),
+      position: exports_external.number().optional().describe("Position (0-based). Appended to end if omitted.")
+    }, async ({ task_id, text, position }) => {
+      try {
+        const resolvedId = resolveId(task_id, "tasks");
+        const item = addChecklistItem({ task_id: resolvedId, text, position });
+        return {
+          content: [{
+            type: "text",
+            text: `Item added: ${item.position + 1}. [ ] ${item.text}  (${item.id.slice(0, 8)})`
+          }]
+        };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("check_checklist_item")) {
+    server.tool("check_checklist_item", "Mark a checklist item as checked or unchecked.", {
+      item_id: exports_external.string().describe("Checklist item ID or prefix"),
+      checked: exports_external.boolean().describe("true to check, false to uncheck")
+    }, async ({ item_id, checked }) => {
+      try {
+        const db = getDatabase();
+        const row = db.query("SELECT id FROM task_checklists WHERE id LIKE ?").get(`${item_id}%`);
+        if (!row)
+          return { content: [{ type: "text", text: `Checklist item not found: ${item_id}` }], isError: true };
+        const item = checkChecklistItem(row.id, checked);
+        if (!item)
+          return { content: [{ type: "text", text: "Update failed" }], isError: true };
+        return {
+          content: [{
+            type: "text",
+            text: `${item.position + 1}. [${item.checked ? "x" : " "}] ${item.text}`
+          }]
+        };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("update_checklist_item")) {
+    server.tool("update_checklist_item", "Update the text of a checklist item.", {
+      item_id: exports_external.string().describe("Checklist item ID or prefix"),
+      text: exports_external.string().describe("New text")
+    }, async ({ item_id, text }) => {
+      try {
+        const db = getDatabase();
+        const row = db.query("SELECT id FROM task_checklists WHERE id LIKE ?").get(`${item_id}%`);
+        if (!row)
+          return { content: [{ type: "text", text: `Checklist item not found: ${item_id}` }], isError: true };
+        const item = updateChecklistItemText(row.id, text);
+        if (!item)
+          return { content: [{ type: "text", text: "Update failed" }], isError: true };
+        return {
+          content: [{
+            type: "text",
+            text: `Updated: ${item.position + 1}. [${item.checked ? "x" : " "}] ${item.text}`
+          }]
+        };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("remove_checklist_item")) {
+    server.tool("remove_checklist_item", "Remove a checklist item from a task.", {
+      item_id: exports_external.string().describe("Checklist item ID or prefix")
+    }, async ({ item_id }) => {
+      try {
+        const db = getDatabase();
+        const row = db.query("SELECT id, text FROM task_checklists WHERE id LIKE ?").get(`${item_id}%`);
+        if (!row)
+          return { content: [{ type: "text", text: `Checklist item not found: ${item_id}` }], isError: true };
+        removeChecklistItem(row.id);
+        return { content: [{ type: "text", text: `Removed: ${row.text}` }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("get_checklist")) {
+    server.tool("get_checklist", "Get all checklist items for a task with progress summary.", {
+      task_id: exports_external.string().describe("Task ID")
+    }, async ({ task_id }) => {
+      try {
+        const resolvedId = resolveId(task_id, "tasks");
+        const items = getChecklist(resolvedId);
+        if (items.length === 0) {
+          return { content: [{ type: "text", text: "No checklist items." }] };
+        }
+        const done = items.filter((i) => i.checked).length;
+        const lines = [`Checklist (${done}/${items.length} done):`];
+        for (const item of items) {
+          lines.push(`  ${item.position + 1}. [${item.checked ? "x" : " "}] ${item.text}  (${item.id.slice(0, 8)})`);
+        }
+        return { content: [{ type: "text", text: lines.join(`
+`) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
   if (shouldRegisterTool("create_plan")) {
     server.tool("create_plan", "Create a plan to group related tasks.", {
       name: exports_external.string(),
@@ -11245,6 +11689,19 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
             lines.push(`Other agents active: ${others.slice(0, 3).map((w) => `${w.short_id || w.id.slice(0, 8)} (${w.assigned_to || "?"})`).join(", ")}`);
           }
         }
+        if (project_id) {
+          const resolvedId = resolveId(project_id, "projects");
+          const sources = listProjectSources(resolvedId);
+          if (sources.length > 0) {
+            lines.push("");
+            lines.push(`## Data Sources`);
+            for (const s of sources) {
+              lines.push(`[${s.type}] ${s.name}: ${s.uri}${s.description ? ` \u2014 ${s.description}` : ""}`);
+            }
+          }
+        }
+        lines.push(`
+as_of: ${new Date().toISOString()}`);
         return { content: [{ type: "text", text: lines.join(`
 `) }] };
       } catch (e) {
@@ -11295,6 +11752,14 @@ Claimed: ${formatTask(result.claimed)}`);
         "log_progress",
         "create_project",
         "list_projects",
+        "add_project_source",
+        "remove_project_source",
+        "list_project_sources",
+        "add_checklist_item",
+        "check_checklist_item",
+        "update_checklist_item",
+        "remove_checklist_item",
+        "get_checklist",
         "create_plan",
         "list_plans",
         "get_plan",
@@ -11403,6 +11868,30 @@ Claimed: ${formatTask(result.claimed)}`);
   Params: name(string, req), path(string, req \u2014 unique absolute path), description(string), task_list_id(string)
   Example: {name: 'my-app', path: '/Users/dev/my-app'}`,
         list_projects: "List all registered projects. No params.",
+        add_checklist_item: `Add a checklist item (numbered sub-step) to a task.
+  Params: task_id(string, req), text(string, req), position(number \u2014 0-based, appended to end if omitted)
+  Example: {task_id: 'a1b2c3d4', text: 'Cancel Slack subscription'}`,
+        check_checklist_item: `Mark a checklist item checked or unchecked.
+  Params: item_id(string, req \u2014 item ID or prefix), checked(boolean, req)
+  Example: {item_id: 'abc12345', checked: true}`,
+        update_checklist_item: `Update the text of a checklist item.
+  Params: item_id(string, req), text(string, req)
+  Example: {item_id: 'abc12345', text: 'Cancel GitHub subscription'}`,
+        remove_checklist_item: `Remove a checklist item permanently.
+  Params: item_id(string, req)
+  Example: {item_id: 'abc12345'}`,
+        get_checklist: `Get all checklist items for a task with progress (done/total).
+  Params: task_id(string, req)
+  Example: {task_id: 'a1b2c3d4'}`,
+        add_project_source: `Add a data source to a project (S3, GDrive, local path, GitHub, Notion, HTTP, etc.).
+  Params: project_id(string, req), type(string, req \u2014 e.g. 's3','gdrive','local','github','notion','http'), name(string, req), uri(string, req), description(string), metadata(object)
+  Example: {project_id: 'a1b2c3d4', type: 's3', name: 'Assets bucket', uri: 's3://my-bucket/assets/', description: 'Project media files'}`,
+        remove_project_source: `Remove a data source from a project.
+  Params: source_id(string, req \u2014 source ID or prefix)
+  Example: {source_id: 'abc12345'}`,
+        list_project_sources: `List all data sources for a project.
+  Params: project_id(string, req)
+  Example: {project_id: 'a1b2c3d4'}`,
         create_plan: `Create a plan to group related tasks.
   Params: name(string, req), project_id(string), description(string), status(active|completed|archived, default:active), task_list_id(string), agent_id(string)
   Example: {name: 'Sprint 1', project_id: 'a1b2c3d4'}`,
@@ -11563,6 +12052,62 @@ Claimed: ${formatTask(result.claimed)}`);
     const agents = listAgents();
     return { contents: [{ uri: "todos://agents", text: JSON.stringify(agents, null, 2), mimeType: "application/json" }] };
   });
+  if (shouldRegisterTool("create_handoff")) {
+    server.tool("create_handoff", "Create a session handoff note for agent coordination.", {
+      agent_id: exports_external.string().optional().describe("Agent creating the handoff"),
+      project_id: exports_external.string().optional().describe("Project ID"),
+      summary: exports_external.string().describe("What was accomplished this session"),
+      completed: exports_external.array(exports_external.string()).optional().describe("Items completed"),
+      in_progress: exports_external.array(exports_external.string()).optional().describe("Items still in progress"),
+      blockers: exports_external.array(exports_external.string()).optional().describe("Blocking issues"),
+      next_steps: exports_external.array(exports_external.string()).optional().describe("Recommended next actions")
+    }, async ({ agent_id, project_id, summary, completed, in_progress, blockers, next_steps }) => {
+      try {
+        const { createHandoff: createHandoff2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
+        const handoff = createHandoff2({
+          agent_id,
+          project_id: project_id ? resolveId(project_id, "projects") : undefined,
+          summary,
+          completed,
+          in_progress,
+          blockers,
+          next_steps
+        });
+        return { content: [{ type: "text", text: `Handoff created: ${handoff.id.slice(0, 8)} by ${handoff.agent_id || "unknown"}` }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("get_latest_handoff")) {
+    server.tool("get_latest_handoff", "Get the most recent handoff for an agent or project.", {
+      agent_id: exports_external.string().optional().describe("Filter by agent"),
+      project_id: exports_external.string().optional().describe("Filter by project")
+    }, async ({ agent_id, project_id }) => {
+      try {
+        const { getLatestHandoff: getLatestHandoff2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
+        const handoff = getLatestHandoff2(agent_id, project_id ? resolveId(project_id, "projects") : undefined);
+        if (!handoff)
+          return { content: [{ type: "text", text: "No handoffs found." }] };
+        const lines = [
+          `${handoff.created_at.slice(0, 16)} ${handoff.agent_id || "unknown"}`,
+          handoff.summary
+        ];
+        if (handoff.completed?.length)
+          lines.push(`Done: ${handoff.completed.join(", ")}`);
+        if (handoff.in_progress?.length)
+          lines.push(`In progress: ${handoff.in_progress.join(", ")}`);
+        if (handoff.blockers?.length)
+          lines.push(`Blocked: ${handoff.blockers.join(", ")}`);
+        if (handoff.next_steps?.length)
+          lines.push(`Next: ${handoff.next_steps.join(", ")}`);
+        return { content: [{ type: "text", text: lines.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" }] };
@@ -15749,6 +16294,480 @@ program2.command("yesterday").description("Show task activity from yesterday").o
   if (completed.length === 0 && started.length === 0)
     console.log(chalk.dim("  No activity yesterday."));
 });
+program2.command("mine").description("Show tasks assigned to you, grouped by status").argument("<agent>", "Agent name or ID").option("--json", "Output as JSON").action(async (agent, opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { listTasks: listTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const projectId = autoProject(globalOpts) || undefined;
+  const filter = { assigned_to: agent };
+  if (projectId)
+    filter.project_id = projectId;
+  const tasks = listTasks2(filter, db);
+  const filterByAgent = { agent_id: agent };
+  if (projectId)
+    filterByAgent.project_id = projectId;
+  const agentTasks = listTasks2(filterByAgent, db);
+  const seen = new Set(tasks.map((t) => t.id));
+  for (const t of agentTasks) {
+    if (!seen.has(t.id)) {
+      tasks.push(t);
+      seen.add(t.id);
+    }
+  }
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(tasks));
+    return;
+  }
+  const groups = {};
+  for (const t of tasks) {
+    const s = t.status || "unknown";
+    if (!groups[s])
+      groups[s] = [];
+    groups[s].push(t);
+  }
+  const statusOrder = ["in_progress", "pending", "blocked", "completed", "failed", "cancelled"];
+  const statusIcons2 = { in_progress: "\u25B6", pending: "\u25CB", blocked: "\u2298", completed: "\u2713", failed: "\u2717", cancelled: "\u2014" };
+  const statusColors5 = { in_progress: chalk.blue, pending: chalk.white, blocked: chalk.red, completed: chalk.green, failed: chalk.red, cancelled: chalk.dim };
+  console.log(chalk.bold(`Tasks for ${agent} (${tasks.length} total):
+`));
+  for (const status of statusOrder) {
+    const group = groups[status];
+    if (!group || group.length === 0)
+      continue;
+    const color = statusColors5[status] || chalk.white;
+    const icon = statusIcons2[status] || "?";
+    console.log(color(`  ${icon} ${status.replace("_", " ")} (${group.length}):`));
+    for (const t of group) {
+      const priority = t.priority === "critical" || t.priority === "high" ? chalk.red(` [${t.priority}]`) : "";
+      console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${priority}`);
+    }
+  }
+  if (tasks.length === 0)
+    console.log(chalk.dim(`  No tasks assigned to ${agent}.`));
+});
+program2.command("blocked").description("Show tasks blocked by incomplete dependencies").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { listTasks: listTasks2, getBlockingDeps: getBlockingDeps2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const projectId = autoProject(globalOpts) || opts.project || undefined;
+  const filter = { status: "pending" };
+  if (projectId)
+    filter.project_id = projectId;
+  const allPending = listTasks2(filter, db);
+  const blockedTasks = [];
+  for (const t of allPending) {
+    const blockers = getBlockingDeps2(t.id, db);
+    if (blockers.length > 0)
+      blockedTasks.push({ task: t, blockers });
+  }
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(blockedTasks.map((b) => ({ ...b.task, blocked_by: b.blockers.map((bl) => ({ id: bl.id, short_id: bl.short_id, title: bl.title, status: bl.status })) }))));
+    return;
+  }
+  if (blockedTasks.length === 0) {
+    console.log(chalk.green("  No blocked tasks!"));
+    return;
+  }
+  console.log(chalk.bold(`Blocked (${blockedTasks.length}):
+`));
+  for (const { task, blockers } of blockedTasks) {
+    console.log(`  ${chalk.cyan(task.short_id || task.id.slice(0, 8))} ${task.title}`);
+    for (const bl of blockers) {
+      console.log(`    ${chalk.red("\u2298")} ${chalk.dim(bl.short_id || bl.id.slice(0, 8))} ${chalk.dim(bl.title)} ${chalk.yellow(`[${bl.status}]`)}`);
+    }
+  }
+});
+program2.command("overdue").description("Show tasks past their due date").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const projectId = autoProject(globalOpts) || opts.project || undefined;
+  const { getOverdueTasks: getOverdueTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const tasks = getOverdueTasks2(projectId);
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(tasks));
+    return;
+  }
+  if (tasks.length === 0) {
+    console.log(chalk.green("  No overdue tasks!"));
+    return;
+  }
+  console.log(chalk.bold.red(`Overdue (${tasks.length}):
+`));
+  for (const t of tasks) {
+    const dueDate = t.due_at.slice(0, 10);
+    const daysOverdue = Math.floor((Date.now() - new Date(t.due_at).getTime()) / 86400000);
+    const urgency = daysOverdue > 7 ? chalk.bgRed.white(` ${daysOverdue}d `) : chalk.red(`${daysOverdue}d`);
+    console.log(`  ${urgency} ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : ""} ${chalk.dim(`(due ${dueDate})`)}`);
+  }
+});
+program2.command("week").description("Show task activity from the past 7 days").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { getTasksChangedSince: getTasksChangedSince2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const now2 = new Date;
+  const start = new Date(now2);
+  start.setDate(start.getDate() - 7);
+  start.setHours(0, 0, 0, 0);
+  const tasks = getTasksChangedSince2(start.toISOString(), undefined, db);
+  const days = {};
+  for (let i = 0;i < 7; i++) {
+    const d = new Date(now2);
+    d.setDate(d.getDate() - i);
+    days[d.toISOString().slice(0, 10)] = { completed: [], started: [], other: [] };
+  }
+  for (const t of tasks) {
+    const day = (t.updated_at || t.created_at).slice(0, 10);
+    if (!days[day])
+      days[day] = { completed: [], started: [], other: [] };
+    if (t.status === "completed")
+      days[day].completed.push(t);
+    else if (t.status === "in_progress")
+      days[day].started.push(t);
+    else
+      days[day].other.push(t);
+  }
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify({ from: start.toISOString().slice(0, 10), to: now2.toISOString().slice(0, 10), days }));
+    return;
+  }
+  const totalCompleted = tasks.filter((t) => t.status === "completed").length;
+  const totalStarted = tasks.filter((t) => t.status === "in_progress").length;
+  console.log(chalk.bold(`Week \u2014 ${start.toISOString().slice(0, 10)} to ${now2.toISOString().slice(0, 10)}`));
+  console.log(chalk.dim(`  ${totalCompleted} completed, ${totalStarted} in progress, ${tasks.length} total changes
+`));
+  const sortedDays = Object.keys(days).sort().reverse();
+  for (const day of sortedDays) {
+    const dayData = days[day];
+    if (!dayData)
+      continue;
+    const { completed, started } = dayData;
+    if (completed.length === 0 && started.length === 0)
+      continue;
+    const weekday = new Date(day + "T12:00:00").toLocaleDateString("en-US", { weekday: "short" });
+    console.log(chalk.bold(`  ${weekday} ${day}`));
+    for (const t of completed)
+      console.log(`    ${chalk.green("\u2713")} ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : ""}`);
+    for (const t of started)
+      console.log(`    ${chalk.blue("\u25B6")} ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : ""}`);
+  }
+  if (tasks.length === 0)
+    console.log(chalk.dim("  No activity this week."));
+});
+program2.command("burndown").description("Show task completion velocity over the past 7 days").option("--days <n>", "Number of days", "7").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { getRecentActivity: getRecentActivity2 } = (init_audit(), __toCommonJS(exports_audit));
+  const numDays = parseInt(opts.days, 10);
+  const entries = getRecentActivity2(5000, db);
+  const now2 = new Date;
+  const dayStats = [];
+  for (let i = numDays - 1;i >= 0; i--) {
+    const d = new Date(now2);
+    d.setDate(d.getDate() - i);
+    const dateStr = d.toISOString().slice(0, 10);
+    const dayEntries = entries.filter((e) => e.created_at.slice(0, 10) === dateStr);
+    dayStats.push({
+      date: dateStr,
+      completed: dayEntries.filter((e) => e.action === "complete").length,
+      created: dayEntries.filter((e) => e.action === "create").length,
+      failed: dayEntries.filter((e) => e.action === "fail").length
+    });
+  }
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(dayStats));
+    return;
+  }
+  const maxVal = Math.max(...dayStats.map((d) => Math.max(d.completed, d.created)), 1);
+  const barWidth = 30;
+  console.log(chalk.bold("Burndown (last " + numDays + ` days):
+`));
+  console.log(chalk.dim("  Date        Done  New   Failed  Chart"));
+  for (const day of dayStats) {
+    const weekday = new Date(day.date + "T12:00:00").toLocaleDateString("en-US", { weekday: "short" });
+    const completedBar = chalk.green("\u2588".repeat(Math.round(day.completed / maxVal * barWidth)));
+    const createdBar = chalk.blue("\u2591".repeat(Math.round(day.created / maxVal * barWidth)));
+    const failed = day.failed > 0 ? chalk.red(String(day.failed).padStart(4)) : chalk.dim("   0");
+    console.log(`  ${weekday} ${day.date.slice(5)}  ${chalk.green(String(day.completed).padStart(4))}  ${chalk.blue(String(day.created).padStart(4))}   ${failed}  ${completedBar}${createdBar}`);
+  }
+  const totalCompleted = dayStats.reduce((s, d) => s + d.completed, 0);
+  const totalCreated = dayStats.reduce((s, d) => s + d.created, 0);
+  const velocity = (totalCompleted / numDays).toFixed(1);
+  console.log(chalk.dim(`
+  Velocity: ${velocity}/day \xB7 ${totalCompleted} done \xB7 ${totalCreated} created`));
+});
+program2.command("log").description("Show recent task activity log (git-log style)").option("--limit <n>", "Number of entries", "30").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { getRecentActivity: getRecentActivity2 } = (init_audit(), __toCommonJS(exports_audit));
+  const entries = getRecentActivity2(parseInt(opts.limit, 10), db);
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(entries));
+    return;
+  }
+  if (entries.length === 0) {
+    console.log(chalk.dim("  No activity yet."));
+    return;
+  }
+  const actionIcons = {
+    create: chalk.green("+"),
+    start: chalk.blue("\u25B6"),
+    complete: chalk.green("\u2713"),
+    fail: chalk.red("\u2717"),
+    update: chalk.yellow("~"),
+    approve: chalk.green("\u2605"),
+    lock: chalk.dim("\uD83D\uDD12"),
+    unlock: chalk.dim("\uD83D\uDD13")
+  };
+  let lastDate = "";
+  for (const e of entries) {
+    const date = e.created_at.slice(0, 10);
+    const time = e.created_at.slice(11, 16);
+    if (date !== lastDate) {
+      console.log(chalk.bold(`
+  ${date}`));
+      lastDate = date;
+    }
+    const icon = actionIcons[e.action] || chalk.dim("\xB7");
+    const agent = e.agent_id ? chalk.dim(` (${e.agent_id})`) : "";
+    const taskRef = chalk.cyan(e.task_id.slice(0, 8));
+    let detail = "";
+    if (e.field && e.old_value && e.new_value) {
+      detail = chalk.dim(` ${e.field}: ${e.old_value} \u2192 ${e.new_value}`);
+    } else if (e.field && e.new_value) {
+      detail = chalk.dim(` ${e.field}: ${e.new_value}`);
+    }
+    console.log(`  ${chalk.dim(time)} ${icon} ${e.action.padEnd(8)} ${taskRef}${detail}${agent}`);
+  }
+});
+program2.command("ready").description("Show all tasks ready to be claimed (pending, unblocked, unlocked)").option("--json", "Output as JSON").option("--project <id>", "Filter to project").option("--limit <n>", "Max tasks to show", "20").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { listTasks: listTasks2, getBlockingDeps: getBlockingDeps2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const { isLockExpired: isLockExpired2 } = (init_database(), __toCommonJS(exports_database));
+  const projectId = autoProject(globalOpts) || opts.project || undefined;
+  const filter = { status: "pending" };
+  if (projectId)
+    filter.project_id = projectId;
+  const pending = listTasks2(filter, db);
+  const ready = pending.filter((t) => {
+    if (t.locked_by && !isLockExpired2(t.locked_at))
+      return false;
+    const blockers = getBlockingDeps2(t.id, db);
+    return blockers.length === 0;
+  });
+  const limited = ready.slice(0, parseInt(opts.limit, 10));
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(limited));
+    return;
+  }
+  if (limited.length === 0) {
+    console.log(chalk.dim("  No tasks ready to claim."));
+    return;
+  }
+  console.log(chalk.bold(`Ready to claim (${ready.length}${ready.length > limited.length ? `, showing ${limited.length}` : ""}):
+`));
+  for (const t of limited) {
+    const pri = t.priority === "critical" ? chalk.bgRed.white(" CRIT ") : t.priority === "high" ? chalk.red("[high]") : t.priority === "medium" ? chalk.yellow("[med]") : "";
+    const due = t.due_at ? chalk.dim(` due ${t.due_at.slice(0, 10)}`) : "";
+    console.log(`  ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title} ${pri}${due}`);
+  }
+});
+program2.command("sprint").description("Sprint dashboard: in-progress, next up, blockers, and overdue").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { listTasks: listTasks2, getBlockingDeps: getBlockingDeps2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const projectId = autoProject(globalOpts) || opts.project || undefined;
+  const baseFilter = {};
+  if (projectId)
+    baseFilter.project_id = projectId;
+  const inProgress = listTasks2({ ...baseFilter, status: "in_progress" }, db);
+  const pending = listTasks2({ ...baseFilter, status: "pending" }, db);
+  const nowStr = new Date().toISOString();
+  const blocked = [];
+  for (const t of pending) {
+    const blockers = getBlockingDeps2(t.id, db);
+    if (blockers.length > 0)
+      blocked.push({ task: t, blockers });
+  }
+  const overdue = [...inProgress, ...pending].filter((t) => t.due_at && t.due_at < nowStr);
+  const blockedIds = new Set(blocked.map((b) => b.task.id));
+  const nextUp = pending.filter((t) => !blockedIds.has(t.id)).slice(0, 5);
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify({ in_progress: inProgress, next_up: nextUp, blocked, overdue }));
+    return;
+  }
+  console.log(chalk.bold(`Sprint Dashboard
+`));
+  console.log(chalk.blue(`  \u25B6 In Progress (${inProgress.length}):`));
+  if (inProgress.length === 0)
+    console.log(chalk.dim("    (none)"));
+  for (const t of inProgress) {
+    const agent = t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : "";
+    console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${agent}`);
+  }
+  console.log(chalk.white(`
+  \u25CB Next Up (${nextUp.length}):`));
+  if (nextUp.length === 0)
+    console.log(chalk.dim("    (none)"));
+  for (const t of nextUp) {
+    const pri = t.priority === "critical" ? chalk.bgRed.white(" CRIT ") : t.priority === "high" ? chalk.red("[high]") : "";
+    console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title} ${pri}`);
+  }
+  if (blocked.length > 0) {
+    console.log(chalk.red(`
+  \u2298 Blocked (${blocked.length}):`));
+    for (const { task, blockers } of blocked) {
+      console.log(`    ${chalk.cyan(task.short_id || task.id.slice(0, 8))} ${task.title}`);
+      for (const bl of blockers)
+        console.log(`      ${chalk.dim("\u2190 " + (bl.short_id || bl.id.slice(0, 8)) + " " + bl.title)} ${chalk.yellow(`[${bl.status}]`)}`);
+    }
+  }
+  if (overdue.length > 0) {
+    console.log(chalk.red(`
+  \u26A0 Overdue (${overdue.length}):`));
+    for (const t of overdue) {
+      const daysOver = Math.floor((Date.now() - new Date(t.due_at).getTime()) / 86400000);
+      console.log(`    ${chalk.red(`${daysOver}d`)} ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}`);
+    }
+  }
+  console.log(chalk.dim(`
+  ${inProgress.length} active \xB7 ${pending.length} pending \xB7 ${blocked.length} blocked \xB7 ${overdue.length} overdue`));
+});
+program2.command("handoff").description("Create or view agent session handoffs").option("--create", "Create a new handoff").option("--agent <name>", "Agent name").option("--summary <text>", "Handoff summary").option("--completed <items>", "Comma-separated completed items").option("--in-progress <items>", "Comma-separated in-progress items").option("--blockers <items>", "Comma-separated blockers").option("--next <items>", "Comma-separated next steps").option("--json", "Output as JSON").option("--limit <n>", "Number of handoffs to show", "5").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { createHandoff: createHandoff2, listHandoffs: listHandoffs2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
+  const projectId = autoProject(globalOpts) || undefined;
+  if (opts.create || opts.summary) {
+    if (!opts.summary) {
+      console.error(chalk.red("  --summary is required for creating a handoff"));
+      process.exit(1);
+    }
+    const handoff = createHandoff2({
+      agent_id: opts.agent || globalOpts.agent || undefined,
+      project_id: projectId,
+      summary: opts.summary,
+      completed: opts.completed ? opts.completed.split(",").map((s) => s.trim()) : undefined,
+      inProgress: opts.inProgress ? opts.inProgress.split(",").map((s) => s.trim()) : undefined,
+      blockers: opts.blockers ? opts.blockers.split(",").map((s) => s.trim()) : undefined,
+      next_steps: opts.next ? opts.next.split(",").map((s) => s.trim()) : undefined
+    }, db);
+    if (opts.json || globalOpts.json) {
+      console.log(JSON.stringify(handoff));
+      return;
+    }
+    console.log(chalk.green(`  \u2713 Handoff created by ${handoff.agent_id || "unknown"}`));
+    return;
+  }
+  const handoffs = listHandoffs2(projectId, parseInt(opts.limit, 10), db);
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(handoffs));
+    return;
+  }
+  if (handoffs.length === 0) {
+    console.log(chalk.dim("  No handoffs yet."));
+    return;
+  }
+  for (const h of handoffs) {
+    const time = h.created_at.slice(0, 16).replace("T", " ");
+    console.log(chalk.bold(`
+  ${time} ${h.agent_id || "unknown"}`));
+    console.log(`  ${h.summary}`);
+    if (h.completed?.length) {
+      console.log(chalk.green(`  \u2713 Completed:`));
+      for (const c of h.completed)
+        console.log(`    - ${c}`);
+    }
+    if (h.in_progress?.length) {
+      console.log(chalk.blue(`  \u25B6 In progress:`));
+      for (const c of h.in_progress)
+        console.log(`    - ${c}`);
+    }
+    if (h.blockers?.length) {
+      console.log(chalk.red(`  \u2298 Blockers:`));
+      for (const c of h.blockers)
+        console.log(`    - ${c}`);
+    }
+    if (h.next_steps?.length) {
+      console.log(chalk.cyan(`  \u2192 Next steps:`));
+      for (const c of h.next_steps)
+        console.log(`    - ${c}`);
+    }
+  }
+});
+program2.command("priorities").description("Show task counts grouped by priority").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { countTasks: countTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const projectId = autoProject(globalOpts) || opts.project || undefined;
+  const base = projectId ? { project_id: projectId } : {};
+  const priorities = ["critical", "high", "medium", "low", "none"];
+  const counts = {};
+  for (const p of priorities) {
+    counts[p] = {
+      total: countTasks2({ ...base, priority: p }, db),
+      pending: countTasks2({ ...base, priority: p, status: "pending" }, db),
+      in_progress: countTasks2({ ...base, priority: p, status: "in_progress" }, db),
+      completed: countTasks2({ ...base, priority: p, status: "completed" }, db)
+    };
+  }
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify(counts));
+    return;
+  }
+  console.log(chalk.bold(`Priority Breakdown:
+`));
+  const priColors = { critical: chalk.bgRed.white, high: chalk.red, medium: chalk.yellow, low: chalk.blue, none: chalk.dim };
+  for (const p of priorities) {
+    const c = counts[p];
+    if (!c || c.total === 0)
+      continue;
+    const color = priColors[p] || chalk.white;
+    const bar = chalk.green("\u2588".repeat(Math.min(c.completed, 30))) + chalk.blue("\u2591".repeat(Math.min(c.in_progress, 10))) + chalk.dim("\xB7".repeat(Math.min(c.pending, 20)));
+    console.log(`  ${color(p.padEnd(9))} ${String(c.total).padStart(4)} total  ${chalk.green(String(c.completed).padStart(3))} done  ${chalk.blue(String(c.in_progress).padStart(3))} active  ${chalk.dim(String(c.pending).padStart(3))} pending  ${bar}`);
+  }
+});
+program2.command("context").description("Session start context: status, latest handoff, next task, overdue").option("--agent <name>", "Agent name for handoff lookup").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { getStatus: getStatus2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const { getNextTask: getNextTask2, getOverdueTasks: getOverdueTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const { getLatestHandoff: getLatestHandoff2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
+  const projectId = autoProject(globalOpts) || undefined;
+  const agentName = opts.agent || globalOpts.agent || undefined;
+  const filters = projectId ? { project_id: projectId } : undefined;
+  const status = getStatus2(filters, agentName);
+  const nextTask = getNextTask2(agentName, filters, db);
+  const overdue = getOverdueTasks2(projectId, db);
+  const handoff = agentName ? getLatestHandoff2(agentName, projectId, db) : getLatestHandoff2(undefined, projectId, db);
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify({ status, next_task: nextTask, overdue_count: overdue.length, latest_handoff: handoff, as_of: new Date().toISOString() }));
+    return;
+  }
+  console.log(chalk.bold(`Session Context
+`));
+  console.log(`  ${status.pending} pending \xB7 ${status.in_progress} active \xB7 ${status.completed} done \xB7 ${status.total} total`);
+  if (status.stale_count > 0)
+    console.log(chalk.yellow(`  \u26A0 ${status.stale_count} stale tasks`));
+  if (overdue.length > 0)
+    console.log(chalk.red(`  \u26A0 ${overdue.length} overdue tasks`));
+  if (nextTask) {
+    const pri = nextTask.priority === "critical" || nextTask.priority === "high" ? chalk.red(` [${nextTask.priority}]`) : "";
+    console.log(chalk.bold(`
+  Next up:`));
+    console.log(`    ${chalk.cyan(nextTask.short_id || nextTask.id.slice(0, 8))} ${nextTask.title}${pri}`);
+  }
+  if (handoff) {
+    console.log(chalk.bold(`
+  Last handoff (${handoff.agent_id || "unknown"}, ${handoff.created_at.slice(0, 16).replace("T", " ")}):`));
+    console.log(`    ${handoff.summary}`);
+    if (handoff.next_steps?.length) {
+      for (const s of handoff.next_steps)
+        console.log(`    \u2192 ${s}`);
+    }
+  }
+  console.log(chalk.dim(`
+  as_of: ${new Date().toISOString()}`));
+});
 program2.action(async () => {
   if (process.stdout.isTTY) {
     try {