linear-sdk-cli 0.8.3 → 0.9.1

package/skills/linear-sdk-cli/references/release-stage.md

@@ -0,0 +1,121 @@
+# linear release-stage
+
+> Manage release stages and freeze scheduled release scope
+
+_Generated from `linear commands --json`. `linear release-stage --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `--access-token <token>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear release-stage`
+
+Manage release stages and freeze scheduled release scope
+
+```
+linear release-stage [options]
+```
+
+### `linear release-stage create`
+
+Create a stage in a release pipeline
+
+```
+linear release-stage create [options]
+```
+
+| Option                  | Description                                                  |
+| ----------------------- | ------------------------------------------------------------ |
+| `--name <name>`         | stage name                                                   |
+| `--color <hex>`         | six-digit HEX color                                          |
+| `--position <number>`   | stage ordering position                                      |
+| `--frozen <boolean>`    | exclude this started stage from automated sync (true\|false) |
+| `--pipeline <id\|slug>` | pipeline UUID or slug                                        |
+| `--type <type>`         | lifecycle stage type                                         |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+type: string
+color: string
+position: number
+frozen: boolean
+pipeline: {id: string, name: string}
+archivedAt: string | null
+```
+
+### `linear release-stage list`
+
+List stages for a pipeline UUID or slug
+
+Aliases: `ls`
+
+```
+linear release-stage list [options] <pipeline>
+```
+
+| Option               | Description             |
+| -------------------- | ----------------------- |
+| `--include-archived` | include archived stages |
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+type: string
+color: string
+position: number
+frozen: boolean
+pipeline: {id: string, name: string}
+archivedAt: string | null
+```
+
+### `linear release-stage update`
+
+Update name, color, order, or frozen state by stage UUID
+
+```
+linear release-stage update [options] <id>
+```
+
+| Option                | Description                                                  |
+| --------------------- | ------------------------------------------------------------ |
+| `--name <name>`       | stage name                                                   |
+| `--color <hex>`       | six-digit HEX color                                          |
+| `--position <number>` | stage ordering position                                      |
+| `--frozen <boolean>`  | exclude this started stage from automated sync (true\|false) |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+type: string
+color: string
+position: number
+frozen: boolean
+pipeline: {id: string, name: string}
+archivedAt: string | null
+```
+
+### `linear release-stage view`
+
+Show a release stage by UUID
+
+```
+linear release-stage view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+type: string
+color: string
+position: number
+frozen: boolean
+pipeline: {id: string, name: string}
+archivedAt: string | null
+```

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

@@ -0,0 +1,348 @@
+# linear release
+
+> Track releases and issue membership (Business/Enterprise)
+
+_Generated from `linear commands --json`. `linear release --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `--access-token <token>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear release`
+
+Track releases and issue membership (Business/Enterprise)
+
+```
+linear release [options]
+```
+
+### `linear release add-issue`
+
+Add an issue (KEY-123 or UUID) to an exact release
+
+```
+linear release add-issue [options] <id> <issue>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+releaseId: string
+issueId: string
+identifier: string
+```
+
+### `linear release complete`
+
+Complete an explicit scheduled release; may roll open issues forward
+
+```
+linear release complete [options]
+```
+
+| Option                        | Description                                                          |
+| ----------------------------- | -------------------------------------------------------------------- |
+| `--description <text>`        | release description (Markdown)                                       |
+| `--description-file <path>`   | read description from file ('-' for stdin)                           |
+| `--clear-description`         | clear the description                                                |
+| `--pipeline <id\|slug>`       | target pipeline UUID or slug                                         |
+| `--release-version <version>` | explicit release version within the pipeline (no latest fallback)    |
+| `--name <name>`               | release name                                                         |
+| `--link <label=url\|url>`     | attach an external link (repeatable)                                 |
+| `--commit-sha <sha>`          | full SHA (Linear preserves an existing SHA when targeting a version) |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+description: string | null
+issueCount: number
+```
+
+### `linear release create`
+
+Create a release (stage defaults depend on pipeline type)
+
+Aliases: `new`
+
+```
+linear release create [options]
+```
+
+| Option                        | Description                                  |
+| ----------------------------- | -------------------------------------------- |
+| `--description <text>`        | release description (Markdown)               |
+| `--description-file <path>`   | read description from file ('-' for stdin)   |
+| `--clear-description`         | clear the description                        |
+| `--name <name>`               | release name                                 |
+| `--release-version <version>` | release version (unique within the pipeline) |
+| `--commit-sha <sha>`          | full Git commit SHA                          |
+| `--stage <id>`                | stage UUID from the same pipeline            |
+| `--start-date <date>`         | estimated start date (YYYY-MM-DD)            |
+| `--target-date <date>`        | estimated completion date (YYYY-MM-DD)       |
+| `--pipeline <id\|slug>`       | pipeline UUID or slug                        |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+description: string | null
+issueCount: number
+```
+
+### `linear release issues`
+
+List issues in a release (UUID or slug)
+
+```
+linear release issues [options] <id>
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+identifier: string
+title: string
+url: string
+```
+
+### `linear release links`
+
+List external links on a release (UUID or slug)
+
+```
+linear release links [options] <id>
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+label: string | null
+url: string
+```
+
+### `linear release list`
+
+List releases, optionally scoped to a pipeline
+
+Aliases: `ls`
+
+```
+linear release list [options]
+```
+
+| Option                        | Description                     |
+| ----------------------------- | ------------------------------- |
+| `--pipeline <id\|slug>`       | filter by pipeline UUID or slug |
+| `--release-version <version>` | filter by exact version         |
+| `--stage-type <type>`         | filter by lifecycle stage type  |
+| `--include-archived`          | include archived releases       |
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+```
+
+### `linear release remove-issue`
+
+Remove an issue from an exact release
+
+```
+linear release remove-issue [options] <id> <issue>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+releaseId: string
+issue: string
+removed: boolean
+```
+
+### `linear release sync`
+
+Sync explicit issue references; continuous pipelines complete immediately
+
+```
+linear release sync [options]
+```
+
+| Option                         | Description                                                       |
+| ------------------------------ | ----------------------------------------------------------------- |
+| `--description <text>`         | release description (Markdown)                                    |
+| `--description-file <path>`    | read description from file ('-' for stdin)                        |
+| `--clear-description`          | clear the description                                             |
+| `--pipeline <id\|slug>`        | target pipeline UUID or slug                                      |
+| `--release-version <version>`  | explicit release version within the pipeline (no latest fallback) |
+| `--name <name>`                | release name                                                      |
+| `--link <label=url\|url>`      | attach an external link (repeatable)                              |
+| `--commit-sha <sha>`           | full Git commit SHA (no implicit checkout scanning)               |
+| `--issue <key[=sha]>`          | issue reference, defaulting to --commit-sha (repeatable)          |
+| `--reverted-issue <key[=sha]>` | reverted issue reference to remove (repeatable)                   |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+description: string | null
+issueCount: number
+```
+
+### `linear release update`
+
+Update exact release metadata or stage by UUID/slug
+
+Aliases: `edit`
+
+```
+linear release update [options] <id>
+```
+
+| Option                        | Description                                  |
+| ----------------------------- | -------------------------------------------- |
+| `--description <text>`        | release description (Markdown)               |
+| `--description-file <path>`   | read description from file ('-' for stdin)   |
+| `--clear-description`         | clear the description                        |
+| `--name <name>`               | release name                                 |
+| `--release-version <version>` | release version (unique within the pipeline) |
+| `--commit-sha <sha>`          | full Git commit SHA                          |
+| `--stage <id>`                | stage UUID from the same pipeline            |
+| `--start-date <date>`         | estimated start date (YYYY-MM-DD)            |
+| `--target-date <date>`        | estimated completion date (YYYY-MM-DD)       |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+description: string | null
+issueCount: number
+```
+
+### `linear release update-version`
+
+Update stage/name/links for an explicit pipeline and release version
+
+```
+linear release update-version [options]
+```
+
+| Option                        | Description                                                       |
+| ----------------------------- | ----------------------------------------------------------------- |
+| `--description <text>`        | release description (Markdown)                                    |
+| `--description-file <path>`   | read description from file ('-' for stdin)                        |
+| `--clear-description`         | clear the description                                             |
+| `--pipeline <id\|slug>`       | target pipeline UUID or slug                                      |
+| `--release-version <version>` | explicit release version within the pipeline (no latest fallback) |
+| `--name <name>`               | release name                                                      |
+| `--link <label=url\|url>`     | attach an external link (repeatable)                              |
+| `--stage <name>`              | stage name (Linear matches exact name, then normalized name)      |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+description: string | null
+issueCount: number
+```
+
+### `linear release view`
+
+Show a release by UUID or slug
+
+```
+linear release view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+version: string | null
+commitSha: string | null
+url: string
+pipeline: {id: string, name: string, type: string}
+stage: {id: string, name: string, type: string, frozen: boolean}
+startDate: string | null
+targetDate: string | null
+startedAt: string | null
+completedAt: string | null
+canceledAt: string | null
+archivedAt: string | null
+description: string | null
+issueCount: number
+```

package/src/cli.ts

@@ -19,6 +19,10 @@ import { registerProjectLabel } from "./commands/project-label.js";
 import { registerProjectUpdate } from "./commands/project-update.js";
 import { registerMilestone } from "./commands/milestone.js";
 import { registerCycle } from "./commands/cycle.js";
+import { registerRelease } from "./commands/release.js";
+import { registerReleasePipeline } from "./commands/release-pipeline.js";
+import { registerReleaseStage } from "./commands/release-stage.js";
+import { registerReleaseNote } from "./commands/release-note.js";
 import { registerUser } from "./commands/user.js";
 import { registerLabel } from "./commands/label.js";
 import { registerState } from "./commands/state.js";
@@ -94,6 +98,10 @@ export function createProgram(): Command {
   registerProjectUpdate(program);
   registerMilestone(program);
   registerCycle(program);
+  registerRelease(program);
+  registerReleasePipeline(program);
+  registerReleaseStage(program);
+  registerReleaseNote(program);
   // Phase 3: users, labels, workflow states, comments, documents, attachments, favorites.
   registerUser(program);
   registerLabel(program);

package/src/commands/issue.ts

@@ -371,8 +371,12 @@ export function registerIssue(program: Command): void {
     .option("-s, --state <name>", "workflow state name or type")
     .option("-P, --priority <0-4>", "priority", parsePriority)
     .option("-l, --label <name>", "label (repeatable / comma-separated)", parseList)
-    .option("-p, --project <name>", "project name or id")
-    .option("--milestone <name>", "project milestone (requires --project)")
+    .option("-p, --project <name>", "project name or id (overrides the configured default)")
+    .option("--no-project", "create outside any project, ignoring configured and parent defaults")
+    .option(
+      "--milestone <name>",
+      "project milestone (requires an explicit, configured, or parent project)",
+    )
     .option(CYCLE_FLAG, CYCLE_DESC)
     .option("--estimate <n>", "estimate points", parseIntOption)
     .option(
@@ -391,6 +395,7 @@ export function registerIssue(program: Command): void {
       [
         "",
         "Examples:",
+        "  linear config set project 'My Project'                      # default for this folder/repo",
         "  linear issue create --title 'Fix login' --team TES --assignee me",
         "  linear issue create --title 'Fix login' --assignee me --delegate Codex",
         "  linear issue create --title 'Fix login' --delegate Codex --dry-run --json",
@@ -438,7 +443,8 @@ export function registerIssue(program: Command): void {
             state: opts.state,
             priority: opts.priority,
             label: opts.label,
-            project: opts.project,
+            project: opts.project === false ? null : opts.project,
+            defaultProject: ctx.config.project,
             milestone: opts.milestone,
             cycle: opts.cycle,
             estimate: opts.estimate,