@hasna/todos 0.10.18 → 0.10.19

package/dist/cli/index.js

@@ -10040,6 +10040,7 @@ __export(exports_task_files, {
   listTaskFiles: () => listTaskFiles,
   listActiveFiles: () => listActiveFiles,
   getTaskFile: () => getTaskFile,
+  getFileHeatMap: () => getFileHeatMap,
   findTasksByFile: () => findTasksByFile,
   detectFileConflicts: () => detectFileConflicts,
   bulkFindTasksByFiles: () => bulkFindTasksByFiles,
@@ -10152,6 +10153,36 @@ function listActiveFiles(db) {
     ORDER BY tf.updated_at DESC
   `).all();
 }
+function getFileHeatMap(opts, db) {
+  const d = db || getDatabase();
+  const limit = opts?.limit ?? 20;
+  const minEdits = opts?.min_edits ?? 1;
+  const rows = d.query(`
+    SELECT
+      tf.path,
+      COUNT(*) AS edit_count,
+      COUNT(DISTINCT COALESCE(tf.agent_id, t.assigned_to)) AS unique_agents,
+      GROUP_CONCAT(DISTINCT COALESCE(tf.agent_id, t.assigned_to)) AS agent_ids,
+      MAX(tf.updated_at) AS last_edited_at,
+      SUM(CASE WHEN t.status = 'in_progress' THEN 1 ELSE 0 END) AS active_task_count
+    FROM task_files tf
+    JOIN tasks t ON tf.task_id = t.id
+    WHERE tf.status != 'removed'
+    ${opts?.project_id ? `AND t.project_id = '${opts.project_id}'` : ""}
+    GROUP BY tf.path
+    HAVING edit_count >= ${minEdits}
+    ORDER BY edit_count DESC, last_edited_at DESC
+    LIMIT ${limit}
+  `).all();
+  return rows.map((r) => ({
+    path: r.path,
+    edit_count: r.edit_count,
+    unique_agents: r.unique_agents,
+    agent_ids: r.agent_ids ? r.agent_ids.split(",").filter(Boolean) : [],
+    last_edited_at: r.last_edited_at,
+    active_task_count: r.active_task_count
+  }));
+}
 function bulkAddTaskFiles(taskId, paths, agentId, db) {
   const d = db || getDatabase();
   const results = [];
@@ -13826,6 +13857,22 @@ ${lines.join(`
       }
     });
   }
+  if (shouldRegisterTool("get_file_heat_map")) {
+    server.tool("get_file_heat_map", "Aggregate file edit frequency across all tasks and agents. Returns hottest files with edit count, unique agents, and last edit. Hot files = high coordination risk, good candidates for extra test coverage.", {
+      limit: exports_external.number().optional().describe("Max files to return (default: 20)"),
+      project_id: exports_external.string().optional().describe("Filter to a specific project"),
+      min_edits: exports_external.number().optional().describe("Minimum edit count to include (default: 1)")
+    }, async ({ limit, project_id, min_edits }) => {
+      try {
+        const { getFileHeatMap: getFileHeatMap2 } = (init_task_files(), __toCommonJS(exports_task_files));
+        const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
+        const results = getFileHeatMap2({ limit, project_id: resolvedProjectId, min_edits });
+        return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
   if (shouldRegisterTool("bulk_find_tasks_by_files")) {
     server.tool("bulk_find_tasks_by_files", "Check multiple file paths at once for task/agent collisions. Returns per-path task list, in-progress count, and conflict flag.", {
       paths: exports_external.array(exports_external.string()).describe("Array of file paths to check")

package/dist/db/task-files.d.ts

@@ -57,5 +57,18 @@ export interface ActiveFileInfo {
     agent_name: string | null;
 }
 export declare function listActiveFiles(db?: Database): ActiveFileInfo[];
+export interface FileHeatMapEntry {
+    path: string;
+    edit_count: number;
+    unique_agents: number;
+    agent_ids: string[];
+    last_edited_at: string;
+    active_task_count: number;
+}
+export declare function getFileHeatMap(opts?: {
+    limit?: number;
+    project_id?: string;
+    min_edits?: number;
+}, db?: Database): FileHeatMapEntry[];
 export declare function bulkAddTaskFiles(taskId: string, paths: string[], agentId?: string, db?: Database): TaskFile[];
 //# sourceMappingURL=task-files.d.ts.map

package/dist/db/task-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-files.d.ts","sourceRoot":"","sources":["../../src/db/task-files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-files.d.ts","sourceRoot":"","sources":["../../src/db/task-files.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.js

@@ -3091,6 +3091,7 @@ __export(exports_task_files, {
   listTaskFiles: () => listTaskFiles,
   listActiveFiles: () => listActiveFiles,
   getTaskFile: () => getTaskFile,
+  getFileHeatMap: () => getFileHeatMap,
   findTasksByFile: () => findTasksByFile,
   detectFileConflicts: () => detectFileConflicts,
   bulkFindTasksByFiles: () => bulkFindTasksByFiles,
@@ -3203,6 +3204,36 @@ function listActiveFiles(db) {
     ORDER BY tf.updated_at DESC
   `).all();
 }
+function getFileHeatMap(opts, db) {
+  const d = db || getDatabase();
+  const limit = opts?.limit ?? 20;
+  const minEdits = opts?.min_edits ?? 1;
+  const rows = d.query(`
+    SELECT
+      tf.path,
+      COUNT(*) AS edit_count,
+      COUNT(DISTINCT COALESCE(tf.agent_id, t.assigned_to)) AS unique_agents,
+      GROUP_CONCAT(DISTINCT COALESCE(tf.agent_id, t.assigned_to)) AS agent_ids,
+      MAX(tf.updated_at) AS last_edited_at,
+      SUM(CASE WHEN t.status = 'in_progress' THEN 1 ELSE 0 END) AS active_task_count
+    FROM task_files tf
+    JOIN tasks t ON tf.task_id = t.id
+    WHERE tf.status != 'removed'
+    ${opts?.project_id ? `AND t.project_id = '${opts.project_id}'` : ""}
+    GROUP BY tf.path
+    HAVING edit_count >= ${minEdits}
+    ORDER BY edit_count DESC, last_edited_at DESC
+    LIMIT ${limit}
+  `).all();
+  return rows.map((r) => ({
+    path: r.path,
+    edit_count: r.edit_count,
+    unique_agents: r.unique_agents,
+    agent_ids: r.agent_ids ? r.agent_ids.split(",").filter(Boolean) : [],
+    last_edited_at: r.last_edited_at,
+    active_task_count: r.active_task_count
+  }));
+}
 function bulkAddTaskFiles(taskId, paths, agentId, db) {
   const d = db || getDatabase();
   const results = [];
@@ -11638,6 +11669,22 @@ ${lines.join(`
     }
   });
 }
+if (shouldRegisterTool("get_file_heat_map")) {
+  server.tool("get_file_heat_map", "Aggregate file edit frequency across all tasks and agents. Returns hottest files with edit count, unique agents, and last edit. Hot files = high coordination risk, good candidates for extra test coverage.", {
+    limit: exports_external.number().optional().describe("Max files to return (default: 20)"),
+    project_id: exports_external.string().optional().describe("Filter to a specific project"),
+    min_edits: exports_external.number().optional().describe("Minimum edit count to include (default: 1)")
+  }, async ({ limit, project_id, min_edits }) => {
+    try {
+      const { getFileHeatMap: getFileHeatMap2 } = (init_task_files(), __toCommonJS(exports_task_files));
+      const resolvedProjectId = project_id ? resolveId(project_id, "projects") : undefined;
+      const results = getFileHeatMap2({ limit, project_id: resolvedProjectId, min_edits });
+      return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("bulk_find_tasks_by_files")) {
   server.tool("bulk_find_tasks_by_files", "Check multiple file paths at once for task/agent collisions. Returns per-path task list, in-progress count, and conflict flag.", {
     paths: exports_external.array(exports_external.string()).describe("Array of file paths to check")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.10.18",
+  "version": "0.10.19",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",