linear-sdk-cli 0.4.0 → 0.5.0

package/skills/linear-sdk-cli/references/issue.md

@@ -40,6 +40,7 @@ completedAt: string | null
 canceledAt: string | null
 state: {id: string, name: string, type: string} | null
 assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
 team: {id: string, key: string, name: string} | null
 project: {id: string, name: string} | null
 milestone: {id: string, name: string} | null
@@ -368,6 +369,10 @@ linear issue create [options]
 | `--description-file <path>` | read description from a file ('-' = stdin)                                                           |
 | `--editor`                  | compose the description in $EDITOR                                                                   |
 | `-a, --assignee <who>`      | assignee (me\|email\|name\|id)                                                                       |
+| `--delegate <agent>`        | delegate to an eligible agent app user (name or id)                                                  |
+| `--clear-delegate`          | explicitly create with no agent delegate                                                             |
+| `--dry-run`                 | resolve and show the delegation mutation input without writing                                       |
+| `--full-result`             | read back and verify the resulting delegate                                                          |
 | `-s, --state <name>`        | workflow state name or type                                                                          |
 | `-P, --priority <0-4>`      | priority                                                                                             |
 | `-l, --label <name>`        | label (repeatable / comma-separated)                                                                 |
@@ -397,6 +402,78 @@ checkedOut: boolean
 stateChanged: boolean
 ```
 
+With `--delegate`: the same, plus:
+
+```text
+assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
+```
+
+With `--clear-delegate`: the same, plus:
+
+```text
+assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
+```
+
+With `--dry-run`: a receipt object
+
+```text
+operation: string
+dryRun: boolean
+target: {id: string, identifier: string} | null
+input: object
+```
+
+With `--full-result`: a receipt object
+
+```text
+receipt: {id: string, identifier: string, url: string, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null}
+resource: {id: string, identifier: string, title: string, description: string | null, priority: number, priorityLabel: string, estimate: number | null, url: string, branchName: string, dueDate: string | null, createdAt: string, updatedAt: string, archivedAt: string | null, trashed: boolean, startedAt: string | null, completedAt: string | null, canceledAt: string | null, state: {id: string, name: string, type: string} | null, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null, team: {id: string, key: string, name: string} | null, project: {id: string, name: string} | null, milestone: {id: string, name: string} | null, cycle: {id: string, number: number, name: string | null} | null, parent: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null} | null, children: Array<{id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}>, labels: Array<{id: string, name: string}>, subscribers: Array<{id: string, displayName: string}>, attachments: Array<{id: string, title: string, url: string, subtitle: string | null, sourceType: string | null, createdAt: string}>, documents: Array<{id: string, title: string, slugId: string, url: string, createdAt: string, updatedAt: string}>, relations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, inverseRelations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, comments: Array<{id: string, body: string, url: string, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, user: {id: string, displayName: string} | null, externalUser: {id: string, displayName: string} | null, resolvingCommentId: string | null, resolvingUser: {id: string, displayName: string} | null}>}
+verified: boolean
+```
+
+### `linear issue delegate`
+
+Delegate an issue to an eligible agent, or --clear it. Issue defaults to the branch.
+
+```
+linear issue delegate [options] [idOrAgent] [agent]
+```
+
+| Option          | Description                                                |
+| --------------- | ---------------------------------------------------------- |
+| `--clear`       | remove the agent delegate                                  |
+| `--dry-run`     | resolve and show the exact delegateId without writing      |
+| `--full-result` | read back the full issue and verify the resulting delegate |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+identifier: string
+url: string
+assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
+```
+
+With `--dry-run`: a receipt object
+
+```text
+operation: string
+dryRun: boolean
+target: {id: string, identifier: string} | null
+input: object
+```
+
+With `--full-result`: a receipt object
+
+```text
+receipt: {id: string, identifier: string, url: string, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null}
+resource: {id: string, identifier: string, title: string, description: string | null, priority: number, priorityLabel: string, estimate: number | null, url: string, branchName: string, dueDate: string | null, createdAt: string, updatedAt: string, archivedAt: string | null, trashed: boolean, startedAt: string | null, completedAt: string | null, canceledAt: string | null, state: {id: string, name: string, type: string} | null, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null, team: {id: string, key: string, name: string} | null, project: {id: string, name: string} | null, milestone: {id: string, name: string} | null, cycle: {id: string, number: number, name: string | null} | null, parent: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null} | null, children: Array<{id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}>, labels: Array<{id: string, name: string}>, subscribers: Array<{id: string, displayName: string}>, attachments: Array<{id: string, title: string, url: string, subtitle: string | null, sourceType: string | null, createdAt: string}>, documents: Array<{id: string, title: string, slugId: string, url: string, createdAt: string, updatedAt: string}>, relations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, inverseRelations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, comments: Array<{id: string, body: string, url: string, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, user: {id: string, displayName: string} | null, externalUser: {id: string, displayName: string} | null, resolvingCommentId: string | null, resolvingUser: {id: string, displayName: string} | null}>}
+verified: boolean
+```
+
 ### `linear issue delete`
 
 Delete (trash) an issue
@@ -468,16 +545,19 @@ id: string
 
 ### `linear issue label`
 
-Add/remove labels on an issue
+Add, remove, or replace one member of a label group on an issue
 
 ```
 linear issue label [options] [id]
 ```
 
-| Option            | Description                 |
-| ----------------- | --------------------------- |
-| `--add <name>`    | add a label (repeatable)    |
-| `--remove <name>` | remove a label (repeatable) |
+| Option                      | Description                                                        |
+| --------------------------- | ------------------------------------------------------------------ |
+| `--add <name>`              | add a label (repeatable)                                           |
+| `--remove <name>`           | remove a label (repeatable)                                        |
+| `--set-group <group=label>` | replace a group's direct member (repeatable; exact name or UUID)   |
+| `--dry-run`                 | resolve and show the exact relative-label mutation without writing |
+| `--full-result`             | read back and verify the resulting group labels                    |
 
 **Output (`--json`)**: a receipt object
 
@@ -486,6 +566,35 @@ id: string
 identifier: string
 ```
 
+With `--set-group`: the same, plus:
+
+```text
+changed: boolean
+mutationSent: boolean
+groups: Array<{group: {id: string, name: string}, label: {id: string, name: string}}>
+```
+
+With `--dry-run`: a receipt object
+
+```text
+operation: string
+dryRun: boolean
+target: {id: string, identifier: string} | null
+input: object
+changed: boolean
+mutationSent: boolean
+groups: Array<{group: {id: string, name: string}, label: {id: string, name: string}}>
+```
+
+With `--full-result`: a receipt object
+
+```text
+receipt: {id: string, identifier: string, changed: boolean, mutationSent: boolean, groups: Array<{group: {id: string, name: string}, label: {id: string, name: string}}>}
+resource: {id: string, identifier: string, title: string, description: string | null, priority: number, priorityLabel: string, estimate: number | null, url: string, branchName: string, dueDate: string | null, createdAt: string, updatedAt: string, archivedAt: string | null, trashed: boolean, startedAt: string | null, completedAt: string | null, canceledAt: string | null, state: {id: string, name: string, type: string} | null, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null, team: {id: string, key: string, name: string} | null, project: {id: string, name: string} | null, milestone: {id: string, name: string} | null, cycle: {id: string, number: number, name: string | null} | null, parent: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null} | null, children: Array<{id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}>, labels: Array<{id: string, name: string}>, subscribers: Array<{id: string, displayName: string}>, attachments: Array<{id: string, title: string, url: string, subtitle: string | null, sourceType: string | null, createdAt: string}>, documents: Array<{id: string, title: string, slugId: string, url: string, createdAt: string, updatedAt: string}>, relations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, inverseRelations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, comments: Array<{id: string, body: string, url: string, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, user: {id: string, displayName: string} | null, externalUser: {id: string, displayName: string} | null, resolvingCommentId: string | null, resolvingUser: {id: string, displayName: string} | null}>}
+priorState: Array<{group: {id: string, name: string}, labels: Array<{id: string, name: string}>}>
+verified: boolean
+```
+
 ### `linear issue list`
 
 List issues with filters
@@ -496,24 +605,24 @@ Aliases: `ls`, `query`
 linear issue list [options]
 ```
 
-| Option                   | Description                                               |
-| ------------------------ | --------------------------------------------------------- |
-| `-t, --team <key>`       | filter by team key (repeatable; default: configured team) |
-| `-s, --state <name>`     | filter by workflow state name/type (repeatable)           |
-| `-a, --assignee <who>`   | filter by assignee (me\|email\|name)                      |
-| `-U, --unassigned`       | only issues with no assignee                              |
-| `-p, --project <name>`   | filter by project                                         |
-| `--project-label <name>` | filter by the project's label (excludes --project)        |
-| `--milestone <name>`     | filter by project milestone                               |
-| `-l, --label <name>`     | filter by label (repeat to narrow)                        |
-| `-P, --priority <0-4>`   | filter by priority                                        |
-| `--cycle <n>`            | cycle number, name, id, or 'current'                      |
-| `--created-after <date>` | only issues created at/after a date (YYYY-MM-DD)          |
-| `--updated-after <date>` | only issues updated at/after a date (YYYY-MM-DD)          |
-| `--all-teams`            | search every team, ignoring the default team              |
-| `--include-archived`     | include archived issues                                   |
-| `--query <text>`         | full-text search                                          |
-| `--sort <field>`         | sort order                                                |
+| Option                   | Description                                                          |
+| ------------------------ | -------------------------------------------------------------------- |
+| `-t, --team <key>`       | filter by team key (repeatable; default: configured team)            |
+| `-s, --state <name>`     | filter by workflow state name/type (repeatable)                      |
+| `-a, --assignee <who>`   | filter by assignee (me\|email\|name)                                 |
+| `-U, --unassigned`       | only issues with no assignee                                         |
+| `-p, --project <name>`   | filter by project                                                    |
+| `--project-label <name>` | filter by the project's label (excludes --project)                   |
+| `--milestone <name>`     | filter by project milestone                                          |
+| `-l, --label <name>`     | filter by label (repeat to narrow)                                   |
+| `-P, --priority <0-4>`   | filter by priority                                                   |
+| `--cycle <n>`            | cycle number, name, id, or 'current'                                 |
+| `--created-after <date>` | only issues created at/after a date (YYYY-MM-DD)                     |
+| `--updated-after <date>` | only issues updated at/after a date (YYYY-MM-DD)                     |
+| `--all-teams`            | search every team, ignoring the default team                         |
+| `--include-archived`     | include archived resources (the API may also return trashed records) |
+| `--query <text>`         | full-text search                                                     |
+| `--sort <field>`         | sort order                                                           |
 
 **Output (`--json`)**: a bare array of objects
 
@@ -547,23 +656,23 @@ List your unstarted issues (--all-states for every state)
 linear issue mine [options]
 ```
 
-| Option                   | Description                                               |
-| ------------------------ | --------------------------------------------------------- |
-| `-t, --team <key>`       | filter by team key (repeatable; default: configured team) |
-| `-s, --state <name>`     | filter by workflow state name/type (repeatable)           |
-| `-p, --project <name>`   | filter by project                                         |
-| `--project-label <name>` | filter by the project's label (excludes --project)        |
-| `--milestone <name>`     | filter by project milestone                               |
-| `-l, --label <name>`     | filter by label (repeat to narrow)                        |
-| `-P, --priority <0-4>`   | filter by priority                                        |
-| `--cycle <n>`            | cycle number, name, id, or 'current'                      |
-| `--created-after <date>` | only issues created at/after a date (YYYY-MM-DD)          |
-| `--updated-after <date>` | only issues updated at/after a date (YYYY-MM-DD)          |
-| `--all-teams`            | search every team, ignoring the default team              |
-| `--include-archived`     | include archived issues                                   |
-| `--query <text>`         | full-text search                                          |
-| `--sort <field>`         | sort order                                                |
-| `--all-states`           | include every workflow state, not just unstarted          |
+| Option                   | Description                                                          |
+| ------------------------ | -------------------------------------------------------------------- |
+| `-t, --team <key>`       | filter by team key (repeatable; default: configured team)            |
+| `-s, --state <name>`     | filter by workflow state name/type (repeatable)                      |
+| `-p, --project <name>`   | filter by project                                                    |
+| `--project-label <name>` | filter by the project's label (excludes --project)                   |
+| `--milestone <name>`     | filter by project milestone                                          |
+| `-l, --label <name>`     | filter by label (repeat to narrow)                                   |
+| `-P, --priority <0-4>`   | filter by priority                                                   |
+| `--cycle <n>`            | cycle number, name, id, or 'current'                                 |
+| `--created-after <date>` | only issues created at/after a date (YYYY-MM-DD)                     |
+| `--updated-after <date>` | only issues updated at/after a date (YYYY-MM-DD)                     |
+| `--all-teams`            | search every team, ignoring the default team                         |
+| `--include-archived`     | include archived resources (the API may also return trashed records) |
+| `--query <text>`         | full-text search                                                     |
+| `--sort <field>`         | sort order                                                           |
+| `--all-states`           | include every workflow state, not just unstarted                     |
 
 **Output (`--json`)**: a bare array of objects
 
@@ -664,23 +773,23 @@ Full-text search across issues (scoped to the default team; --all-teams widens)
 linear issue search [options] <text>
 ```
 
-| Option                   | Description                                               |
-| ------------------------ | --------------------------------------------------------- |
-| `-t, --team <key>`       | filter by team key (repeatable; default: configured team) |
-| `-s, --state <name>`     | filter by workflow state name/type (repeatable)           |
-| `-a, --assignee <who>`   | filter by assignee (me\|email\|name)                      |
-| `-U, --unassigned`       | only issues with no assignee                              |
-| `-p, --project <name>`   | filter by project                                         |
-| `--project-label <name>` | filter by the project's label (excludes --project)        |
-| `--milestone <name>`     | filter by project milestone                               |
-| `-l, --label <name>`     | filter by label (repeat to narrow)                        |
-| `-P, --priority <0-4>`   | filter by priority                                        |
-| `--cycle <n>`            | cycle number, name, id, or 'current'                      |
-| `--created-after <date>` | only issues created at/after a date (YYYY-MM-DD)          |
-| `--updated-after <date>` | only issues updated at/after a date (YYYY-MM-DD)          |
-| `--all-teams`            | search every team, ignoring the default team              |
-| `--include-archived`     | include archived issues                                   |
-| `--search-comments`      | match comment bodies as well as titles and descriptions   |
+| Option                   | Description                                                          |
+| ------------------------ | -------------------------------------------------------------------- |
+| `-t, --team <key>`       | filter by team key (repeatable; default: configured team)            |
+| `-s, --state <name>`     | filter by workflow state name/type (repeatable)                      |
+| `-a, --assignee <who>`   | filter by assignee (me\|email\|name)                                 |
+| `-U, --unassigned`       | only issues with no assignee                                         |
+| `-p, --project <name>`   | filter by project                                                    |
+| `--project-label <name>` | filter by the project's label (excludes --project)                   |
+| `--milestone <name>`     | filter by project milestone                                          |
+| `-l, --label <name>`     | filter by label (repeat to narrow)                                   |
+| `-P, --priority <0-4>`   | filter by priority                                                   |
+| `--cycle <n>`            | cycle number, name, id, or 'current'                                 |
+| `--created-after <date>` | only issues created at/after a date (YYYY-MM-DD)                     |
+| `--updated-after <date>` | only issues updated at/after a date (YYYY-MM-DD)                     |
+| `--all-teams`            | search every team, ignoring the default team                         |
+| `--include-archived`     | include archived resources (the API may also return trashed records) |
+| `--search-comments`      | match comment bodies as well as titles and descriptions              |
 
 **Output (`--json`)**: a bare array of objects
 
@@ -817,26 +926,30 @@ Aliases: `edit`
 linear issue update [options] [id]
 ```
 
-| Option                      | Description                                             |
-| --------------------------- | ------------------------------------------------------- |
-| `--title <title>`           | new title                                               |
-| `-d, --description <text>`  | new description                                         |
-| `--description-file <path>` | read description from a file ('-' = stdin)              |
-| `-t, --team <key>`          | move the issue to another team (changes its identifier) |
-| `-a, --assignee <who>`      | assignee (me\|email\|name\|id)                          |
-| `-s, --state <name>`        | workflow state name or type                             |
-| `-P, --priority <0-4>`      | priority                                                |
-| `-p, --project <name>`      | project name or id                                      |
-| `--milestone <name>`        | project milestone                                       |
-| `--cycle <n>`               | cycle number, name, id, or 'current'                    |
-| `--estimate <n>`            | estimate points                                         |
-| `--parent <id>`             | parent issue id                                         |
-| `--due <date>`              | due date (YYYY-MM-DD)                                   |
-| `-l, --label <name>`        | replace all labels (repeatable / comma-separated)       |
-| `--add-label <name>`        | add a label (repeatable)                                |
-| `--remove-label <name>`     | remove a label (repeatable)                             |
-| `--unassign`                | clear the assignee                                      |
-| `--clear-cycle`             | remove the issue from its cycle                         |
+| Option                      | Description                                                    |
+| --------------------------- | -------------------------------------------------------------- |
+| `--title <title>`           | new title                                                      |
+| `-d, --description <text>`  | new description                                                |
+| `--description-file <path>` | read description from a file ('-' = stdin)                     |
+| `-t, --team <key>`          | move the issue to another team (changes its identifier)        |
+| `-a, --assignee <who>`      | assignee (me\|email\|name\|id)                                 |
+| `--delegate <agent>`        | delegate to an eligible agent app user (name or id)            |
+| `-s, --state <name>`        | workflow state name or type                                    |
+| `-P, --priority <0-4>`      | priority                                                       |
+| `-p, --project <name>`      | project name or id                                             |
+| `--milestone <name>`        | project milestone                                              |
+| `--cycle <n>`               | cycle number, name, id, or 'current'                           |
+| `--estimate <n>`            | estimate points                                                |
+| `--parent <id>`             | parent issue id                                                |
+| `--due <date>`              | due date (YYYY-MM-DD)                                          |
+| `-l, --label <name>`        | replace all labels (repeatable / comma-separated)              |
+| `--add-label <name>`        | add a label (repeatable)                                       |
+| `--remove-label <name>`     | remove a label (repeatable)                                    |
+| `--unassign`                | clear the assignee                                             |
+| `--clear-delegate`          | remove the agent delegate                                      |
+| `--clear-cycle`             | remove the issue from its cycle                                |
+| `--dry-run`                 | resolve and show the delegation mutation input without writing |
+| `--full-result`             | read back and verify the resulting delegate                    |
 
 **Output (`--json`)**: a receipt object
 
@@ -846,6 +959,37 @@ identifier: string
 url: string
 ```
 
+With `--delegate`: the same, plus:
+
+```text
+assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
+```
+
+With `--clear-delegate`: the same, plus:
+
+```text
+assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
+```
+
+With `--dry-run`: a receipt object
+
+```text
+operation: string
+dryRun: boolean
+target: {id: string, identifier: string} | null
+input: object
+```
+
+With `--full-result`: a receipt object
+
+```text
+receipt: {id: string, identifier: string, url: string, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null}
+resource: {id: string, identifier: string, title: string, description: string | null, priority: number, priorityLabel: string, estimate: number | null, url: string, branchName: string, dueDate: string | null, createdAt: string, updatedAt: string, archivedAt: string | null, trashed: boolean, startedAt: string | null, completedAt: string | null, canceledAt: string | null, state: {id: string, name: string, type: string} | null, assignee: {id: string, displayName: string, email: string} | null, delegate: {id: string, displayName: string, name: string} | null, team: {id: string, key: string, name: string} | null, project: {id: string, name: string} | null, milestone: {id: string, name: string} | null, cycle: {id: string, number: number, name: string | null} | null, parent: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null} | null, children: Array<{id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}>, labels: Array<{id: string, name: string}>, subscribers: Array<{id: string, displayName: string}>, attachments: Array<{id: string, title: string, url: string, subtitle: string | null, sourceType: string | null, createdAt: string}>, documents: Array<{id: string, title: string, slugId: string, url: string, createdAt: string, updatedAt: string}>, relations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, inverseRelations: Array<{id: string, type: string, issue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}, relatedIssue: {id: string, identifier: string, title: string, state: {id: string, name: string, type: string} | null}}>, comments: Array<{id: string, body: string, url: string, createdAt: string, editedAt: string | null, resolvedAt: string | null, parent: {id: string} | null, user: {id: string, displayName: string} | null, externalUser: {id: string, displayName: string} | null, resolvingCommentId: string | null, resolvingUser: {id: string, displayName: string} | null}>}
+verified: boolean
+```
+
 ### `linear issue url`
 
 Print the issue URL
@@ -897,6 +1041,7 @@ completedAt: string | null
 canceledAt: string | null
 state: {id: string, name: string, type: string} | null
 assignee: {id: string, displayName: string, email: string} | null
+delegate: {id: string, displayName: string, name: string} | null
 team: {id: string, key: string, name: string} | null
 project: {id: string, name: string} | null
 milestone: {id: string, name: string} | null

package/skills/linear-sdk-cli/references/notification.md

@@ -43,9 +43,9 @@ Aliases: `ls`
 linear notification list [options]
 ```
 
-| Option               | Description                    |
-| -------------------- | ------------------------------ |
-| `--include-archived` | include archived notifications |
+| Option               | Description                                                          |
+| -------------------- | -------------------------------------------------------------------- |
+| `--include-archived` | include archived resources (the API may also return trashed records) |
 
 **Output (`--json`)**: a bare array of objects
 

package/skills/linear-sdk-cli/references/project.md

@@ -39,6 +39,7 @@ createdAt: string
 updatedAt: string
 completedAt: string | null
 archivedAt: string | null
+trashed: boolean
 lead: {id: string, displayName: string, email: string} | null
 teams: Array<{id: string, key: string, name: string}>
 members: Array<{id: string, displayName: string, email: string}>
@@ -125,10 +126,11 @@ Aliases: `ls`
 linear project list [options]
 ```
 
-| Option           | Description                                           |
-| ---------------- | ----------------------------------------------------- |
-| `--state <name>` | filter by status name or type (e.g. 'In QA', started) |
-| `--all-teams`    | every team's projects, ignoring the default team      |
+| Option               | Description                                                          |
+| -------------------- | -------------------------------------------------------------------- |
+| `--state <name>`     | filter by status name or type (e.g. 'In QA', started)                |
+| `--all-teams`        | every team's projects, ignoring the default team                     |
+| `--include-archived` | include archived resources (the API may also return trashed records) |
 
 **Output (`--json`)**: a bare array of objects
 
@@ -142,6 +144,8 @@ startDate: string | null
 targetDate: string | null
 status: {name: string} | null
 lead: {displayName: string} | null
+archivedAt: string | null
+trashed: boolean
 ```
 
 ### `linear project milestones`
@@ -228,6 +232,7 @@ createdAt: string
 updatedAt: string
 completedAt: string | null
 archivedAt: string | null
+trashed: boolean
 lead: {id: string, displayName: string, email: string} | null
 teams: Array<{id: string, key: string, name: string}>
 members: Array<{id: string, displayName: string, email: string}>

package/src/commands/initiative.ts

@@ -10,14 +10,26 @@ import { Command, Option } from "commander";
 import { action } from "../lib/action.js";
 import { resolveBody } from "../lib/body.js";
 import { confirmDestructive, promptInput } from "../lib/prompt.js";
-import { parseList, parseIntOption, addAliasOption, readAlias } from "../lib/options.js";
+import {
+  parseList,
+  parseIntOption,
+  addAliasOption,
+  readAlias,
+  addIncludeArchivedOption,
+} from "../lib/options.js";
 import type { Context } from "../context.js";
 import * as svc from "../services/initiative.js";
 import type { Column } from "../output/table.js";
+import { lifecycleSuffix } from "../output/lifecycle.js";
 
 const ROW_COLUMNS: Column<svc.InitiativeRow>[] = [
   { key: "name", header: "Name", value: (r) => r.name, max: 40 },
-  { key: "status", header: "Status", value: (r) => r.status ?? "—", max: 12 },
+  {
+    key: "status",
+    header: "Status",
+    value: (r) => `${r.status ?? "—"}${lifecycleSuffix(r)}`,
+    max: 24,
+  },
   {
     key: "priority",
     header: "Pri",
@@ -34,7 +46,7 @@ export function registerInitiative(program: Command): void {
     .description("Work with initiatives");
 
   // list --------------------------------------------------------------------
-  initiative
+  const list = initiative
     .command("list")
     .alias("ls")
     .description("List workspace initiatives (every status unless --status narrows)")
@@ -42,7 +54,6 @@ export function registerInitiative(program: Command): void {
     // in the tree, and a short flag means one thing everywhere here.
     .option("--status <name>", "filter by status (Planned, Active, Completed, Canceled, Proposed)")
     .option("--owner <who>", "filter by owner (me|email|name|id)")
-    .option("--archived", "include archived initiatives")
     // The reference CLI lists Active only and needs `--all-statuses` to widen;
     // this list is every status already, so the flag is accepted as the no-op
     // it is here rather than failing a transplanted script.
@@ -52,11 +63,13 @@ export function registerInitiative(program: Command): void {
         const rows = await svc.listInitiatives(ctx.client, ctx.limit, {
           status: opts.status,
           owner: opts.owner,
-          archived: !!opts.archived,
+          includeArchived: !!readAlias<boolean>(opts, "--include-archived", "--archived"),
         });
         ctx.output.list(rows, ROW_COLUMNS, rows);
       }),
     );
+  addIncludeArchivedOption(list);
+  list.addOption(new Option("--archived", "compatibility alias of --include-archived"));
 
   // view --------------------------------------------------------------------
   initiative
@@ -68,7 +81,11 @@ export function registerInitiative(program: Command): void {
         const detail = await svc.getInitiativeDetail(ctx.client, idArg);
         ctx.output.detail(detail, [
           ["Initiative", detail.name],
-          ["Archived", detail.archivedAt ? `YES (${detail.archivedAt})` : null],
+          [
+            "Trashed",
+            detail.trashed ? `YES (deleted ${detail.archivedAt ?? "at an unknown time"})` : null,
+          ],
+          ["Archived", !detail.trashed && detail.archivedAt ? `YES (${detail.archivedAt})` : null],
           ["Status", detail.status],
           ["Priority", detail.priority ? detail.priorityLabel : null],
           ["Labels", detail.labels.length ? detail.labels.join(", ") : null],