@tekmidian/pai 0.18.6 → 0.19.0

package/docs/commands/README.md

@@ -167,7 +167,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai task add <title>` | File a task onto the bus |
 | `pai task config` | View or change task bus settings without running the full setup wizard |
 | `pai task dispatch` | Hand open tasks to the PAI sessions that own them |
-| `pai task done <id>` | Mark a task complete on the tracker |
+| `pai task done <id>` | Mark a task complete on the tracker, keeping its discussion |
 | `pai task list` | List open tasks on the bus |
 | `pai task poll` | One scheduler tick: dispatch what is due, check what is running, report |
 | `pai task projects` | Show which sessions can be given work from the tracker, and create the missing projects |

package/docs/commands/task.md

@@ -23,7 +23,7 @@ pai task <subcommand> [options]
 | [`pai task poll`](#pai-task-poll) | One scheduler tick: dispatch what is due, check what is running, report |
 | [`pai task schedule`](#pai-task-schedule) | Install, remove or inspect the launchd agent that ticks the scheduler |
 | [`pai task config`](#pai-task-config) | View or change task bus settings without running the full setup wizard |
-| [`pai task done <id>`](#pai-task-done-id) | Mark a task complete on the tracker |
+| [`pai task done <id>`](#pai-task-done-id) | Mark a task complete on the tracker, keeping its discussion |
 
 ### pai task projects
 
@@ -144,7 +144,7 @@ View or change task bus settings without running the full setup wizard
 
 ### pai task done <id>
 
-Mark a task complete on the tracker
+Mark a task complete on the tracker, keeping its discussion
 
 **Arguments**
 
@@ -152,6 +152,12 @@ Mark a task complete on the tracker
 |----------|------|
 | `<id>` | required |
 
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--no-archive` | Complete without saving the comment thread |  |
+
 
 ## See also
 

package/docs/task-bus.md

@@ -158,12 +158,25 @@ account that had genuinely authorised. Trust `aibroker todoist status`.
 **4. A lapsed grant looks like a healthy channel.** Webhooks are verified with
 the client *secret*, not the token, so **task delivery keeps working**. What
 breaks is everything needing the API: comment routing (a comment payload has no
-project or labels, so the parent must be fetched) and replying on a task. The
-signature is `401` with `error_code 477` and a `retry_after` that climbs —
-3, 7, 65, 129 seconds. That climb is throttling stacked on a dead credential, so
-retrying makes it worse. The reliable tell is the consent dialog appearing again
-for a URL that used to redirect straight through. Fix: `aibroker todoist auth`
-and one click.
+project or labels, so the parent must be fetched) and replying on a task. So the
+signature is the asymmetry itself — **tasks arrive, comments do not.**
+
+The response is `401` with `error_code 477` and a `retry_after` that climbs:
+3, 7, 65, 129 seconds.
+
+**That climb is not throttling, and this document said it was.** Todoist's
+reference states that `retry_after` is backoff metadata not limited to 429s, and
+that on a 477 you must *not* wait and retry the same token — an invalid token is
+invalid, and waiting changes nothing. The escalating numbers look exactly like
+rate limiting and are not. Corrected 2026-08-02, after the wrong explanation had
+been repeated between two codebases and written down here as fact.
+
+**Enable refresh tokens on the Todoist app.** Without them, Todoist issues
+tokens with no `expires_in` and no refresh path: they die and can only be fixed
+by re-authorising by hand, which is what produced two lapses in twenty hours.
+With them, the token refreshes on demand and the daily re-auth disappears.
+
+Fix for a grant that has already died: `aibroker todoist auth` and one click.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekmidian/pai",
-  "version": "0.18.6",
+  "version": "0.19.0",
   "description": "PAI Knowledge OS — Personal AI Infrastructure with federated memory and project management",
   "type": "module",
   "main": "dist/index.mjs",