@hasna/todos 0.11.41 → 0.11.42

package/dist/index.js

@@ -979,6 +979,19 @@ var init_migrations = __esm(() => {
   );
   CREATE INDEX IF NOT EXISTS idx_handoff_acks_agent ON handoff_acknowledgements(agent_id, acknowledged_at);
   INSERT OR IGNORE INTO _migrations (id) VALUES (54);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS saved_search_views (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    description TEXT,
+    scope TEXT NOT NULL DEFAULT 'tasks' CHECK(scope IN ('all', 'tasks', 'projects', 'plans', 'runs', 'comments')),
+    filters TEXT NOT NULL DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_saved_search_views_scope ON saved_search_views(scope);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (55);
   `
   ];
 });
@@ -1155,6 +1168,17 @@ function ensureSchema(db) {
       PRIMARY KEY (handoff_id, agent_id)
     )`);
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_handoff_acks_agent ON handoff_acknowledgements(agent_id, acknowledged_at)");
+  ensureTable("saved_search_views", `
+    CREATE TABLE saved_search_views (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      description TEXT,
+      scope TEXT NOT NULL DEFAULT 'tasks' CHECK(scope IN ('all', 'tasks', 'projects', 'plans', 'runs', 'comments')),
+      filters TEXT NOT NULL DEFAULT '{}',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )`);
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_saved_search_views_scope ON saved_search_views(scope)");
   ensureTable("task_relationships", `
     CREATE TABLE task_relationships (
       id TEXT PRIMARY KEY,
@@ -2713,6 +2737,39 @@ var TODOS_JSON_CONTRACTS = [
       created: field("object", "Flags and source types created by this bootstrap run.")
     },
     optional: {}
+  }),
+  contract({
+    id: "saved_search_view",
+    name: "Saved Search View",
+    description: "Local saved search view for repeatable task, project, plan, run, comment, or cross-entity searches.",
+    surfaces: ["cli", "mcp", "sdk"],
+    stability: "stable",
+    required: {
+      id: idField,
+      name: field("string", "Human-readable unique view name."),
+      description: field(["string", "null"], "Optional view description.", true),
+      scope: field("string", "Search scope: all, tasks, projects, plans, runs, or comments."),
+      filters: field("object", "Saved local filter object."),
+      created_at: isoDateField,
+      updated_at: isoDateField
+    },
+    optional: {}
+  }),
+  contract({
+    id: "saved_search_run_result",
+    name: "Saved Search Run Result",
+    description: "Stable JSON envelope returned when running a saved search view or cross-entity search.",
+    surfaces: ["cli", "mcp", "sdk"],
+    stability: "stable",
+    required: {
+      scope: field("string", "Search scope used for the run."),
+      filters: field("object", "Applied local filters."),
+      count: field("integer", "Number of returned result records."),
+      results: field("array", "Result records with entity_type and entity.")
+    },
+    optional: {
+      view: field("object", "Saved view metadata when the run came from a named view.")
+    }
   })
 ];
 function expectedTypes(contract2) {
@@ -6247,7 +6304,8 @@ var dataKeys = [
   "task_files",
   "task_commits",
   "task_git_refs",
-  "task_verifications"
+  "task_verifications",
+  "saved_views"
 ];
 var insertColumns = {
   projects: ["id", "name", "path", "description", "task_list_id", "task_prefix", "task_counter", "created_at", "updated_at", "machine_id", "synced_at"],
@@ -6319,7 +6377,8 @@ var insertColumns = {
   task_files: ["id", "task_id", "path", "status", "agent_id", "note", "created_at", "updated_at", "machine_id"],
   task_commits: ["id", "task_id", "sha", "message", "author", "files_changed", "committed_at", "created_at"],
   task_git_refs: ["id", "task_id", "ref_type", "name", "url", "provider", "metadata", "created_at", "updated_at"],
-  task_verifications: ["id", "task_id", "command", "status", "output_summary", "artifact_path", "agent_id", "run_at", "created_at"]
+  task_verifications: ["id", "task_id", "command", "status", "output_summary", "artifact_path", "agent_id", "run_at", "created_at"],
+  saved_views: ["id", "name", "description", "scope", "filters", "created_at", "updated_at"]
 };
 var tableByKey = {
   projects: "projects",
@@ -6335,9 +6394,10 @@ var tableByKey = {
   task_files: "task_files",
   task_commits: "task_commits",
   task_git_refs: "task_git_refs",
-  task_verifications: "task_verifications"
+  task_verifications: "task_verifications",
+  saved_views: "saved_search_views"
 };
-var jsonColumns = new Set(["metadata", "tags", "data", "files_changed"]);
+var jsonColumns = new Set(["metadata", "tags", "data", "files_changed", "filters"]);
 function packageSource(version) {
   return {
     packageName: "@hasna/todos",
@@ -6410,6 +6470,9 @@ function rowToRunEvent(row) {
 function rowToCommit(row) {
   return { ...row, files_changed: row.files_changed ? parseJsonArray(row.files_changed) : null };
 }
+function rowToSavedView(row) {
+  return { ...row, filters: parseJsonObject(row.filters) };
+}
 function bridgeStats(data) {
   return Object.fromEntries(dataKeys.map((key) => [key, data[key].length]));
 }
@@ -6433,7 +6496,8 @@ function createLocalBridgeBundle(options = {}, db) {
     task_files: queryByTaskIds(d, "SELECT * FROM task_files WHERE task_id IN (__TASK_IDS__) ORDER BY path, id", taskIds),
     task_commits: queryByTaskIds(d, "SELECT * FROM task_commits WHERE task_id IN (__TASK_IDS__) ORDER BY created_at, id", taskIds).map(rowToCommit),
     task_git_refs: queryByTaskIds(d, "SELECT * FROM task_git_refs WHERE task_id IN (__TASK_IDS__) ORDER BY created_at, id", taskIds).map(rowWithMetadata),
-    task_verifications: queryByTaskIds(d, "SELECT * FROM task_verifications WHERE task_id IN (__TASK_IDS__) ORDER BY run_at, id", taskIds)
+    task_verifications: queryByTaskIds(d, "SELECT * FROM task_verifications WHERE task_id IN (__TASK_IDS__) ORDER BY run_at, id", taskIds),
+    saved_views: (options.project_id ? d.query("SELECT * FROM saved_search_views WHERE json_extract(filters, '$.project_id') = ? ORDER BY name").all(options.project_id) : d.query("SELECT * FROM saved_search_views ORDER BY name").all()).map(rowToSavedView)
   };
   const artifactContents = data.run_artifacts.map((artifact) => exportStoredArtifactContent({
     id: artifact.id,
@@ -6472,6 +6536,8 @@ function validateLocalBridgeBundle(value) {
     issues.push("data must be an object");
   } else {
     for (const key of dataKeys) {
+      if (key === "saved_views" && data[key] === undefined)
+        continue;
       if (!Array.isArray(data[key]))
         issues.push(`data.${key} must be an array`);
     }
@@ -6644,7 +6710,8 @@ function importLocalBridgeBundle(bundle, options = {}, db) {
   const conflictStrategy = options.conflictStrategy ?? "skip";
   const data = {
     ...bundle.data,
-    tasks: sortedTasks(bundle.data.tasks)
+    tasks: sortedTasks(bundle.data.tasks),
+    saved_views: bundle.data.saved_views ?? []
   };
   for (const key of dataKeys) {
     for (const row of data[key]) {
@@ -7255,6 +7322,10 @@ var MCP_TOOL_GROUPS = {
     "request_task_review",
     "reschedule_task",
     "search_tasks",
+    "save_search_view",
+    "list_search_views",
+    "run_search_view",
+    "delete_search_view",
     "standup",
     "set_task_contract",
     "task_context",
@@ -8214,6 +8285,10 @@ var TODOS_CLI_MCP_PARITY = [
     domain: "search",
     cliCommands: [
       "todos search",
+      "todos views save",
+      "todos views list",
+      "todos views run",
+      "todos views delete",
       "todos status",
       "todos recap",
       "todos standup",
@@ -8225,6 +8300,10 @@ var TODOS_CLI_MCP_PARITY = [
     ],
     mcpTools: [
       "search_tasks",
+      "save_search_view",
+      "list_search_views",
+      "run_search_view",
+      "delete_search_view",
       "get_status",
       "standup",
       "get_task_stats",
@@ -8233,7 +8312,7 @@ var TODOS_CLI_MCP_PARITY = [
       "get_task_graph",
       "get_recent_activity"
     ],
-    jsonContracts: ["task", "status_summary", "audit_history", "structured_error", "api_error"],
+    jsonContracts: ["task", "saved_search_view", "saved_search_run_result", "status_summary", "audit_history", "structured_error", "api_error"],
     errorContracts: ["structured_error", "api_error"],
     status: "matched",
     example: {
@@ -11359,6 +11438,426 @@ function searchTasks(options, projectId, taskListId, db) {
   const rows = d.query(sql).all(...params);
   return rows.map(rowToTask4);
 }
+// src/lib/saved-search-views.ts
+init_database();
+
+// src/lib/local-fields.ts
+init_database();
+init_types();
+var LOCAL_FIELDS_KEY = "local_fields";
+function normalizeList(values) {
+  return [...new Set((values || []).map((value) => value.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b));
+}
+function metadataFields(task) {
+  const value = task.metadata[LOCAL_FIELDS_KEY];
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function sameCustomValue(actual, expected) {
+  return JSON.stringify(actual) === JSON.stringify(expected);
+}
+function hasOwnField(fields, key) {
+  return Object.prototype.hasOwnProperty.call(fields, key);
+}
+function getTaskLocalFields(taskId, db) {
+  const d = db || getDatabase();
+  const task = getTask(taskId, d);
+  if (!task)
+    throw new TaskNotFoundError(taskId);
+  const fields = metadataFields(task);
+  return {
+    labels: normalizeList(fields.labels),
+    priority: task.priority,
+    severity: typeof fields.severity === "string" ? fields.severity : null,
+    owner: hasOwnField(fields, "owner") ? typeof fields.owner === "string" ? fields.owner : null : task.assigned_to,
+    area: typeof fields.area === "string" ? fields.area : null,
+    custom: fields.custom && typeof fields.custom === "object" && !Array.isArray(fields.custom) ? fields.custom : {}
+  };
+}
+function setTaskLocalFields(taskId, input, db) {
+  const d = db || getDatabase();
+  const task = getTask(taskId, d);
+  if (!task)
+    throw new TaskNotFoundError(taskId);
+  const currentFields = getTaskLocalFields(taskId, d);
+  const labels = input.labels !== undefined ? normalizeList(input.labels) : currentFields.labels;
+  const custom = input.custom !== undefined ? redactValue(input.merge_custom === false ? input.custom : { ...currentFields.custom, ...input.custom }) : currentFields.custom;
+  const nextFields = {
+    labels,
+    priority: input.priority || task.priority,
+    severity: input.severity !== undefined ? input.severity : currentFields.severity,
+    owner: input.owner !== undefined ? input.owner : currentFields.owner,
+    area: input.area !== undefined ? input.area : currentFields.area,
+    custom
+  };
+  const nextMetadata = {
+    ...task.metadata,
+    [LOCAL_FIELDS_KEY]: nextFields
+  };
+  const previousLabels = new Set(currentFields.labels);
+  const nextTags = normalizeList([...task.tags.filter((tag) => !previousLabels.has(tag)), ...labels]);
+  const updates = {
+    version: task.version,
+    priority: input.priority,
+    tags: nextTags,
+    metadata: nextMetadata
+  };
+  if (input.owner !== undefined)
+    updates.assigned_to = nextFields.owner;
+  return updateTask(taskId, updates, d);
+}
+function queryTasksByLocalFields(query, db) {
+  const d = db || getDatabase();
+  const tasks = listTasks({
+    priority: query.priority,
+    tags: query.labels,
+    limit: 1e4
+  }, d);
+  const matches = tasks.filter((task) => {
+    const fields = getTaskLocalFields(task.id, d);
+    if (query.labels && !query.labels.every((label) => fields.labels.includes(label)))
+      return false;
+    if (query.severity && fields.severity !== query.severity)
+      return false;
+    if (query.owner && fields.owner !== query.owner)
+      return false;
+    if (query.area && fields.area !== query.area)
+      return false;
+    if (query.custom) {
+      for (const [key, expected] of Object.entries(query.custom)) {
+        if (!sameCustomValue(fields.custom[key], expected))
+          return false;
+      }
+    }
+    return true;
+  });
+  return matches.slice(0, query.limit || 100);
+}
+
+// src/lib/saved-search-views.ts
+function parseFilters(value) {
+  if (!value)
+    return {};
+  try {
+    const parsed = JSON.parse(value);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function rowToSavedSearchView(row) {
+  return {
+    ...row,
+    scope: normalizeScope(row.scope),
+    filters: parseFilters(row.filters)
+  };
+}
+function normalizeScope(scope) {
+  if (scope === "all" || scope === "tasks" || scope === "projects" || scope === "plans" || scope === "runs" || scope === "comments") {
+    return scope;
+  }
+  return "tasks";
+}
+function normalizeName(name) {
+  const normalized = name.trim();
+  if (!normalized)
+    throw new Error("Saved view name is required");
+  return normalized;
+}
+function normalizeLimit(limit) {
+  if (!Number.isFinite(limit) || !limit || limit <= 0)
+    return 100;
+  return Math.min(Math.trunc(limit), 1000);
+}
+function valuesList(value) {
+  if (value === undefined)
+    return [];
+  return (Array.isArray(value) ? value : [value]).map((item) => item.trim()).filter(Boolean);
+}
+function addStatusFilter(sql, params, column, value) {
+  const values = valuesList(value);
+  if (values.length === 0)
+    return sql;
+  params.push(...values);
+  return `${sql} AND ${column} IN (${values.map(() => "?").join(",")})`;
+}
+function addDateFilter(sql, params, column, value) {
+  if (!value)
+    return sql;
+  params.push(value);
+  return `${sql} AND ${column} > ?`;
+}
+function likePattern(query) {
+  const trimmed = query?.trim();
+  if (!trimmed || trimmed === "*")
+    return null;
+  return `%${trimmed}%`;
+}
+function parseJsonObject2(value) {
+  if (!value)
+    return {};
+  if (typeof value === "object" && !Array.isArray(value))
+    return value;
+  if (typeof value !== "string")
+    return {};
+  try {
+    const parsed = JSON.parse(value);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function rowToTaskRun(row) {
+  return { ...row, metadata: parseJsonObject2(row.metadata) };
+}
+function taskMatchesSavedFilters(task, filters, db) {
+  if (filters.plan_id && task.plan_id !== filters.plan_id)
+    return false;
+  if (filters.tags && !filters.tags.every((tag) => task.tags.includes(tag)))
+    return false;
+  if (filters.depends_on) {
+    const row = db.query("SELECT 1 FROM task_dependencies WHERE task_id = ? AND depends_on = ?").get(task.id, filters.depends_on);
+    if (!row)
+      return false;
+  }
+  if (filters.blocks) {
+    const row = db.query("SELECT 1 FROM task_dependencies WHERE task_id = ? AND depends_on = ?").get(filters.blocks, task.id);
+    if (!row)
+      return false;
+  }
+  return true;
+}
+function searchTaskEntities(filters, db) {
+  let tasks;
+  if (filters.local_fields) {
+    const localMatches = queryTasksByLocalFields({ ...filters.local_fields, limit: 1e4 }, db);
+    const allowedIds = new Set(localMatches.map((task) => task.id));
+    tasks = searchTasks({
+      query: filters.query,
+      project_id: filters.project_id,
+      task_list_id: filters.task_list_id,
+      status: filters.status,
+      priority: filters.priority,
+      assigned_to: filters.assigned_to,
+      agent_id: filters.agent_id,
+      created_after: filters.created_after,
+      updated_after: filters.updated_after,
+      has_dependencies: filters.has_dependencies,
+      is_blocked: filters.is_blocked
+    }, undefined, undefined, db).filter((task) => allowedIds.has(task.id));
+  } else {
+    tasks = searchTasks({
+      query: filters.query,
+      project_id: filters.project_id,
+      task_list_id: filters.task_list_id,
+      status: filters.status,
+      priority: filters.priority,
+      assigned_to: filters.assigned_to,
+      agent_id: filters.agent_id,
+      created_after: filters.created_after,
+      updated_after: filters.updated_after,
+      has_dependencies: filters.has_dependencies,
+      is_blocked: filters.is_blocked
+    }, undefined, undefined, db);
+  }
+  return tasks.filter((task) => taskMatchesSavedFilters(task, filters, db)).slice(0, normalizeLimit(filters.limit));
+}
+function searchProjects(filters, db) {
+  const params = [];
+  let sql = "SELECT * FROM projects WHERE 1=1";
+  if (filters.project_id) {
+    sql += " AND id = ?";
+    params.push(filters.project_id);
+  }
+  const pattern = likePattern(filters.query);
+  if (pattern) {
+    sql += " AND (name LIKE ? OR description LIKE ? OR path LIKE ?)";
+    params.push(pattern, pattern, pattern);
+  }
+  sql = addDateFilter(sql, params, "created_at", filters.created_after);
+  sql = addDateFilter(sql, params, "updated_at", filters.updated_after);
+  sql += " ORDER BY name LIMIT ?";
+  params.push(normalizeLimit(filters.limit));
+  return db.query(sql).all(...params);
+}
+function searchPlans(filters, db) {
+  const params = [];
+  let sql = "SELECT * FROM plans WHERE 1=1";
+  if (filters.project_id) {
+    sql += " AND project_id = ?";
+    params.push(filters.project_id);
+  }
+  if (filters.task_list_id) {
+    sql += " AND task_list_id = ?";
+    params.push(filters.task_list_id);
+  }
+  if (filters.agent_id) {
+    sql += " AND agent_id = ?";
+    params.push(filters.agent_id);
+  }
+  sql = addStatusFilter(sql, params, "status", filters.status);
+  const pattern = likePattern(filters.query);
+  if (pattern) {
+    sql += " AND (name LIKE ? OR description LIKE ?)";
+    params.push(pattern, pattern);
+  }
+  sql = addDateFilter(sql, params, "created_at", filters.created_after);
+  sql = addDateFilter(sql, params, "updated_at", filters.updated_after);
+  sql += " ORDER BY updated_at DESC, created_at DESC LIMIT ?";
+  params.push(normalizeLimit(filters.limit));
+  return db.query(sql).all(...params);
+}
+function searchRuns(filters, db) {
+  const params = [];
+  let sql = `SELECT r.* FROM task_runs r
+    JOIN tasks t ON t.id = r.task_id
+    WHERE 1=1`;
+  if (filters.project_id) {
+    sql += " AND t.project_id = ?";
+    params.push(filters.project_id);
+  }
+  if (filters.task_list_id) {
+    sql += " AND t.task_list_id = ?";
+    params.push(filters.task_list_id);
+  }
+  if (filters.plan_id) {
+    sql += " AND t.plan_id = ?";
+    params.push(filters.plan_id);
+  }
+  if (filters.task_id) {
+    sql += " AND r.task_id = ?";
+    params.push(filters.task_id);
+  }
+  if (filters.agent_id) {
+    sql += " AND r.agent_id = ?";
+    params.push(filters.agent_id);
+  }
+  sql = addStatusFilter(sql, params, "r.status", filters.status);
+  const pattern = likePattern(filters.query);
+  if (pattern) {
+    sql += " AND (r.title LIKE ? OR r.summary LIKE ? OR t.title LIKE ?)";
+    params.push(pattern, pattern, pattern);
+  }
+  sql = addDateFilter(sql, params, "r.created_at", filters.created_after);
+  sql = addDateFilter(sql, params, "r.updated_at", filters.updated_after);
+  sql += " ORDER BY r.started_at DESC, r.created_at DESC LIMIT ?";
+  params.push(normalizeLimit(filters.limit));
+  return db.query(sql).all(...params).map(rowToTaskRun);
+}
+function searchComments(filters, db) {
+  const params = [];
+  let sql = `SELECT c.* FROM task_comments c
+    JOIN tasks t ON t.id = c.task_id
+    WHERE 1=1`;
+  if (filters.project_id) {
+    sql += " AND t.project_id = ?";
+    params.push(filters.project_id);
+  }
+  if (filters.task_list_id) {
+    sql += " AND t.task_list_id = ?";
+    params.push(filters.task_list_id);
+  }
+  if (filters.plan_id) {
+    sql += " AND t.plan_id = ?";
+    params.push(filters.plan_id);
+  }
+  if (filters.task_id) {
+    sql += " AND c.task_id = ?";
+    params.push(filters.task_id);
+  }
+  if (filters.agent_id) {
+    sql += " AND c.agent_id = ?";
+    params.push(filters.agent_id);
+  }
+  const pattern = likePattern(filters.query);
+  if (pattern) {
+    sql += " AND (c.content LIKE ? OR t.title LIKE ?)";
+    params.push(pattern, pattern);
+  }
+  sql = addDateFilter(sql, params, "c.created_at", filters.created_after);
+  sql += " ORDER BY c.created_at DESC, c.id LIMIT ?";
+  params.push(normalizeLimit(filters.limit));
+  return db.query(sql).all(...params);
+}
+function toResults(entityType, rows) {
+  return rows.map((entity) => ({ entity_type: entityType, entity }));
+}
+function runSavedSearch(filters = {}, scope = "tasks", db) {
+  const d = db || getDatabase();
+  const normalizedScope = normalizeScope(scope);
+  const scopes = normalizedScope === "all" ? ["tasks", "projects", "plans", "runs", "comments"] : [normalizedScope];
+  const results = [];
+  for (const item of scopes) {
+    if (item === "tasks")
+      results.push(...toResults("tasks", searchTaskEntities(filters, d)));
+    if (item === "projects")
+      results.push(...toResults("projects", searchProjects(filters, d)));
+    if (item === "plans")
+      results.push(...toResults("plans", searchPlans(filters, d)));
+    if (item === "runs")
+      results.push(...toResults("runs", searchRuns(filters, d)));
+    if (item === "comments")
+      results.push(...toResults("comments", searchComments(filters, d)));
+  }
+  return {
+    scope: normalizedScope,
+    filters,
+    count: results.length,
+    results: results.slice(0, normalizeLimit(filters.limit))
+  };
+}
+function saveSearchView(input, db) {
+  const d = db || getDatabase();
+  const name = normalizeName(input.name);
+  const timestamp = now();
+  const existing = getSearchView(name, d);
+  if (existing) {
+    d.run(`UPDATE saved_search_views
+       SET description = ?, scope = ?, filters = ?, updated_at = ?
+       WHERE id = ?`, [
+      input.description ?? existing.description,
+      normalizeScope(input.scope ?? existing.scope),
+      JSON.stringify(input.filters ?? existing.filters),
+      timestamp,
+      existing.id
+    ]);
+    return getSearchView(existing.id, d);
+  }
+  const id = uuid();
+  d.run(`INSERT INTO saved_search_views (id, name, description, scope, filters, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    name,
+    input.description ?? null,
+    normalizeScope(input.scope),
+    JSON.stringify(input.filters ?? {}),
+    timestamp,
+    timestamp
+  ]);
+  return getSearchView(id, d);
+}
+function getSearchView(idOrName, db) {
+  const d = db || getDatabase();
+  const row = d.query("SELECT * FROM saved_search_views WHERE id = ? OR name = ?").get(idOrName, idOrName);
+  return row ? rowToSavedSearchView(row) : null;
+}
+function listSearchViews(scope, db) {
+  const d = db || getDatabase();
+  const normalizedScope = scope ? normalizeScope(scope) : null;
+  const rows = normalizedScope ? d.query("SELECT * FROM saved_search_views WHERE scope = ? ORDER BY name").all(normalizedScope) : d.query("SELECT * FROM saved_search_views ORDER BY name").all();
+  return rows.map(rowToSavedSearchView);
+}
+function deleteSearchView(idOrName, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM saved_search_views WHERE id = ? OR name = ?", [idOrName, idOrName]);
+  return result.changes > 0;
+}
+function runSearchView(idOrName, db) {
+  const d = db || getDatabase();
+  const view = getSearchView(idOrName, d);
+  if (!view)
+    throw new Error(`Saved search view not found: ${idOrName}`);
+  return { ...runSavedSearch(view.filters, view.scope, d), view };
+}
 // src/lib/claude-tasks.ts
 import { existsSync as existsSync8, readFileSync as readFileSync6, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "fs";
 import { join as join7 } from "path";
@@ -13449,97 +13948,6 @@ function assertApprovalGate(taskId, gateName, db) {
     throw new Error(result.reasons.join("; "));
   return result.gate;
 }
-// src/lib/local-fields.ts
-init_database();
-init_types();
-var LOCAL_FIELDS_KEY = "local_fields";
-function normalizeList(values) {
-  return [...new Set((values || []).map((value) => value.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b));
-}
-function metadataFields(task) {
-  const value = task.metadata[LOCAL_FIELDS_KEY];
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-function sameCustomValue(actual, expected) {
-  return JSON.stringify(actual) === JSON.stringify(expected);
-}
-function hasOwnField(fields, key) {
-  return Object.prototype.hasOwnProperty.call(fields, key);
-}
-function getTaskLocalFields(taskId, db) {
-  const d = db || getDatabase();
-  const task = getTask(taskId, d);
-  if (!task)
-    throw new TaskNotFoundError(taskId);
-  const fields = metadataFields(task);
-  return {
-    labels: normalizeList(fields.labels),
-    priority: task.priority,
-    severity: typeof fields.severity === "string" ? fields.severity : null,
-    owner: hasOwnField(fields, "owner") ? typeof fields.owner === "string" ? fields.owner : null : task.assigned_to,
-    area: typeof fields.area === "string" ? fields.area : null,
-    custom: fields.custom && typeof fields.custom === "object" && !Array.isArray(fields.custom) ? fields.custom : {}
-  };
-}
-function setTaskLocalFields(taskId, input, db) {
-  const d = db || getDatabase();
-  const task = getTask(taskId, d);
-  if (!task)
-    throw new TaskNotFoundError(taskId);
-  const currentFields = getTaskLocalFields(taskId, d);
-  const labels = input.labels !== undefined ? normalizeList(input.labels) : currentFields.labels;
-  const custom = input.custom !== undefined ? redactValue(input.merge_custom === false ? input.custom : { ...currentFields.custom, ...input.custom }) : currentFields.custom;
-  const nextFields = {
-    labels,
-    priority: input.priority || task.priority,
-    severity: input.severity !== undefined ? input.severity : currentFields.severity,
-    owner: input.owner !== undefined ? input.owner : currentFields.owner,
-    area: input.area !== undefined ? input.area : currentFields.area,
-    custom
-  };
-  const nextMetadata = {
-    ...task.metadata,
-    [LOCAL_FIELDS_KEY]: nextFields
-  };
-  const previousLabels = new Set(currentFields.labels);
-  const nextTags = normalizeList([...task.tags.filter((tag) => !previousLabels.has(tag)), ...labels]);
-  const updates = {
-    version: task.version,
-    priority: input.priority,
-    tags: nextTags,
-    metadata: nextMetadata
-  };
-  if (input.owner !== undefined)
-    updates.assigned_to = nextFields.owner;
-  return updateTask(taskId, updates, d);
-}
-function queryTasksByLocalFields(query, db) {
-  const d = db || getDatabase();
-  const tasks = listTasks({
-    priority: query.priority,
-    tags: query.labels,
-    limit: 1e4
-  }, d);
-  const matches = tasks.filter((task) => {
-    const fields = getTaskLocalFields(task.id, d);
-    if (query.labels && !query.labels.every((label) => fields.labels.includes(label)))
-      return false;
-    if (query.severity && fields.severity !== query.severity)
-      return false;
-    if (query.owner && fields.owner !== query.owner)
-      return false;
-    if (query.area && fields.area !== query.area)
-      return false;
-    if (query.custom) {
-      for (const [key, expected] of Object.entries(query.custom)) {
-        if (!sameCustomValue(fields.custom[key], expected))
-          return false;
-      }
-    }
-    return true;
-  });
-  return matches.slice(0, query.limit || 100);
-}
 // src/lib/task-dedupe.ts
 init_database();
 var DEFAULT_THRESHOLD = 0.74;
@@ -13978,7 +14386,7 @@ var DEFAULT_CAPABILITIES = {
   browser: ["browser", "screenshot", "artifact", "evidence"],
   script: ["script", "command", "retry", "evidence"]
 };
-function normalizeName(name) {
+function normalizeName2(name) {
   const normalized = name.trim().toLowerCase();
   if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(normalized)) {
     throw new Error("verification provider name must use lowercase letters, numbers, dashes, or underscores");
@@ -13997,10 +14405,10 @@ function timeoutMs(value) {
   return Math.max(1, Math.min(24 * 60 * 60000, Math.floor(value)));
 }
 function getProvider(name) {
-  return loadConfig().verification_providers?.[normalizeName(name)] || null;
+  return loadConfig().verification_providers?.[normalizeName2(name)] || null;
 }
 function upsertVerificationProvider(input) {
-  const name = normalizeName(input.name);
+  const name = normalizeName2(input.name);
   const config = loadConfig();
   const existing = config.verification_providers?.[name];
   const timestamp = new Date().toISOString();
@@ -14030,7 +14438,7 @@ function listVerificationProviders() {
   return Object.values(loadConfig().verification_providers || {}).sort((a, b) => a.name.localeCompare(b.name));
 }
 function removeVerificationProvider(name) {
-  const normalized = normalizeName(name);
+  const normalized = normalizeName2(name);
   const config = loadConfig();
   if (!config.verification_providers?.[normalized])
     return false;
@@ -14879,7 +15287,8 @@ function emptyCounts2() {
     task_files: 0,
     task_commits: 0,
     task_git_refs: 0,
-    task_verifications: 0
+    task_verifications: 0,
+    saved_views: 0
   };
 }
 function bridgeToMarkdownPayload(bundle) {
@@ -15963,8 +16372,11 @@ export {
   searchTasks,
   scoreTask,
   saveSnapshot,
+  saveSearchView,
   runVerificationProvider,
   runTodosDoctor,
+  runSearchView,
+  runSavedSearch,
   runNextAgentDispatch,
   runDueDispatches,
   revokeApiKey,
@@ -16009,6 +16421,7 @@ export {
   parseRecurrenceRule,
   parseGitHubUrl,
   now,
+  normalizeScope,
   normalizeGeneratedAgentNames,
   normalizeApiUrl,
   nextTaskShortId,
@@ -16033,6 +16446,7 @@ export {
   listTaskFiles,
   listSnapshots,
   listSessions,
+  listSearchViews,
   listRunnerSandboxProfiles,
   listProjects,
   listProjectSources,
@@ -16097,6 +16511,7 @@ export {
   getStatus,
   getStaleTasks,
   getSession,
+  getSearchView,
   getRunnerSandboxProfile,
   getReviewQueue,
   getRelated,
@@ -16193,6 +16608,7 @@ export {
   deleteTaskList,
   deleteTask,
   deleteSession,
+  deleteSearchView,
   deleteProject,
   deletePlan,
   deleteOrg,