@skrr-ai/cli 0.1.22 → 0.1.24

package/README.md

@@ -12,50 +12,54 @@ observability), and shared links.
 
 ### Command Catalog
 
-| Topic                                 | Commands                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **auth**                              | `login`, `logout`, `whoami`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| **convos**                            | `list` (`--agent`, `--search`, `--tag`, `--archived`, `--order`), `show`, `update`, `delete`, `archive`, `unarchive`, `fork`, `duplicate`, `import`                                                                                                                                                                                                                                                                                                                                                             |
-| **messages**                          | `list` (`--limit`, `--head`), `show`, `update`, `update-content`, `feedback`, `edit-artifact`                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| **agent call**                        | `request`, `show`, `cancel` — autonomous Agent → owner app voice-call invites; the owner must accept before a LiveKit call starts                                                                                                                                                                                                                                                                                                                                                                               |
-| **shares** (conversation share links) | `list`, `get`, `link-for`, `create`, `update`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| **agents**                            | `list`, `show`, `overview`, `chat`, `create`, `update`, `attach-harness`, `delete`, `duplicate`, `revert`, `versions`, `visibility`, `schedule`, `upcoming`, `plan-day`, `reflect`, `schedule-overview`, `activity`                                                                                                                                                                                                                                                                                             |
-| **agents triggers**                   | `list`, `create`, `show`, `update`, `enable`, `disable`, `fire`, `delete`, `runs`, `replay`, `policy` (agent-scoped facade over the universal trigger engine)                                                                                                                                                                                                                                                                                                                                                   |
-| **agents todos**                      | `list`, `create`, `cancel` (the day-plan feed; Smart Schedule = `agents plan-day`)                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **agent-groups**                      | `list`, `show`, `create`, `update`, `delete`, `add`, `remove`                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| **agent-shares**                      | `received`, `sent`, `with`, `list-for`, `create`, `accept`, `decline`, `revoke`, `leave`                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| **triggers**                          | `list`, `show`, `create`, `update`, `delete`, `enable`, `disable`, `fire`, `fire-detail`, `replay`, `audit`, `capabilities`, `event-catalog`, `parse-intent`, `rotate-secret`                                                                                                                                                                                                                                                                                                                                   |
-| **spaces**                            | `list`, `show`, `create`, `update`, `delete`, `archive`, `unarchive`, `tasks`, `conversations`, `snapshot`, `goals`, `revisions`, `subspaces`, `move`, `reorder`, `pin`, `summary`, `bootstrap`, `capacity`, `auto-executor update/preview/run`                                                                                                                                                                                                                                                                 |
-| **spaces members**                    | `list`, `search`, `add`, `remove`                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| **spaces briefs**                     | `list`, `get`, `set`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **spaces files**                      | `list`, `upload`, `rename`, `move`, `delete`, `folders list/create/update/delete`                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| **spaces actions**                    | `list`, `add`, `update`, `delete`, `replace`                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| **spaces views**                      | `list`, `create`, `update`, `delete`, `duplicate`, `reorder`                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| **spaces live**                       | `scene`, `cards list/create/update/delete/reorder`                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **spaces preferences**                | `show`, `tabs`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **spaces heartbeats**                 | `list`, `create`, `update`, `delete`, `status`                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **spaces triggers**                   | `show`, `set`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| **spaces widgets**                    | `list`, `add`, `remove`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| **spaces skills**                     | `list`, `add`, `remove`, `pin`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **spaces labels**                     | `list`, `add`, `remove` (attach/detach; filter with `spaces list --label`)                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| **labels**                            | `list`, `palette`, `create`, `update`, `archive`, `restore`, `delete`, `reorder` (unified labels across `user`, `space`, and `workspace` scopes)                                                                                                                                                                                                                                                                                                                                                                |
-| **chats triggers**                    | `show`, `set`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| **dm**                                | `list`, `show`, `messages`, `threads`, `thread show/messages/follow/mute/share`, `send` (agent 1:1 main chat and Slack-style Thread controls)                                                                                                                                                                                                                                                                                                                                                                   |
-| **diagnostics**                       | `context`, `doctor`, `usage`, `commands` (agent-friendly runtime identity, readiness, progressive token-budgeted discovery, and complete machine-readable schemas)                                                                                                                                                                                                                                                                                                                                             |
-| **goals**                             | `list`, `show`, `create`, `update`, `delete`, `descendants`, `tasks`, `archive`, `revisions`                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| **commitments**                       | `list`, `show`, `create`, `plan`, `preflight`, `update`, `checks`, `check-now`, `action-proposals`, `autonomy`, `pause`, `resume`, `complete`, `subject`, `attach`, `detach`, `reports`, `export`, `import`, `fork` (durable agent commitment contracts)                                                                                                                                                                                                                                                        |
-| **goals briefing**                    | `enable`, `disable`, `preview`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **tasks**                             | `list`, `show`, `create`, `upsert`, `create-tree`, `bulk-update`, `tree`, `update`, `delete`, `actionability`, `ready`, `start`, `active`, `monitor`, `watch`, `wait`, `continue-ready`, `move`, `complete`, `children`, `ancestors`, `descendants`, `activity`, `runs`, `execution-summary`, `execution-timeline`, `replay`, `checkout`, `release`, `start-all`, `cancel-cascade`, `cascade-status`, `dri-status`, `duplicate-pipeline`, `archive`, `today`, `prompt-log`, `revisions`, `transcript`, `output` |
-| **tasks input**                       | `show`, `answer`, `dismiss` (durable Human-input handoff)                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| **tasks comments**                    | `list`, `add`, `anchor`, `delete`, `resolve`, `reopen` (human collaboration threads)                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| **tasks events**                      | `append`, `list`, `tail` (canonical typed append-only task facts)                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| **tasks labels**                      | `list`, `create`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| **tasks approvals**                   | `list`, `create`, `delete`, `resolve`                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| **tasks attachments**                 | `list`, `delete`, `upload`, `download`                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| **integrations**                      | `toolkits`, `search`, `execute`, `tools list`, `tools allow`, `connections connect`, `connections list`, `connections finalize`, `connections disconnect`, `connections reconnect`                                                                                                                                                                                                                                                                                                                              |
-| **runtimes**                          | `start`, `list`, `status`, `exec`, `pull`, `connect`, `pause`, `resume`, `destroy` (OverSky Hosted Machine workspaces backed by the server runtime engine)                                                                                                                                                                                                                                                                                                                                                      |
-| **github**                            | `connect`, `finalize`, `connections`, `tools`, `run`, `allow-tools`, `reconnect`, `disconnect`                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **slack**                             | `send-as-agent`, `list-channels`, `list-users`, `read-channel`, `read-thread`, `tools`, `run`                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| Topic                                 | Commands                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **auth**                              | `login`, `logout`, `whoami`                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| **convos**                            | `list` (`--agent`, `--search`, `--tag`, `--archived`, `--order`), `show`, `update`, `delete`, `archive`, `unarchive`, `fork`, `duplicate`, `import`                                                                                                                                                                                                                                                                                                                                                   |
+| **messages**                          | `list` (`--limit`, `--head`), `show`, `update`, `update-content`, `feedback`, `edit-artifact`                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **agent call**                        | `request`, `show`, `cancel` — autonomous Agent → owner app voice-call invites; the owner must accept before a LiveKit call starts                                                                                                                                                                                                                                                                                                                                                                     |
+| **shares** (conversation share links) | `list`, `get`, `link-for`, `create`, `update`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **agents**                            | `list`, `show`, `overview`, `chat`, `create`, `update`, `attach-harness`, `delete`, `duplicate`, `revert`, `versions`, `visibility`, `schedule`, `upcoming`, `plan-day`, `reflect`, `schedule-overview`, `activity`                                                                                                                                                                                                                                                                                   |
+| **agents triggers**                   | `list`, `create`, `show`, `update`, `enable`, `disable`, `fire`, `delete`, `runs`, `replay`, `policy` (agent-scoped facade over the universal trigger engine)                                                                                                                                                                                                                                                                                                                                         |
+| **agents todos**                      | `list`, `create`, `cancel` (the day-plan feed; Smart Schedule = `agents plan-day`)                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| **agent-groups**                      | `list`, `show`, `create`, `update`, `delete`, `add`, `remove`                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **agent-shares**                      | `received`, `sent`, `with`, `list-for`, `create`, `accept`, `decline`, `revoke`, `leave`                                                                                                                                                                                                                                                                                                                                                                                                              |
+| **triggers**                          | `list`, `show`, `create`, `update`, `delete`, `enable`, `disable`, `fire`, `fire-detail`, `replay`, `audit`, `capabilities`, `event-catalog`, `parse-intent`, `rotate-secret`                                                                                                                                                                                                                                                                                                                         |
+| **spaces**                            | `list`, `show`, `create`, `update`, `delete`, `archive`, `unarchive`, `tasks`, `conversations`, `snapshot`, `goals`, `revisions`, `subspaces`, `move`, `reorder`, `pin`, `summary`, `bootstrap`, `capacity`, `auto-executor update/preview/run`                                                                                                                                                                                                                                                       |
+| **spaces members**                    | `list`, `search`, `add`, `remove`                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| **spaces briefs**                     | `list`, `get`, `set`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **spaces files**                      | `list`, `upload`, `rename`, `move`, `delete`, `folders list/create/update/delete`                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| **spaces actions**                    | `list`, `add`, `update`, `delete`, `replace`                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| **spaces views**                      | `list`, `create`, `update`, `delete`, `duplicate`, `reorder`                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| **spaces live**                       | `scene`, `cards list/create/update/delete/reorder`                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| **spaces preferences**                | `show`, `tabs`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **spaces heartbeats**                 | `list`, `create`, `update`, `delete`, `status`                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **spaces triggers**                   | `show`, `set`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **spaces widgets**                    | `list`, `add`, `remove`                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| **spaces skills**                     | `list`, `add`, `remove`, `pin`                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **spaces labels**                     | `list`, `add`, `remove` (attach/detach; filter with `spaces list --label`)                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| **labels**                            | `list`, `palette`, `create`, `update`, `archive`, `restore`, `delete`, `reorder` (unified labels across `user`, `space`, and `workspace` scopes)                                                                                                                                                                                                                                                                                                                                                      |
+| **chats triggers**                    | `show`, `set`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **dm**                                | `list`, `show`, `messages`, `threads`, `thread show/messages/follow/mute/share`, `send` (agent 1:1 main chat and Slack-style Thread controls)                                                                                                                                                                                                                                                                                                                                                         |
+| **diagnostics**                       | `context`, `doctor`, `usage`, `commands` (agent-friendly runtime identity, readiness, progressive token-budgeted discovery, and complete machine-readable schemas)                                                                                                                                                                                                                                                                                                                                    |
+| **goals**                             | `list`, `show`, `create`, `update`, `delete`, `descendants`, `tasks`, `archive`, `revisions`                                                                                                                                                                                                                                                                                                                                                                                                          |
+| **commitments**                       | `list`, `show`, `create`, `plan`, `preflight`, `update`, `checks`, `check-now`, `action-proposals`, `autonomy`, `pause`, `resume`, `complete`, `subject`, `attach`, `detach`, `reports`, `export`, `import`, `fork` (durable agent commitment contracts)                                                                                                                                                                                                                                              |
+| **goals briefing**                    | `enable`, `disable`, `preview`                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **tasks**                             | `list`, `show`, `create`, `upsert`, `create-tree`, `bulk-update`, `tree`, `update`, `delete`, `actionability`, `ready`, `start`, `active`, `monitor`, `watch`, `wait`, `continue-ready`, `move`, `complete`, `children`, `ancestors`, `descendants`, `activity`, `runs`, `execution-summary`, `execution-timeline`, `replay`, `checkout`, `release`, `start-all`, `cancel-cascade`, `cascade-status`, `dri-status`, `duplicate-pipeline`, `archive`, `today`, `prompt-log`, `revisions`, `transcript` |
+| **tasks input**                       | `show`, `answer`, `dismiss` (durable Human-input handoff)                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| **tasks comments**                    | `list`, `add`, `anchor`, `delete`, `resolve`, `reopen` (human collaboration threads)                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| **tasks updates**                     | `add`, `list` (meaningful, typed, append-only progress, findings, decisions, blockers, and verification)                                                                                                                                                                                                                                                                                                                                                                                              |
+| **tasks resume**                      | `save`, `show` (Run- and Task-spec-bound recovery snapshots)                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| **tasks result**                      | `submit`, `show` (immutable Result versions and exact Review state)                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| **tasks resource**                    | `add`, `list` (versioned inputs, references, evidence, attachments, and Deliverables)                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| **tasks deliverable**                 | `add`, `list`, `confirm` (the user-facing produced-Resource workflow)                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| **tasks labels**                      | `list`, `create`, `delete`                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| **tasks approvals**                   | `list`, `create`, `delete`, `resolve`                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| **tasks attachments**                 | `list`, `delete`, `upload`, `download`                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **integrations**                      | `toolkits`, `search`, `execute`, `tools list`, `tools allow`, `connections connect`, `connections list`, `connections finalize`, `connections disconnect`, `connections reconnect`                                                                                                                                                                                                                                                                                                                    |
+| **runtimes**                          | `start`, `list`, `status`, `exec`, `pull`, `connect`, `pause`, `resume`, `destroy` (OverSky Hosted Machine workspaces backed by the server runtime engine)                                                                                                                                                                                                                                                                                                                                            |
+| **github**                            | `connect`, `finalize`, `connections`, `tools`, `run`, `allow-tools`, `reconnect`, `disconnect`                                                                                                                                                                                                                                                                                                                                                                                                        |
+| **slack**                             | `send-as-agent`, `list-channels`, `list-users`, `read-channel`, `read-thread`, `tools`, `run`                                                                                                                                                                                                                                                                                                                                                                                                         |
 
 ### Reading history (conversations, tasks, agent output)
 
@@ -74,7 +78,7 @@ Tasks, and what the agent actually produced:
 ```bash
 sky tasks list --assignee-agent <agent-id>     # what this agent is working on
 sky tasks show <task-id>                       # includes the Convo: pointer
-sky tasks output <task-id>                     # verdict + last-run + final agent message
+sky tasks result show <task-id>                # current Result + exact Review
 sky tasks transcript <task-id> --assistant-only  # full agent transcript, no prompt
 sky tasks comments list <task-id>              # raw comment thread
 ```
@@ -1004,7 +1008,7 @@ Create persistent, personalized Task Views that can select exact task IDs or
 apply criteria across one or more Spaces. The create/show JSON response includes
 a durable `url`; opening it displays the view in a focused modal.
 
-```bash
+````bash
 sky views create --name "Launch scope" --task-id <task-id> --task-id <task-id>
 sky views create --name "Cross-space blockers" \
   --space <space-id> --space <space-id> --status blocked --group-by space
@@ -1023,7 +1027,7 @@ sky space-directory-views list --json
 sky space-directory-views create --name "Active delivery" --config '{"schemaVersion":1,"layout":"list"}' --json
 sky space-directory-views update <view-id> --version 3 --from-json ./space-view-patch.json
 sky space-directory-views delete <view-id> --version 3 --yes
-```
+````
 
 ### `sky work-views ...`
 
@@ -1036,7 +1040,8 @@ sky work-views update <view-id> --version 2 --from-json ./work-view-patch.json
 sky work-views result <view-id> --json
 sky work-views delete <view-id> --version 2 --yes
 ```
-```
+
+````
 
 ### `sky spaces live ...`
 
@@ -1050,7 +1055,7 @@ sky spaces live cards create <space-id> --kind tasks --title Tasks --slot top
 sky spaces live cards update <space-id> <card-id> --enabled
 sky spaces live cards reorder <space-id> --card <card-id> --card <other-card-id>
 sky spaces live cards delete <space-id> <card-id> --yes
-```
+````
 
 ### `sky spaces preferences ...`
 
@@ -1296,8 +1301,8 @@ positional when the current task is obvious:
 ```bash
 sky tasks show --json
 sky tasks comments add --body "Done investigating." --json # human discussion comment
-sky tasks events append --kind checkpoint --summary "Done investigating." --idempotency-key investigation-1 --json
-sky tasks complete --summary "Shipped the fix." --artifacts none --verdict approved --json
+sky tasks updates add --type progress --summary "Done investigating." --data '{"completedSinceLast":["Root cause confirmed"],"nextActions":["Implement fix"]}' --json
+sky tasks complete --summary "Shipped and verified the fix." --json
 sky tasks move --status in_progress --json
 ```
 
@@ -1508,19 +1513,21 @@ to transition between states like `todo`, `in_progress`, `blocked`, or
 
 ### `sky tasks complete [id]`
 
-Post the canonical `---TASK_OUTPUT---` closeout comment and move the task to a
-terminal status. In a task daemon session, omit the id to complete the current
-task.
+Submit one versioned Result and advance the Task workflow. An Agent-submitted
+Result stops in review until an independent reviewer accepts that exact Result;
+a machine Comment is never used as the closeout record. In a task daemon
+session, omit the id to use the bound Task and Run.
 
 ```bash
-sky tasks complete --summary "Shipped the fix." --artifacts none --verdict approved --json
-sky tasks complete <task-id> --summary "Shipped the fix." --verdict approved
-sky tasks complete --task <task-id> --status failed --summary "Blocked by missing access" --verdict blocked
-sky tasks complete --from-json task-output.json --json
+sky tasks complete --summary "Shipped and verified the fix" --deliverable <resource-link-id> --json
+sky tasks complete <task-id> --summary "Do not ship" --conclusion-type release_recommendation --conclusion-json '{"posture":"no_ship"}'
+sky tasks complete --task <task-id> --status blocked --summary "Waiting for access" --remaining "A workspace owner must grant access"
+sky tasks complete --from-json task-result.json --json
 ```
 
-`--status completed` moves the task to `done`; `--status failed` moves it to
-`failed`. Pass `--no-move` when another runner owns the status transition.
+Use `sky tasks result submit` when the Result should be recorded without a
+workflow transition. Use `sky tasks review` to accept or request changes on an
+exact Result version.
 
 ### `sky tasks delete <id>`
 
@@ -1824,19 +1831,22 @@ sky tasks list --space <space-id> --json | jq '.data[] | select(.priority == "hi
 
 The commands that move a task through its lifecycle, most to least common:
 
-| Action              | Command                                                            |
-| ------------------- | ------------------------------------------------------------------ |
-| Complete task       | `sky tasks complete [id] --summary "..." --verdict approved`       |
-| Change status       | `sky tasks move [id] --status <new-status>`                        |
-| Start execution     | `sky tasks start [id]` (optionally `--skill <id>`)                 |
-| Stop a running task | `sky tasks interrupt <id>`                                         |
-| Run via DRI agent   | `sky tasks dri-run <id>` / `sky tasks dri-plan <id>`               |
-| Schedule a fire     | `sky tasks schedule <id> --at <iso>` (`--cron …` for recurring)    |
-| Pause / resume cron | `sky tasks pause-schedule <id>` / `sky tasks resume-schedule <id>` |
-| Forward to chats    | `sky tasks forward <id> --to <group-chat-id>`                      |
-| Incremental tags    | `sky tasks tags add/remove <id> --tag …`                           |
-| Pin/unpin skills    | `sky tasks skills pin/unpin <id> <skill-id>`                       |
-| Delete              | `sky tasks delete <id>`                                            |
+| Action              | Command                                                                     |
+| ------------------- | --------------------------------------------------------------------------- |
+| Submit and advance  | `sky tasks complete [id] --summary "..."`                                   |
+| Record an update    | `sky tasks updates add [id] --type progress --summary "..." --data '{...}'` |
+| Link a deliverable  | `sky tasks deliverable add <id> <coordinate>`                               |
+| Review a Result     | `sky tasks review [id] --result-id <id> --decision accepted`                |
+| Change status       | `sky tasks move [id] --status <new-status>`                                 |
+| Start execution     | `sky tasks start [id]` (optionally `--skill <id>`)                          |
+| Stop a running task | `sky tasks interrupt <id>`                                                  |
+| Run via DRI agent   | `sky tasks dri-run <id>` / `sky tasks dri-plan <id>`                        |
+| Schedule a fire     | `sky tasks schedule <id> --at <iso>` (`--cron …` for recurring)             |
+| Pause / resume cron | `sky tasks pause-schedule <id>` / `sky tasks resume-schedule <id>`          |
+| Forward to chats    | `sky tasks forward <id> --to <group-chat-id>`                               |
+| Incremental tags    | `sky tasks tags add/remove <id> --tag …`                                    |
+| Pin/unpin skills    | `sky tasks skills pin/unpin <id> <skill-id>`                                |
+| Delete              | `sky tasks delete <id>`                                                     |
 
 `tasks update` handles every other field (title, description, priority,
 assignees, due date, goal) but explicitly does NOT touch status — use

package/bin/dev-fallback.js

@@ -0,0 +1,221 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+
+const COMMAND_BUILD_MANIFEST = 'command-source-digests.json';
+
+function sourceDigest(fileSystem, source) {
+  return crypto.createHash('sha256').update(fileSystem.readFileSync(source)).digest('hex');
+}
+
+function buildSourceFiles(fileSystem, sourceRoot) {
+  const files = [];
+  const pending = [sourceRoot];
+  while (pending.length) {
+    const directory = pending.shift();
+    let entries;
+    try {
+      entries = fileSystem.readdirSync(directory, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (entry.name === '__tests__') continue;
+      const candidate = path.join(directory, entry.name);
+      if (entry.isDirectory()) pending.push(candidate);
+      else if (
+        entry.isFile() &&
+        /\.(?:ts|tsx)$/.test(entry.name) &&
+        !/\.(?:spec|test)\.(?:ts|tsx)$/.test(entry.name)
+      ) {
+        files.push(candidate);
+      }
+    }
+  }
+  return files.sort();
+}
+
+function sourceTreeDigest(fileSystem, sourceRoot) {
+  const hash = crypto.createHash('sha256');
+  for (const source of buildSourceFiles(fileSystem, sourceRoot)) {
+    hash.update(path.relative(sourceRoot, source).split(path.sep).join('/'));
+    hash.update('\0');
+    hash.update(fileSystem.readFileSync(source));
+    hash.update('\0');
+  }
+  return hash.digest('hex');
+}
+
+function findAlternateCli({
+  commandName,
+  currentEntry,
+  requiredCommand,
+  pathValue = process.env.PATH || '',
+  fileSystem = fs,
+}) {
+  let currentRealPath;
+  try {
+    currentRealPath = fileSystem.realpathSync(currentEntry);
+  } catch {
+    currentRealPath = path.resolve(currentEntry);
+  }
+
+  for (const directory of pathValue.split(path.delimiter).filter(Boolean)) {
+    const candidate = path.join(directory, commandName);
+    try {
+      if (!fileSystem.existsSync(candidate)) continue;
+      fileSystem.accessSync(candidate, fileSystem.constants?.X_OK ?? fs.constants.X_OK);
+      const candidateRealPath = fileSystem.realpathSync(candidate);
+      if (candidateRealPath === currentRealPath) continue;
+      const candidateCommands = path.resolve(path.dirname(candidateRealPath), '../dist/commands');
+      if (
+        path.basename(candidateRealPath) === 'run.js' &&
+        !fileSystem.existsSync(candidateCommands)
+      ) {
+        continue;
+      }
+      if (
+        requiredCommand &&
+        !fileSystem.existsSync(path.join(candidateCommands, requiredCommand))
+      ) {
+        continue;
+      }
+      if (requiredCommand) {
+        const candidateRoot = path.resolve(path.dirname(candidateRealPath), '..');
+        const candidateSourceCommands = path.join(candidateRoot, 'src', 'commands');
+        const sourceStem = path.join(candidateSourceCommands, requiredCommand.replace(/\.js$/, ''));
+        const candidateSource = ['.ts', '.tsx']
+          .map((extension) => `${sourceStem}${extension}`)
+          .find((source) => fileSystem.existsSync(source));
+        // An alternate development checkout must prove that its requested
+        // command matches its own source too. Published CLIs omit `src`, so
+        // their packaged dist remains a valid fallback.
+        if (!candidateSource && fileSystem.existsSync(candidateSourceCommands)) {
+          continue;
+        }
+        if (candidateSource) {
+          let candidateManifest;
+          try {
+            candidateManifest = JSON.parse(
+              fileSystem.readFileSync(
+                path.join(candidateRoot, 'dist', COMMAND_BUILD_MANIFEST),
+                'utf8',
+              ),
+            );
+          } catch {
+            continue;
+          }
+          if (
+            candidateManifest?.sourceTreeDigest !==
+            sourceTreeDigest(fileSystem, path.join(candidateRoot, 'src'))
+          ) {
+            continue;
+          }
+          const relative = path
+            .relative(path.join(candidateRoot, 'src', 'commands'), candidateSource)
+            .split(path.sep)
+            .join('/');
+          if (
+            candidateManifest?.commands?.[relative] !== sourceDigest(fileSystem, candidateSource)
+          ) {
+            continue;
+          }
+        }
+      }
+      return candidate;
+    } catch {
+      // A stale PATH entry is not a startup failure; keep looking.
+    }
+  }
+  return null;
+}
+
+function missingLocalCommandBuild({ cliRoot, argv, fileSystem = fs, verifySourceIdentity = true }) {
+  const commandsDirectory = path.join(cliRoot, 'dist', 'commands');
+  const sourceCommandsDirectory = path.join(cliRoot, 'src', 'commands');
+  let commandBuildManifest;
+  try {
+    commandBuildManifest = JSON.parse(
+      fileSystem.readFileSync(path.join(cliRoot, 'dist', COMMAND_BUILD_MANIFEST), 'utf8'),
+    );
+  } catch {
+    commandBuildManifest = null;
+  }
+  const currentSourceTreeDigest = commandBuildManifest
+    ? sourceTreeDigest(fileSystem, path.join(cliRoot, 'src'))
+    : null;
+  const commandParts = [];
+  for (const value of argv) {
+    if (String(value).startsWith('-')) break;
+    commandParts.push(...String(value).split(':').filter(Boolean));
+  }
+  const compiledForSource = (source) => {
+    const relative = path.relative(sourceCommandsDirectory, source).replace(/\.(?:ts|tsx)$/, '.js');
+    return path.join(commandsDirectory, relative);
+  };
+  const missingOrStale = (source) => {
+    const compiled = compiledForSource(source);
+    if (!fileSystem.existsSync(compiled)) return compiled;
+    // CI creates dist from a clean checkout immediately before executing it.
+    // Source identity is a development-checkout guard; re-hashing the live
+    // source tree inside CLI integration tests adds no proof and can make test
+    // fixtures that intentionally exercise the launcher affect one another.
+    if (!verifySourceIdentity) return null;
+    try {
+      const relative = path.relative(sourceCommandsDirectory, source).split(path.sep).join('/');
+      const builtDigest = commandBuildManifest?.commands?.[relative];
+      // Git checkouts and partial builds can make old JS newer than its source.
+      // Content identity is authoritative; no digest means the development
+      // build is unproved and the installed CLI is safer.
+      return commandBuildManifest?.sourceTreeDigest === currentSourceTreeDigest &&
+        typeof builtDigest === 'string' &&
+        builtDigest === sourceDigest(fileSystem, source)
+        ? null
+        : compiled;
+    } catch {
+      return compiled;
+    }
+  };
+  for (let length = commandParts.length; length > 0; length -= 1) {
+    const relative = path.join(...commandParts.slice(0, length));
+    const source = ['.ts', '.tsx']
+      .map((extension) => path.join(cliRoot, 'src', 'commands', `${relative}${extension}`))
+      .find((candidate) => fileSystem.existsSync(candidate));
+    if (!source) continue;
+    const incomplete = missingOrStale(source);
+    if (incomplete) return incomplete;
+    break;
+  }
+  if (argv.some((value) => value === '--help' || value === '-h')) {
+    const sourceDirectory = path.join(sourceCommandsDirectory, ...commandParts);
+    const pending = [sourceDirectory];
+    while (pending.length) {
+      const current = pending.shift();
+      let entries;
+      try {
+        entries = fileSystem.readdirSync(current, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const entry of entries) {
+        if (entry.name === '__tests__') continue;
+        const candidate = path.join(current, entry.name);
+        if (entry.isDirectory()) pending.push(candidate);
+        else if (entry.isFile() && /\.(?:ts|tsx)$/.test(entry.name)) {
+          const incomplete = missingOrStale(candidate);
+          if (incomplete) return incomplete;
+        }
+      }
+    }
+  }
+  return fileSystem.existsSync(commandsDirectory) ? null : commandsDirectory;
+}
+
+module.exports = {
+  COMMAND_BUILD_MANIFEST,
+  findAlternateCli,
+  missingLocalCommandBuild,
+  sourceTreeDigest,
+};

package/bin/run.js

@@ -1,5 +1,101 @@
 #!/usr/bin/env node
 
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { findAlternateCli, missingLocalCommandBuild } = require('./dev-fallback');
+
+/**
+ * The version a CLI entry point would run, for the fallback notice. Best effort:
+ * a version we cannot read must never be the reason a command fails.
+ */
+function describeCliVersion(startPath) {
+  const fsModule = require('node:fs');
+  // Resolve through the symlink first. An installed CLI is almost always a link
+  // in a bin directory, and walking up from THAT finds nothing — which is how
+  // the version, the one fact this message exists to report, came back unknown.
+  let resolved = startPath;
+  try {
+    resolved = fsModule.realpathSync(startPath);
+  } catch {
+    // fall through to the path as given
+  }
+  let dir =
+    fsModule.existsSync(resolved) && fsModule.statSync(resolved).isDirectory()
+      ? resolved
+      : path.dirname(resolved);
+  for (let depth = 0; depth < 6; depth += 1) {
+    try {
+      const pkg = JSON.parse(
+        require('node:fs').readFileSync(path.join(dir, 'package.json'), 'utf8'),
+      );
+      if (pkg?.version) return `v${pkg.version}`;
+    } catch {
+      // keep walking
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return 'version unknown';
+}
+
+const cliRoot = path.resolve(__dirname, '..');
+const missingBuildPath = missingLocalCommandBuild({
+  cliRoot,
+  argv: process.argv.slice(2),
+  verifySourceIdentity: process.env.CI !== 'true',
+});
+if (missingBuildPath) {
+  const invokedName = path.basename(process.argv[1] || 'skrr');
+  const commandName = invokedName === 'run.js' ? 'skrr' : invokedName;
+  const fallback =
+    process.env.SKRR_DEV_FALLBACK_ACTIVE === '1'
+      ? null
+      : findAlternateCli({
+          commandName,
+          currentEntry: __filename,
+          requiredCommand: path.relative(path.join(cliRoot, 'dist', 'commands'), missingBuildPath),
+        });
+  if (fallback) {
+    // A developer verifying a change is the one caller for whom this fallback is
+    // not a safety net: it silently substitutes a DIFFERENT BUILD of the thing
+    // under test. The loop that trips it is exactly fix -> commit -> verify,
+    // because the pre-commit hook reformats staged sources and that invalidates
+    // the whole-tree digest for every command, not just the one edited.
+    //
+    // So name the substitution rather than just the fact, and let anyone who is
+    // verifying turn the fallback off outright.
+    if (process.env.SKRR_NO_DEV_FALLBACK === '1') {
+      console.error(
+        `[skrr] Refusing to fall back: SKRR_NO_DEV_FALLBACK=1 and the local build is stale at ` +
+          `${missingBuildPath}. Run "npm --prefix cli run build".`,
+      );
+      process.exit(1);
+    }
+    console.error(
+      `[skrr] Local development build is incomplete (${missingBuildPath}).\n` +
+        `[skrr] Running ${fallback} (${describeCliVersion(fallback)}) INSTEAD OF ` +
+        `this checkout (${describeCliVersion(cliRoot)}). Run "npm --prefix cli run build" to use ` +
+        `your own changes, or set SKRR_NO_DEV_FALLBACK=1 to make this an error.`,
+    );
+    const delegated = spawnSync(fallback, process.argv.slice(2), {
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+      env: { ...process.env, SKRR_DEV_FALLBACK_ACTIVE: '1' },
+    });
+    if (delegated.error) {
+      console.error(`[skrr] Could not start installed CLI ${fallback}: ${delegated.error.message}`);
+      process.exit(1);
+    }
+    process.exit(Number.isInteger(delegated.status) ? delegated.status : 1);
+  }
+  console.error(
+    `[skrr] CLI build output is missing or stale at ${missingBuildPath}. Run "npm --prefix cli run build" ` +
+      'or install @skrr-ai/cli so this development launcher has a stable fallback.',
+  );
+  process.exit(1);
+}
+
 const oclif = require('@oclif/core');
 
 // The workspace this machine works in (`sky workspaces use`) becomes