@hasna/todos 0.11.18 → 0.11.20

package/dist/cli/index.js

@@ -2260,6 +2260,18 @@ function ensureSchema(db) {
       created_at TEXT NOT NULL DEFAULT (datetime('now')),
       UNIQUE(source_id, source_type, target_id, target_type, relation_type)
     )`);
+  ensureTable("project_machine_paths", `
+    CREATE TABLE project_machine_paths (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      machine_id TEXT NOT NULL,
+      path TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      UNIQUE(project_id, machine_id)
+    )`);
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_machine_paths_project ON project_machine_paths(project_id)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_machine_paths_machine ON project_machine_paths(machine_id)");
   ensureTable("machines", `
     CREATE TABLE machines (
       id TEXT PRIMARY KEY, name TEXT NOT NULL UNIQUE, hostname TEXT, platform TEXT,
@@ -2295,6 +2307,7 @@ function ensureSchema(db) {
   ensureColumn("tasks", "max_retries", "INTEGER DEFAULT 3");
   ensureColumn("tasks", "retry_after", "TEXT");
   ensureColumn("tasks", "sla_minutes", "INTEGER");
+  ensureColumn("tasks", "archived_at", "TEXT");
   ensureColumn("agents", "role", "TEXT DEFAULT 'agent'");
   ensureColumn("agents", "permissions", `TEXT DEFAULT '["*"]'`);
   ensureColumn("agents", "reports_to", "TEXT");
@@ -3133,6 +3146,25 @@ var init_schema = __esm(() => {
   CREATE INDEX IF NOT EXISTS idx_agents_machine ON agents(machine_id);
 
   INSERT OR IGNORE INTO _migrations (id) VALUES (41);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS project_machine_paths (
+    id TEXT PRIMARY KEY,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    machine_id TEXT NOT NULL,
+    path TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(project_id, machine_id)
+  );
+  CREATE INDEX IF NOT EXISTS idx_project_machine_paths_project ON project_machine_paths(project_id);
+  CREATE INDEX IF NOT EXISTS idx_project_machine_paths_machine ON project_machine_paths(machine_id);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (42);
+  `,
+    `
+  ALTER TABLE tasks ADD COLUMN archived_at TEXT;
+  CREATE INDEX IF NOT EXISTS idx_tasks_archived ON tasks(archived_at) WHERE archived_at IS NOT NULL;
+  INSERT OR IGNORE INTO _migrations (id) VALUES (43);
   `
   ];
 });
@@ -3517,13 +3549,18 @@ var exports_projects = {};
 __export(exports_projects, {
   updateProject: () => updateProject,
   slugify: () => slugify,
+  setMachineLocalPath: () => setMachineLocalPath,
+  renameProject: () => renameProject,
   removeProjectSource: () => removeProjectSource,
+  removeMachineLocalPath: () => removeMachineLocalPath,
   nextTaskShortId: () => nextTaskShortId,
   listProjects: () => listProjects,
   listProjectSources: () => listProjectSources,
+  listMachineLocalPaths: () => listMachineLocalPaths,
   getProjectWithSources: () => getProjectWithSources,
   getProjectByPath: () => getProjectByPath,
   getProject: () => getProject,
+  getMachineLocalPath: () => getMachineLocalPath,
   ensureProject: () => ensureProject,
   deleteProject: () => deleteProject,
   createProject: () => createProject,
@@ -3569,8 +3606,15 @@ function getProject(id, db) {
 }
 function getProjectByPath(path, db) {
   const d = db || getDatabase();
-  const row = d.query("SELECT * FROM projects WHERE path = ?").get(path);
-  return row;
+  try {
+    const machineId = getMachineId(d);
+    const machineRow = d.query(`SELECT p.* FROM projects p
+       JOIN project_machine_paths pmp ON pmp.project_id = p.id
+       WHERE pmp.machine_id = ? AND pmp.path = ?`).get(machineId, path);
+    if (machineRow)
+      return machineRow;
+  } catch {}
+  return d.query("SELECT * FROM projects WHERE path = ?").get(path);
 }
 function listProjects(db) {
   const d = db || getDatabase();
@@ -3595,10 +3639,40 @@ function updateProject(id, input, db) {
     sets.push("task_list_id = ?");
     params.push(input.task_list_id);
   }
+  if (input.path !== undefined) {
+    sets.push("path = ?");
+    params.push(input.path);
+  }
   params.push(id);
   d.run(`UPDATE projects SET ${sets.join(", ")} WHERE id = ?`, params);
   return getProject(id, d);
 }
+function renameProject(id, input, db) {
+  const d = db || getDatabase();
+  const project = getProject(id, d);
+  if (!project)
+    throw new ProjectNotFoundError(id);
+  let taskListsUpdated = 0;
+  const ts = now();
+  if (input.new_slug !== undefined) {
+    const normalised = input.new_slug.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-|-$/g, "");
+    if (!normalised)
+      throw new Error("Invalid slug \u2014 must be non-empty kebab-case");
+    const conflict = d.query("SELECT id FROM projects WHERE task_list_id = ? AND id != ?").get(normalised, id);
+    if (conflict)
+      throw new Error(`Slug "${normalised}" is already used by another project`);
+    const oldSlug = project.task_list_id;
+    d.run("UPDATE projects SET task_list_id = ?, updated_at = ? WHERE id = ?", [normalised, ts, id]);
+    if (oldSlug) {
+      const result = d.run("UPDATE task_lists SET slug = ?, name = COALESCE(?, name), updated_at = ? WHERE project_id = ? AND slug = ?", [normalised, input.name ?? null, ts, id, oldSlug]);
+      taskListsUpdated = result.changes;
+    }
+  }
+  if (input.name !== undefined) {
+    d.run("UPDATE projects SET name = ?, updated_at = ? WHERE id = ?", [input.name, ts, id]);
+  }
+  return { project: getProject(id, d), task_lists_updated: taskListsUpdated };
+}
 function deleteProject(id, db) {
   const d = db || getDatabase();
   const result = d.run("DELETE FROM projects WHERE id = ?", [id]);
@@ -3665,13 +3739,53 @@ function ensureProject(name, path, db) {
       d.run("UPDATE projects SET task_prefix = ?, updated_at = ? WHERE id = ?", [prefix, now(), existing.id]);
       return getProject(existing.id, d);
     }
+    setMachineLocalPath(existing.id, path, d);
     return existing;
   }
-  return createProject({ name, path }, d);
+  const project = createProject({ name, path }, d);
+  setMachineLocalPath(project.id, path, d);
+  return project;
+}
+function setMachineLocalPath(projectId, path, db) {
+  const d = db || getDatabase();
+  const machineId = getMachineId(d);
+  const ts = now();
+  const existing = d.query("SELECT * FROM project_machine_paths WHERE project_id = ? AND machine_id = ?").get(projectId, machineId);
+  if (existing) {
+    if (existing.path !== path) {
+      d.run("UPDATE project_machine_paths SET path = ?, updated_at = ? WHERE id = ?", [path, ts, existing.id]);
+    }
+    return d.query("SELECT * FROM project_machine_paths WHERE id = ?").get(existing.id);
+  }
+  const id = uuid();
+  d.run("INSERT INTO project_machine_paths (id, project_id, machine_id, path, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)", [id, projectId, machineId, path, ts, ts]);
+  return d.query("SELECT * FROM project_machine_paths WHERE id = ?").get(id);
+}
+function getMachineLocalPath(projectId, db) {
+  const d = db || getDatabase();
+  try {
+    const machineId = getMachineId(d);
+    const row = d.query("SELECT path FROM project_machine_paths WHERE project_id = ? AND machine_id = ?").get(projectId, machineId);
+    if (row)
+      return row.path;
+  } catch {}
+  const project = getProject(projectId, d);
+  return project?.path ?? null;
+}
+function listMachineLocalPaths(projectId, db) {
+  const d = db || getDatabase();
+  return d.query("SELECT * FROM project_machine_paths WHERE project_id = ? ORDER BY machine_id").all(projectId);
+}
+function removeMachineLocalPath(projectId, machineId, db) {
+  const d = db || getDatabase();
+  const mid = machineId ?? getMachineId(d);
+  const result = d.run("DELETE FROM project_machine_paths WHERE project_id = ? AND machine_id = ?", [projectId, mid]);
+  return result.changes > 0;
 }
 var init_projects = __esm(() => {
   init_types();
   init_database();
+  init_machines();
 });
 
 // src/lib/sync-utils.ts
@@ -4658,6 +4772,7 @@ var exports_tasks = {};
 __export(exports_tasks, {
   updateTask: () => updateTask,
   unlockTask: () => unlockTask,
+  unarchiveTask: () => unarchiveTask,
   stealTask: () => stealTask,
   startTask: () => startTask,
   setTaskStatus: () => setTaskStatus,
@@ -4692,6 +4807,7 @@ __export(exports_tasks, {
   claimNextTask: () => claimNextTask,
   bulkUpdateTasks: () => bulkUpdateTasks,
   bulkCreateTasks: () => bulkCreateTasks,
+  archiveTasks: () => archiveTasks,
   addDependency: () => addDependency
 });
 function rowToTask(row) {
@@ -4884,6 +5000,9 @@ function listTasks(filter = {}, db) {
       params.push(decoded.p, decoded.p, decoded.c, decoded.p, decoded.c, decoded.i);
     } catch {}
   }
+  if (!filter.include_archived) {
+    conditions.push("archived_at IS NULL");
+  }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   let limitClause = "";
   if (filter.limit) {
@@ -5797,6 +5916,35 @@ function bulkUpdateTasks(taskIds, updates, db) {
   tx();
   return { updated, failed };
 }
+function archiveTasks(options, db) {
+  const d = db || getDatabase();
+  const conditions = ["archived_at IS NULL"];
+  const params = [];
+  const statuses = options.status ?? ["completed", "failed", "cancelled"];
+  conditions.push(`status IN (${statuses.map(() => "?").join(",")})`);
+  params.push(...statuses);
+  if (options.project_id) {
+    conditions.push("project_id = ?");
+    params.push(options.project_id);
+  }
+  if (options.task_list_id) {
+    conditions.push("task_list_id = ?");
+    params.push(options.task_list_id);
+  }
+  if (options.older_than_days !== undefined) {
+    const cutoff = new Date(Date.now() - options.older_than_days * 86400000).toISOString();
+    conditions.push("updated_at < ?");
+    params.push(cutoff);
+  }
+  const ts = now();
+  const result = d.run(`UPDATE tasks SET archived_at = ? WHERE ${conditions.join(" AND ")}`, [ts, ...params]);
+  return { archived: result.changes };
+}
+function unarchiveTask(id, db) {
+  const d = db || getDatabase();
+  d.run("UPDATE tasks SET archived_at = NULL WHERE id = ?", [id]);
+  return getTask(id, d);
+}
 function getOverdueTasks(projectId, db) {
   const d = db || getDatabase();
   const nowStr = new Date().toISOString();
@@ -6331,21 +6479,25 @@ function escapeFtsQuery(q) {
   return q.replace(/["*^()]/g, " ").trim().split(/\s+/).filter(Boolean).map((token) => `"${token}"*`).join(" ");
 }
 function searchTasks(options, projectId, taskListId, db) {
-  const opts = typeof options === "string" ? { query: options, project_id: projectId, task_list_id: taskListId } : options;
+  const opts = typeof options === "string" ? { query: options || undefined, project_id: projectId, task_list_id: taskListId } : options;
   const d = db || getDatabase();
   clearExpiredLocks(d);
   const params = [];
   let sql;
-  if (hasFts(d) && opts.query.trim()) {
-    const ftsQuery = escapeFtsQuery(opts.query);
+  const raw = opts.query?.trim() ?? "";
+  const q = raw === "*" ? "" : raw;
+  if (hasFts(d) && q) {
+    const ftsQuery = escapeFtsQuery(q);
     sql = `SELECT t.* FROM tasks t
       INNER JOIN tasks_fts fts ON fts.rowid = t.rowid
       WHERE tasks_fts MATCH ?`;
     params.push(ftsQuery);
-  } else {
-    const pattern = `%${opts.query}%`;
+  } else if (q) {
+    const pattern = `%${q}%`;
     sql = `SELECT * FROM tasks t WHERE (t.title LIKE ? OR t.description LIKE ? OR EXISTS (SELECT 1 FROM task_tags WHERE task_tags.task_id = t.id AND tag LIKE ?))`;
     params.push(pattern, pattern, pattern);
+  } else {
+    sql = `SELECT * FROM tasks t WHERE 1=1`;
   }
   if (opts.project_id) {
     sql += " AND t.project_id = ?";
@@ -6399,7 +6551,7 @@ function searchTasks(options, projectId, taskListId, db) {
   } else if (opts.is_blocked === false) {
     sql += " AND t.id NOT IN (SELECT td.task_id FROM task_dependencies td JOIN tasks dep ON dep.id = td.depends_on WHERE dep.status != 'completed')";
   }
-  if (hasFts(d) && opts.query.trim()) {
+  if (hasFts(d) && q) {
     sql += ` ORDER BY bm25(tasks_fts),
       CASE t.priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 END,
       t.created_at DESC`;
@@ -23771,12 +23923,17 @@ ${text}` }] };
         if (!agent) {
           return { content: [{ type: "text", text: `Agent not found: ${id || name}` }], isError: true };
         }
+        const oldName = agent.name;
         const updated = updateAgent(agent.id, { name: new_name });
+        const db = getDatabase();
+        const tasksResult = db.run("UPDATE tasks SET assigned_to = ? WHERE assigned_to = ?", [new_name, oldName]);
+        const taskNote = tasksResult.changes > 0 ? `
+Updated assigned_to on ${tasksResult.changes} task(s).` : "";
         return {
           content: [{
             type: "text",
-            text: `Agent renamed: ${agent.name} -> ${updated.name}
-ID: ${updated.id}`
+            text: `Agent renamed: ${oldName} -> ${updated.name}
+ID: ${updated.id}${taskNote}`
           }]
         };
       } catch (e) {
@@ -25996,6 +26153,8 @@ function formatTaskDetail(task, maxDescriptionChars) {
     parts.push(`Project: ${task.project_id}`);
   if (task.plan_id)
     parts.push(`Plan: ${task.plan_id}`);
+  if (task.due_at)
+    parts.push(`Due: ${task.due_at.slice(0, 10)}`);
   if (task.tags.length > 0)
     parts.push(`Tags: ${task.tags.join(", ")}`);
   if (task.recurrence_rule)
@@ -26097,7 +26256,8 @@ var init_mcp = __esm(() => {
       reason: exports_external.string().optional().describe("Why this task exists \u2014 context for agents picking it up"),
       spawned_from_session: exports_external.string().optional().describe("Session ID that created this task (for tracing task lineage)"),
       assigned_from_project: exports_external.string().optional().describe("Override: project ID the assigning agent is working from. Auto-detected from agent focus if omitted."),
-      task_type: exports_external.string().optional().describe("Task type: bug, feature, chore, improvement, docs, test, security, or any custom string")
+      task_type: exports_external.string().optional().describe("Task type: bug, feature, chore, improvement, docs, test, security, or any custom string"),
+      due_date: exports_external.string().optional().describe("Due date as YYYY-MM-DD (e.g. '2026-04-15'). Stored as end-of-day ISO timestamp.")
     }, async (params) => {
       try {
         if (!params.agent_id) {
@@ -26112,6 +26272,10 @@ var init_mcp = __esm(() => {
           resolved["plan_id"] = resolveId(resolved["plan_id"], "plans");
         if (resolved["task_list_id"])
           resolved["task_list_id"] = resolveId(resolved["task_list_id"], "task_lists");
+        if (resolved["due_date"]) {
+          resolved["due_at"] = `${resolved["due_date"]}T23:59:59.000Z`;
+          delete resolved["due_date"];
+        }
         if (!resolved["assigned_from_project"]) {
           const focus = getAgentFocus(params.agent_id);
           if (focus?.project_id) {
@@ -26147,7 +26311,8 @@ var init_mcp = __esm(() => {
       limit: exports_external.number().optional(),
       offset: exports_external.number().optional(),
       summary_only: exports_external.boolean().optional().describe("When true, return only id, short_id, title, status, priority \u2014 minimal tokens for navigation"),
-      cursor: exports_external.string().optional().describe("Opaque cursor from a prior response for stable pagination. Use next_cursor from the previous page. Mutually exclusive with offset.")
+      cursor: exports_external.string().optional().describe("Opaque cursor from a prior response for stable pagination. Use next_cursor from the previous page. Mutually exclusive with offset."),
+      include_archived: exports_external.boolean().optional().describe("When true, include archived tasks. Default: false.")
     }, async (params) => {
       try {
         const { due_today, overdue, summary_only, ...rest } = params;
@@ -26182,7 +26347,8 @@ var init_mcp = __esm(() => {
           const assigned = t.assigned_to ? ` -> ${t.assigned_to}` : "";
           const due = t.due_at ? ` due:${t.due_at.slice(0, 10)}` : "";
           const recur = t.recurrence_rule ? " [\u21BB]" : "";
-          return `[${t.status}] ${t.id.slice(0, 8)} | ${t.priority} | ${t.title}${assigned}${lock}${due}${recur}`;
+          const list = t.task_list_id ? ` list:${t.task_list_id.slice(0, 8)}` : "";
+          return `[${t.status}] ${t.id.slice(0, 8)} | ${t.priority} | ${t.title}${assigned}${list}${lock}${due}${recur}`;
         }).join(`
 `);
         const currentOffset = resolved.offset || 0;
@@ -26269,7 +26435,7 @@ Checklist (${done}/${task.checklist.length}):`);
   if (shouldRegisterTool("update_task")) {
     server.tool("update_task", "Update task fields. Version required for optimistic locking.", {
       id: exports_external.string(),
-      version: exports_external.number(),
+      version: exports_external.union([exports_external.number(), exports_external.string()]).transform((v) => Number(v)),
       title: exports_external.string().optional(),
       description: exports_external.string().optional(),
       status: exports_external.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional(),
@@ -26279,7 +26445,8 @@ Checklist (${done}/${task.checklist.length}):`);
       metadata: exports_external.record(exports_external.unknown()).optional(),
       plan_id: exports_external.string().optional(),
       task_list_id: exports_external.string().optional(),
-      task_type: exports_external.string().nullable().optional().describe("Task type: bug, feature, chore, improvement, docs, test, security, or custom. null to clear.")
+      task_type: exports_external.string().nullable().optional().describe("Task type: bug, feature, chore, improvement, docs, test, security, or custom. null to clear."),
+      due_date: exports_external.string().nullable().optional().describe("Due date as YYYY-MM-DD. null to clear. Stored as end-of-day ISO timestamp.")
     }, async ({ id, ...rest }) => {
       try {
         const resolvedId = resolveId(id);
@@ -26288,6 +26455,10 @@ Checklist (${done}/${task.checklist.length}):`);
           resolved.task_list_id = resolveId(resolved.task_list_id, "task_lists");
         if (resolved.plan_id)
           resolved.plan_id = resolveId(resolved.plan_id, "plans");
+        if ("due_date" in resolved) {
+          resolved["due_at"] = resolved["due_date"] ? `${resolved["due_date"]}T23:59:59.000Z` : null;
+          delete resolved["due_date"];
+        }
         const task = updateTask(resolvedId, resolved);
         return { content: [{ type: "text", text: `updated: ${formatTask(task)}` }] };
       } catch (e) {
@@ -26523,6 +26694,29 @@ ${text}` }] };
       }
     });
   }
+  if (shouldRegisterTool("update_project")) {
+    server.tool("update_project", "Update project fields: name, description, path, task_list_id. Use new_slug to rename the project slug (cascades to task_lists).", {
+      id: exports_external.string().describe("Project ID"),
+      name: exports_external.string().optional(),
+      description: exports_external.string().optional(),
+      path: exports_external.string().optional().describe("Update global path (use projects-path set for machine-local overrides)"),
+      task_list_id: exports_external.string().optional(),
+      new_slug: exports_external.string().optional().describe("Rename the project slug (kebab-case). Cascades to matching task_list slugs.")
+    }, async ({ id, name, description, path, task_list_id, new_slug }) => {
+      try {
+        const resolvedId = resolveId(id, "projects");
+        if (new_slug || name && !description && !path && !task_list_id) {
+          const result = renameProject(resolvedId, { name, new_slug });
+          const note = result.task_lists_updated > 0 ? ` (${result.task_lists_updated} task list(s) slug updated)` : "";
+          return { content: [{ type: "text", text: `Project updated: ${result.project.id.slice(0, 8)} | ${result.project.name}${note}` }] };
+        }
+        const updated = updateProject(resolvedId, { name, description, path, task_list_id });
+        return { content: [{ type: "text", text: `Project updated: ${updated.id.slice(0, 8)} | ${updated.name}${updated.path ? ` (${updated.path})` : ""}` }] };
+      } 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")
@@ -26786,8 +26980,8 @@ ${text}` }] };
     });
   }
   if (shouldRegisterTool("search_tasks")) {
-    server.tool("search_tasks", "Full-text search across tasks with filters.", {
-      query: exports_external.string(),
+    server.tool("search_tasks", "Full-text search across tasks with filters. query is optional \u2014 if omitted, returns all tasks matching the given filters.", {
+      query: exports_external.string().optional(),
       project_id: exports_external.string().optional(),
       task_list_id: exports_external.string().optional(),
       status: exports_external.union([
@@ -26815,11 +27009,12 @@ ${text}` }] };
           ...filters
         });
         if (tasks.length === 0) {
-          return { content: [{ type: "text", text: `No tasks matching "${query}".` }] };
+          return { content: [{ type: "text", text: query ? `No tasks matching "${query}".` : "No tasks found." }] };
         }
         const text = tasks.map((t) => `[${t.status}] ${t.id.slice(0, 8)} | ${t.priority} | ${t.title}`).join(`
 `);
-        return { content: [{ type: "text", text: `${tasks.length} result(s) for "${query}":
+        const label = query ? `${tasks.length} result(s) for "${query}"` : `${tasks.length} task(s)`;
+        return { content: [{ type: "text", text: `${label}:
 ${text}` }] };
       } catch (e) {
         return { content: [{ type: "text", text: formatError(e) }], isError: true };
@@ -26915,9 +27110,15 @@ Description: ${list.description}` : ""}`
         if (lists.length === 0) {
           return { content: [{ type: "text", text: "No task lists found." }] };
         }
+        const db = getDatabase();
         const text = lists.map((l) => {
           const project = l.project_id ? ` (project: ${l.project_id.slice(0, 8)})` : "";
-          return `${l.id.slice(0, 8)} | ${l.name} [${l.slug}]${project}${l.description ? ` - ${l.description}` : ""}`;
+          const counts = db.query(`SELECT COUNT(*) as total,
+            SUM(CASE WHEN status IN ('pending','in_progress') THEN 1 ELSE 0 END) as active,
+            SUM(CASE WHEN status = 'completed' THEN 1 ELSE 0 END) as done
+           FROM tasks WHERE task_list_id = ? AND archived_at IS NULL`).get(l.id);
+          const taskNote = ` [${counts.active} active, ${counts.done} done / ${counts.total} total]`;
+          return `${l.id.slice(0, 8)} | ${l.name} [${l.slug}]${taskNote}${project}${l.description ? ` - ${l.description}` : ""}`;
         }).join(`
 `);
         return { content: [{ type: "text", text: `${lists.length} task list(s):
@@ -27505,6 +27706,52 @@ In Progress:`);
       }
     });
   }
+  if (shouldRegisterTool("archive_completed")) {
+    server.tool("archive_completed", "Archive completed/failed/cancelled tasks to reduce clutter. Archived tasks are hidden from list_tasks and search_tasks by default.", {
+      project_id: exports_external.string().optional().describe("Scope to a project"),
+      task_list_id: exports_external.string().optional().describe("Scope to a task list"),
+      older_than_days: exports_external.number().optional().describe("Only archive tasks last updated more than N days ago. Default: all matching tasks."),
+      status: exports_external.array(exports_external.enum(["completed", "failed", "cancelled"])).optional().describe("Statuses to archive. Default: completed, failed, cancelled."),
+      dry_run: exports_external.boolean().optional().describe("Preview count without archiving. Default: false.")
+    }, async ({ project_id, task_list_id, older_than_days, status, dry_run }) => {
+      try {
+        const filters = {};
+        if (project_id)
+          filters.project_id = resolveId(project_id, "projects");
+        if (task_list_id)
+          filters.task_list_id = resolveId(task_list_id, "task_lists");
+        if (older_than_days !== undefined)
+          filters.older_than_days = older_than_days;
+        if (status)
+          filters.status = status;
+        if (dry_run) {
+          const db = getDatabase();
+          const statuses = status ?? ["completed", "failed", "cancelled"];
+          const conditions = ["archived_at IS NULL", `status IN (${statuses.map(() => "?").join(",")})`];
+          const params = [...statuses];
+          if (filters.project_id) {
+            conditions.push("project_id = ?");
+            params.push(filters.project_id);
+          }
+          if (filters.task_list_id) {
+            conditions.push("task_list_id = ?");
+            params.push(filters.task_list_id);
+          }
+          if (older_than_days !== undefined) {
+            const cutoff = new Date(Date.now() - older_than_days * 86400000).toISOString();
+            conditions.push("updated_at < ?");
+            params.push(cutoff);
+          }
+          const count = db.query(`SELECT COUNT(*) as c FROM tasks WHERE ${conditions.join(" AND ")}`).get(...params).c;
+          return { content: [{ type: "text", text: `Dry run: would archive ${count} task(s).` }] };
+        }
+        const result = archiveTasks(filters);
+        return { content: [{ type: "text", text: `Archived ${result.archived} task(s).` }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
   if (shouldRegisterTool("bulk_update_tasks")) {
     server.tool("bulk_update_tasks", "Update multiple tasks at once. Two modes: (1) task_ids + shared fields \u2014 apply the same changes to all; (2) updates array \u2014 per-task fields, each entry has id plus any fields to update.", {
       task_ids: exports_external.array(exports_external.string()).optional().describe("Task IDs to update with the same fields (mode 1)"),
@@ -27617,6 +27864,26 @@ In Progress:`);
         if (agent_id)
           filters.agent_id = agent_id;
         const stats = getTaskStats(Object.keys(filters).length > 0 ? filters : undefined);
+        if (!task_list_id) {
+          const db = getDatabase();
+          const listRows = db.query(`SELECT tl.id, tl.name, tl.slug,
+            COUNT(t.id) as total,
+            SUM(CASE WHEN t.status = 'completed' THEN 1 ELSE 0 END) as completed,
+            SUM(CASE WHEN t.status IN ('pending','in_progress') THEN 1 ELSE 0 END) as active
+           FROM task_lists tl
+           LEFT JOIN tasks t ON t.task_list_id = tl.id ${filters.project_id ? "AND t.project_id = ?" : ""}
+           ${filters.project_id ? "WHERE tl.project_id = ?" : ""}
+           GROUP BY tl.id ORDER BY tl.name`).all(...filters.project_id ? [filters.project_id, filters.project_id] : []);
+          stats.by_task_list = listRows.map((r) => ({
+            id: r.id.slice(0, 8),
+            name: r.name,
+            slug: r.slug,
+            total: r.total,
+            completed: r.completed,
+            active: r.active,
+            completion_rate: r.total > 0 ? Math.round(r.completed / r.total * 100) : 0
+          }));
+        }
         return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
       } catch (e) {
         return { content: [{ type: "text", text: formatError(e) }], isError: true };
@@ -33513,6 +33780,10 @@ program2.command("projects").description("List and manage projects").option("--a
     } else {
       project = createProject({ name, path: projectPath, task_list_id: opts.taskListId });
     }
+    try {
+      const { setMachineLocalPath: setMachineLocalPath2 } = (init_projects(), __toCommonJS(exports_projects));
+      setMachineLocalPath2(project.id, projectPath);
+    } catch {}
     if (globalOpts.json) {
       output(project, true);
     } else {
@@ -33538,6 +33809,106 @@ program2.command("projects").description("List and manage projects").option("--a
     console.log(`${chalk3.dim(p.id.slice(0, 8))} ${chalk3.bold(p.name)} ${chalk3.dim(p.path)}${taskList}${p.description ? ` - ${p.description}` : ""}`);
   }
 });
+program2.command("project-rename <id-or-slug> <new-slug>").description("Rename a project slug. Cascades to matching task lists. Task prefixes (e.g. APP-00001) are unchanged.").option("--name <name>", "Also update the project display name").option("--json", "Output as JSON").action((idOrSlug, newSlug, opts) => {
+  const globalOpts = program2.opts();
+  const useJson = opts.json || globalOpts.json;
+  try {
+    const { renameProject: renameProject2 } = (init_projects(), __toCommonJS(exports_projects));
+    const db = getDatabase();
+    let resolvedId = resolvePartialId(db, "projects", idOrSlug);
+    if (!resolvedId) {
+      const bySlug = db.query("SELECT id FROM projects WHERE task_list_id = ?").get(idOrSlug);
+      resolvedId = bySlug?.id ?? null;
+    }
+    if (!resolvedId) {
+      console.error(chalk3.red(`Project not found: ${idOrSlug}`));
+      process.exit(1);
+    }
+    const result = renameProject2(resolvedId, { name: opts.name, new_slug: newSlug });
+    if (useJson) {
+      output({ project: result.project, task_lists_updated: result.task_lists_updated }, true);
+    } else {
+      console.log(chalk3.green(`Project renamed: ${result.project.name} (slug: ${result.project.task_list_id})`));
+      if (result.task_lists_updated > 0) {
+        console.log(chalk3.dim(`  Updated ${result.task_lists_updated} task list slug(s).`));
+      }
+    }
+  } catch (e) {
+    console.error(chalk3.red(e instanceof Error ? e.message : String(e)));
+    process.exit(1);
+  }
+});
+var projectsPathCmd = program2.command("projects-path").description("Manage machine-local path overrides for projects");
+projectsPathCmd.command("set <project-id> <path>").description("Set the local path for a project on this machine").option("--json", "Output as JSON").action((projectId, projectPath, opts) => {
+  const globalOpts = program2.opts();
+  const useJson = opts.json || globalOpts.json;
+  try {
+    const { setMachineLocalPath: setMachineLocalPath2 } = (init_projects(), __toCommonJS(exports_projects));
+    const db = getDatabase();
+    const resolved = resolvePartialId(db, "projects", projectId);
+    if (!resolved) {
+      console.error(chalk3.red(`Project not found: ${projectId}`));
+      process.exit(1);
+    }
+    const entry = setMachineLocalPath2(resolved, resolve4(projectPath));
+    if (useJson) {
+      output(entry, true);
+    } else {
+      console.log(chalk3.green(`Local path set: ${entry.path} (machine: ${entry.machine_id.slice(0, 8)})`));
+    }
+  } catch (e) {
+    console.error(chalk3.red(e instanceof Error ? e.message : String(e)));
+    process.exit(1);
+  }
+});
+projectsPathCmd.command("list <project-id>").description("List all machine path overrides for a project").option("--json", "Output as JSON").action((projectId, opts) => {
+  const globalOpts = program2.opts();
+  const useJson = opts.json || globalOpts.json;
+  try {
+    const { listMachineLocalPaths: listMachineLocalPaths2 } = (init_projects(), __toCommonJS(exports_projects));
+    const db = getDatabase();
+    const resolved = resolvePartialId(db, "projects", projectId);
+    if (!resolved) {
+      console.error(chalk3.red(`Project not found: ${projectId}`));
+      process.exit(1);
+    }
+    const paths = listMachineLocalPaths2(resolved);
+    if (useJson) {
+      output(paths, true);
+      return;
+    }
+    if (paths.length === 0) {
+      console.log(chalk3.dim("No machine path overrides."));
+      return;
+    }
+    for (const p of paths) {
+      console.log(`${chalk3.dim(p.machine_id.slice(0, 8))} ${p.path}  ${chalk3.dim(p.updated_at)}`);
+    }
+  } catch (e) {
+    console.error(chalk3.red(e instanceof Error ? e.message : String(e)));
+    process.exit(1);
+  }
+});
+projectsPathCmd.command("remove <project-id>").description("Remove the local path override for a project on this machine").option("--machine <id>", "Machine ID to remove override for (default: this machine)").action((projectId, opts) => {
+  try {
+    const { removeMachineLocalPath: removeMachineLocalPath2 } = (init_projects(), __toCommonJS(exports_projects));
+    const db = getDatabase();
+    const resolved = resolvePartialId(db, "projects", projectId);
+    if (!resolved) {
+      console.error(chalk3.red(`Project not found: ${projectId}`));
+      process.exit(1);
+    }
+    const removed = removeMachineLocalPath2(resolved, opts.machine);
+    if (removed) {
+      console.log(chalk3.green("Machine path override removed."));
+    } else {
+      console.log(chalk3.dim("No override found to remove."));
+    }
+  } catch (e) {
+    console.error(chalk3.red(e instanceof Error ? e.message : String(e)));
+    process.exit(1);
+  }
+});
 program2.command("extract <path>").description("Extract TODO/FIXME/HACK/BUG/XXX/NOTE comments from source files and create tasks").option("--dry-run", "Show extracted comments without creating tasks").option("--pattern <tags>", "Comma-separated tags to look for (default: TODO,FIXME,HACK,XXX,BUG,NOTE)").option("-t, --tags <tags>", "Extra comma-separated tags to add to created tasks").option("--assign <agent>", "Assign extracted tasks to an agent").option("--list <id>", "Task list ID").option("--ext <extensions>", "Comma-separated file extensions to scan (e.g. ts,py,go)").action((scanPath, opts) => {
   try {
     const globalOpts = program2.opts();