linear-sdk-cli 0.5.2 → 0.6.0

package/src/commands/project-label.ts

@@ -0,0 +1,144 @@
+/** `linear project-label` — manage labels that apply to projects, not issues. */
+
+import { Command } from "commander";
+import type { Context } from "../context.js";
+import { action } from "../lib/action.js";
+import { confirmDestructive, promptInput } from "../lib/prompt.js";
+import type { Column } from "../output/table.js";
+import * as svc from "../services/project-label.js";
+
+const COLUMNS: Column<svc.ProjectLabelRow>[] = [
+  { key: "name", header: "Name", value: (label) => label.name, max: 30 },
+  { key: "color", header: "Color", value: (label) => label.color },
+  { key: "group", header: "Group", value: (label) => (label.isGroup ? "yes" : "—") },
+  { key: "parent", header: "Parent", value: (label) => label.parent?.name ?? "—" },
+  { key: "retired", header: "Retired", value: (label) => (label.retiredAt ? "yes" : "—") },
+];
+
+const receipt = (label: { id: string; name: string; color: string }) => ({
+  id: label.id,
+  name: label.name,
+  color: label.color,
+});
+
+export function registerProjectLabel(program: Command): void {
+  const labels = program
+    .command("project-label")
+    .alias("pl")
+    .description("Manage project labels (distinct from issue labels)");
+
+  labels
+    .command("list")
+    .alias("ls")
+    .description("List project labels")
+    .option("--include-retired", "include labels retired from new project assignment")
+    .action(
+      action(async (ctx: Context, opts) => {
+        const rows = await svc.listProjectLabels(ctx.client, ctx.limit, !!opts.includeRetired);
+        ctx.output.list(rows, COLUMNS, rows);
+      }),
+    );
+
+  labels
+    .command("view <name-or-id>")
+    .description("View a project label or label group by exact name or id")
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const label = await svc.getProjectLabel(ctx.client, input);
+        ctx.output.emit(label, () =>
+          ctx.output.detail(label.name, [
+            ["ID", label.id],
+            ["Color", label.color],
+            ["Description", label.description],
+            ["Group", label.isGroup ? "yes" : "no"],
+            ["Parent", label.parent?.name ?? null],
+            ["Retired", label.retiredAt],
+            [
+              "Children",
+              label.children.length ? label.children.map((child) => child.name).join(", ") : null,
+            ],
+          ]),
+        );
+      }),
+    );
+
+  labels
+    .command("create")
+    .alias("new")
+    .description("Create a project label or label group")
+    .option("--name <name>", "project label name")
+    .option("--color <hex>", "label color (six-digit hex, e.g. #5E6AD2)")
+    .option("-d, --description <text>", "label description")
+    .option("--group", "create a non-assignable label group")
+    .option("--parent <name-or-id>", "put the label in this group")
+    .action(
+      action(async (ctx: Context, opts) => {
+        let name: string | undefined = opts.name;
+        if (!name) name = await promptInput(ctx, "Name:", { required: true });
+        const label = await svc.createProjectLabel(ctx.client, { ...opts, name });
+        ctx.output.emit(receipt(label), () =>
+          ctx.output.success(`Created project label ${label.name}`),
+        );
+      }),
+    );
+
+  labels
+    .command("update <name-or-id>")
+    .alias("edit")
+    .description("Update a project label by exact name or id")
+    .option("--name <name>", "new name")
+    .option("--color <hex>", "new color (six-digit hex, e.g. #5E6AD2)")
+    .option("-d, --description <text>", "new description")
+    .option("--parent <name-or-id>", "move the label into this group")
+    .option("--clear-parent", "remove the label from its group")
+    .action(
+      action(async (ctx: Context, opts, input: string) => {
+        const label = await svc.updateProjectLabel(ctx.client, input, opts);
+        ctx.output.emit(receipt(label), () =>
+          ctx.output.success(`Updated project label ${label.name}`),
+        );
+      }),
+    );
+
+  labels
+    .command("retire <name-or-id>")
+    .description("Retire a label so it cannot be assigned to new projects")
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const current = await svc.getProjectLabel(ctx.client, input);
+        if (!(await confirmDestructive(ctx, `Retire project label ${current.name}?`))) return;
+        const label = await svc.retireProjectLabel(ctx.client, current.id);
+        ctx.output.emit({ id: label.id, name: label.name, retired: true }, () =>
+          ctx.output.success(`Retired project label ${label.name}`),
+        );
+      }),
+    );
+
+  labels
+    .command("restore <name-or-id>")
+    .alias("unretire")
+    .description("Restore a retired project label")
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const label = await svc.restoreProjectLabel(ctx.client, input);
+        ctx.output.emit({ id: label.id, name: label.name, restored: true }, () =>
+          ctx.output.success(`Restored project label ${label.name}`),
+        );
+      }),
+    );
+
+  labels
+    .command("delete <name-or-id>")
+    .alias("rm")
+    .description("Permanently delete a project label")
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const current = await svc.getProjectLabel(ctx.client, input);
+        if (!(await confirmDestructive(ctx, `Delete project label ${current.name}?`))) return;
+        const label = await svc.deleteProjectLabel(ctx.client, current.id);
+        ctx.output.emit({ id: label.id, name: label.name, deleted: true }, () =>
+          ctx.output.success(`Deleted project label ${label.name}`),
+        );
+      }),
+    );
+}

package/src/commands/project-status.ts

@@ -0,0 +1,166 @@
+/** `linear project-status` — manage workspace project-status definitions. */
+
+import { Command } from "commander";
+import type { Context } from "../context.js";
+import { action } from "../lib/action.js";
+import { resolveBody } from "../lib/body.js";
+import { usageError } from "../lib/errors.js";
+import { confirmDestructive, promptInput } from "../lib/prompt.js";
+import type { Column } from "../output/table.js";
+import * as svc from "../services/project-status.js";
+
+const ROW_COLUMNS: Column<svc.ProjectStatusRow>[] = [
+  { key: "name", header: "Name", value: (r) => r.name, max: 28 },
+  { key: "type", header: "Type", value: (r) => r.type },
+  { key: "position", header: "Pos", value: (r) => r.position },
+  { key: "color", header: "Color", value: (r) => r.color },
+  { key: "indefinite", header: "Indefinite", value: (r) => (r.indefinite ? "yes" : "no") },
+  { key: "archived", header: "Archived", value: (r) => (r.archivedAt ? "yes" : "no") },
+];
+
+export function registerProjectStatus(program: Command): void {
+  const status = program
+    .command("project-status")
+    .alias("project-statuses")
+    .description("Manage workspace project-status definitions");
+
+  status
+    .command("list")
+    .alias("ls")
+    .description("List workspace project statuses")
+    .option("--include-archived", "include archived project statuses")
+    .action(
+      action(async (ctx: Context, opts) => {
+        const rows = await svc.listProjectStatuses(ctx.client, ctx.limit, !!opts.includeArchived);
+        ctx.output.list(rows, ROW_COLUMNS, rows);
+      }),
+    );
+
+  status
+    .command("view <name-or-id>")
+    .description("Show a project status by exact name or id")
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const detail = await svc.getProjectStatusDetail(ctx.client, input);
+        ctx.output.detail(detail, [
+          ["Project status", detail.name],
+          ["ID", detail.id],
+          ["Type", detail.type],
+          ["Position", detail.position],
+          ["Color", detail.color],
+          ["Indefinite", detail.indefinite],
+          ["Archived", detail.archivedAt],
+          ["Description", detail.description ? `\n${detail.description}` : null],
+          ["Created", detail.createdAt],
+          ["Updated", detail.updatedAt],
+        ]);
+      }),
+    );
+
+  status
+    .command("create")
+    .alias("new")
+    .description("Create a workspace project status (explicit because duplicate names are valid)")
+    .option("--name <name>", "status name")
+    .option("-d, --description <text>", "status description")
+    .option("--description-file <path>", "read description from a file ('-' = stdin)")
+    .option("--color <hex>", "six-digit hex color (e.g. #5E6AD2)")
+    .option("--position <number>", "position within the status type", parseNumber)
+    .option("--type <type>", `status type (${svc.PROJECT_STATUS_TYPES.join("|")})`)
+    .option("--indefinite", "allow projects to remain in this status indefinitely")
+    .action(
+      action(async (ctx: Context, opts) => {
+        let name: string | undefined = opts.name;
+        if (!name) name = await promptInput(ctx, "Name:", { required: true });
+        const created = await svc.createProjectStatus(ctx.client, {
+          name,
+          description: resolveBody({
+            arg: opts.description,
+            file: opts.descriptionFile,
+            interactive: false,
+          }),
+          color: opts.color,
+          position: opts.position,
+          type: opts.type,
+          indefinite: opts.indefinite,
+        });
+        ctx.output.emit(statusReceipt(created), () =>
+          ctx.output.success(`Created project status ${created.name}`),
+        );
+      }),
+    );
+
+  status
+    .command("update <name-or-id>")
+    .alias("edit")
+    .description("Update a project status by exact name or id")
+    .option("--name <name>", "new status name")
+    .option("-d, --description <text>", "new status description")
+    .option("--description-file <path>", "read description from a file ('-' = stdin)")
+    .option("--color <hex>", "six-digit hex color (e.g. #5E6AD2)")
+    .option("--position <number>", "position within the status type", parseNumber)
+    .option("--type <type>", `status type (${svc.PROJECT_STATUS_TYPES.join("|")})`)
+    .option("--indefinite", "allow projects to remain in this status indefinitely")
+    .option("--no-indefinite", "do not allow projects to remain indefinitely")
+    .action(
+      action(async (ctx: Context, opts, input: string) => {
+        const updated = await svc.updateProjectStatus(ctx.client, input, {
+          name: opts.name,
+          description: resolveBody({
+            arg: opts.description,
+            file: opts.descriptionFile,
+            interactive: false,
+          }),
+          color: opts.color,
+          position: opts.position,
+          type: opts.type,
+          indefinite: opts.indefinite,
+        });
+        ctx.output.emit(statusReceipt(updated), () =>
+          ctx.output.success(`Updated project status ${updated.name}`),
+        );
+      }),
+    );
+
+  status
+    .command("archive <name-or-id>")
+    .description(
+      "Archive a project status (requires no active projects and another status of its type)",
+    )
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const detail = await svc.getProjectStatusDetail(ctx.client, input);
+        if (!(await confirmDestructive(ctx, `Archive project status ${detail.name}?`))) return;
+        const archived = await svc.archiveProjectStatus(ctx.client, detail.id);
+        ctx.output.emit({ id: archived.id, name: archived.name, archived: true }, () =>
+          ctx.output.success(`Archived project status ${archived.name}`),
+        );
+      }),
+    );
+
+  status
+    .command("unarchive <name-or-id>")
+    .description("Unarchive a project status by exact name or id")
+    .action(
+      action(async (ctx: Context, _opts, input: string) => {
+        const restored = await svc.unarchiveProjectStatus(ctx.client, input);
+        ctx.output.emit({ id: restored.id, name: restored.name, archived: false }, () =>
+          ctx.output.success(`Unarchived project status ${restored.name}`),
+        );
+      }),
+    );
+}
+
+function statusReceipt(status: any) {
+  return {
+    id: status.id,
+    name: status.name,
+    type: status.type,
+  };
+}
+
+function parseNumber(value: string): number {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) throw usageError(`Invalid number '${value}'.`);
+  return parsed;
+}

package/src/commands/project.ts

@@ -165,7 +165,11 @@ export function registerProject(program: Command): void {
     .option("--start <date>", "planned start date (YYYY-MM-DD)")
     .option("--target <date>", "planned target date (YYYY-MM-DD)")
     .option("-P, --priority <0-4>", "priority (0 none, 1 urgent … 4 low)", parseIntOption)
-    .option("-l, --label <name>", "project label (repeatable / comma-separated)", parseList)
+    .option(
+      "-l, --label <name>",
+      "project label from `project-label list` (repeatable / comma-separated)",
+      parseList,
+    )
     .option("--icon <name>", "Linear icon name, capitalized (e.g. Rocket)")
     .option("--color <hex>", "project color (e.g. #EB5757)")
     .addHelpText(
@@ -243,7 +247,11 @@ export function registerProject(program: Command): void {
     .option("--start <date>", "planned start date (YYYY-MM-DD)")
     .option("--target <date>", "planned target date (YYYY-MM-DD)")
     .option("-P, --priority <0-4>", "priority (0 none, 1 urgent … 4 low)", parseIntOption)
-    .option("-l, --label <name>", "replace the labels (repeatable / comma-separated)", parseList)
+    .option(
+      "-l, --label <name>",
+      "replace project labels from `project-label list` (repeatable / comma-separated)",
+      parseList,
+    )
     .option("--icon <name>", "Linear icon name, capitalized (e.g. Rocket)")
     .option("--color <hex>", "project color (e.g. #EB5757)")
     // `-t/--team` is a global on every other command, so it is the flag a user

package/src/lib/action.ts

@@ -8,6 +8,7 @@
 
 import type { Command } from "commander";
 import { Context, type GlobalOptions } from "../context.js";
+import { enrichAuthorizationError } from "./authorization.js";
 
 export type ActionHandler = (
   ctx: Context,
@@ -29,6 +30,10 @@ export function action(handler: ActionHandler) {
       ["config", "open", "commands", "completion"].includes(group.name()) ||
       (group.name() === "auth" && !["whoami", "status", "token"].includes(command.name()));
     if (!offline) await ctx.selectWorkspace();
-    await handler(ctx, localOpts, ...positionals);
+    try {
+      await handler(ctx, localOpts, ...positionals);
+    } catch (error) {
+      throw enrichAuthorizationError(error, ctx.config);
+    }
   };
 }

package/src/lib/authorization.ts

@@ -0,0 +1,91 @@
+import type { ResolvedConfig } from "../config.js";
+import { CliError, normalizeError } from "./errors.js";
+
+export type CredentialType = "api-key" | "oauth-access-token" | "oauth-user" | null;
+export type ScopeVisibility = "known" | "unknown" | "unavailable";
+
+export interface AuthorizationCapabilities {
+  credentialType: CredentialType;
+  scopeVisibility: ScopeVisibility;
+  scopes: string[] | null;
+  adminScope: boolean | null;
+  note: string;
+}
+
+export function credentialType(config: ResolvedConfig): CredentialType {
+  if (config.oauthCredential) return "oauth-user";
+  if (config.accessToken) return "oauth-access-token";
+  if (config.apiKey) return "api-key";
+  return null;
+}
+
+/**
+ * Report only capabilities the CLI can establish without probing a mutation.
+ * Stored OAuth grants carry their requested scopes. Linear exposes no safe
+ * read-only scope introspection for personal API keys or injected access tokens.
+ */
+export function authorizationCapabilities(config: ResolvedConfig): AuthorizationCapabilities {
+  const type = credentialType(config);
+  if (config.oauthCredential) {
+    const scopes = [...config.oauthCredential.scopes];
+    return {
+      credentialType: type,
+      scopeVisibility: "known",
+      scopes,
+      adminScope: scopes.includes("admin"),
+      note: "Stored OAuth grant scopes are known; workspace role is a separate authorization check.",
+    };
+  }
+  if (type) {
+    return {
+      credentialType: type,
+      scopeVisibility: "unknown",
+      scopes: null,
+      adminScope: null,
+      note:
+        type === "api-key"
+          ? "Linear does not expose personal API-key scopes for read-only introspection; workspace role alone does not prove admin-scope access."
+          : "Injected OAuth token scopes are not available to the CLI; workspace role alone does not prove admin-scope access.",
+    };
+  }
+  return {
+    credentialType: null,
+    scopeVisibility: "unavailable",
+    scopes: null,
+    adminScope: null,
+    note: "No active credential is available to inspect.",
+  };
+}
+
+function requiredScope(error: CliError): string | undefined {
+  const text = [error.message, JSON.stringify(error.detail ?? "")].join(" ");
+  if (/admin[^.]{0,40}scope|scope[^.]{0,40}admin/i.test(text)) return "admin";
+  return undefined;
+}
+
+/** Add safe, stable authorization context to scope-related forbidden failures. */
+export function enrichAuthorizationError(error: unknown, config: ResolvedConfig): CliError {
+  const normalized = normalizeError(error);
+  if (normalized.code !== "forbidden") return normalized;
+  const required = requiredScope(normalized);
+  if (!required) return normalized;
+
+  const capabilities = authorizationCapabilities(config);
+  const remediation =
+    capabilities.credentialType === "oauth-user"
+      ? "Re-authenticate with `linear auth login --admin`; member admin status alone is insufficient."
+      : "Use a credential authorized for the admin scope; member admin status alone is insufficient.";
+  return new CliError(
+    normalized.message,
+    normalized.code,
+    normalized.detail,
+    normalized.suggestion ?? remediation,
+    {
+      requiredScope: required,
+      credentialType: capabilities.credentialType,
+      scopeVisibility: capabilities.scopeVisibility,
+      grantedScopes: capabilities.scopes,
+      remediation,
+    },
+  );
+}

package/src/lib/errors.ts

@@ -52,14 +52,23 @@ export class CliError extends Error {
   readonly detail?: unknown;
   /** A separately actionable hint; machine callers never have to parse prose. */
   readonly suggestion?: string;
-
-  constructor(message: string, code: ErrorCode = "runtime", detail?: unknown, suggestion?: string) {
+  /** Stable, safe machine-readable context; unlike `detail`, this needs no --debug. */
+  readonly details?: Record<string, unknown>;
+
+  constructor(
+    message: string,
+    code: ErrorCode = "runtime",
+    detail?: unknown,
+    suggestion?: string,
+    details?: Record<string, unknown>,
+  ) {
     super(message);
     this.name = "CliError";
     this.code = code;
     this.exitCode = EXIT_BY_CODE[code];
     this.detail = detail;
     this.suggestion = suggestion;
+    this.details = details;
   }
 }
 

package/src/lib/options.ts

@@ -399,6 +399,10 @@ export const FIELDS_COMMANDS: ReadonlySet<string> = new Set([
   "project list",
   "project view",
   "project milestones",
+  "project-status list",
+  "project-status view",
+  "project-label list",
+  "project-label view",
   "project-update list",
   "roadmap list",
   "roadmap view",
@@ -444,6 +448,8 @@ export const LIMIT_COMMANDS: ReadonlySet<string> = new Set([
   "organization invites",
   "project list",
   "project milestones",
+  "project-status list",
+  "project-label list",
   "project-update list",
   "roadmap list",
   "state list",
@@ -510,7 +516,10 @@ export const YES_COMMANDS: ReadonlySet<string> = new Set([
   "milestone delete",
   "notification archive",
   "project archive",
+  "project-status archive",
   "project delete",
+  "project-label retire",
+  "project-label delete",
   "roadmap delete",
   "team delete",
   "webhook delete",

package/src/lib/output-shapes.ts

@@ -51,6 +51,11 @@ import {
   PROJECT_MILESTONE_ROW_SHAPE,
   PROJECT_ROW_SHAPE,
 } from "../services/project.js";
+import {
+  PROJECT_STATUS_DETAIL_SHAPE,
+  PROJECT_STATUS_ROW_SHAPE,
+} from "../services/project-status.js";
+import { PROJECT_LABEL_DETAIL_SHAPE, PROJECT_LABEL_ROW_SHAPE } from "../services/project-label.js";
 import { ROADMAP_DETAIL_SHAPE, ROADMAP_ROW_SHAPE } from "../services/roadmap.js";
 import { STATE_DETAIL_SHAPE, STATE_ROW_SHAPE } from "../services/state.js";
 import {
@@ -140,6 +145,14 @@ const UPDATE_RECEIPT_SHAPE = shape<UpdateRow & { url: string }>({
   url: "string",
 });
 
+const AUTHORIZATION_CAPABILITIES: ObjectFields = {
+  credentialType: "string|null",
+  scopeVisibility: "string",
+  scopes: { nullable: ["string"] },
+  adminScope: "boolean|null",
+  note: "string",
+};
+
 /** `whoami` / `auth whoami`. */
 const WHOAMI_SHAPE: ObjectFields = {
   id: "string",
@@ -147,6 +160,7 @@ const WHOAMI_SHAPE: ObjectFields = {
   displayName: "string",
   email: "string",
   admin: "boolean",
+  authorization: AUTHORIZATION_CAPABILITIES,
   organization: { id: "string", name: "string", urlKey: "string" },
 };
 
@@ -348,6 +362,9 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
     keyring: "string|null",
     scopes: { nullable: ["string"] },
     expiresAt: "string|null",
+    scopeVisibility: "string",
+    adminScope: "boolean|null",
+    scopeNote: "string",
   }),
   "auth token": object({ apiKey: "string", workspace: "string|null" }),
   "auth whoami": WHOAMI,
@@ -620,6 +637,31 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
   "project update": receipt(NAMED_URL_RECEIPT),
   "project view": object(PROJECT_DETAIL_SHAPE),
 
+  "project-status": null,
+  "project-status archive": receipt({ id: "string", name: "string", archived: "boolean" }),
+  "project-status create": receipt({
+    id: "string",
+    name: "string",
+    type: "string",
+  }),
+  "project-status list": list(PROJECT_STATUS_ROW_SHAPE),
+  "project-status unarchive": receipt({ id: "string", name: "string", archived: "boolean" }),
+  "project-status update": receipt({
+    id: "string",
+    name: "string",
+    type: "string",
+  }),
+  "project-status view": object(PROJECT_STATUS_DETAIL_SHAPE),
+
+  "project-label": null,
+  "project-label create": receipt({ id: "string", name: "string", color: "string" }),
+  "project-label delete": receipt(NAMED_DELETED),
+  "project-label list": list(PROJECT_LABEL_ROW_SHAPE),
+  "project-label restore": receipt({ id: "string", name: "string", restored: "boolean" }),
+  "project-label retire": receipt({ id: "string", name: "string", retired: "boolean" }),
+  "project-label update": receipt({ id: "string", name: "string", color: "string" }),
+  "project-label view": object(PROJECT_LABEL_DETAIL_SHAPE),
+
   "project-update": null,
   "project-update create": receipt(UPDATE_RECEIPT_SHAPE),
   "project-update list": list(UPDATE_ROW_SHAPE),

package/src/lib/resolve.ts

@@ -315,10 +315,15 @@ export async function resolveProjectLabelIds(
   client: LinearClient,
   names: string[],
 ): Promise<string[]> {
-  const ids: string[] = [];
+  const labels: any[] = [];
   for (const name of names) {
     if (isUuid(name)) {
-      ids.push(name);
+      const label: any = await withRetry(() => (client as any).projectLabel(name));
+      if (label.isGroup)
+        throw usageError(`Project label '${label.name}' is a group and cannot be assigned.`);
+      if (label.retiredAt || label.retiredById)
+        throw usageError(`Project label '${label.name}' is retired and cannot be assigned.`);
+      labels.push(label);
       continue;
     }
     const conn: any = await withRetry(() =>
@@ -327,21 +332,33 @@ export async function resolveProjectLabelIds(
         first: RESOLVE_PAGE,
       }),
     );
-    const nodes = await scanAll<any>(conn, "project labels", "linear project label list");
-    const candidates = nodes.filter((l) => !l.isGroup);
+    const nodes = await scanAll<any>(conn, "project labels", "linear project-label list");
+    const candidates = nodes.filter((l) => !l.isGroup && !l.retiredAt && !l.retiredById);
     if (candidates.length === 0)
       throw notFound(
-        `No project label matching '${name}'. Run 'linear project label list' to see the options.`,
+        `No project label matching '${name}'. Run 'linear project-label list' to see the options.`,
       );
 
     const exact = candidates.filter((l) => l.name === name);
     const finalists = exact.length ? exact : candidates;
     if (finalists.length > 1)
       throw ambiguous(`Multiple project labels named '${name}'; pass the label id instead.`);
-    ids.push(finalists[0]!.id);
+    labels.push(finalists[0]!);
+  }
+  const byParent = new Map<string, any>();
+  for (const label of labels) {
+    const parentId = label.parentId;
+    if (!parentId) continue;
+    const other = byParent.get(parentId);
+    if (other && other.id !== label.id) {
+      throw usageError(
+        `Project labels '${other.name}' and '${label.name}' belong to the same mutually exclusive group; choose one.`,
+      );
+    }
+    byParent.set(parentId, label);
   }
   // The same label named twice (or by name and id) must not be sent twice.
-  return [...new Set(ids)];
+  return [...new Set(labels.map((label) => label.id))];
 }
 
 /** First workflow state of a given type (lowest position) within a team. */

package/src/output/format.ts

@@ -217,6 +217,7 @@ export class Output {
       // absent entirely without --debug.
       const error: Record<string, unknown> = { message: err.message, code: err.code };
       if (err.suggestion !== undefined) error.suggestion = err.suggestion;
+      if (err.details !== undefined) error.details = err.details;
       if (showDetail) error.detail = err.detail;
       process.stderr.write(JSON.stringify({ error }) + "\n");
       return;