linear-sdk-cli 0.4.0 → 0.5.1

package/src/lib/options.ts

@@ -210,6 +210,20 @@ export function readAlias<T = string>(
   return (canonicalValue ?? aliasValue) as T | undefined;
 }
 
+/**
+ * Add the canonical lifecycle-listing option. Linear may return both archived
+ * and trashed records when this is true, so the help does not imply an
+ * archived-only filter.
+ */
+export function addIncludeArchivedOption(cmd: Command): Command {
+  return cmd.addOption(
+    new Option(
+      "--include-archived",
+      "include archived resources (the API may also return trashed records)",
+    ),
+  );
+}
+
 /**
  * A `--no-…` global registered as an ordinary boolean flag rather than as
  * commander's *negation* of a positive option. Two bugs came out of leaving
@@ -603,7 +617,7 @@ export function addCoreFilterOptions(cmd: Command, set: FilterOptionSet = {}): C
     cmd.addOption(new Option("-a, --assignee <who>", "filter by assignee (me|email|name)"));
     cmd.addOption(new Option("-U, --unassigned", "only issues with no assignee"));
   }
-  return cmd
+  cmd
     .addOption(new Option("-p, --project <name>", "filter by project"))
     .addOption(
       new Option("--project-label <name>", "filter by the project's label (excludes --project)"),
@@ -622,8 +636,8 @@ export function addCoreFilterOptions(cmd: Command, set: FilterOptionSet = {}): C
     .addOption(
       new Option("--updated-after <date>", "only issues updated at/after a date (YYYY-MM-DD)"),
     )
-    .addOption(new Option("--all-teams", "search every team, ignoring the default team"))
-    .addOption(new Option("--include-archived", "include archived issues"));
+    .addOption(new Option("--all-teams", "search every team, ignoring the default team"));
+  return addIncludeArchivedOption(cmd);
 }
 
 /**

package/src/lib/output-shapes.ts

@@ -154,6 +154,7 @@ const SETTING_ORIGIN_SHAPE = shape<SettingOrigin>({
   source: "string",
   "path?": "string",
   "key?": "string",
+  "workspace?": "string",
 });
 const SETTING_ORIGINS_SHAPE = shape<SettingOrigins>({
   team: SETTING_ORIGIN_SHAPE,
@@ -168,6 +169,7 @@ const CONFIG_SHOW_SHAPE: ObjectFields = {
   accessToken: "string",
   accessTokenSource: "string",
   credentialWorkspace: "string|null",
+  workspaceProfile: "string|null",
   team: "string|null",
   workspace: "string|null",
   sort: "string",
@@ -208,6 +210,48 @@ export const COMMAND_NODE_SHAPE = shape<CommandNode>({
 // Receipts shared by several commands.
 const ISSUE_REF: ObjectFields = { id: "string", identifier: "string" };
 const ISSUE_URL_RECEIPT: ObjectFields = { ...ISSUE_REF, url: "string" };
+const ISSUE_ASSIGNEE_SHAPE: FieldShape = {
+  nullable: { id: "string", displayName: "string", email: "string" },
+};
+const ISSUE_DELEGATE_SHAPE: FieldShape = {
+  nullable: { id: "string", displayName: "string", name: "string" },
+};
+const ISSUE_DELEGATION_RECEIPT: ObjectFields = {
+  ...ISSUE_URL_RECEIPT,
+  assignee: ISSUE_ASSIGNEE_SHAPE,
+  delegate: ISSUE_DELEGATE_SHAPE,
+};
+const ISSUE_MUTATION_PREVIEW: ObjectFields = {
+  operation: "string",
+  dryRun: "boolean",
+  target: { nullable: ISSUE_REF },
+  input: "object",
+};
+const ISSUE_DELEGATION_FULL_RESULT: ObjectFields = {
+  receipt: ISSUE_DELEGATION_RECEIPT,
+  resource: ISSUE_DETAIL_SHAPE,
+  verified: "boolean",
+};
+const ISSUE_LABEL_REF: ObjectFields = { id: "string", name: "string" };
+const ISSUE_LABEL_GROUPS: FieldShape = [{ group: ISSUE_LABEL_REF, label: ISSUE_LABEL_REF }];
+const ISSUE_LABEL_GROUP_RECEIPT: ObjectFields = {
+  ...ISSUE_REF,
+  changed: "boolean",
+  mutationSent: "boolean",
+  groups: ISSUE_LABEL_GROUPS,
+};
+const ISSUE_LABEL_GROUP_PREVIEW: ObjectFields = {
+  ...ISSUE_MUTATION_PREVIEW,
+  changed: "boolean",
+  mutationSent: "boolean",
+  groups: ISSUE_LABEL_GROUPS,
+};
+const ISSUE_LABEL_GROUP_FULL_RESULT: ObjectFields = {
+  receipt: ISSUE_LABEL_GROUP_RECEIPT,
+  resource: ISSUE_DETAIL_SHAPE,
+  priorState: [{ group: ISSUE_LABEL_REF, labels: [ISSUE_LABEL_REF] }],
+  verified: "boolean",
+};
 const NAMED_URL_RECEIPT: ObjectFields = { id: "string", name: "string", url: "string" };
 const NAMED_DELETED: ObjectFields = { id: "string", name: "string", deleted: "boolean" };
 const NAMED_ARCHIVED: ObjectFields = { id: "string", name: "string", archived: "boolean" };
@@ -284,6 +328,7 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
     "scopes?": ["string"],
     "expiresAt?": "string",
     path: "string",
+    projectConfigPath: "string|null",
   }),
   "auth logout": receipt({
     success: "boolean",
@@ -291,6 +336,7 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
     removed: "boolean",
     revocation: "string",
     fallbackCredentialType: "string|null",
+    teamMetadataRemoved: "boolean",
   }),
   "auth migrate": receipt({ success: "boolean", migrated: ["string"], path: "string" }),
   "auth status": object({
@@ -324,7 +370,13 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
 
   config: runs("config show", object(CONFIG_SHOW_SHAPE)),
   "config init": receipt({ success: "boolean", path: "string", team: "string", "sort?": "string" }),
-  "config set": receipt({ success: "boolean", path: "string", key: "string", value: "string" }),
+  "config set": receipt({
+    success: "boolean",
+    path: "string",
+    key: "string",
+    value: "string",
+    "workspace?": "string",
+  }),
   "config show": object(CONFIG_SHOW_SHAPE),
 
   cycle: null,
@@ -408,6 +460,12 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
     },
   ),
   "issue assign": receipt(ISSUE_REF),
+  "issue delegate": receipt(ISSUE_DELEGATION_RECEIPT, {
+    variants: {
+      "--dry-run": receipt(ISSUE_MUTATION_PREVIEW),
+      "--full-result": receipt(ISSUE_DELEGATION_FULL_RESULT),
+    },
+  }),
   "issue attach": list(
     {
       id: "string",
@@ -438,6 +496,10 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
         checkedOut: "boolean",
         stateChanged: "boolean",
       }),
+      "--delegate": receipt(ISSUE_DELEGATION_RECEIPT),
+      "--clear-delegate": receipt(ISSUE_DELEGATION_RECEIPT),
+      "--dry-run": receipt(ISSUE_MUTATION_PREVIEW),
+      "--full-result": receipt(ISSUE_DELEGATION_FULL_RESULT),
     },
   }),
   "issue delete": receipt(
@@ -469,7 +531,13 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
     },
   ),
   "issue id": receipt({ id: "string" }, { note: "`id` is the identifier (TES-123), not the UUID" }),
-  "issue label": receipt(ISSUE_REF),
+  "issue label": receipt(ISSUE_REF, {
+    variants: {
+      "--set-group": receipt(ISSUE_LABEL_GROUP_RECEIPT),
+      "--dry-run": receipt(ISSUE_LABEL_GROUP_PREVIEW),
+      "--full-result": receipt(ISSUE_LABEL_GROUP_FULL_RESULT),
+    },
+  }),
   "issue list": ISSUE_LIST,
   "issue mine": ISSUE_LIST,
   "issue pull-request": receipt(
@@ -499,7 +567,14 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
   "issue title": receipt({ title: "string" }),
   "issue unarchive": receipt({ ...ISSUE_REF, archived: "boolean" }),
   "issue unsubscribe": receipt({ ...ISSUE_REF, subscribed: "boolean" }),
-  "issue update": receipt(ISSUE_URL_RECEIPT),
+  "issue update": receipt(ISSUE_URL_RECEIPT, {
+    variants: {
+      "--delegate": receipt(ISSUE_DELEGATION_RECEIPT),
+      "--clear-delegate": receipt(ISSUE_DELEGATION_RECEIPT),
+      "--dry-run": receipt(ISSUE_MUTATION_PREVIEW),
+      "--full-result": receipt(ISSUE_DELEGATION_FULL_RESULT),
+    },
+  }),
   "issue url": receipt({ url: "string" }),
   "issue view": ISSUE_VIEW,
 

package/src/lib/resolve.ts

@@ -209,46 +209,60 @@ export async function resolveLabelIds(
   names: string[],
   teamId?: string,
 ): Promise<string[]> {
-  const ids: string[] = [];
-  for (const name of names) {
-    if (isUuid(name)) {
-      ids.push(name);
-      continue;
+  // Share in-flight searches only within this call. Later calls must observe
+  // renamed/deleted labels, and exact spelling matters for case preference.
+  const lookups = new Map<string, Promise<any[]>>();
+  const lookup = (name: string): Promise<any[]> => {
+    let pending = lookups.get(name);
+    if (!pending) {
+      pending = (async () => {
+        const conn = await withRetry(() =>
+          client.issueLabels({
+            filter: { name: { eqIgnoreCase: name } } as any,
+            first: RESOLVE_PAGE,
+          }),
+        );
+        // Share the complete scan too: concurrent consumers must not advance
+        // the same mutable SDK connection independently.
+        return scanAll<any>(conn as any, "labels", "linear label list");
+      })();
+      lookups.set(name, pending);
     }
-    const conn = await withRetry(() =>
-      client.issueLabels({ filter: { name: { eqIgnoreCase: name } } as any, first: RESOLVE_PAGE }),
-    );
-    // Scanned rather than capped: the team narrowing below can discard every
-    // label on the first page, so a fixed page cap could turn a label that
-    // exists into a not-found.
-    const nodes = await scanAll<any>(conn as any, "labels", "linear label list");
-    if (nodes.length === 0)
-      throw notFound(`No label matching '${name}'. Run 'linear label list' to see the options.`);
-
-    // Narrow to this team's labels + workspace-level labels when a team is known.
-    // If a team is known and nothing is in scope, that's not-found (do NOT fall
-    // back to an out-of-scope label from another team).
-    // Label groups are containers, not labels that can be applied to an issue.
-    let candidates: any[] = nodes.filter((label: any) => !label.isGroup);
-    if (teamId) {
-      const scoped = await Promise.all(
-        nodes.map(async (l: any) => ({ label: l, team: await l.team })),
-      );
-      candidates = scoped.filter((s) => !s.team || s.team.id === teamId).map((s) => s.label);
-      if (candidates.length === 0) throw notFound(`No label '${name}' in this team or workspace.`);
-    }
-
-    // Prefer an exact (case-sensitive) match.
-    const exact = candidates.filter((l: any) => l.name === name);
-    const finalists = exact.length ? exact : candidates;
-    if (finalists.length > 1) {
-      throw ambiguous(
-        `Multiple labels named '${name}'${teamId ? " in scope" : ""}; pass the label id instead.`,
-      );
-    }
-    ids.push(finalists[0]!.id);
-  }
-  return ids;
+    return pending;
+  };
+  return Promise.all(
+    names.map(async (name) => {
+      if (isUuid(name)) return name;
+      const nodes = await lookup(name);
+      if (nodes.length === 0)
+        throw notFound(`No label matching '${name}'. Run 'linear label list' to see the options.`);
+
+      // Narrow to this team's labels + workspace-level labels when a team is known.
+      // If a team is known and nothing is in scope, that's not-found (do NOT fall
+      // back to an out-of-scope label from another team).
+      // Label groups are containers, not labels that can be applied to an issue.
+      let candidates: any[] = nodes.filter((label: any) => !label.isGroup);
+      if (teamId) {
+        // The SDK includes teamId in the label response; accessing team fetches it again.
+        candidates = candidates.filter((label) => !label.teamId || label.teamId === teamId);
+        if (candidates.length === 0)
+          throw notFound(`No label '${name}' in this team or workspace.`);
+      }
+
+      if (candidates.length === 0)
+        throw notFound(`No label matching '${name}'. Run 'linear label list' to see the options.`);
+
+      // Prefer an exact (case-sensitive) match.
+      const exact = candidates.filter((l: any) => l.name === name);
+      const finalists = exact.length ? exact : candidates;
+      if (finalists.length > 1) {
+        throw ambiguous(
+          `Multiple labels named '${name}'${teamId ? " in scope" : ""}; pass the label id instead.`,
+        );
+      }
+      return finalists[0]!.id;
+    }),
+  );
 }
 
 /**

package/src/output/lifecycle.ts

@@ -0,0 +1,10 @@
+/** Lifecycle fields exposed by Linear on historically listable resources. */
+export interface LifecycleFields {
+  archivedAt: string | null;
+  trashed?: boolean;
+}
+
+/** A visible suffix for mixed live/historical tables. Trashed wins over archived. */
+export function lifecycleSuffix(resource: LifecycleFields): string {
+  return resource.trashed ? " (trashed)" : resource.archivedAt ? " (archived)" : "";
+}

package/src/services/initiative.ts

@@ -51,6 +51,8 @@ export interface InitiativeRow {
   targetDate: string | null;
   health: string | null;
   url: string;
+  archivedAt: string | null;
+  trashed: boolean;
 }
 
 /** The row's shape as `linear commands` advertises it (TES-610); checked against the interface. */
@@ -62,13 +64,15 @@ export const INITIATIVE_ROW_SHAPE = shape<InitiativeRow>({
   targetDate: "string|null",
   health: "string|null",
   url: "string",
+  archivedAt: "string|null",
+  trashed: "boolean",
 });
 
 const LIST_QUERY = `
 query CliInitiatives($filter: InitiativeFilter, $first: Int!, $after: String, $includeArchived: Boolean) {
   initiatives(filter: $filter, first: $first, after: $after, includeArchived: $includeArchived) {
     nodes {
-      id name status priority targetDate health url
+      id name status priority targetDate health url archivedAt trashed
     }
     pageInfo { hasNextPage endCursor }
   }
@@ -80,7 +84,7 @@ export interface ListFilters {
   /** me|email|name|id — resolved to a user id. */
   owner?: string;
   /** Include archived initiatives (the API excludes them by default). */
-  archived?: boolean;
+  includeArchived?: boolean;
 }
 
 /** Build an InitiativeFilter from human options, resolving names to ids. Exported for tests. */
@@ -104,7 +108,7 @@ export async function listInitiatives(
   return collectRawQuery<InitiativeRow>(
     client as any,
     LIST_QUERY,
-    { filter, includeArchived: filters.archived === true },
+    { filter, includeArchived: filters.includeArchived === true },
     "initiatives",
     limit,
     (n) => ({
@@ -115,6 +119,8 @@ export async function listInitiatives(
       targetDate: n.targetDate ?? null,
       health: n.health ?? null,
       url: n.url,
+      archivedAt: n.archivedAt ?? null,
+      trashed: n.trashed === true,
     }),
   );
 }
@@ -137,6 +143,7 @@ export interface InitiativeDetail {
   startedAt: string | null;
   completedAt: string | null;
   archivedAt: string | null;
+  trashed: boolean;
   owner: string | null;
   creator: string | null;
   /** The projects linked to the initiative (`initiative add-project`), API order. */
@@ -162,6 +169,7 @@ export const INITIATIVE_DETAIL_SHAPE = shape<InitiativeDetail>({
   startedAt: "string|null",
   completedAt: "string|null",
   archivedAt: "string|null",
+  trashed: "boolean",
   owner: "string|null",
   creator: "string|null",
   projects: [
@@ -214,6 +222,7 @@ export async function getInitiativeDetail(
     startedAt: initiative.startedAt ? initiative.startedAt.toISOString() : null,
     completedAt: initiative.completedAt ? initiative.completedAt.toISOString() : null,
     archivedAt: initiative.archivedAt ? initiative.archivedAt.toISOString() : null,
+    trashed: initiative.trashed === true,
     owner: owner?.displayName ?? null,
     creator: creator?.displayName ?? null,
     projects: projectRows,