linear-sdk-cli 0.1.3 → 0.2.3

package/src/lib/options.ts

@@ -6,12 +6,24 @@
 import { Command, Option } from "commander";
 import { usageError, type CliError } from "./errors.js";
 
-/** Repeatable `--var k=v` collector → { k: v }. */
-export function collectKeyVal(value: string, previous: Record<string, string> = {}): Record<string, string> {
+/**
+ * Repeatable `--var k=v` collector. JSON literals become their real types
+ * (`2`, `true`, `null`, arrays/objects); ordinary text stays a string.
+ */
+export function collectKeyVal(
+  value: string,
+  previous: Record<string, unknown> = {},
+): Record<string, unknown> {
   const eq = value.indexOf("=");
   if (eq === -1) throw usageError(`Expected key=value, got '${value}'`);
   const key = value.slice(0, eq);
-  previous[key] = value.slice(eq + 1);
+  if (!key) throw usageError(`Expected a non-empty key in key=value, got '${value}'`);
+  const raw = value.slice(eq + 1);
+  try {
+    previous[key] = JSON.parse(raw);
+  } catch {
+    previous[key] = raw;
+  }
   return previous;
 }
 
@@ -376,6 +388,7 @@ export const FIELDS_COMMANDS: ReadonlySet<string> = new Set([
   "state view",
   "team list",
   "team view",
+  "team id",
   "team members",
   "team states",
   "team labels",
@@ -423,6 +436,65 @@ export const LIMIT_COMMANDS: ReadonlySet<string> = new Set([
   "webhook list",
 ]);
 
+/** Commands where the global team changes resolution, filtering, or a mutation. */
+export const TEAM_COMMANDS: ReadonlySet<string> = new Set([
+  "config show",
+  "config init",
+  "issue view",
+  "issue list",
+  "issue mine",
+  "issue search",
+  "issue create",
+  "issue update",
+  "team view",
+  "team members",
+  "team states",
+  "team labels",
+  "team cycles",
+  "team update",
+  "project list",
+  "project create",
+  // Registered locally by project update so it can reject the dangerous
+  // singular spelling with a tailored `--teams` explanation.
+  "project update",
+  "cycle list",
+  "cycle view",
+  "cycle current",
+  "cycle create",
+  "cycle update",
+  "state list",
+  "state view",
+  "label list",
+  "label create",
+  "document list",
+  "document create",
+  "document update",
+  "webhook create",
+]);
+
+/** Commands whose confirmation prompt is bypassed by `--yes`. */
+export const YES_COMMANDS: ReadonlySet<string> = new Set([
+  "attachment delete",
+  "auth logout",
+  "comment delete",
+  "issue comment delete",
+  "document delete",
+  "favorite remove",
+  "initiative archive",
+  "initiative remove-project",
+  "initiative delete",
+  "issue archive",
+  "issue delete",
+  "label delete",
+  "milestone delete",
+  "notification archive",
+  "project archive",
+  "project delete",
+  "roadmap delete",
+  "team delete",
+  "webhook delete",
+]);
+
 /** `project list` for the `list` command under `project` — the path without the program name. */
 export function subcommandPath(cmd: Command): string {
   const names: string[] = [];
@@ -461,7 +533,9 @@ export function assertGlobalsApply(cmd: Command): void {
     const files = fileOptionsOf(cmd);
     throw usageError(
       `--fields does not apply to \`linear ${path}\`: it prints a receipt, not a table or detail block to select fields from.` +
-        (files.length ? ` To read from a file, use ${files.join(" or ")} (-f is --fields here, not a file).` : ""),
+        (files.length
+          ? ` To read from a file, use ${files.join(" or ")} (-f is --fields here, not a file).`
+          : ""),
     );
   }
   if (!LIMIT_COMMANDS.has(path)) {
@@ -477,6 +551,12 @@ export function assertGlobalsApply(cmd: Command): void {
       throw usageError(`--all does not apply to \`linear ${path}\`: it is not a paged query.`);
     }
   }
+  if (merged.team !== undefined && !TEAM_COMMANDS.has(path)) {
+    throw usageError(`--team does not apply to \`linear ${path}\`.`);
+  }
+  if (merged.yes === true && !YES_COMMANDS.has(path)) {
+    throw usageError(`--yes does not apply to \`linear ${path}\`: it has no confirmation prompt.`);
+  }
 }
 
 /** Opt-outs for the shared filter sets; `issue mine` is fixed to the viewer. */
@@ -502,9 +582,10 @@ export interface FilterOptionSet {
  */
 export function addCoreFilterOptions(cmd: Command, set: FilterOptionSet = {}): Command {
   cmd.addOption(
-    new Option("-t, --team <key>", "filter by team key (repeatable; default: configured team)").argParser(
-      collectArray,
-    ),
+    new Option(
+      "-t, --team <key>",
+      "filter by team key (repeatable; default: configured team)",
+    ).argParser(collectArray),
   );
   cmd.addOption(
     new Option("-s, --state <name>", "filter by workflow state name/type (repeatable)").argParser(
@@ -521,11 +602,19 @@ export function addCoreFilterOptions(cmd: Command, set: FilterOptionSet = {}): C
       new Option("--project-label <name>", "filter by the project's label (excludes --project)"),
     )
     .addOption(new Option("--milestone <name>", "filter by project milestone"))
-    .addOption(new Option("-l, --label <name>", "filter by label (repeat to narrow)").argParser(parseList))
-    .addOption(new Option("-P, --priority <0-4>", "filter by priority").argParser(parsePriorityFilter))
+    .addOption(
+      new Option("-l, --label <name>", "filter by label (repeat to narrow)").argParser(parseList),
+    )
+    .addOption(
+      new Option("-P, --priority <0-4>", "filter by priority").argParser(parsePriorityFilter),
+    )
     .addOption(new Option(CYCLE_FLAG, CYCLE_DESC))
-    .addOption(new Option("--created-after <date>", "only issues created at/after a date (YYYY-MM-DD)"))
-    .addOption(new Option("--updated-after <date>", "only issues updated at/after a date (YYYY-MM-DD)"))
+    .addOption(
+      new Option("--created-after <date>", "only issues created at/after a date (YYYY-MM-DD)"),
+    )
+    .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"));
 }
@@ -538,7 +627,14 @@ export function addCoreFilterOptions(cmd: Command, set: FilterOptionSet = {}): C
 export function addFilterOptions(cmd: Command, set: FilterOptionSet = {}): Command {
   addCoreFilterOptions(cmd, set)
     .addOption(new Option("--query <text>", "full-text search"))
-    .addOption(new Option("--sort <field>", "sort order").choices(["priority", "updated", "created"]));
+    .addOption(
+      new Option("--sort <field>", "sort order").choices([
+        "priority",
+        "manual",
+        "updated",
+        "created",
+      ]),
+    );
   // `--search` is the reference CLI's spelling of the same filter.
   return addAliasOption(cmd, "--search <text>", "--query");
 }

package/src/lib/output-shapes.ts

@@ -130,7 +130,10 @@ export const UPDATE_ROW_SHAPE = shape<UpdateRow>({
   body: "string",
   health: "string|null",
 });
-const UPDATE_RECEIPT_SHAPE = shape<UpdateRow & { url: string }>({ ...UPDATE_ROW_SHAPE, url: "string" });
+const UPDATE_RECEIPT_SHAPE = shape<UpdateRow & { url: string }>({
+  ...UPDATE_ROW_SHAPE,
+  url: "string",
+});
 
 /** `whoami` / `auth whoami`. */
 const WHOAMI_SHAPE: ObjectFields = {
@@ -142,12 +145,15 @@ const WHOAMI_SHAPE: ObjectFields = {
   organization: { id: "string", name: "string", urlKey: "string" },
 };
 
-const SETTING_ORIGIN_SHAPE = shape<SettingOrigin>({ source: "string", "path?": "string" });
+const SETTING_ORIGIN_SHAPE = shape<SettingOrigin>({
+  source: "string",
+  "path?": "string",
+  "key?": "string",
+});
 const SETTING_ORIGINS_SHAPE = shape<SettingOrigins>({
   team: SETTING_ORIGIN_SHAPE,
   workspace: SETTING_ORIGIN_SHAPE,
   sort: SETTING_ORIGIN_SHAPE,
-  vcs: SETTING_ORIGIN_SHAPE,
 });
 
 /** `config show`: every resolved setting, redacted, with its provenance. */
@@ -158,7 +164,6 @@ const CONFIG_SHOW_SHAPE: ObjectFields = {
   team: "string|null",
   workspace: "string|null",
   sort: "string",
-  vcs: "string",
   origins: SETTING_ORIGINS_SHAPE,
   userConfigPath: "string",
   projectConfigPath: "string|null",
@@ -171,7 +176,20 @@ export const COMMAND_NODE_SHAPE = shape<CommandNode>({
   description: "string",
   aliases: ["string"],
   arguments: [{ name: "string", required: "boolean", variadic: "boolean" }],
-  options: [{ flags: "string", description: "string" }],
+  options: [
+    {
+      flags: "string",
+      description: "string",
+      attribute: "string",
+      valueRequired: "boolean",
+      valueOptional: "boolean",
+      variadic: "boolean",
+      "choices?": ["string"],
+      "defaultValue?": "unknown",
+      global: "boolean",
+      applicable: "boolean",
+    },
+  ],
   "output?": {
     kind: "string",
     "fields?": "object",
@@ -210,8 +228,8 @@ const RELATION_ROW: ObjectFields = { type: "string", issue: "string", title: "st
 
 const ISSUE_VIEW = object(ISSUE_DETAIL_SHAPE, {
   variants: {
-    "--comments": object({ ...ISSUE_DETAIL_SHAPE, comments: [COMMENT_ROW_SHAPE] }),
     "--web": receipt({ ...ISSUE_URL_RECEIPT, opened: "boolean" }),
+    "--app": receipt({ ...ISSUE_URL_RECEIPT, opened: "boolean" }),
   },
 });
 const ISSUE_LIST = list(ISSUE_ROW_SHAPE);
@@ -236,6 +254,13 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
   "attachment list": list(ATTACHMENT_ROW_SHAPE),
 
   auth: null,
+  "auth adopt": receipt({
+    success: "boolean",
+    workspace: "string",
+    user: { id: "string", name: "string", email: "string" },
+    storage: "string",
+    path: "string",
+  }),
   "auth default": receipt({ success: "boolean", default_workspace: "string", path: "string" }),
   "auth list": list({ slug: "string", isDefault: "boolean", storage: "string" }),
   "auth login": receipt({
@@ -316,7 +341,28 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
   "issue agent-session": null,
   "issue agent-session list": list(AGENT_SESSION_ROW_SHAPE),
   "issue agent-session view": object(AGENT_SESSION_DETAIL_SHAPE),
-  "issue archive": receipt({ ...ISSUE_REF, archived: "boolean" }),
+  "issue archive": receipt(
+    { ...ISSUE_REF, archived: "boolean" },
+    {
+      variants: {
+        "--bulk": receipt({
+          action: "string",
+          results: [
+            {
+              input: "string",
+              "id?": "string",
+              "identifier?": "string",
+              "archived?": "boolean",
+              "deleted?": "boolean",
+              "error?": { message: "string", code: "string" },
+            },
+          ],
+          succeeded: "number",
+          failed: "number",
+        }),
+      },
+    },
+  ),
   "issue assign": receipt(ISSUE_REF),
   "issue attach": list(
     {
@@ -350,10 +396,33 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
       }),
     },
   }),
-  "issue delete": receipt({ ...ISSUE_REF, deleted: "boolean" }),
+  "issue delete": receipt(
+    { ...ISSUE_REF, deleted: "boolean" },
+    {
+      variants: {
+        "--bulk": receipt({
+          action: "string",
+          results: [
+            {
+              input: "string",
+              "id?": "string",
+              "identifier?": "string",
+              "archived?": "boolean",
+              "deleted?": "boolean",
+              "error?": { message: "string", code: "string" },
+            },
+          ],
+          succeeded: "number",
+          failed: "number",
+        }),
+      },
+    },
+  ),
   "issue describe": receipt(
     { identifier: "string", title: "string", url: "string", trailer: "string", message: "string" },
-    { note: "`trailer` is the magic-word phrase (Fixes TES-1); `message` the full commit text as printed" },
+    {
+      note: "`trailer` is the magic-word phrase (Fixes TES-1); `message` the full commit text as printed",
+    },
   ),
   "issue id": receipt({ id: "string" }, { note: "`id` is the identifier (TES-123), not the UUID" }),
   "issue label": receipt(ISSUE_REF),
@@ -416,6 +485,8 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
   "notification snooze": receipt({ id: "string", snoozedUntilAt: "string" }),
   "notification unread": receipt({ id: "string", read: "boolean" }),
 
+  open: receipt({ target: "string", url: "string", label: "string", opened: "boolean" }),
+
   organization: runs("organization view", object(ORGANIZATION_DETAIL_SHAPE)),
   "organization invites": list(INVITE_ROW_SHAPE),
   "organization members": list(ORGANIZATION_MEMBER_ROW_SHAPE),
@@ -459,6 +530,7 @@ export const OUTPUT_SHAPES: Record<string, OutputShape | null> = {
     movedIssues: "number",
     movedTo: { nullable: TEAM_ROW_SHAPE },
   }),
+  "team id": receipt(TEAM_ROW_SHAPE),
   "team labels": list(TEAM_LABEL_ROW_SHAPE),
   "team list": list(TEAM_ROW_SHAPE),
   "team members": list(TEAM_MEMBER_ROW_SHAPE),

package/src/lib/pagination.ts

@@ -5,7 +5,10 @@
  * and `.fetchNext()` mutates the connection to append the next page's nodes.
  */
 
-import { withRetry } from "../client.js";
+import { fetchNextWithRetry, withRetry } from "../client.js";
+
+/** Linear accepts at most 250 nodes per connection page. */
+export const MAX_PAGE_SIZE = 250;
 
 export interface Connection<T> {
   nodes: T[];
@@ -13,22 +16,49 @@ export interface Connection<T> {
   fetchNext: () => Promise<Connection<T>>;
 }
 
-export async function collect<T>(
-  first: Connection<T>,
-  limit: number,
-): Promise<T[]> {
+/** Non-enumerable metadata carried by list arrays without changing their JSON contract. */
+const HAS_MORE = Symbol.for("linear-sdk-cli.pagination.has-more");
+
+type PagedArray<T> = T[] & { [HAS_MORE]?: boolean };
+
+function withMoreMetadata<T>(items: T[], hasMore: boolean): T[] {
+  Object.defineProperty(items, HAS_MORE, { value: hasMore, enumerable: false });
+  return items;
+}
+
+/** Attach an explicit pagination result to an array without changing its JSON value. */
+export function setPaginationMetadata<T>(items: T[], hasMore: boolean): T[] {
+  return withMoreMetadata(items, hasMore);
+}
+
+/** Whether a service list stopped at its caller-supplied limit. */
+export function hasMoreResults(items: readonly unknown[]): boolean {
+  return (items as PagedArray<unknown>)[HAS_MORE] === true;
+}
+
+/** Carry pagination metadata through a service's map/filter/sort result. */
+export function inheritPaginationMetadata<T>(items: T[], source: readonly unknown[]): T[] {
+  return withMoreMetadata(items, hasMoreResults(source));
+}
+
+export async function collect<T>(first: Connection<T>, limit: number): Promise<T[]> {
   let conn = first;
   // Each fetchNext() appends to conn.nodes in place.
   while (conn.nodes.length < limit && conn.pageInfo.hasNextPage) {
-    conn = await conn.fetchNext();
+    // Page two and later are independent requests and can be rate-limited just
+    // like page one. Keep them behind the same bounded retry policy.
+    conn = await fetchNextWithRetry(conn);
   }
-  return limit === Infinity ? conn.nodes : conn.nodes.slice(0, limit);
+  if (limit === Infinity) return withMoreMetadata(conn.nodes, false);
+  const hasMore =
+    conn.nodes.length > limit || (conn.nodes.length >= limit && conn.pageInfo.hasNextPage);
+  return withMoreMetadata(conn.nodes.slice(0, limit), hasMore);
 }
 
 /** How many to request per page given a desired total limit. */
 export function pageSize(limit: number): number {
-  if (limit === Infinity) return 100;
-  return Math.min(Math.max(limit, 1), 100);
+  if (limit === Infinity) return MAX_PAGE_SIZE;
+  return Math.min(Math.max(limit, 1), MAX_PAGE_SIZE);
 }
 
 /**
@@ -76,7 +106,7 @@ interface RawClient {
  * `withRetry`; pagination stops at `limit` or when `hasNextPage` is false.
  *
  * Mirrors the hand-rolled loops in the list services exactly: page size is
- * `limit === Infinity ? 100 : Math.min(limit, 100)`, and rows are capped at
+ * `limit === Infinity ? 250 : Math.min(limit, 250)`, and rows are capped at
  * `limit` mid-page.
  */
 export async function collectRawQuery<T>(
@@ -87,26 +117,29 @@ export async function collectRawQuery<T>(
   limit: number,
   transform: (node: any) => T,
 ): Promise<T[]> {
-  const pageLimit = limit === Infinity ? 100 : Math.min(limit, 100);
+  const pageLimit = pageSize(limit);
   const rows: T[] = [];
   let after: string | undefined;
+  let hasMore = false;
 
   for (;;) {
     const data: any = await withRetry(() =>
       client.client.rawRequest(query, { ...variables, first: pageLimit, after }),
     );
-    const conn = connectionPath
-      .split(".")
-      .reduce((acc: any, key) => acc?.[key], data.data) as RawConnection | null | undefined;
+    const conn = connectionPath.split(".").reduce((acc: any, key) => acc?.[key], data.data) as
+      RawConnection | null | undefined;
     // A nested path (`issue.comments`) can land on null when the parent entity
     // is gone; that is an empty list, not a crash.
     if (!conn) break;
-    for (const n of conn.nodes) {
+    for (const [index, n] of conn.nodes.entries()) {
       rows.push(transform(n));
-      if (rows.length >= limit) break;
+      if (rows.length >= limit) {
+        hasMore = index < conn.nodes.length - 1 || conn.pageInfo.hasNextPage;
+        break;
+      }
     }
     if (rows.length >= limit || !conn.pageInfo.hasNextPage) break;
     after = conn.pageInfo.endCursor;
   }
-  return rows;
+  return withMoreMetadata(rows, hasMore);
 }

package/src/lib/resolve.ts

@@ -15,6 +15,27 @@ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
 export const isUuid = (v: string): boolean => UUID_RE.test(v);
 
 const IDENTIFIER_RE = /^([a-zA-Z][a-zA-Z0-9]*)-(\d+)$/;
+const ISSUE_NUMBER_RE = /^\d+$/;
+
+/**
+ * Expand a bare issue number with the configured team (`42` + `TES` →
+ * `TES-42`). This is deliberately pure: commands can normalize every place an
+ * issue reference appears before handing it to the existing resolvers.
+ */
+export function normalizeIssueReference(input: string, defaultTeamKey?: string): string {
+  if (!ISSUE_NUMBER_RE.test(input)) return input;
+  if (!defaultTeamKey) {
+    throw usageError(
+      `Bare issue number '${input}' needs a default team. Pass --team <KEY> or set one in config.`,
+    );
+  }
+  if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(defaultTeamKey)) {
+    throw usageError(
+      `Cannot expand issue number '${input}' with default team '${defaultTeamKey}'; configure a team key such as TES.`,
+    );
+  }
+  return `${defaultTeamKey.toUpperCase()}-${Number.parseInt(input, 10)}`;
+}
 
 /** Known workflow-state types, used to decide name-vs-type filtering. */
 export const STATE_TYPES = ["triage", "backlog", "unstarted", "started", "completed", "canceled"];
@@ -101,13 +122,15 @@ export async function resolveTeam(
         "linear team list",
       )}`,
     );
-  if (matches.length > 1) throw ambiguous(`Multiple teams match '${value}': ${matches.map((t) => t.key).join(", ")}`);
+  if (matches.length > 1)
+    throw ambiguous(`Multiple teams match '${value}': ${matches.map((t) => t.key).join(", ")}`);
   const team = matches[0]!;
   return { id: team.id, key: team.key, name: team.name };
 }
 
 /** The spellings that mean "the authenticated user": ours (`me`, `@me`) and the reference CLI's (`self`). */
-export const isSelf = (input: string): boolean => input === "me" || input === "@me" || input === "self";
+export const isSelf = (input: string): boolean =>
+  input === "me" || input === "@me" || input === "self";
 
 /**
  * Resolve an assignee reference (`me`, email, name, or id) to a user id.
@@ -138,7 +161,9 @@ export async function resolveUserId(client: LinearClient, input: string): Promis
   if (nodes.length === 0)
     throw notFound(`No user matching '${input}'. Run 'linear user list' to see workspace members.`);
   if (nodes.length > 1)
-    throw ambiguous(`Multiple users match '${input}': ${nodes.map((u: any) => u.email).join(", ")}`);
+    throw ambiguous(
+      `Multiple users match '${input}': ${nodes.map((u: any) => u.email).join(", ")}`,
+    );
   return nodes[0]!.id;
 }
 
@@ -203,7 +228,8 @@ export async function resolveLabelIds(
     // 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).
-    let candidates: any[] = nodes;
+    // 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 })),
@@ -334,7 +360,9 @@ export async function resolveProjectId(client: LinearClient, input: string): Pro
   if (nodes.length === 0)
     throw notFound(`No project matching '${input}'. Run 'linear project list' to see the options.`);
   if (nodes.length > 1)
-    throw ambiguous(`Multiple projects match '${input}': ${nodes.map((p: any) => p.name).join(", ")}`);
+    throw ambiguous(
+      `Multiple projects match '${input}': ${nodes.map((p: any) => p.name).join(", ")}`,
+    );
   return nodes[0]!.id;
 }
 
@@ -485,7 +513,11 @@ export async function resolveReleaseId(client: LinearClient, input: string): Pro
       first: RESOLVE_PAGE,
     }),
   );
-  const nodes = await scanAll<any>(conn as any, "releases", "linear api '{ releases { nodes { id name version } } }'");
+  const nodes = await scanAll<any>(
+    conn as any,
+    "releases",
+    "linear api '{ releases { nodes { id name version } } }'",
+  );
   if (nodes.length === 0) throw notFound(`No release named or versioned '${input}'.`);
   if (nodes.length > 1)
     throw ambiguous(
@@ -547,7 +579,8 @@ export async function resolveTemplateId(
 export async function resolveIssue(client: LinearClient, input: string): Promise<Issue> {
   if (isUuid(input)) return withRetry(() => client.issue(input));
   const match = input.match(IDENTIFIER_RE);
-  if (!match) throw usageError(`'${input}' is not a valid issue id (expected e.g. TES-123 or a UUID).`);
+  if (!match)
+    throw usageError(`'${input}' is not a valid issue id (expected e.g. TES-123 or a UUID).`);
   const key = match[1]!.toUpperCase();
   const number = Number.parseInt(match[2]!, 10);
   // includeArchived so archive/unarchive/delete can operate on archived issues.

package/src/lib/shape.ts

@@ -66,11 +66,13 @@ type IsAny<T> = 0 extends 1 & T ? true : false;
 type ObjectShapeOf<T> = string extends keyof T
   ? "object"
   : {
-      [K in keyof T as IsAny<T[K]> extends true
-        ? K & string
-        : undefined extends T[K]
-          ? `${K & string}?`
-          : K & string]-?: ShapeOf<Exclude<T[K], undefined>>;
+      [
+        K in keyof T as IsAny<T[K]> extends true
+          ? K & string
+          : undefined extends T[K]
+            ? `${K & string}?`
+            : K & string
+      ]-?: ShapeOf<Exclude<T[K], undefined>>;
     };
 
 export type ShapeOf<T> =
@@ -119,10 +121,7 @@ export type ObjectFields = Record<string, FieldShape>;
 
 function isNullableWrapper(s: FieldShape): s is { readonly nullable: FieldShape } {
   return (
-    typeof s === "object" &&
-    !Array.isArray(s) &&
-    Object.keys(s).length === 1 &&
-    "nullable" in s
+    typeof s === "object" && !Array.isArray(s) && Object.keys(s).length === 1 && "nullable" in s
   );
 }
 
@@ -160,7 +159,9 @@ export function matchesShape(
   }
   if (Array.isArray(shape)) {
     if (!Array.isArray(value)) return [`${path}: expected an array, got ${describe(value)}`];
-    return value.flatMap((item, i) => matchesShape(item, shape[0], `${path}[${i}]`, strictNullable));
+    return value.flatMap((item, i) =>
+      matchesShape(item, shape[0], `${path}[${i}]`, strictNullable),
+    );
   }
   if (isNullableWrapper(shape)) {
     if (value === undefined) return [`${path}: expected an object or null, got undefined`];
@@ -184,7 +185,8 @@ export function matchesShape(
     problems.push(...matchesShape(record[key], sub, `${path}.${key}`, strictNullable));
   }
   for (const key of Object.keys(record)) {
-    if (!declared.has(key) && record[key] !== undefined) problems.push(`${path}.${key}: not in the declared shape`);
+    if (!declared.has(key) && record[key] !== undefined)
+      problems.push(`${path}.${key}: not in the declared shape`);
   }
   return problems;
 }
@@ -203,7 +205,9 @@ export function renderShape(shape: FieldShape): string {
   if (typeof shape === "string") return shape.replace("|null", " | null");
   if (Array.isArray(shape)) {
     const inner = renderShape(shape[0]);
-    return typeof shape[0] === "string" && !shape[0].includes("|") ? `${inner}[]` : `Array<${inner}>`;
+    return typeof shape[0] === "string" && !shape[0].includes("|")
+      ? `${inner}[]`
+      : `Array<${inner}>`;
   }
   if (isNullableWrapper(shape)) return `${renderShape(shape.nullable)} | null`;
   const parts = Object.entries(shape).map(([k, v]) => `${k}: ${renderShape(v)}`);

package/src/lib/upload.ts

@@ -294,7 +294,9 @@ function redact(text: string, uploadUrl: string): string {
 }
 
 /** Markdown for a comment body: images embed inline, anything else links. */
-export function formatEmbed(r: Pick<UploadResult, "filename" | "assetUrl" | "contentType">): string {
+export function formatEmbed(
+  r: Pick<UploadResult, "filename" | "assetUrl" | "contentType">,
+): string {
   return `${isImage(r.contentType) ? "!" : ""}[${r.filename}](${r.assetUrl})`;
 }