@useairfoil/producer-linear 0.0.2 → 0.0.3

package/src/schemas/issues.ts

@@ -9,60 +9,102 @@ import {
   Ref,
   common,
   deleted,
-  field,
-  list,
 } from "./shared";
 
 export const IssueSchema = Schema.Struct({
   ...common("Issue"),
   _deleted: deleted("issue"),
-  identifier: Schema.String.pipe(field(10, "Readable ID, such as ENG-123.")),
-  number: Schema.Finite.pipe(field(11, "Issue number within its team.")),
-  title: Schema.String.pipe(field(12, "Issue title.")),
-  description: OptionalString.pipe(field(13, "Description in markdown.")),
-  url: Schema.String.pipe(field(14, "Issue URL.")),
-  branch_name: Schema.String.pipe(field(15, "Suggested Git branch name.")),
-  priority: Schema.Finite.pipe(field(16, "0 none, 1 urgent, 2 high, 3 medium, 4 low.")),
-  priority_label: Schema.String.pipe(field(17, "Priority name.")),
-  estimate: Schema.NullOr(Schema.Finite).pipe(field(18, "Estimate, on the team's scale.")),
-  due_date: OptionalString.pipe(field(19, "Due date, as YYYY-MM-DD.")),
-  creator_id: OptionalRef.pipe(field(20, "User who created the issue.")),
-  assignee_id: OptionalRef.pipe(field(21, "Assigned user.")),
-  delegate_id: OptionalRef.pipe(field(22, "Agent user working on the issue.")),
-  snoozed_by_id: OptionalRef.pipe(field(23, "User who snoozed the issue.")),
-  state_id: Ref.pipe(field(24, "Workflow state.")),
-  team_id: Ref.pipe(field(25, "Team the issue belongs to.")),
-  project_id: OptionalRef.pipe(field(26, "Project.")),
-  project_milestone_id: OptionalRef.pipe(field(27, "Project milestone.")),
-  cycle_id: OptionalRef.pipe(field(28, "Cycle.")),
-  parent_id: OptionalRef.pipe(field(29, "Parent issue.")),
-  source_comment_id: OptionalRef.pipe(field(30, "Comment the issue was made from.")),
+  identifier: Schema.String.pipe(
+    Schema.annotateKey({ description: "Readable ID, such as ENG-123." }),
+  ),
+  number: Schema.Finite.pipe(Schema.annotateKey({ description: "Issue number within its team." })),
+  title: Schema.String.pipe(Schema.annotateKey({ description: "Issue title." })),
+  description: OptionalString.pipe(Schema.annotateKey({ description: "Description in markdown." })),
+  url: Schema.String.pipe(Schema.annotateKey({ description: "Issue URL." })),
+  branch_name: Schema.String.pipe(
+    Schema.annotateKey({ description: "Suggested Git branch name." }),
+  ),
+  priority: Schema.Finite.pipe(
+    Schema.annotateKey({ description: "0 none, 1 urgent, 2 high, 3 medium, 4 low." }),
+  ),
+  priority_label: Schema.String.pipe(Schema.annotateKey({ description: "Priority name." })),
+  estimate: Schema.NullOr(Schema.Finite).pipe(
+    Schema.annotateKey({ description: "Estimate, on the team's scale." }),
+  ),
+  due_date: OptionalString.pipe(Schema.annotateKey({ description: "Due date, as YYYY-MM-DD." })),
+  creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who created the issue." })),
+  assignee_id: OptionalRef.pipe(Schema.annotateKey({ description: "Assigned user." })),
+  delegate_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "Agent user working on the issue." }),
+  ),
+  snoozed_by_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "User who snoozed the issue." }),
+  ),
+  state_id: Ref.pipe(Schema.annotateKey({ description: "Workflow state." })),
+  team_id: Ref.pipe(Schema.annotateKey({ description: "Team the issue belongs to." })),
+  project_id: OptionalRef.pipe(Schema.annotateKey({ description: "Project." })),
+  project_milestone_id: OptionalRef.pipe(Schema.annotateKey({ description: "Project milestone." })),
+  cycle_id: OptionalRef.pipe(Schema.annotateKey({ description: "Cycle." })),
+  parent_id: OptionalRef.pipe(Schema.annotateKey({ description: "Parent issue." })),
+  source_comment_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "Comment the issue was made from." }),
+  ),
   external_user_creator_id: OptionalRef.pipe(
-    field(31, "External user who created the issue through an integration."),
-  ),
-  label_ids: list(101, Schema.String).pipe(field(32, "Labels.")),
-  previous_identifiers: list(102, Schema.String).pipe(
-    field(33, "Earlier readable IDs, from before the issue moved team."),
-  ),
-  started_at: OptionalTimestamp.pipe(field(34, "Time the issue moved to a started state.")),
-  completed_at: OptionalTimestamp.pipe(field(35, "Time the issue was completed.")),
-  canceled_at: OptionalTimestamp.pipe(field(36, "Time the issue was canceled.")),
-  started_triage_at: OptionalTimestamp.pipe(field(37, "Time the issue entered triage.")),
-  triaged_at: OptionalTimestamp.pipe(field(38, "Time the issue left triage.")),
-  auto_closed_at: OptionalTimestamp.pipe(field(39, "Time the issue was closed automatically.")),
-  auto_archived_at: OptionalTimestamp.pipe(field(40, "Time the issue was archived automatically.")),
-  added_to_cycle_at: OptionalTimestamp.pipe(field(41, "Time the issue was added to its cycle.")),
+    Schema.annotateKey({
+      description: "External user who created the issue through an integration.",
+    }),
+  ),
+  label_ids: Schema.Array(Schema.String).pipe(Schema.annotateKey({ description: "Labels." })),
+  previous_identifiers: Schema.Array(Schema.String).pipe(
+    Schema.annotateKey({ description: "Earlier readable IDs, from before the issue moved team." }),
+  ),
+  started_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue moved to a started state." }),
+  ),
+  completed_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue was completed." }),
+  ),
+  canceled_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue was canceled." }),
+  ),
+  started_triage_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue entered triage." }),
+  ),
+  triaged_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue left triage." }),
+  ),
+  auto_closed_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue was closed automatically." }),
+  ),
+  auto_archived_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue was archived automatically." }),
+  ),
+  added_to_cycle_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue was added to its cycle." }),
+  ),
   added_to_project_at: OptionalTimestamp.pipe(
-    field(42, "Time the issue was added to its project."),
-  ),
-  added_to_team_at: OptionalTimestamp.pipe(field(43, "Time the issue was added to its team.")),
-  snoozed_until_at: OptionalTimestamp.pipe(field(44, "Time the issue is snoozed until.")),
-  sla_type: OptionalString.pipe(field(45, "SLA type.")),
-  sla_started_at: OptionalTimestamp.pipe(field(46, "Time the SLA started.")),
-  sla_breaches_at: OptionalTimestamp.pipe(field(47, "Time the SLA breaches.")),
-  customer_ticket_count: Long.pipe(field(48, "Linked support tickets.")),
-  integration_source_type: OptionalString.pipe(field(49, "Integration that created the issue.")),
-  trashed: Schema.NullOr(Schema.Boolean).pipe(field(50, "Whether the issue is in the trash.")),
+    Schema.annotateKey({ description: "Time the issue was added to its project." }),
+  ),
+  added_to_team_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue was added to its team." }),
+  ),
+  snoozed_until_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the issue is snoozed until." }),
+  ),
+  sla_type: OptionalString.pipe(Schema.annotateKey({ description: "SLA type." })),
+  sla_started_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the SLA started." }),
+  ),
+  sla_breaches_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the SLA breaches." }),
+  ),
+  customer_ticket_count: Long.pipe(Schema.annotateKey({ description: "Linked support tickets." })),
+  integration_source_type: OptionalString.pipe(
+    Schema.annotateKey({ description: "Integration that created the issue." }),
+  ),
+  trashed: Schema.NullOr(Schema.Boolean).pipe(
+    Schema.annotateKey({ description: "Whether the issue is in the trash." }),
+  ),
 })
   .annotate({ description: "Linear issues, including archived and trashed ones." })
   .pipe(Iceberg.identifier("id"));
@@ -75,43 +117,69 @@ export const IssueObjectSchema = IssueSchema.mapFields((fields) =>
 
 export const IssueHistorySchema = Schema.Struct({
   ...common("History entry"),
-  issue_id: Schema.String.pipe(field(10, "Issue that changed.")),
-  actor_id: OptionalString.pipe(field(11, "User who made the change.")),
-  from_state_id: OptionalString.pipe(field(12, "Workflow state before.")),
-  to_state_id: OptionalString.pipe(field(13, "Workflow state after.")),
-  from_assignee_id: OptionalString.pipe(field(14, "Assignee before.")),
-  to_assignee_id: OptionalString.pipe(field(15, "Assignee after.")),
-  from_cycle_id: OptionalString.pipe(field(16, "Cycle before.")),
-  to_cycle_id: OptionalString.pipe(field(17, "Cycle after.")),
-  from_project_id: OptionalString.pipe(field(18, "Project before.")),
-  to_project_id: OptionalString.pipe(field(19, "Project after.")),
-  from_parent_id: OptionalString.pipe(field(20, "Parent issue before.")),
-  to_parent_id: OptionalString.pipe(field(21, "Parent issue after.")),
-  from_team_id: OptionalString.pipe(field(22, "Team before.")),
-  to_team_id: OptionalString.pipe(field(23, "Team after.")),
-  from_priority: Schema.NullOr(Schema.Finite).pipe(field(24, "Priority before.")),
-  to_priority: Schema.NullOr(Schema.Finite).pipe(field(25, "Priority after.")),
-  from_estimate: Schema.NullOr(Schema.Finite).pipe(field(26, "Estimate before.")),
-  to_estimate: Schema.NullOr(Schema.Finite).pipe(field(27, "Estimate after.")),
-  from_due_date: OptionalString.pipe(field(28, "Due date before, as YYYY-MM-DD.")),
-  to_due_date: OptionalString.pipe(field(29, "Due date after, as YYYY-MM-DD.")),
-  from_title: OptionalString.pipe(field(30, "Title before.")),
-  to_title: OptionalString.pipe(field(31, "Title after.")),
-  added_label_ids: Schema.NullOr(list(101, Schema.String)).pipe(field(32, "Labels added.")),
-  removed_label_ids: Schema.NullOr(list(102, Schema.String)).pipe(field(33, "Labels removed.")),
-  attachment_id: OptionalString.pipe(field(34, "Attachment linked or unlinked.")),
-  customer_need_id: OptionalString.pipe(field(35, "Customer request linked or unlinked.")),
-  to_converted_project_id: OptionalString.pipe(field(36, "Project the issue became.")),
+  issue_id: Schema.String.pipe(Schema.annotateKey({ description: "Issue that changed." })),
+  actor_id: OptionalString.pipe(Schema.annotateKey({ description: "User who made the change." })),
+  from_state_id: OptionalString.pipe(Schema.annotateKey({ description: "Workflow state before." })),
+  to_state_id: OptionalString.pipe(Schema.annotateKey({ description: "Workflow state after." })),
+  from_assignee_id: OptionalString.pipe(Schema.annotateKey({ description: "Assignee before." })),
+  to_assignee_id: OptionalString.pipe(Schema.annotateKey({ description: "Assignee after." })),
+  from_cycle_id: OptionalString.pipe(Schema.annotateKey({ description: "Cycle before." })),
+  to_cycle_id: OptionalString.pipe(Schema.annotateKey({ description: "Cycle after." })),
+  from_project_id: OptionalString.pipe(Schema.annotateKey({ description: "Project before." })),
+  to_project_id: OptionalString.pipe(Schema.annotateKey({ description: "Project after." })),
+  from_parent_id: OptionalString.pipe(Schema.annotateKey({ description: "Parent issue before." })),
+  to_parent_id: OptionalString.pipe(Schema.annotateKey({ description: "Parent issue after." })),
+  from_team_id: OptionalString.pipe(Schema.annotateKey({ description: "Team before." })),
+  to_team_id: OptionalString.pipe(Schema.annotateKey({ description: "Team after." })),
+  from_priority: Schema.NullOr(Schema.Finite).pipe(
+    Schema.annotateKey({ description: "Priority before." }),
+  ),
+  to_priority: Schema.NullOr(Schema.Finite).pipe(
+    Schema.annotateKey({ description: "Priority after." }),
+  ),
+  from_estimate: Schema.NullOr(Schema.Finite).pipe(
+    Schema.annotateKey({ description: "Estimate before." }),
+  ),
+  to_estimate: Schema.NullOr(Schema.Finite).pipe(
+    Schema.annotateKey({ description: "Estimate after." }),
+  ),
+  from_due_date: OptionalString.pipe(
+    Schema.annotateKey({ description: "Due date before, as YYYY-MM-DD." }),
+  ),
+  to_due_date: OptionalString.pipe(
+    Schema.annotateKey({ description: "Due date after, as YYYY-MM-DD." }),
+  ),
+  from_title: OptionalString.pipe(Schema.annotateKey({ description: "Title before." })),
+  to_title: OptionalString.pipe(Schema.annotateKey({ description: "Title after." })),
+  added_label_ids: Schema.NullOr(Schema.Array(Schema.String)).pipe(
+    Schema.annotateKey({ description: "Labels added." }),
+  ),
+  removed_label_ids: Schema.NullOr(Schema.Array(Schema.String)).pipe(
+    Schema.annotateKey({ description: "Labels removed." }),
+  ),
+  attachment_id: OptionalString.pipe(
+    Schema.annotateKey({ description: "Attachment linked or unlinked." }),
+  ),
+  customer_need_id: OptionalString.pipe(
+    Schema.annotateKey({ description: "Customer request linked or unlinked." }),
+  ),
+  to_converted_project_id: OptionalString.pipe(
+    Schema.annotateKey({ description: "Project the issue became." }),
+  ),
   updated_description: Schema.NullOr(Schema.Boolean).pipe(
-    field(37, "Whether the description changed."),
+    Schema.annotateKey({ description: "Whether the description changed." }),
+  ),
+  archived: Schema.NullOr(Schema.Boolean).pipe(
+    Schema.annotateKey({ description: "Whether the issue was archived." }),
+  ),
+  trashed: Schema.NullOr(Schema.Boolean).pipe(
+    Schema.annotateKey({ description: "Whether the issue was trashed." }),
   ),
-  archived: Schema.NullOr(Schema.Boolean).pipe(field(38, "Whether the issue was archived.")),
-  trashed: Schema.NullOr(Schema.Boolean).pipe(field(39, "Whether the issue was trashed.")),
   auto_archived: Schema.NullOr(Schema.Boolean).pipe(
-    field(40, "Whether the issue was archived automatically."),
+    Schema.annotateKey({ description: "Whether the issue was archived automatically." }),
   ),
   auto_closed: Schema.NullOr(Schema.Boolean).pipe(
-    field(41, "Whether the issue was closed automatically."),
+    Schema.annotateKey({ description: "Whether the issue was closed automatically." }),
   ),
 })
   .annotate({ description: "Linear issue history. One row per change to an issue." })
@@ -125,9 +193,11 @@ export const IssueHistoryObjectSchema = IssueHistorySchema.mapFields((fields) =>
 
 export const IssueRelationSchema = Schema.Struct({
   ...common("Relation"),
-  issue_id: Ref.pipe(field(10, "Issue the relation starts from.")),
-  related_issue_id: Ref.pipe(field(11, "Related issue.")),
-  type: Schema.String.pipe(field(12, "Relation type: blocks, duplicate, related, or similar.")),
+  issue_id: Ref.pipe(Schema.annotateKey({ description: "Issue the relation starts from." })),
+  related_issue_id: Ref.pipe(Schema.annotateKey({ description: "Related issue." })),
+  type: Schema.String.pipe(
+    Schema.annotateKey({ description: "Relation type: blocks, duplicate, related, or similar." }),
+  ),
 })
   .annotate({ description: "Linear issue relations. Deleted relations aren't seen." })
   .pipe(Iceberg.identifier("id"));
@@ -141,13 +211,19 @@ export const IssueRelationObjectSchema = IssueRelationSchema.mapFields((fields)
 export const AttachmentSchema = Schema.Struct({
   ...common("Attachment"),
   _deleted: deleted("attachment"),
-  issue_id: Ref.pipe(field(10, "Issue the attachment is on.")),
-  creator_id: OptionalRef.pipe(field(11, "User who added it.")),
-  external_user_creator_id: OptionalRef.pipe(field(12, "External user who added it.")),
-  title: Schema.String.pipe(field(13, "Title.")),
-  subtitle: OptionalString.pipe(field(14, "Subtitle.")),
-  url: Schema.String.pipe(field(15, "Linked URL, such as a pull request or ticket.")),
-  source_type: OptionalString.pipe(field(16, "Source, such as github or zendesk.")),
+  issue_id: Ref.pipe(Schema.annotateKey({ description: "Issue the attachment is on." })),
+  creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who added it." })),
+  external_user_creator_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "External user who added it." }),
+  ),
+  title: Schema.String.pipe(Schema.annotateKey({ description: "Title." })),
+  subtitle: OptionalString.pipe(Schema.annotateKey({ description: "Subtitle." })),
+  url: Schema.String.pipe(
+    Schema.annotateKey({ description: "Linked URL, such as a pull request or ticket." }),
+  ),
+  source_type: OptionalString.pipe(
+    Schema.annotateKey({ description: "Source, such as github or zendesk." }),
+  ),
 })
   .annotate({ description: "Linear issue attachments: links to pull requests, tickets, and more." })
   .pipe(Iceberg.identifier("id"));
@@ -161,14 +237,20 @@ export const AttachmentObjectSchema = AttachmentSchema.mapFields((fields) =>
 export const IssueLabelSchema = Schema.Struct({
   ...common("Label"),
   _deleted: deleted("label"),
-  name: Schema.String.pipe(field(10, "Label name.")),
-  description: OptionalString.pipe(field(11, "Label description.")),
-  color: Schema.String.pipe(field(12, "Label color, as hex.")),
-  is_group: Schema.Boolean.pipe(field(13, "Whether the label groups other labels.")),
-  parent_id: OptionalRef.pipe(field(14, "Label group.")),
-  team_id: OptionalRef.pipe(field(15, "Team, or null for a workspace label.")),
-  creator_id: OptionalRef.pipe(field(16, "User who made the label.")),
-  retired_at: OptionalTimestamp.pipe(field(17, "Time the label was retired.")),
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Label name." })),
+  description: OptionalString.pipe(Schema.annotateKey({ description: "Label description." })),
+  color: Schema.String.pipe(Schema.annotateKey({ description: "Label color, as hex." })),
+  is_group: Schema.Boolean.pipe(
+    Schema.annotateKey({ description: "Whether the label groups other labels." }),
+  ),
+  parent_id: OptionalRef.pipe(Schema.annotateKey({ description: "Label group." })),
+  team_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "Team, or null for a workspace label." }),
+  ),
+  creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the label." })),
+  retired_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the label was retired." }),
+  ),
 })
   .annotate({ description: "Linear issue labels. Names the IDs in `issues.label_ids`." })
   .pipe(Iceberg.identifier("id"));

package/src/schemas/projects.ts

@@ -10,41 +10,71 @@ import {
   RefList,
   common,
   deleted,
-  field,
-  list,
 } from "./shared";
 
 export const ProjectSchema = Schema.Struct({
   ...common("Project"),
   _deleted: deleted("project"),
-  name: Schema.String.pipe(field(10, "Project name.")),
-  description: Schema.String.pipe(field(11, "Short summary.")),
-  content: OptionalString.pipe(field(12, "Project overview in markdown.")),
-  url: Schema.String.pipe(field(13, "Project URL.")),
-  icon: OptionalString.pipe(field(14, "Icon.")),
-  color: Schema.String.pipe(field(15, "Color, as hex.")),
-  status_id: Ref.pipe(field(16, "Project status.")),
-  priority: Long.pipe(field(17, "0 none, 1 urgent, 2 high, 3 medium, 4 low.")),
-  priority_label: Schema.String.pipe(field(18, "Priority name.")),
-  health: OptionalString.pipe(field(19, "Health from the latest update.")),
-  health_updated_at: OptionalTimestamp.pipe(field(20, "Time the health last changed.")),
-  progress: Schema.Finite.pipe(field(21, "Share of the scope completed, from 0 to 1.")),
-  scope: Schema.Finite.pipe(field(22, "Total estimate of the project's issues.")),
-  lead_id: OptionalRef.pipe(field(23, "Project lead.")),
-  creator_id: OptionalRef.pipe(field(24, "User who made the project.")),
-  converted_from_issue_id: OptionalRef.pipe(field(25, "Issue the project was made from.")),
-  start_date: OptionalString.pipe(field(26, "Start date, as YYYY-MM-DD.")),
-  target_date: OptionalString.pipe(field(27, "Target date, as YYYY-MM-DD.")),
-  started_at: OptionalTimestamp.pipe(field(28, "Time the project started.")),
-  completed_at: OptionalTimestamp.pipe(field(29, "Time the project was completed.")),
-  canceled_at: OptionalTimestamp.pipe(field(30, "Time the project was canceled.")),
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Project name." })),
+  description: Schema.String.pipe(Schema.annotateKey({ description: "Short summary." })),
+  content: OptionalString.pipe(
+    Schema.annotateKey({ description: "Project overview in markdown." }),
+  ),
+  url: Schema.String.pipe(Schema.annotateKey({ description: "Project URL." })),
+  icon: OptionalString.pipe(Schema.annotateKey({ description: "Icon." })),
+  color: Schema.String.pipe(Schema.annotateKey({ description: "Color, as hex." })),
+  status_id: Ref.pipe(Schema.annotateKey({ description: "Project status." })),
+  priority: Long.pipe(
+    Schema.annotateKey({ description: "0 none, 1 urgent, 2 high, 3 medium, 4 low." }),
+  ),
+  priority_label: Schema.String.pipe(Schema.annotateKey({ description: "Priority name." })),
+  health: OptionalString.pipe(
+    Schema.annotateKey({ description: "Health from the latest update." }),
+  ),
+  health_updated_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the health last changed." }),
+  ),
+  progress: Schema.Finite.pipe(
+    Schema.annotateKey({ description: "Share of the scope completed, from 0 to 1." }),
+  ),
+  scope: Schema.Finite.pipe(
+    Schema.annotateKey({ description: "Total estimate of the project's issues." }),
+  ),
+  lead_id: OptionalRef.pipe(Schema.annotateKey({ description: "Project lead." })),
+  creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the project." })),
+  converted_from_issue_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "Issue the project was made from." }),
+  ),
+  start_date: OptionalString.pipe(
+    Schema.annotateKey({ description: "Start date, as YYYY-MM-DD." }),
+  ),
+  target_date: OptionalString.pipe(
+    Schema.annotateKey({ description: "Target date, as YYYY-MM-DD." }),
+  ),
+  started_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the project started." }),
+  ),
+  completed_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the project was completed." }),
+  ),
+  canceled_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the project was canceled." }),
+  ),
   auto_archived_at: OptionalTimestamp.pipe(
-    field(31, "Time the project was archived automatically."),
+    Schema.annotateKey({ description: "Time the project was archived automatically." }),
+  ),
+  label_ids: Schema.Array(Schema.String).pipe(
+    Schema.annotateKey({ description: "Project labels." }),
+  ),
+  team_ids: RefList.pipe(
+    Schema.annotateKey({ description: "Teams the project belongs to. Reads up to 50." }),
+  ),
+  member_ids: RefList.pipe(
+    Schema.annotateKey({ description: "Project members. Reads up to 100." }),
+  ),
+  trashed: Schema.NullOr(Schema.Boolean).pipe(
+    Schema.annotateKey({ description: "Whether the project is in the trash." }),
   ),
-  label_ids: list(101, Schema.String).pipe(field(32, "Project labels.")),
-  team_ids: RefList(102).pipe(field(33, "Teams the project belongs to. Reads up to 50.")),
-  member_ids: RefList(103).pipe(field(34, "Project members. Reads up to 100.")),
-  trashed: Schema.NullOr(Schema.Boolean).pipe(field(35, "Whether the project is in the trash.")),
 })
   .annotate({ description: "Linear projects, including archived and trashed ones." })
   .pipe(Iceberg.identifier("id"));
@@ -57,13 +87,19 @@ export const ProjectObjectSchema = ProjectSchema.mapFields((fields) =>
 
 export const ProjectMilestoneSchema = Schema.Struct({
   ...common("Milestone"),
-  name: Schema.String.pipe(field(10, "Milestone name.")),
-  description: OptionalString.pipe(field(11, "Description in markdown.")),
-  project_id: Ref.pipe(field(12, "Project.")),
-  target_date: OptionalString.pipe(field(13, "Target date, as YYYY-MM-DD.")),
-  status: Schema.String.pipe(field(14, "Status: unstarted, next, overdue, or done.")),
-  progress: Schema.Finite.pipe(field(15, "Share of the scope completed, from 0 to 1.")),
-  sort_order: Schema.Finite.pipe(field(16, "Order within the project.")),
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Milestone name." })),
+  description: OptionalString.pipe(Schema.annotateKey({ description: "Description in markdown." })),
+  project_id: Ref.pipe(Schema.annotateKey({ description: "Project." })),
+  target_date: OptionalString.pipe(
+    Schema.annotateKey({ description: "Target date, as YYYY-MM-DD." }),
+  ),
+  status: Schema.String.pipe(
+    Schema.annotateKey({ description: "Status: unstarted, next, overdue, or done." }),
+  ),
+  progress: Schema.Finite.pipe(
+    Schema.annotateKey({ description: "Share of the scope completed, from 0 to 1." }),
+  ),
+  sort_order: Schema.Finite.pipe(Schema.annotateKey({ description: "Order within the project." })),
 })
   .annotate({ description: "Linear project milestones. Deleted milestones aren't seen." })
   .pipe(Iceberg.identifier("id"));
@@ -77,13 +113,17 @@ export const ProjectMilestoneObjectSchema = ProjectMilestoneSchema.mapFields((fi
 export const ProjectUpdateSchema = Schema.Struct({
   ...common("Update"),
   _deleted: deleted("update"),
-  project_id: Ref.pipe(field(10, "Project.")),
-  user_id: Ref.pipe(field(11, "User who posted the update.")),
-  body: Schema.String.pipe(field(12, "Update text in markdown.")),
-  health: Schema.String.pipe(field(13, "Health: onTrack, atRisk, or offTrack.")),
-  url: Schema.String.pipe(field(14, "Update URL.")),
-  edited_at: OptionalTimestamp.pipe(field(15, "Time the update was last edited.")),
-  comment_count: Long.pipe(field(16, "Comments on the update.")),
+  project_id: Ref.pipe(Schema.annotateKey({ description: "Project." })),
+  user_id: Ref.pipe(Schema.annotateKey({ description: "User who posted the update." })),
+  body: Schema.String.pipe(Schema.annotateKey({ description: "Update text in markdown." })),
+  health: Schema.String.pipe(
+    Schema.annotateKey({ description: "Health: onTrack, atRisk, or offTrack." }),
+  ),
+  url: Schema.String.pipe(Schema.annotateKey({ description: "Update URL." })),
+  edited_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the update was last edited." }),
+  ),
+  comment_count: Long.pipe(Schema.annotateKey({ description: "Comments on the update." })),
 })
   .annotate({ description: "Linear project updates: status posts with a health." })
   .pipe(Iceberg.identifier("id"));
@@ -96,13 +136,15 @@ export const ProjectUpdateObjectSchema = ProjectUpdateSchema.mapFields((fields)
 
 export const ProjectStatusSchema = Schema.Struct({
   ...common("Status"),
-  name: Schema.String.pipe(field(10, "Status name.")),
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Status name." })),
   type: Schema.String.pipe(
-    field(11, "Status type: backlog, planned, started, paused, completed, or canceled."),
+    Schema.annotateKey({
+      description: "Status type: backlog, planned, started, paused, completed, or canceled.",
+    }),
   ),
-  color: Schema.String.pipe(field(12, "Color, as hex.")),
-  description: OptionalString.pipe(field(13, "Description.")),
-  position: Schema.Finite.pipe(field(14, "Order in the list.")),
+  color: Schema.String.pipe(Schema.annotateKey({ description: "Color, as hex." })),
+  description: OptionalString.pipe(Schema.annotateKey({ description: "Description." })),
+  position: Schema.Finite.pipe(Schema.annotateKey({ description: "Order in the list." })),
 })
   .annotate({ description: "Linear project statuses. Names the IDs in `projects.status_id`." })
   .pipe(Iceberg.identifier("id"));
@@ -116,13 +158,17 @@ export const ProjectStatusObjectSchema = ProjectStatusSchema.mapFields((fields)
 export const ProjectLabelSchema = Schema.Struct({
   ...common("Label"),
   _deleted: deleted("label"),
-  name: Schema.String.pipe(field(10, "Label name.")),
-  description: OptionalString.pipe(field(11, "Label description.")),
-  color: Schema.String.pipe(field(12, "Label color, as hex.")),
-  is_group: Schema.Boolean.pipe(field(13, "Whether the label groups other labels.")),
-  parent_id: OptionalRef.pipe(field(14, "Label group.")),
-  creator_id: OptionalRef.pipe(field(15, "User who made the label.")),
-  retired_at: OptionalTimestamp.pipe(field(16, "Time the label was retired.")),
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Label name." })),
+  description: OptionalString.pipe(Schema.annotateKey({ description: "Label description." })),
+  color: Schema.String.pipe(Schema.annotateKey({ description: "Label color, as hex." })),
+  is_group: Schema.Boolean.pipe(
+    Schema.annotateKey({ description: "Whether the label groups other labels." }),
+  ),
+  parent_id: OptionalRef.pipe(Schema.annotateKey({ description: "Label group." })),
+  creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the label." })),
+  retired_at: OptionalTimestamp.pipe(
+    Schema.annotateKey({ description: "Time the label was retired." }),
+  ),
 })
   .annotate({ description: "Linear project labels. Names the IDs in `projects.label_ids`." })
   .pipe(Iceberg.identifier("id"));
@@ -135,14 +181,24 @@ export const ProjectLabelObjectSchema = ProjectLabelSchema.mapFields((fields) =>
 
 export const ProjectRelationSchema = Schema.Struct({
   ...common("Relation"),
-  type: Schema.String.pipe(field(10, "Relation type, such as dependency.")),
-  project_id: Ref.pipe(field(11, "Project the relation starts from.")),
-  project_milestone_id: OptionalRef.pipe(field(12, "Milestone the relation starts from.")),
-  anchor_type: Schema.String.pipe(field(13, "Which end of the project it starts from.")),
-  related_project_id: Ref.pipe(field(14, "Related project.")),
-  related_project_milestone_id: OptionalRef.pipe(field(15, "Related milestone.")),
-  related_anchor_type: Schema.String.pipe(field(16, "Which end of the related project.")),
-  user_id: OptionalRef.pipe(field(17, "User who made the relation.")),
+  type: Schema.String.pipe(
+    Schema.annotateKey({ description: "Relation type, such as dependency." }),
+  ),
+  project_id: Ref.pipe(Schema.annotateKey({ description: "Project the relation starts from." })),
+  project_milestone_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "Milestone the relation starts from." }),
+  ),
+  anchor_type: Schema.String.pipe(
+    Schema.annotateKey({ description: "Which end of the project it starts from." }),
+  ),
+  related_project_id: Ref.pipe(Schema.annotateKey({ description: "Related project." })),
+  related_project_milestone_id: OptionalRef.pipe(
+    Schema.annotateKey({ description: "Related milestone." }),
+  ),
+  related_anchor_type: Schema.String.pipe(
+    Schema.annotateKey({ description: "Which end of the related project." }),
+  ),
+  user_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the relation." })),
 })
   .annotate({ description: "Linear project dependencies. Deleted relations aren't seen." })
   .pipe(Iceberg.identifier("id"));