@wirecat/cli-core 0.287.0 → 0.289.0

package/parity.json

@@ -106,10 +106,6 @@
       "meaning": "let the messenger send it later, even with this machine off: a local time like 2026-09-25T09:00, or 30m",
       "note": "schedule agent and schedule command take it for their one run: a duration from now or an ISO 8601 time"
     },
-    "--attach": {
-      "value": "<task>",
-      "meaning": "link the message to this task, one that may be the same job, instead of opening a new one"
-    },
     "--attachment": {
       "value": "<n>",
       "meaning": "which file of the message, from 1; needed when it has more than one"
@@ -212,9 +208,6 @@
       "meaning": "maximum source bytes returned from a retained attachment; 1–1048576",
       "default": "524288"
     },
-    "--claimed": {
-      "meaning": "also list tasks someone else holds"
-    },
     "--close-time": {
       "value": "<delay>",
       "meaning": "it closes by itself this long after sending, like 90s or 5m"
@@ -309,9 +302,13 @@
       "note": "A command-specific dry run keeps its richer plan; otherwise the shared shell previews arguments and permissions without running the action. Targets remain unresolved unless that command provides a preview."
     },
     "--due": {
-      "value": "<when>",
-      "meaning": "when a task must be done: an ISO 8601 time or a duration from now; none clears it",
-      "note": "tasks agenda instead takes a duration such as 1d to select tasks due within that interval"
+      "value": "<time>",
+      "meaning": "when a task must be done: an ISO 8601 time or a duration from now; none clears it"
+    },
+    "--due-within": {
+      "value": "<duration>",
+      "meaning": "list tasks due within this: 30m, 2h, 1d",
+      "default": "1d"
     },
     "--emoji": {
       "value": "<emoji>",
@@ -381,8 +378,7 @@
     "--for": {
       "value": "<agents>",
       "meaning": "which agents a skill is installed for: claude, agents or all",
-      "default": "all",
-      "note": "tasks claim instead takes how long the claim lasts, such as 30m or 2h"
+      "default": "all"
     },
     "--for-everyone": {
       "meaning": "delete for everyone in the chat, not only for you — they cannot get it back"
@@ -440,8 +436,8 @@
       "note": "a folder (`chats folders`) or an export folder (`store export`) takes these chats"
     },
     "--into": {
-      "value": "<task>",
-      "meaning": "the task that stays when another is merged into it"
+      "value": "<id>",
+      "meaning": "the task that stays: a duplicate is merged into it, or a message is linked to it instead of opening a task"
     },
     "--join-approval": {
       "value": "<on|off>",
@@ -470,6 +466,11 @@
       "value": "<name>",
       "meaning": "your last name"
     },
+    "--lease": {
+      "value": "<duration>",
+      "meaning": "how long a task claim lasts, such as 30m or 2h; claiming again extends it",
+      "default": "30m"
+    },
     "--left": {
       "meaning": "only the chats this account has left"
     },
@@ -478,11 +479,6 @@
       "meaning": "how many: rows to show, or messages one run fetches",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
     },
-    "--lines": {
-      "value": "<n>",
-      "meaning": "how many lines",
-      "default": "50"
-    },
     "--link": {
       "value": "<link>",
       "meaning": "an invite link: only the requests made through it",
@@ -532,8 +528,8 @@
       "default": "16777216"
     },
     "--max-meetings": {
-      "value": "<n|all>",
-      "meaning": "how many of the meeting account's meetings to look through, newest first; all looks through every one (default 100)"
+      "value": "<n>",
+      "meaning": "how many of the meeting account's meetings to look through, newest first, or all for every one (default 100)"
     },
     "--max-messages": {
       "value": "<n>",
@@ -756,10 +752,6 @@
       "default": "5s",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
     },
-    "--payload": {
-      "value": "<text>",
-      "meaning": "the start parameter the bot reads; a link's own ?start= when not given"
-    },
     "--per-chat": {
       "meaning": "at most this many per chat, such as 1/12h",
       "value": "<limit>"
@@ -859,7 +851,7 @@
       "meaning": "take your vote back, where the poll allows it"
     },
     "--revision": {
-      "value": "<number>",
+      "value": "<n>",
       "meaning": "the revision you read before editing"
     },
     "--revoke": {
@@ -877,8 +869,8 @@
       "meaning": "run a saved search, or an earlier run by its id; options typed with it replace its own, more words are AND-ed"
     },
     "--scope": {
-      "value": "<personal|work>",
-      "meaning": "only what belongs to personal or to work accounts"
+      "value": "<scope>",
+      "meaning": "only what belongs to personal or to work accounts: personal or work"
     },
     "--score": {
       "value": "<helpful|active|engaging>",
@@ -946,7 +938,7 @@
     },
     "--start": {
       "value": "<param>",
-      "meaning": "the start parameter the app reads"
+      "meaning": "the start parameter the bot or app reads; for chats start, a link's own ?start= when not given"
     },
     "--status": {
       "value": "<status>",
@@ -967,12 +959,8 @@
       "value": "<duration>",
       "meaning": "stop fetching after this long (default: 30s)"
     },
-    "--tag": {
-      "value": "<name>",
-      "meaning": "only what carries this tag"
-    },
     "--task": {
-      "value": "<task>",
+      "value": "<id>",
       "meaning": "a task, by its id or key as tasks list shows it"
     },
     "--template": {
@@ -1062,9 +1050,6 @@
       "note": "max's own `review` still takes bare hours until T6 moves it (e2)",
       "default": "24h"
     },
-    "--unsure": {
-      "meaning": "only the pairs the reviewing agent left to the owner"
-    },
     "--until": {
       "value": "<time>",
       "meaning": "only until then: a local time, or a duration from now"
@@ -1093,7 +1078,7 @@
       "meaning": "send an Ogg Opus file as a voice message, alone, with no text"
     },
     "--waiting": {
-      "value": "<span>",
+      "value": "<duration>",
       "meaning": "only chats where the owner wrote last at least this long ago",
       "default": "7d"
     },
@@ -2057,7 +2042,7 @@
         "tg": "tg-cli backlog: start a bot, open its mini app"
       },
       "options": {
-        "--payload": {
+        "--start": {
           "in": ["max"],
           "planned": {
             "tg": "tg-cli backlog: start a bot, open its mini app"
@@ -3496,7 +3481,7 @@
     "server logs": {
       "in": "all",
       "options": {
-        "--lines": "all"
+        "--limit": "all"
       }
     },
     "server restart": {
@@ -4023,10 +4008,10 @@
     "tasks add": {
       "in": "all",
       "options": {
-        "--attach": "all",
         "--category": "all",
         "--description": "all",
         "--due": "all",
+        "--into": "all",
         "--new": "all",
         "--remind-time": "all",
         "--title": "all",
@@ -4038,11 +4023,8 @@
     "tasks agenda": {
       "in": "all",
       "options": {
-        "--category": "all",
-        "--claimed": "all",
-        "--due": "all",
+        "--due-within": "all",
         "--holder": "all",
-        "--tag": "all",
         "--unanswered": "all",
         "--waiting": "all",
         "--within": "all"
@@ -4054,8 +4036,8 @@
     "tasks claim": {
       "in": "all",
       "options": {
-        "--for": "all",
-        "--holder": "all"
+        "--holder": "all",
+        "--lease": "all"
       }
     },
     "tasks close": {
@@ -4072,14 +4054,13 @@
     "tasks duplicates": {
       "in": "all",
       "options": {
-        "--limit": "all",
-        "--unsure": "all"
+        "--limit": "all"
       }
     },
-    "tasks duplicates reject": {
+    "tasks duplicates defer": {
       "in": "all"
     },
-    "tasks duplicates unsure": {
+    "tasks duplicates reject": {
       "in": "all"
     },
     "tasks link": {
@@ -4113,6 +4094,12 @@
         "--title": "all"
       }
     },
+    "tasks related": {
+      "in": "all",
+      "options": {
+        "--limit": "all"
+      }
+    },
     "tasks release": {
       "in": "all",
       "options": {
@@ -4122,12 +4109,6 @@
     "tasks show": {
       "in": "all"
     },
-    "tasks similar": {
-      "in": "all",
-      "options": {
-        "--limit": "all"
-      }
-    },
     "tasks unmerge": {
       "in": "all"
     },

package/skills/follow-ups/SKILL.md

@@ -19,14 +19,14 @@ forwards, deletes or marks read. A draft is text in your answer to the owner, no
 
 ```sh
 {{command}} review --new --json                       # every message since the last run, both sides: the day's only full read
-{{command}} tasks agenda --json                       # defaults: --due 1d --unanswered 1d --waiting 7d --within 30d
+{{command}} tasks agenda --json                       # defaults: --due-within 1d --unanswered 1d --waiting 7d --within 30d
 ```
 
 `review --new` also saves what it reads, so the agenda after it knows who wrote last. The agenda holds
 no message text — read all of it:
 
 - `stale: true` — the store saved nothing for a day. Say so first: quiet chats may only be unsynced.
-- `tasks` — open tasks with `reasons`: `overdue`, `due` (within `--due`), `check` (their next check
+- `tasks` — open tasks with `reasons`: `overdue`, `due` (within `--due-within`), `check` (their next check
   passed), `unplanned` (no due date and no next check: plan it now).
 - `owed` — someone else wrote last and the owner has not answered for `--unanswered`.
 - `waiting` — the owner wrote last and nobody answered for `--waiting`.
@@ -54,8 +54,8 @@ For a chat in `owed` or `waiting`: read around its `lastMessage` the same way.
 |---|---|
 | A promise, a request, a question someone waits on | `tasks add <msg> --type promise\|request\|question --category <name>` with a plan; `tasks categories` lists the names |
 | `tasks add` answers `created: false` | the message already has that task (a rule made it): `tasks plan` that one |
-| `tasks add` refuses with `task.duplicate-candidates` | read the listed tasks: the same job → repeat with `--attach <key>`; a different one → repeat with `--new` |
-| `tasks duplicates` lists pairs a rule opened | one job → `tasks merge <task> --into <other>`; two jobs → `tasks duplicates reject <task> <other>`; the meaning cannot tell (mum's gift or dad's) → `tasks duplicates unsure <task> <other>` for the owner. A wrong merge: `tasks unmerge <task>` |
+| `tasks add` refuses with `task.duplicate-candidates` | read the listed tasks: the same job → repeat with `--into <key>`; a different one → repeat with `--new` |
+| `tasks duplicates` lists pairs a rule opened | one job → `tasks merge <task> --into <other>`; two jobs → `tasks duplicates reject <task> <other>`; the meaning cannot tell (mum's gift or dad's) → `tasks duplicates defer <task> <other>` for the owner. A wrong merge: `tasks unmerge <task>` |
 | A task that is done (the reply came, the file was sent) | `tasks close <key> --as done --reason "<one line>"` |
 | A task still open, nothing new | `tasks plan <key> --remind-time <when>` — 1d if hot, 3d–7d if not |
 | A task with the wrong category | `tasks plan <key> --category <name>` |
@@ -99,7 +99,7 @@ A recipe is a set of flags, not a new command:
 |---|---|
 | Morning sweep | `review --new --json`, then `tasks agenda --json` |
 | Weekly quiet-chat pass | `tasks agenda --waiting 3d --within 90d --json` |
-| Groups too, not only people | `tasks agenda --kind dialog,group,channel --json` |
+| Groups too, not only people | `tasks agenda "chat_kind:(dialog OR group OR channel)" --json` |
 | Before a call with someone | `tasks list 'chat:"<chat>" state:open' --json`, then `tasks show` each |
 
 ## Boundaries