@hasna/todos 0.9.73 → 0.9.75

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,18 @@ function ensureSchema(db) {
       metadata TEXT DEFAULT '{}',
       created_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");
@@ -2260,6 +2285,9 @@ function ensureSchema(db) {
   ensureColumn("tasks", "approved_at", "TEXT");
   ensureColumn("tasks", "recurrence_rule", "TEXT");
   ensureColumn("tasks", "recurrence_parent_id", "TEXT REFERENCES tasks(id) ON DELETE SET NULL");
+  ensureColumn("tasks", "confidence", "REAL");
+  ensureColumn("tasks", "reason", "TEXT");
+  ensureColumn("tasks", "spawned_from_session", "TEXT");
   ensureColumn("agents", "role", "TEXT DEFAULT 'agent'");
   ensureColumn("agents", "permissions", `TEXT DEFAULT '["*"]'`);
   ensureColumn("agents", "reports_to", "TEXT");
@@ -2288,6 +2316,8 @@ 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_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 {
@@ -2318,6 +2348,15 @@ function backfillTaskTags(db) {
     }
   } catch {}
 }
+function closeDatabase() {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}
+function resetDatabase() {
+  _db = null;
+}
 function now() {
   return new Date().toISOString();
 }
@@ -2656,6 +2695,45 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN session_id TEXT;
   ALTER TABLE agents ADD COLUMN working_dir TEXT;
   INSERT OR IGNORE INTO _migrations (id) VALUES (17);
+  `,
+    `
+  ALTER TABLE tasks ADD COLUMN confidence REAL;
+  INSERT OR IGNORE INTO _migrations (id) VALUES (18);
+  `,
+    `
+  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 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 (21);
   `
   ];
 });
@@ -2770,13 +2848,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, "");
@@ -2853,6 +2935,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);
@@ -3317,6 +3441,7 @@ __export(exports_tasks, {
   setTaskStatus: () => setTaskStatus,
   setTaskPriority: () => setTaskPriority,
   removeDependency: () => removeDependency,
+  redistributeStaleTasks: () => redistributeStaleTasks,
   moveTask: () => moveTask,
   lockTask: () => lockTask,
   listTasks: () => listTasks,
@@ -3329,6 +3454,7 @@ __export(exports_tasks, {
   getTask: () => getTask,
   getStatus: () => getStatus,
   getStaleTasks: () => getStaleTasks,
+  getOverdueTasks: () => getOverdueTasks,
   getNextTask: () => getNextTask,
   getBlockingDeps: () => getBlockingDeps,
   getActiveWork: () => getActiveWork,
@@ -3374,8 +3500,8 @@ function createTask(input, db) {
   const tags = input.tags || [];
   const shortId = input.project_id ? nextTaskShortId(input.project_id, d) : null;
   const title = shortId ? `${shortId}: ${input.title}` : input.title;
-  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)
-     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)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
     shortId,
     input.project_id || null,
@@ -3401,7 +3527,9 @@ function createTask(input, db) {
     null,
     input.recurrence_rule || null,
     input.recurrence_parent_id || null,
-    input.spawns_template_id || null
+    input.spawns_template_id || null,
+    input.reason || null,
+    input.spawned_from_session || null
   ]);
   if (tags.length > 0) {
     insertTaskTags(id, tags, d);
@@ -3758,13 +3886,21 @@ function completeTask(id, agentId, db, options) {
   checkCompletionGuard(task, agentId || null, d);
   const evidence = options ? { files_changed: options.files_changed, test_results: options.test_results, commit_hash: options.commit_hash, notes: options.notes, attachment_ids: options.attachment_ids } : undefined;
   const hasEvidence = evidence && (evidence.files_changed || evidence.test_results || evidence.commit_hash || evidence.notes || evidence.attachment_ids);
-  if (hasEvidence) {
-    const meta2 = { ...task.metadata, _evidence: evidence };
+  const completionMeta = {};
+  if (hasEvidence)
+    completionMeta._evidence = evidence;
+  if (options?.confidence !== undefined) {
+    completionMeta._completion = { confidence: options.confidence };
+  }
+  const hasMeta = Object.keys(completionMeta).length > 0;
+  if (hasMeta) {
+    const meta2 = { ...task.metadata, ...completionMeta };
     d.run("UPDATE tasks SET metadata = ? WHERE id = ?", [JSON.stringify(meta2), id]);
   }
   const timestamp = now();
-  d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, version = version + 1, updated_at = ?
-     WHERE id = ?`, [timestamp, timestamp, id]);
+  const confidence = options?.confidence !== undefined ? options.confidence : null;
+  d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, confidence = ?, version = version + 1, updated_at = ?
+     WHERE id = ?`, [timestamp, confidence, timestamp, id]);
   logTaskChange(id, "complete", "status", task.status, "completed", agentId || null, d);
   dispatchWebhook("task.completed", { id, agent_id: agentId, title: task.title, completed_at: timestamp }, d).catch(() => {});
   let spawnedTask = null;
@@ -3783,14 +3919,14 @@ function completeTask(id, agentId, db, options) {
       spawnedFromTemplate = createTask(input, d);
     } catch {}
   }
-  const meta = hasEvidence ? { ...task.metadata, _evidence: evidence } : task.metadata;
+  const meta = hasMeta ? { ...task.metadata, ...completionMeta } : task.metadata;
   if (spawnedTask) {
     meta._next_recurrence = { id: spawnedTask.id, short_id: spawnedTask.short_id, due_at: spawnedTask.due_at };
   }
   if (spawnedFromTemplate) {
     meta._spawned_task = { id: spawnedFromTemplate.id, short_id: spawnedFromTemplate.short_id, title: spawnedFromTemplate.title };
   }
-  return { ...task, status: "completed", locked_by: null, locked_at: null, completed_at: timestamp, version: task.version + 1, updated_at: timestamp, metadata: meta };
+  return { ...task, status: "completed", locked_by: null, locked_at: null, completed_at: timestamp, confidence, version: task.version + 1, updated_at: timestamp, metadata: meta };
 }
 function lockTask(id, agentId, db) {
   const d = db || getDatabase();
@@ -4241,6 +4377,20 @@ function setTaskPriority(id, priority, _agentId, db) {
   }
   throw new Error(`Failed to set priority after 3 attempts`);
 }
+function redistributeStaleTasks(agentId, options, db) {
+  const d = db || getDatabase();
+  const maxAge = options?.max_age_minutes ?? 60;
+  const stale = getStaleTasks(maxAge, options?.project_id ? { project_id: options.project_id } : undefined, d);
+  const limited = options?.limit ? stale.slice(0, options.limit) : stale;
+  const timestamp = now();
+  const released = [];
+  for (const t of limited) {
+    d.run(`UPDATE tasks SET locked_by = NULL, locked_at = NULL, status = 'pending', version = version + 1, updated_at = ? WHERE id = ?`, [timestamp, t.id]);
+    released.push({ ...t, locked_by: null, locked_at: null, status: "pending" });
+  }
+  const claimed = released.length > 0 ? claimNextTask(agentId, options?.project_id ? { project_id: options.project_id } : undefined, d) : null;
+  return { released, claimed };
+}
 function wouldCreateCycle(taskId, dependsOn, db) {
   const visited = new Set;
   const queue = [dependsOn];
@@ -4343,6 +4493,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();
@@ -9331,6 +9494,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";
@@ -9517,7 +9751,9 @@ var init_mcp = __esm(() => {
       estimated_minutes: exports_external.number().optional(),
       requires_approval: exports_external.boolean().optional(),
       recurrence_rule: exports_external.string().optional(),
-      spawns_template_id: exports_external.string().optional().describe("Template ID to auto-create as next task when this task is completed (pipeline/handoff chains)")
+      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)")
     }, async (params) => {
       try {
         const resolved = { ...params };
@@ -9732,12 +9968,13 @@ Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
       test_results: exports_external.string().optional().describe("Summary of test results"),
       commit_hash: exports_external.string().optional().describe("Git commit hash associated with this completion"),
       notes: exports_external.string().optional().describe("Notes about the completion"),
-      attachment_ids: exports_external.array(exports_external.string()).optional().describe("IDs of attachments uploaded via @hasna/attachments to link as evidence")
-    }, async ({ id, agent_id, skip_recurrence, files_changed, test_results, commit_hash, notes, attachment_ids }) => {
+      attachment_ids: exports_external.array(exports_external.string()).optional().describe("IDs of attachments uploaded via @hasna/attachments to link as evidence"),
+      confidence: exports_external.number().min(0).max(1).optional().describe("Agent's confidence 0.0-1.0 that the task is fully complete. Default: 1.0. Low confidence (<0.7) is flagged as a signal for review.")
+    }, async ({ id, agent_id, skip_recurrence, files_changed, test_results, commit_hash, notes, attachment_ids, confidence }) => {
       try {
         const resolvedId = resolveId(id);
         const evidence = files_changed || test_results || commit_hash || notes || attachment_ids ? { files_changed, test_results, commit_hash, notes, attachment_ids } : undefined;
-        const task = completeTask(resolvedId, agent_id, undefined, { skip_recurrence, ...evidence });
+        const task = completeTask(resolvedId, agent_id, undefined, { skip_recurrence, confidence, ...evidence });
         let text = `completed: ${formatTask(task)}`;
         if (task.metadata._next_recurrence) {
           const next = task.metadata._next_recurrence;
@@ -9889,6 +10126,65 @@ ${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("create_plan")) {
     server.tool("create_plan", "Create a plan to group related tasks.", {
       name: exports_external.string(),
@@ -11205,6 +11501,42 @@ ${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) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("redistribute_stale_tasks")) {
+    server.tool("redistribute_stale_tasks", "Release stale in-progress tasks and optionally claim the best one. Work-stealing for multi-agent.", {
+      agent_id: exports_external.string().describe("Agent ID claiming the next task after releasing stale ones"),
+      max_age_minutes: exports_external.number().optional().describe("Tasks idle longer than this (default: 60) are released"),
+      project_id: exports_external.string().optional().describe("Limit to a specific project"),
+      limit: exports_external.number().optional().describe("Max number of stale tasks to release")
+    }, async ({ agent_id, max_age_minutes, project_id, limit }) => {
+      try {
+        const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
+        const result = redistributeStaleTasks(agent_id, { max_age_minutes, project_id: resolvedProjectId, limit });
+        const lines = [`Released ${result.released.length} stale task(s).`];
+        for (const t of result.released)
+          lines.push(`  ${formatTask(t)}`);
+        if (result.claimed)
+          lines.push(`
+Claimed: ${formatTask(result.claimed)}`);
         return { content: [{ type: "text", text: lines.join(`
 `) }] };
       } catch (e) {
@@ -11232,6 +11564,9 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
         "log_progress",
         "create_project",
         "list_projects",
+        "add_project_source",
+        "remove_project_source",
+        "list_project_sources",
         "create_plan",
         "list_plans",
         "get_plan",
@@ -11279,6 +11614,7 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
         "decompose_task",
         "set_task_status",
         "set_task_priority",
+        "redistribute_stale_tasks",
         "search_tools",
         "describe_tools"
       ].filter((name) => shouldRegisterTool(name));
@@ -11339,6 +11675,15 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
   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_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'}`,
@@ -11466,6 +11811,9 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
         set_task_priority: `Set task priority without needing version. Auto-retries on conflict (up to 3 attempts). Use instead of update_task when you only need to change priority.
   Params: id(string, req), priority(low|medium|high|critical, req)
   Example: {id: 'a1b2c3d4', priority: 'high'}`,
+        redistribute_stale_tasks: `Release stale in-progress tasks and optionally claim the best one. Multi-agent work-stealing.
+  Params: agent_id(string, req), max_age_minutes(number, default:60), project_id(string, optional), limit(number, optional)
+  Example: {agent_id: 'a1b2c3d4', max_age_minutes: 30}`,
         search_tools: `List all tool names or filter by substring.
   Params: query(string, optional)
   Example: {query: 'task'}`,
@@ -11496,6 +11844,62 @@ ${checks.map((c) => `  ${c.status === "ok" ? "\u2713" : "\u26A0"} ${c.name}: ${c
     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" }] };
@@ -13631,7 +14035,7 @@ function formatTaskLine(t) {
   return `${chalk.dim(t.id.slice(0, 8))} ${statusFn(t.status.padEnd(11))} ${priorityFn(t.priority.padEnd(8))} ${t.title}${assigned}${lock}${tags}${plan}`;
 }
 program2.name("todos").description("Universal task management for AI coding agents").version(getPackageVersion()).option("--project <path>", "Project path").option("--json", "Output as JSON").option("--agent <name>", "Agent name").option("--session <id>", "Session ID");
-program2.command("add <title>").description("Create a new task").option("-d, --description <text>", "Task description").option("-p, --priority <level>", "Priority: low, medium, high, critical").option("--parent <id>", "Parent task ID").option("-t, --tags <tags>", "Comma-separated tags").option("--tag <tags>", "Comma-separated tags (alias for --tags)").option("--plan <id>", "Assign to a plan").option("--assign <agent>", "Assign to agent").option("--status <status>", "Initial status").option("--list <id>", "Task list ID").option("--task-list <id>", "Task list ID (alias for --list)").option("--estimated <minutes>", "Estimated time in minutes").option("--approval", "Require approval before completion").option("--recurrence <rule>", "Recurrence rule, e.g. 'every day', 'every weekday', 'every 2 weeks'").option("--due <date>", "Due date (ISO string or YYYY-MM-DD)").action((title, opts) => {
+program2.command("add <title>").description("Create a new task").option("-d, --description <text>", "Task description").option("-p, --priority <level>", "Priority: low, medium, high, critical").option("--parent <id>", "Parent task ID").option("-t, --tags <tags>", "Comma-separated tags").option("--tag <tags>", "Comma-separated tags (alias for --tags)").option("--plan <id>", "Assign to a plan").option("--assign <agent>", "Assign to agent").option("--status <status>", "Initial status").option("--list <id>", "Task list ID").option("--task-list <id>", "Task list ID (alias for --list)").option("--estimated <minutes>", "Estimated time in minutes").option("--approval", "Require approval before completion").option("--recurrence <rule>", "Recurrence rule, e.g. 'every day', 'every weekday', 'every 2 weeks'").option("--due <date>", "Due date (ISO string or YYYY-MM-DD)").option("--reason <text>", "Why this task exists").action((title, opts) => {
   const globalOpts = program2.opts();
   const projectId = autoProject(globalOpts);
   opts.tags = opts.tags || opts.tag;
@@ -13670,7 +14074,8 @@ program2.command("add <title>").description("Create a new task").option("-d, --d
     estimated_minutes: opts.estimated ? parseInt(opts.estimated, 10) : undefined,
     requires_approval: opts.approval || false,
     recurrence_rule: opts.recurrence,
-    due_at: opts.due ? opts.due.length === 10 ? opts.due + "T00:00:00.000Z" : opts.due : undefined
+    due_at: opts.due ? opts.due.length === 10 ? opts.due + "T00:00:00.000Z" : opts.due : undefined,
+    reason: opts.reason
   });
   if (globalOpts.json) {
     output(task, true);
@@ -13954,15 +14359,16 @@ program2.command("update <id>").description("Update a task").option("--title <te
     console.log(formatTaskLine(task));
   }
 });
-program2.command("done <id>").description("Mark a task as completed").option("--attach-ids <ids>", "Comma-separated @hasna/attachments IDs to link as evidence").option("--files-changed <files>", "Comma-separated list of files changed").option("--test-results <results>", "Test results summary").option("--commit-hash <hash>", "Git commit hash").option("--notes <notes>", "Completion notes").action((id, opts) => {
+program2.command("done <id>").description("Mark a task as completed").option("--attach-ids <ids>", "Comma-separated @hasna/attachments IDs to link as evidence").option("--files-changed <files>", "Comma-separated list of files changed").option("--test-results <results>", "Test results summary").option("--commit-hash <hash>", "Git commit hash").option("--notes <notes>", "Completion notes").option("--confidence <0-1>", "Agent's confidence 0.0-1.0 that the task is fully complete (default: 1.0, <0.7 flagged for review)").action((id, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
   const attachmentIds = opts.attachIds ? opts.attachIds.split(",").map((s) => s.trim()) : undefined;
   const filesChanged = opts.filesChanged ? opts.filesChanged.split(",").map((s) => s.trim()) : undefined;
+  const confidence = opts.confidence !== undefined ? parseFloat(opts.confidence) : undefined;
   const evidence = attachmentIds || filesChanged || opts.testResults || opts.commitHash || opts.notes ? { attachment_ids: attachmentIds, files_changed: filesChanged, test_results: opts.testResults, commit_hash: opts.commitHash, notes: opts.notes } : undefined;
   let task;
   try {
-    task = completeTask(resolvedId, globalOpts.agent, undefined, evidence);
+    task = completeTask(resolvedId, globalOpts.agent, undefined, { ...evidence, confidence });
   } catch (e) {
     handleError(e);
   }
@@ -15275,6 +15681,33 @@ program2.command("stale").description("Find tasks stuck in_progress with no rece
     console.log(`  ${chalk.cyan(id)} | ${t.locked_by || t.assigned_to || "?"} | ${t.title} ${chalk.dim(`(${staleMin}min stale)`)}`);
   }
 });
+program2.command("redistribute <agent>").description("Release stale in-progress tasks and claim the best one (work-stealing)").option("--max-age <minutes>", "Stale threshold in minutes", "60").option("--project <id>", "Limit to a specific project").option("--limit <n>", "Max stale tasks to release").option("--json", "Output as JSON").action(async (agent, opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const projectId = opts.project ? resolveTaskId(opts.project) : autoProject(globalOpts) ?? undefined;
+  const result = redistributeStaleTasks(agent, {
+    max_age_minutes: parseInt(opts.maxAge, 10),
+    project_id: projectId,
+    limit: opts.limit ? parseInt(opts.limit, 10) : undefined
+  }, db);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(chalk.bold(`Released ${result.released.length} stale task(s).`));
+  for (const t of result.released) {
+    const id = t.short_id || t.id.slice(0, 8);
+    console.log(`  ${chalk.yellow("released")} ${chalk.cyan(id)} ${t.title}`);
+  }
+  if (result.claimed) {
+    const id = result.claimed.short_id || result.claimed.id.slice(0, 8);
+    console.log(chalk.green(`
+Claimed: ${chalk.cyan(id)} ${result.claimed.title}`));
+  } else {
+    console.log(chalk.dim(`
+No task claimed (nothing available).`));
+  }
+});
 program2.command("assign <id> <agent>").description("Assign a task to an agent").option("--json", "Output as JSON").action((id, agent, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
@@ -15590,6 +16023,543 @@ program2.command("report").description("Analytics report: task activity, complet
   console.log(lines.join(`
 `));
 });
+program2.command("today").description("Show task activity from today").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { getTasksChangedSince: getTasksChangedSince2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const start = new Date;
+  start.setHours(0, 0, 0, 0);
+  const tasks = getTasksChangedSince2(start.toISOString(), undefined, db);
+  const completed = tasks.filter((t) => t.status === "completed");
+  const started = tasks.filter((t) => t.status === "in_progress");
+  const other = tasks.filter((t) => t.status !== "completed" && t.status !== "in_progress");
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify({ date: start.toISOString().slice(0, 10), completed, started, changed: other }));
+    return;
+  }
+  console.log(chalk.bold(`Today \u2014 ${start.toISOString().slice(0, 10)}
+`));
+  if (completed.length > 0) {
+    console.log(chalk.green(`  \u2713 Completed (${completed.length}):`));
+    for (const t of completed)
+      console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : ""}`);
+  }
+  if (started.length > 0) {
+    console.log(chalk.blue(`
+  \u25B6 Started (${started.length}):`));
+    for (const t of started)
+      console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : ""}`);
+  }
+  if (completed.length === 0 && started.length === 0)
+    console.log(chalk.dim("  No activity today."));
+});
+program2.command("yesterday").description("Show task activity from yesterday").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const { getTasksChangedSince: getTasksChangedSince2 } = (init_tasks(), __toCommonJS(exports_tasks));
+  const start = new Date;
+  start.setDate(start.getDate() - 1);
+  start.setHours(0, 0, 0, 0);
+  const end = new Date(start);
+  end.setHours(23, 59, 59, 999);
+  const allChanged = getTasksChangedSince2(start.toISOString(), undefined, db);
+  const tasks = allChanged.filter((t) => t.updated_at <= end.toISOString());
+  const completed = tasks.filter((t) => t.status === "completed");
+  const started = tasks.filter((t) => t.status === "in_progress");
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify({ date: start.toISOString().slice(0, 10), completed, started }));
+    return;
+  }
+  console.log(chalk.bold(`Yesterday \u2014 ${start.toISOString().slice(0, 10)}
+`));
+  if (completed.length > 0) {
+    console.log(chalk.green(`  \u2713 Completed (${completed.length}):`));
+    for (const t of completed)
+      console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk.dim(` \u2014 ${t.assigned_to}`) : ""}`);
+  }
+  if (started.length > 0) {
+    console.log(chalk.blue(`
+  \u25B6 Started (${started.length}):`));
+    for (const t of started)
+      console.log(`    ${chalk.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}`);
+  }
+  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 {