@zentodo/cli 0.1.5 → 0.1.7

package/dist/skills/zentodo/references/tools.json

@@ -927,7 +927,7 @@
     "name": "zentodo.task.completed-today",
     "domain": "task",
     "action": "completed-today",
-    "description": "调用 /taskController/getCompletedTasks。过滤条件:syncFlag != D、taskState = 0、taskCompletedTime = today。",
+    "description": "调用 /taskController/getCompletedTasks。服务端根据 usrKey + date 直接过滤,不用在客户端再做一次。",
     "http": {
       "method": "POST",
       "path": "/taskController/getCompletedTasks"
@@ -942,41 +942,11 @@
     },
     "params": [
       {
-        "name": "is_templete",
-        "backendName": "isTemplete",
-        "type": "boolean",
-        "default": false,
-        "transform": "booleanToString",
-        "description": "排除模板。"
-      },
-      {
-        "name": "sync_flag",
-        "backendName": "syncFlag",
-        "type": "string",
-        "default": "!=D",
-        "description": "同步标记过滤。"
-      },
-      {
-        "name": "task_state",
-        "backendName": "taskState",
-        "type": "string",
-        "default": "=0",
-        "description": "已完成。"
-      },
-      {
-        "name": "task_completed_time",
-        "backendName": "taskCompletedTime",
-        "type": "string",
-        "default": "=today",
-        "description": "完成时间=今日。"
-      },
-      {
-        "name": "task_create_time_not_null",
-        "backendName": "taskCreateTimeNotNull",
-        "type": "boolean",
-        "default": true,
-        "transform": "booleanToString",
-        "description": "要求 createTime 非空。"
+        "name": "date",
+        "backendName": "date",
+        "type": "date",
+        "transform": "isoToBackendDate",
+        "description": "指定日期(ISO,可选)。不传则使用服务器今天。"
       }
     ],
     "output": {
@@ -987,7 +957,7 @@
     "name": "zentodo.task.mit-list",
     "domain": "task",
     "action": "mit-list",
-    "description": "调用 /taskController/getMitTasks。过滤条件与 PC 端 loadMitHeaderDatas() 一致。",
+    "description": "调用 /taskController/getMitTasks。服务端按 usrKey 过滤 isMIT=true + 未完成 + taskCreateTime<=今天。",
     "http": {
       "method": "POST",
       "path": "/taskController/getMitTasks"
@@ -1000,53 +970,7 @@
       "idempotent": true,
       "destructive": false
     },
-    "params": [
-      {
-        "name": "sync_flag",
-        "backendName": "syncFlag",
-        "type": "string",
-        "default": "!=D",
-        "description": "同步标记过滤。"
-      },
-      {
-        "name": "is_templete",
-        "backendName": "isTemplete",
-        "type": "boolean",
-        "default": false,
-        "transform": "booleanToString",
-        "description": "排除模板。"
-      },
-      {
-        "name": "task_state",
-        "backendName": "taskState",
-        "type": "string",
-        "default": "!=0",
-        "description": "未完成。"
-      },
-      {
-        "name": "task_create_time_not_null",
-        "backendName": "taskCreateTimeNotNull",
-        "type": "boolean",
-        "default": true,
-        "transform": "booleanToString",
-        "description": "要求 createTime 非空。"
-      },
-      {
-        "name": "task_create_time",
-        "backendName": "taskCreateTime",
-        "type": "string",
-        "default": "<=today",
-        "description": "到今日为止。"
-      },
-      {
-        "name": "is_mit",
-        "backendName": "isMIT",
-        "type": "boolean",
-        "default": true,
-        "transform": "booleanToString",
-        "description": "MIT 过滤。"
-      }
-    ],
+    "params": [],
     "output": {
       "shape": "array"
     }
@@ -1055,7 +979,7 @@
     "name": "zentodo.task.calendar",
     "domain": "task",
     "action": "calendar",
-    "description": "调用 /taskController/getCalendarTaskByDate。过滤与安卓端一致(syncFlag!=D、taskState!=0、isTemplete=false、taskStartItem!=FT、taskStartItem!=垃圾箱)。",
+    "description": "调用 /taskController/getCalendarTaskByDate。服务端已内置过滤(未完成 + 非模板 + 非垃圾箱)。",
     "http": {
       "method": "POST",
       "path": "/taskController/getCalendarTaskByDate"
@@ -1084,46 +1008,128 @@
         "transform": "isoToBackendDate",
         "required": true,
         "description": "范围截止(ISO 日期)。"
-      },
-      {
-        "name": "sync_flag",
-        "backendName": "syncFlag",
-        "type": "string",
-        "default": "!=D",
-        "description": "同步标记过滤。"
-      },
+      }
+    ],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.overdue",
+    "domain": "task",
+    "action": "overdue",
+    "description": "调用 /taskController/getOverdueTasks。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/getOverdueTasks"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.inbox",
+    "domain": "task",
+    "action": "inbox",
+    "description": "调用 /taskController/getInboxTasks。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/getInboxTasks"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.search",
+    "domain": "task",
+    "action": "search",
+    "description": "调用 /taskController/searchTasks。服务端按 LIKE 匹配并按 latestVersion 倒序返回。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/searchTasks"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
       {
-        "name": "task_state",
-        "backendName": "taskState",
+        "name": "keyword",
+        "backendName": "keyword",
         "type": "string",
-        "default": "!=0",
-        "description": "未完成。"
+        "required": true,
+        "description": "关键字。"
       },
       {
-        "name": "is_templete",
-        "backendName": "isTemplete",
-        "type": "boolean",
-        "default": false,
-        "transform": "booleanToString",
-        "description": "排除模板。"
-      },
+        "name": "limit",
+        "backendName": "limit",
+        "type": "integer",
+        "default": 50,
+        "description": "最多返回多少条(默认 50,最大 500)。"
+      }
+    ],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.stats",
+    "domain": "task",
+    "action": "stats",
+    "description": "调用 /taskController/getTaskStats。返回 { created, completed, completion_rate, by_project }。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/getTaskStats"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
       {
-        "name": "task_start_item_not_1",
-        "backendName": "taskStartItemNot1",
-        "type": "string",
-        "default": "FT",
-        "description": "排除 FT 项。"
+        "name": "start_date",
+        "backendName": "startDate",
+        "type": "date",
+        "transform": "isoToBackendDate",
+        "description": "起始日期(ISO,可选)。不传则今天。"
       },
       {
-        "name": "task_start_item_not_2",
-        "backendName": "taskStartItemNot2",
-        "type": "string",
-        "default": "垃圾箱",
-        "description": "排除垃圾箱。"
+        "name": "end_date",
+        "backendName": "endDate",
+        "type": "date",
+        "transform": "isoToBackendDate",
+        "description": "截止日期(ISO,可选)。不传则今天。"
       }
     ],
     "output": {
-      "shape": "array"
+      "shape": "object"
     }
   },
   {
@@ -1467,6 +1473,117 @@
       "shape": "array"
     }
   },
+  {
+    "name": "zentodo.project.list-active",
+    "domain": "project",
+    "action": "list-active",
+    "description": "调用 /projectController/getActiveProjects。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/getActiveProjects"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.project.list-archived",
+    "domain": "project",
+    "action": "list-archived",
+    "description": "调用 /projectController/getArchivedProjects。projectState in (2,3,4)。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/getArchivedProjects"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.project.search",
+    "domain": "project",
+    "action": "search",
+    "description": "调用 /projectController/searchProjects。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/searchProjects"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
+      {
+        "name": "keyword",
+        "backendName": "keyword",
+        "type": "string",
+        "required": true,
+        "description": "关键字。"
+      },
+      {
+        "name": "limit",
+        "backendName": "limit",
+        "type": "integer",
+        "default": 50,
+        "description": "最多返回多少条(默认 50,最大 500)。"
+      }
+    ],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.project.stats",
+    "domain": "project",
+    "action": "stats",
+    "description": "调用 /projectController/getProjectStats。返回 { task_count, done_task_count, progress, exec_time_ms, state }。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/getProjectStats"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
+      {
+        "name": "project_key",
+        "backendName": "projectKey",
+        "type": "integer",
+        "required": true,
+        "description": "项目 projectKey。"
+      }
+    ],
+    "output": {
+      "shape": "object"
+    }
+  },
   {
     "name": "zentodo.project.sync-pull",
     "domain": "project",
@@ -2561,6 +2678,43 @@
       "shape": "array"
     }
   },
+  {
+    "name": "zentodo.pomo.focus-stats",
+    "domain": "pomo",
+    "action": "focus-stats",
+    "description": "调用 /tomatoWorkerController/getFocusStats。返回 { sessions, total_sec, total_hours, by_task }。",
+    "http": {
+      "method": "POST",
+      "path": "/tomatoWorkerController/getFocusStats"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
+      {
+        "name": "start_time",
+        "backendName": "startTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "起始时间(ISO,可选)。不传则今天 00:00:00。"
+      },
+      {
+        "name": "end_time",
+        "backendName": "endTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "截止时间(ISO,可选)。不传则今天 23:59:59。"
+      }
+    ],
+    "output": {
+      "shape": "object"
+    }
+  },
   {
     "name": "zentodo.pomo.sync-pull-worker",
     "domain": "pomo",

package/dist/skills/zentodo/references/tools.md

@@ -317,7 +317,7 @@
 
 ## `zentodo.task.completed-today`
 
-调用 /taskController/getCompletedTasks。过滤条件:syncFlag != D、taskState = 0、taskCompletedTime = today。
+调用 /taskController/getCompletedTasks。服务端根据 usrKey + date 直接过滤,不用在客户端再做一次。
 
 - **后端端点**:`POST /taskController/getCompletedTasks`
 - **所需 scope**:`read`
@@ -325,32 +325,19 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `is_templete` | boolean | 否 | 排除模板。 |
-| `sync_flag` | string | 否 | 同步标记过滤。 |
-| `task_state` | string | 否 | 已完成。 |
-| `task_completed_time` | string | 否 | 完成时间=今日。 |
-| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
+| `date` | date | 否 | 指定日期(ISO,可选)。不传则使用服务器今天。 |
 
 ## `zentodo.task.mit-list`
 
-调用 /taskController/getMitTasks。过滤条件与 PC 端 loadMitHeaderDatas() 一致。
+调用 /taskController/getMitTasks。服务端按 usrKey 过滤 isMIT=true + 未完成 + taskCreateTime<=今天。
 
 - **后端端点**:`POST /taskController/getMitTasks`
 - **所需 scope**:`read`
 - **标注**:只读=true,幂等=true,破坏性=false
 
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `sync_flag` | string | 否 | 同步标记过滤。 |
-| `is_templete` | boolean | 否 | 排除模板。 |
-| `task_state` | string | 否 | 未完成。 |
-| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
-| `task_create_time` | string | 否 | 到今日为止。 |
-| `is_mit` | boolean | 否 | MIT 过滤。 |
-
 ## `zentodo.task.calendar`
 
-调用 /taskController/getCalendarTaskByDate。过滤与安卓端一致(syncFlag!=D、taskState!=0、isTemplete=false、taskStartItem!=FT、taskStartItem!=垃圾箱)。
+调用 /taskController/getCalendarTaskByDate。服务端已内置过滤(未完成 + 非模板 + 非垃圾箱)。
 
 - **后端端点**:`POST /taskController/getCalendarTaskByDate`
 - **所需 scope**:`read`
@@ -360,11 +347,48 @@
 | --- | --- | --- | --- |
 | `start_date` | date | 是 | 范围起始(ISO 日期)。 |
 | `end_date` | date | 是 | 范围截止(ISO 日期)。 |
-| `sync_flag` | string | 否 | 同步标记过滤。 |
-| `task_state` | string | 否 | 未完成。 |
-| `is_templete` | boolean | 否 | 排除模板。 |
-| `task_start_item_not_1` | string | 否 | 排除 FT 项。 |
-| `task_start_item_not_2` | string | 否 | 排除垃圾箱。 |
+
+## `zentodo.task.overdue`
+
+调用 /taskController/getOverdueTasks。
+
+- **后端端点**:`POST /taskController/getOverdueTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.task.inbox`
+
+调用 /taskController/getInboxTasks。
+
+- **后端端点**:`POST /taskController/getInboxTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.task.search`
+
+调用 /taskController/searchTasks。服务端按 LIKE 匹配并按 latestVersion 倒序返回。
+
+- **后端端点**:`POST /taskController/searchTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keyword` | string | 是 | 关键字。 |
+| `limit` | integer | 否 | 最多返回多少条(默认 50,最大 500)。 |
+
+## `zentodo.task.stats`
+
+调用 /taskController/getTaskStats。返回 { created, completed, completion_rate, by_project }。
+
+- **后端端点**:`POST /taskController/getTaskStats`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `start_date` | date | 否 | 起始日期(ISO,可选)。不传则今天。 |
+| `end_date` | date | 否 | 截止日期(ISO,可选)。不传则今天。 |
 
 ## `zentodo.task.move`
 
@@ -475,6 +499,47 @@
 - **所需 scope**:`read`
 - **标注**:只读=true,幂等=true,破坏性=false
 
+## `zentodo.project.list-active`
+
+调用 /projectController/getActiveProjects。
+
+- **后端端点**:`POST /projectController/getActiveProjects`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.project.list-archived`
+
+调用 /projectController/getArchivedProjects。projectState in (2,3,4)。
+
+- **后端端点**:`POST /projectController/getArchivedProjects`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.project.search`
+
+调用 /projectController/searchProjects。
+
+- **后端端点**:`POST /projectController/searchProjects`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keyword` | string | 是 | 关键字。 |
+| `limit` | integer | 否 | 最多返回多少条(默认 50,最大 500)。 |
+
+## `zentodo.project.stats`
+
+调用 /projectController/getProjectStats。返回 { task_count, done_task_count, progress, exec_time_ms, state }。
+
+- **后端端点**:`POST /projectController/getProjectStats`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `project_key` | integer | 是 | 项目 projectKey。 |
+
 ## `zentodo.project.sync-pull`
 
 调用 /projectController/getSyncProjectList。
@@ -842,6 +907,19 @@
 - **所需 scope**:`read`
 - **标注**:只读=true,幂等=true,破坏性=false
 
+## `zentodo.pomo.focus-stats`
+
+调用 /tomatoWorkerController/getFocusStats。返回 { sessions, total_sec, total_hours, by_task }。
+
+- **后端端点**:`POST /tomatoWorkerController/getFocusStats`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `start_time` | datetime | 否 | 起始时间(ISO,可选)。不传则今天 00:00:00。 |
+| `end_time` | datetime | 否 | 截止时间(ISO,可选)。不传则今天 23:59:59。 |
+
 ## `zentodo.pomo.sync-pull-worker`
 
 调用 /tomatoWorkerController/getSyncTomatoWorkerList。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zentodo/cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "ZenTodo 命令行工具 — 为 AI Agent 和开发者设计，覆盖任务、项目、番茄钟、日记、同步等全部能力。安装后自动配置 Claude Agent Skill。",
   "type": "module",
   "bin": {