@tekmidian/pai 0.18.6 → 0.20.0

package/docs/commands/README.md

@@ -139,6 +139,7 @@ Generated man pages for every `pai` command area. Read any page in the terminal
 | `pai registry lookup` | Find the project slug for a filesystem path (for use in scripts) |
 | `pai registry migrate` | Import data from ~/.claude/session-registry.json |
 | `pai registry rebuild` | Erase all registry data and rebuild from the filesystem (destructive) |
+| `pai registry reconnect` | Point projects back at the transcripts they lost. |
 | `pai registry scan` | Walk ~/.claude/projects/ and configured scan_dirs, upsert all projects |
 | `pai registry stats` | Show summary statistics for the registry |
 | `pai restore` | Restore from a backup directory (created by pai backup) |
@@ -167,7 +168,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/registry.md

@@ -19,6 +19,7 @@ pai registry <subcommand> [options]
 | [`pai registry stats`](#pai-registry-stats) | Show summary statistics for the registry |
 | [`pai registry rebuild`](#pai-registry-rebuild) | Erase all registry data and rebuild from the filesystem (destructive) |
 | [`pai registry dedupe`](#pai-registry-dedupe) | Merge registry rows that describe the same project. |
+| [`pai registry reconnect`](#pai-registry-reconnect) | Point projects back at the transcripts they lost. |
 | [`pai registry lookup`](#pai-registry-lookup) | Find the project slug for a filesystem path (for use in scripts) |
 
 ### pai registry scan
@@ -66,6 +67,23 @@ Dry-run by default; --execute backs up the registry first and merges in one tran
 | `--execute` | Actually perform the merge (default is dry-run) |  |
 
 
+### pai registry reconnect
+
+Point projects back at the transcripts they lost.
+
+A project's encoded_dir is written once and never updated when the project
+moves, so handovers, session digests and checkpoints silently find nothing.
+Repairs are read from the transcripts themselves — each records the cwd it ran
+in — rather than re-derived from the naming rule that broke.
+Dry-run by default; --execute writes the corrected rows in one transaction.
+
+**Options**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--execute` | Actually write the corrections (default is dry-run) |  |
+
+
 ### pai registry lookup
 
 Find the project slug for a filesystem path (for use in scripts)

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.20.0",
   "description": "PAI Knowledge OS — Personal AI Infrastructure with federated memory and project management",
   "type": "module",
   "main": "dist/index.mjs",