@zentodo/cli 0.1.11 → 0.1.13

package/skills/zentodo/references/tools.json

@@ -547,10 +547,11 @@
     "name": "zentodo.task.add",
     "domain": "task",
     "action": "add",
-    "description": "调用 /taskController/insertTask,使用 FormData 提交。",
+    "description": "调用 /taskController/insertTask,使用 JSON 请求体(后端 @RequestBody)。",
     "http": {
       "method": "POST",
-      "path": "/taskController/insertTask"
+      "path": "/taskController/insertTask",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -642,10 +643,11 @@
     "name": "zentodo.task.update",
     "domain": "task",
     "action": "update",
-    "description": "调用 /taskController/updateTask。未传入的字段不会被写入 FormData,避免把现有列置空。",
+    "description": "调用 /taskController/updateTask(后端 @RequestBody)。未传入的字段不会被写入 JSON payload,避免把现有列置空。",
     "http": {
       "method": "POST",
-      "path": "/taskController/updateTask"
+      "path": "/taskController/updateTask",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -743,7 +745,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "softDelete"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "destructive",
@@ -777,7 +780,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "completeTask"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -804,10 +808,11 @@
     "name": "zentodo.task.uncomplete",
     "domain": "task",
     "action": "uncomplete",
-    "description": "调用 /taskController/updateTask,把 taskState 还原为 1 并清空完成时间。",
+    "description": "调用 /taskController/updateTask(@RequestBody),把 taskState 还原为 1 并清空完成时间。",
     "http": {
       "method": "POST",
-      "path": "/taskController/updateTask"
+      "path": "/taskController/updateTask",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -855,7 +860,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "setMit"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -894,7 +900,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "setQuadrant"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -1205,13 +1212,14 @@
     "name": "zentodo.task.sync-push",
     "domain": "task",
     "action": "sync-push",
-    "description": "调用 /taskController/putSyncTask。所有字段通过 FormData 提交,自动剥离 id / rowid。",
+    "description": "调用 /taskController/putSyncTask(@RequestBody),完整字段提交,自动剥离 id / rowid。",
     "http": {
       "method": "POST",
       "path": "/taskController/putSyncTask",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1266,13 +1274,14 @@
     "name": "zentodo.subtask.sync-push",
     "domain": "subtask",
     "action": "sync-push",
-    "description": "调用 /subTaskController/putSyncSubTask。所有字段通过 FormData 提交,自动剥离 id/rowid。",
+    "description": "调用 /subTaskController/putSyncSubTask(后端 @RequestBody SubTask)。JSON 体,自动剥离 id/rowid。",
     "http": {
       "method": "POST",
       "path": "/subTaskController/putSyncSubTask",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1378,13 +1387,14 @@
     "name": "zentodo.project.sync-push",
     "domain": "project",
     "action": "sync-push",
-    "description": "调用 /projectController/putSyncProject。所有字段通过 FormData 提交,自动剥离 id/rowid。",
+    "description": "调用 /projectController/putSyncProject(后端 @RequestBody Project)。所有字段以 JSON 体提交,自动剥离 id/rowid。",
     "http": {
       "method": "POST",
       "path": "/projectController/putSyncProject",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1619,13 +1629,14 @@
     "name": "zentodo.subproject.sync-push",
     "domain": "subproject",
     "action": "sync-push",
-    "description": "调用 /subProjectController/putSyncSubProject。",
+    "description": "调用 /subProjectController/putSyncSubProject(后端 @RequestBody SubProject)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/subProjectController/putSyncSubProject",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1725,13 +1736,14 @@
     "name": "zentodo.scene.sync-push",
     "domain": "scene",
     "action": "sync-push",
-    "description": "调用 /sceneController/putSyncScene。",
+    "description": "调用 /sceneController/putSyncScene(后端 @RequestBody Scene)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/sceneController/putSyncScene",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1836,13 +1848,14 @@
     "name": "zentodo.target.sync-push",
     "domain": "target",
     "action": "sync-push",
-    "description": "调用 /targetController/putSyncTarget。",
+    "description": "调用 /targetController/putSyncTarget(后端 @RequestBody Target)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/targetController/putSyncTarget",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1948,13 +1961,14 @@
     "name": "zentodo.label.sync-push",
     "domain": "label",
     "action": "sync-push",
-    "description": "调用 /labelController/putSyncLabel。",
+    "description": "调用 /labelController/putSyncLabel(后端 @RequestBody Label)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/labelController/putSyncLabel",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2158,13 +2172,14 @@
     "name": "zentodo.quadrant.sync-push",
     "domain": "quadrant",
     "action": "sync-push",
-    "description": "调用 /quadrantController/putSyncQuadrant。",
+    "description": "调用 /quadrantController/putSyncQuadrant(后端 @RequestBody Quadrant)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/quadrantController/putSyncQuadrant",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2263,13 +2278,14 @@
     "name": "zentodo.timeline.sync-push",
     "domain": "timeline",
     "action": "sync-push",
-    "description": "调用 /timeLineController/putSyncTimeLine。",
+    "description": "调用 /timeLineController/putSyncTimeLine(后端 @RequestBody TimeLine)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/timeLineController/putSyncTimeLine",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2539,13 +2555,14 @@
     "name": "zentodo.attach.sync-push",
     "domain": "attach",
     "action": "sync-push",
-    "description": "调用 /attachmentController/putSyncAttchment。",
+    "description": "调用 /attachmentController/putSyncAttchment(后端 @RequestBody Attachment)。JSON 体,仅元数据,不包含文件二进制。",
     "http": {
       "method": "POST",
       "path": "/attachmentController/putSyncAttchment",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2750,13 +2767,14 @@
     "name": "zentodo.pomo.sync-push-worker",
     "domain": "pomo",
     "action": "sync-push-worker",
-    "description": "调用 /tomatoWorkerController/putSyncTomatoWorker。",
+    "description": "调用 /tomatoWorkerController/putSyncTomatoWorker(后端 @RequestBody TomatoWorker)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/tomatoWorkerController/putSyncTomatoWorker",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2818,13 +2836,14 @@
     "name": "zentodo.pomo.config-set",
     "domain": "pomo",
     "action": "config-set",
-    "description": "调用 /tomatoConfigController/putSyncTomatoConfig。",
+    "description": "调用 /tomatoConfigController/putSyncTomatoConfig(后端 @RequestBody TomatoConfig)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/tomatoConfigController/putSyncTomatoConfig",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3036,10 +3055,11 @@
     "name": "zentodo.workstate.update",
     "domain": "workstate",
     "action": "update",
-    "description": "调用 /workStateController/updateWorkState。",
+    "description": "调用 /workStateController/updateWorkState(后端 @RequestBody WorkState)。JSON 体。",
     "http": {
       "method": "POST",
-      "path": "/workStateController/updateWorkState"
+      "path": "/workStateController/updateWorkState",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -3131,13 +3151,14 @@
     "name": "zentodo.workstate.sync-push",
     "domain": "workstate",
     "action": "sync-push",
-    "description": "调用 /workStateController/putSyncWorkState。",
+    "description": "调用 /workStateController/putSyncWorkState(后端 @RequestBody WorkState)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/workStateController/putSyncWorkState",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3382,13 +3403,14 @@
     "name": "zentodo.mindmap.sync-push",
     "domain": "mindmap",
     "action": "sync-push",
-    "description": "调用 /gdMetaController/putSyncGDMeta。",
+    "description": "调用 /gdMetaController/putSyncGDMeta(后端 @RequestBody GDMeta)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/gdMetaController/putSyncGDMeta",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3487,13 +3509,14 @@
     "name": "zentodo.reward.store-sync-push",
     "domain": "reward",
     "action": "store-sync-push",
-    "description": "调用 /rewardStoreController/putSyncRewardStore。",
+    "description": "调用 /rewardStoreController/putSyncRewardStore(后端 @RequestBody RewardStore)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/rewardStoreController/putSyncRewardStore",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3629,13 +3652,14 @@
     "name": "zentodo.reward.record-sync-push",
     "domain": "reward",
     "action": "record-sync-push",
-    "description": "调用 /rewardRecordController/putSyncRewardRecord。",
+    "description": "调用 /rewardRecordController/putSyncRewardRecord(后端 @RequestBody RewardRecord)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/rewardRecordController/putSyncRewardRecord",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3734,13 +3758,14 @@
     "name": "zentodo.fasttime.sync-push",
     "domain": "fasttime",
     "action": "sync-push",
-    "description": "调用 /fastTimeRecordController/putSyncFastTimeRecord。",
+    "description": "调用 /fastTimeRecordController/putSyncFastTimeRecord(后端 @RequestBody FastTimeRecord)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/fastTimeRecordController/putSyncFastTimeRecord",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",

package/skills/zentodo/references/tools.md

@@ -209,7 +209,7 @@
 
 ## `zentodo.task.add`
 
-调用 /taskController/insertTask,使用 FormData 提交。
+调用 /taskController/insertTask,使用 JSON 请求体(后端 @RequestBody)。
 
 - **后端端点**:`POST /taskController/insertTask`
 - **所需 scope**:`write`
@@ -231,7 +231,7 @@
 
 ## `zentodo.task.update`
 
-调用 /taskController/updateTask。未传入的字段不会被写入 FormData,避免把现有列置空。
+调用 /taskController/updateTask(后端 @RequestBody)。未传入的字段不会被写入 JSON payload,避免把现有列置空。
 
 - **后端端点**:`POST /taskController/updateTask`
 - **所需 scope**:`write`
@@ -277,7 +277,7 @@
 
 ## `zentodo.task.uncomplete`
 
-调用 /taskController/updateTask,把 taskState 还原为 1 并清空完成时间。
+调用 /taskController/updateTask(@RequestBody),把 taskState 还原为 1 并清空完成时间。
 
 - **后端端点**:`POST /taskController/updateTask`
 - **所需 scope**:`write`
@@ -417,7 +417,7 @@
 
 ## `zentodo.task.sync-push`
 
-调用 /taskController/putSyncTask。所有字段通过 FormData 提交,自动剥离 id / rowid。
+调用 /taskController/putSyncTask(@RequestBody),完整字段提交,自动剥离 id / rowid。
 
 - **后端端点**:`POST /taskController/putSyncTask`
 - **所需 scope**:`sync, write`
@@ -438,7 +438,7 @@
 
 ## `zentodo.subtask.sync-push`
 
-调用 /subTaskController/putSyncSubTask。所有字段通过 FormData 提交,自动剥离 id/rowid。
+调用 /subTaskController/putSyncSubTask(后端 @RequestBody SubTask)。JSON 体,自动剥离 id/rowid。
 
 - **后端端点**:`POST /subTaskController/putSyncSubTask`
 - **所需 scope**:`sync, write`
@@ -474,7 +474,7 @@
 
 ## `zentodo.project.sync-push`
 
-调用 /projectController/putSyncProject。所有字段通过 FormData 提交,自动剥离 id/rowid。
+调用 /projectController/putSyncProject(后端 @RequestBody Project)。所有字段以 JSON 体提交,自动剥离 id/rowid。
 
 - **后端端点**:`POST /projectController/putSyncProject`
 - **所需 scope**:`sync, write`
@@ -554,7 +554,7 @@
 
 ## `zentodo.subproject.sync-push`
 
-调用 /subProjectController/putSyncSubProject。
+调用 /subProjectController/putSyncSubProject(后端 @RequestBody SubProject)。JSON 体。
 
 - **后端端点**:`POST /subProjectController/putSyncSubProject`
 - **所需 scope**:`sync, write`
@@ -589,7 +589,7 @@
 
 ## `zentodo.scene.sync-push`
 
-调用 /sceneController/putSyncScene。
+调用 /sceneController/putSyncScene(后端 @RequestBody Scene)。JSON 体。
 
 - **后端端点**:`POST /sceneController/putSyncScene`
 - **所需 scope**:`sync, write`
@@ -625,7 +625,7 @@
 
 ## `zentodo.target.sync-push`
 
-调用 /targetController/putSyncTarget。
+调用 /targetController/putSyncTarget(后端 @RequestBody Target)。JSON 体。
 
 - **后端端点**:`POST /targetController/putSyncTarget`
 - **所需 scope**:`sync, write`
@@ -661,7 +661,7 @@
 
 ## `zentodo.label.sync-push`
 
-调用 /labelController/putSyncLabel。
+调用 /labelController/putSyncLabel(后端 @RequestBody Label)。JSON 体。
 
 - **后端端点**:`POST /labelController/putSyncLabel`
 - **所需 scope**:`sync, write`
@@ -731,7 +731,7 @@
 
 ## `zentodo.quadrant.sync-push`
 
-调用 /quadrantController/putSyncQuadrant。
+调用 /quadrantController/putSyncQuadrant(后端 @RequestBody Quadrant)。JSON 体。
 
 - **后端端点**:`POST /quadrantController/putSyncQuadrant`
 - **所需 scope**:`sync, write`
@@ -766,7 +766,7 @@
 
 ## `zentodo.timeline.sync-push`
 
-调用 /timeLineController/putSyncTimeLine。
+调用 /timeLineController/putSyncTimeLine(后端 @RequestBody TimeLine)。JSON 体。
 
 - **后端端点**:`POST /timeLineController/putSyncTimeLine`
 - **所需 scope**:`sync, write`
@@ -861,7 +861,7 @@
 
 ## `zentodo.attach.sync-push`
 
-调用 /attachmentController/putSyncAttchment。
+调用 /attachmentController/putSyncAttchment(后端 @RequestBody Attachment)。JSON 体,仅元数据,不包含文件二进制。
 
 - **后端端点**:`POST /attachmentController/putSyncAttchment`
 - **所需 scope**:`sync, write`
@@ -934,7 +934,7 @@
 
 ## `zentodo.pomo.sync-push-worker`
 
-调用 /tomatoWorkerController/putSyncTomatoWorker。
+调用 /tomatoWorkerController/putSyncTomatoWorker(后端 @RequestBody TomatoWorker)。JSON 体。
 
 - **后端端点**:`POST /tomatoWorkerController/putSyncTomatoWorker`
 - **所需 scope**:`sync, write`
@@ -956,7 +956,7 @@
 
 ## `zentodo.pomo.config-set`
 
-调用 /tomatoConfigController/putSyncTomatoConfig。
+调用 /tomatoConfigController/putSyncTomatoConfig(后端 @RequestBody TomatoConfig)。JSON 体。
 
 - **后端端点**:`POST /tomatoConfigController/putSyncTomatoConfig`
 - **所需 scope**:`sync, write`
@@ -1031,7 +1031,7 @@
 
 ## `zentodo.workstate.update`
 
-调用 /workStateController/updateWorkState。
+调用 /workStateController/updateWorkState(后端 @RequestBody WorkState)。JSON 体。
 
 - **后端端点**:`POST /workStateController/updateWorkState`
 - **所需 scope**:`write`
@@ -1065,7 +1065,7 @@
 
 ## `zentodo.workstate.sync-push`
 
-调用 /workStateController/putSyncWorkState。
+调用 /workStateController/putSyncWorkState(后端 @RequestBody WorkState)。JSON 体。
 
 - **后端端点**:`POST /workStateController/putSyncWorkState`
 - **所需 scope**:`sync, write`
@@ -1148,7 +1148,7 @@
 
 ## `zentodo.mindmap.sync-push`
 
-调用 /gdMetaController/putSyncGDMeta。
+调用 /gdMetaController/putSyncGDMeta(后端 @RequestBody GDMeta)。JSON 体。
 
 - **后端端点**:`POST /gdMetaController/putSyncGDMeta`
 - **所需 scope**:`sync, write`
@@ -1183,7 +1183,7 @@
 
 ## `zentodo.reward.store-sync-push`
 
-调用 /rewardStoreController/putSyncRewardStore。
+调用 /rewardStoreController/putSyncRewardStore(后端 @RequestBody RewardStore)。JSON 体。
 
 - **后端端点**:`POST /rewardStoreController/putSyncRewardStore`
 - **所需 scope**:`sync, write`
@@ -1231,7 +1231,7 @@
 
 ## `zentodo.reward.record-sync-push`
 
-调用 /rewardRecordController/putSyncRewardRecord。
+调用 /rewardRecordController/putSyncRewardRecord(后端 @RequestBody RewardRecord)。JSON 体。
 
 - **后端端点**:`POST /rewardRecordController/putSyncRewardRecord`
 - **所需 scope**:`sync, write`
@@ -1266,7 +1266,7 @@
 
 ## `zentodo.fasttime.sync-push`
 
-调用 /fastTimeRecordController/putSyncFastTimeRecord。
+调用 /fastTimeRecordController/putSyncFastTimeRecord(后端 @RequestBody FastTimeRecord)。JSON 体。
 
 - **后端端点**:`POST /fastTimeRecordController/putSyncFastTimeRecord`
 - **所需 scope**:`sync, write`