@useairfoil/producer-linear 0.0.2 → 0.0.3

package/dist/{src-Ci3_ltan.mjs → src-BbzySPR7.mjs}

@@ -91,7 +91,6 @@ const layer$1 = (config) => Layer.effect(LinearClient)(make$1(config));
 const layerConfig$1 = (config) => Layer.unwrap(Config.unwrap(config).pipe(Effect.map(layer$1)));
 //#endregion
 //#region src/schemas/shared.ts
-const field = (fieldId, description) => Iceberg.field(fieldId, { description });
 const Timestamp = Schema.DateFromString;
 /** Decodes a GraphQL Int as bigint for an Iceberg long. */
 const Long = Schema.Int.pipe(Schema.decodeTo(Schema.BigInt, SchemaTransformation.transform({
@@ -106,42 +105,40 @@ const Ref = Schema.Struct({ id: Schema.String }).pipe(Schema.decodeTo(Schema.Str
 const OptionalRef = Schema.NullOr(Ref);
 const OptionalTimestamp = Schema.NullOr(Timestamp);
 const OptionalString = Schema.NullOr(Schema.String);
-const RefConnection = Schema.Struct({ nodes: Schema.Array(Schema.Struct({ id: Schema.String })) });
 /** Decodes connection nodes as IDs. The query must fetch any extra pages. */
-const RefList = (elementId) => RefConnection.pipe(Schema.decodeTo(Schema.Array(Schema.String.annotate({ fieldId: elementId })), SchemaTransformation.transform({
+const RefList = Schema.Struct({ nodes: Schema.Array(Schema.Struct({ id: Schema.String })) }).pipe(Schema.decodeTo(Schema.Array(Schema.String), SchemaTransformation.transform({
 	decode: (connection) => connection.nodes.map((node) => node.id),
 	encode: (ids) => ({ nodes: ids.map((id) => ({ id })) })
 })));
-const list = (elementId, item) => Schema.Array(item.annotate({ fieldId: elementId }));
 /** Rows use updated_at as version; lifecycle webhooks use the webhook time. */
 const common = (object) => ({
-	id: Schema.String.pipe(field(1, `${object} ID.`)),
-	version: Schema.Date.pipe(field(2, `Time Linear last changed the ${object.toLowerCase()}.`)),
-	created_at: Timestamp.pipe(field(3, `Time the ${object.toLowerCase()} was created.`)),
-	updated_at: Timestamp.pipe(field(4, `Time the ${object.toLowerCase()} was last updated.`)),
-	archived_at: Schema.NullOr(Timestamp).pipe(field(5, `Time the ${object.toLowerCase()} was archived or trashed.`))
+	id: Schema.String.pipe(Schema.annotateKey({ description: `${object} ID.` })),
+	version: Schema.Date.pipe(Schema.annotateKey({ description: `Time Linear last changed the ${object.toLowerCase()}.` })),
+	created_at: Timestamp.pipe(Schema.annotateKey({ description: `Time the ${object.toLowerCase()} was created.` })),
+	updated_at: Timestamp.pipe(Schema.annotateKey({ description: `Time the ${object.toLowerCase()} was last updated.` })),
+	archived_at: Schema.NullOr(Timestamp).pipe(Schema.annotateKey({ description: `Time the ${object.toLowerCase()} was archived or trashed.` }))
 });
-const deleted = (object) => Schema.optional(Schema.Boolean).pipe(field(6, `Whether the ${object} was deleted in Linear.`));
+const deleted = (object) => Schema.optional(Schema.Boolean).pipe(Schema.annotateKey({ description: `Whether the ${object} was deleted in Linear.` }));
 //#endregion
 //#region src/schemas/comments.ts
 const CommentSchema = Schema.Struct({
 	...common("Comment"),
 	_deleted: deleted("comment"),
-	body: Schema.String.pipe(field(10, "Comment text in markdown.")),
-	user_id: OptionalRef.pipe(field(11, "User who wrote the comment.")),
-	external_user_id: OptionalRef.pipe(field(12, "External user who wrote the comment.")),
-	issue_id: OptionalString.pipe(field(13, "Issue the comment is on.")),
-	project_id: OptionalString.pipe(field(14, "Project the comment is on.")),
-	project_update_id: OptionalString.pipe(field(15, "Project update the comment is on.")),
-	initiative_id: OptionalString.pipe(field(16, "Initiative the comment is on.")),
-	initiative_update_id: OptionalString.pipe(field(17, "Initiative update the comment is on.")),
-	document_content_id: OptionalString.pipe(field(18, "Document content the comment is on.")),
-	parent_id: OptionalString.pipe(field(19, "Comment this one replies to.")),
-	quoted_text: OptionalString.pipe(field(20, "Text the comment quotes.")),
-	edited_at: OptionalTimestamp.pipe(field(21, "Time the comment was last edited.")),
-	resolved_at: OptionalTimestamp.pipe(field(22, "Time the thread was resolved.")),
-	resolving_user_id: OptionalRef.pipe(field(23, "User who resolved the thread.")),
-	url: Schema.String.pipe(field(24, "Comment URL."))
+	body: Schema.String.pipe(Schema.annotateKey({ description: "Comment text in markdown." })),
+	user_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who wrote the comment." })),
+	external_user_id: OptionalRef.pipe(Schema.annotateKey({ description: "External user who wrote the comment." })),
+	issue_id: OptionalString.pipe(Schema.annotateKey({ description: "Issue the comment is on." })),
+	project_id: OptionalString.pipe(Schema.annotateKey({ description: "Project the comment is on." })),
+	project_update_id: OptionalString.pipe(Schema.annotateKey({ description: "Project update the comment is on." })),
+	initiative_id: OptionalString.pipe(Schema.annotateKey({ description: "Initiative the comment is on." })),
+	initiative_update_id: OptionalString.pipe(Schema.annotateKey({ description: "Initiative update the comment is on." })),
+	document_content_id: OptionalString.pipe(Schema.annotateKey({ description: "Document content the comment is on." })),
+	parent_id: OptionalString.pipe(Schema.annotateKey({ description: "Comment this one replies to." })),
+	quoted_text: OptionalString.pipe(Schema.annotateKey({ description: "Text the comment quotes." })),
+	edited_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the comment was last edited." })),
+	resolved_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the thread was resolved." })),
+	resolving_user_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who resolved the thread." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Comment URL." }))
 }).annotate({ description: "Linear comments on issues, projects, initiatives, and updates." }).pipe(Iceberg.identifier("id"));
 const CommentObjectSchema = CommentSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 //#endregion
@@ -344,41 +341,41 @@ const makeComments = (client) => Resource.entity({
 const CustomerSchema = Schema.Struct({
 	...common("Customer"),
 	_deleted: deleted("customer"),
-	name: Schema.String.pipe(field(10, "Customer name.")),
-	domains: list(101, Schema.String).pipe(field(11, "Email domains of the customer.")),
-	external_ids: list(102, Schema.String).pipe(field(12, "IDs in other systems.")),
-	logo_url: OptionalString.pipe(field(13, "Logo URL.")),
-	owner_id: OptionalRef.pipe(field(14, "User who owns the customer.")),
-	status_id: Ref.pipe(field(15, "Customer status.")),
-	tier_id: OptionalRef.pipe(field(16, "Customer tier.")),
-	revenue: Schema.NullOr(Long).pipe(field(17, "Annual revenue.")),
-	size: Schema.NullOr(Schema.Finite).pipe(field(18, "Company size.")),
-	approximate_need_count: Schema.Finite.pipe(field(19, "About how many requests it has.")),
-	url: Schema.String.pipe(field(20, "Customer URL."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Customer name." })),
+	domains: Schema.Array(Schema.String).pipe(Schema.annotateKey({ description: "Email domains of the customer." })),
+	external_ids: Schema.Array(Schema.String).pipe(Schema.annotateKey({ description: "IDs in other systems." })),
+	logo_url: OptionalString.pipe(Schema.annotateKey({ description: "Logo URL." })),
+	owner_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who owns the customer." })),
+	status_id: Ref.pipe(Schema.annotateKey({ description: "Customer status." })),
+	tier_id: OptionalRef.pipe(Schema.annotateKey({ description: "Customer tier." })),
+	revenue: Schema.NullOr(Long).pipe(Schema.annotateKey({ description: "Annual revenue." })),
+	size: Schema.NullOr(Schema.Finite).pipe(Schema.annotateKey({ description: "Company size." })),
+	approximate_need_count: Schema.Finite.pipe(Schema.annotateKey({ description: "About how many requests it has." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Customer URL." }))
 }).annotate({ description: "Linear customers." }).pipe(Iceberg.identifier("id"));
 const CustomerObjectSchema = CustomerSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 const CustomerNeedSchema = Schema.Struct({
 	...common("Request"),
 	_deleted: deleted("request"),
-	customer_id: OptionalRef.pipe(field(10, "Customer.")),
-	issue_id: OptionalRef.pipe(field(11, "Issue the request is linked to.")),
-	project_id: OptionalRef.pipe(field(12, "Project the request is linked to.")),
-	original_issue_id: OptionalRef.pipe(field(13, "Issue the request was first linked to.")),
-	comment_id: OptionalRef.pipe(field(14, "Comment the request came from.")),
-	attachment_id: OptionalRef.pipe(field(15, "Attachment the request came from.")),
-	creator_id: OptionalRef.pipe(field(16, "User who added the request.")),
-	body: OptionalString.pipe(field(17, "Request text in markdown.")),
-	priority: Schema.Finite.pipe(field(18, "0 normal, 1 important.")),
-	url: OptionalString.pipe(field(19, "Source URL."))
+	customer_id: OptionalRef.pipe(Schema.annotateKey({ description: "Customer." })),
+	issue_id: OptionalRef.pipe(Schema.annotateKey({ description: "Issue the request is linked to." })),
+	project_id: OptionalRef.pipe(Schema.annotateKey({ description: "Project the request is linked to." })),
+	original_issue_id: OptionalRef.pipe(Schema.annotateKey({ description: "Issue the request was first linked to." })),
+	comment_id: OptionalRef.pipe(Schema.annotateKey({ description: "Comment the request came from." })),
+	attachment_id: OptionalRef.pipe(Schema.annotateKey({ description: "Attachment the request came from." })),
+	creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who added the request." })),
+	body: OptionalString.pipe(Schema.annotateKey({ description: "Request text in markdown." })),
+	priority: Schema.Finite.pipe(Schema.annotateKey({ description: "0 normal, 1 important." })),
+	url: OptionalString.pipe(Schema.annotateKey({ description: "Source URL." }))
 }).annotate({ description: "Linear customer requests, linked to issues or projects." }).pipe(Iceberg.identifier("id"));
 const CustomerNeedObjectSchema = CustomerNeedSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 const levelFields$1 = (object) => ({
 	...common(object),
-	name: Schema.String.pipe(field(10, "Name.")),
-	display_name: Schema.String.pipe(field(11, "Name shown in Linear.")),
-	description: OptionalString.pipe(field(12, "Description.")),
-	color: Schema.String.pipe(field(13, "Color, as hex.")),
-	position: Schema.Finite.pipe(field(14, "Order in the list."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Name." })),
+	display_name: Schema.String.pipe(Schema.annotateKey({ description: "Name shown in Linear." })),
+	description: OptionalString.pipe(Schema.annotateKey({ description: "Description." })),
+	color: Schema.String.pipe(Schema.annotateKey({ description: "Color, as hex." })),
+	position: Schema.Finite.pipe(Schema.annotateKey({ description: "Order in the list." }))
 });
 const CustomerStatusSchema = Schema.Struct(levelFields$1("Status")).annotate({ description: "Linear customer statuses. Names the IDs in `customers.status_id`." }).pipe(Iceberg.identifier("id"));
 const CustomerStatusObjectSchema = CustomerStatusSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
@@ -472,21 +469,21 @@ const makeCustomerTiers = (client) => Resource.entity({
 const DocumentSchema = Schema.Struct({
 	...common("Document"),
 	_deleted: deleted("document"),
-	title: Schema.String.pipe(field(10, "Title.")),
-	content: OptionalString.pipe(field(11, "Content in markdown.")),
-	url: Schema.String.pipe(field(12, "Document URL.")),
-	icon: OptionalString.pipe(field(13, "Icon.")),
-	color: OptionalString.pipe(field(14, "Icon color.")),
-	creator_id: OptionalRef.pipe(field(15, "User who made the document.")),
-	updated_by_id: OptionalRef.pipe(field(16, "User who last changed the document.")),
-	project_id: OptionalRef.pipe(field(17, "Project the document is in.")),
-	initiative_id: OptionalRef.pipe(field(18, "Initiative the document is in.")),
-	issue_id: OptionalRef.pipe(field(19, "Issue the document is in.")),
-	cycle_id: OptionalRef.pipe(field(20, "Cycle the document is in.")),
-	team_id: OptionalRef.pipe(field(21, "Team the document is in.")),
-	parent_document_id: OptionalRef.pipe(field(22, "Parent document.")),
-	hidden_at: OptionalTimestamp.pipe(field(23, "Time the document was hidden.")),
-	trashed: Schema.NullOr(Schema.Boolean).pipe(field(24, "Whether the document is in the trash."))
+	title: Schema.String.pipe(Schema.annotateKey({ description: "Title." })),
+	content: OptionalString.pipe(Schema.annotateKey({ description: "Content in markdown." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Document URL." })),
+	icon: OptionalString.pipe(Schema.annotateKey({ description: "Icon." })),
+	color: OptionalString.pipe(Schema.annotateKey({ description: "Icon color." })),
+	creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the document." })),
+	updated_by_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who last changed the document." })),
+	project_id: OptionalRef.pipe(Schema.annotateKey({ description: "Project the document is in." })),
+	initiative_id: OptionalRef.pipe(Schema.annotateKey({ description: "Initiative the document is in." })),
+	issue_id: OptionalRef.pipe(Schema.annotateKey({ description: "Issue the document is in." })),
+	cycle_id: OptionalRef.pipe(Schema.annotateKey({ description: "Cycle the document is in." })),
+	team_id: OptionalRef.pipe(Schema.annotateKey({ description: "Team the document is in." })),
+	parent_document_id: OptionalRef.pipe(Schema.annotateKey({ description: "Parent document." })),
+	hidden_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the document was hidden." })),
+	trashed: Schema.NullOr(Schema.Boolean).pipe(Schema.annotateKey({ description: "Whether the document is in the trash." }))
 }).annotate({ description: "Linear documents, including archived and trashed ones." }).pipe(Iceberg.identifier("id"));
 //#endregion
 //#region src/resources/documents.ts
@@ -520,64 +517,64 @@ const makeDocuments = (client) => Resource.entity({
 const InitiativeSchema = Schema.Struct({
 	...common("Initiative"),
 	_deleted: deleted("initiative"),
-	name: Schema.String.pipe(field(10, "Initiative name.")),
-	description: OptionalString.pipe(field(11, "Short summary.")),
-	content: OptionalString.pipe(field(12, "Initiative overview in markdown.")),
-	url: Schema.String.pipe(field(13, "Initiative URL.")),
-	icon: OptionalString.pipe(field(14, "Icon.")),
-	color: OptionalString.pipe(field(15, "Color, as hex.")),
-	status: Schema.String.pipe(field(16, "Status: Planned, Active, or Completed.")),
-	health: OptionalString.pipe(field(17, "Health from the latest update.")),
-	health_updated_at: OptionalTimestamp.pipe(field(18, "Time the health last changed.")),
-	priority: Long.pipe(field(19, "0 none, 1 urgent, 2 high, 3 medium, 4 low.")),
-	owner_id: OptionalRef.pipe(field(20, "Initiative owner.")),
-	creator_id: OptionalRef.pipe(field(21, "User who made the initiative.")),
-	parent_initiative_id: OptionalRef.pipe(field(22, "Parent initiative.")),
-	target_date: OptionalString.pipe(field(23, "Target date, as YYYY-MM-DD.")),
-	started_at: OptionalTimestamp.pipe(field(24, "Time the initiative started.")),
-	completed_at: OptionalTimestamp.pipe(field(25, "Time the initiative was completed.")),
-	canceled_at: OptionalTimestamp.pipe(field(26, "Time the initiative was canceled.")),
-	label_ids: list(101, Schema.String).pipe(field(27, "Initiative labels.")),
-	visibility: Schema.String.pipe(field(28, "Who can see the initiative.")),
-	trashed: Schema.NullOr(Schema.Boolean).pipe(field(29, "Whether the initiative is in the trash."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Initiative name." })),
+	description: OptionalString.pipe(Schema.annotateKey({ description: "Short summary." })),
+	content: OptionalString.pipe(Schema.annotateKey({ description: "Initiative overview in markdown." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Initiative URL." })),
+	icon: OptionalString.pipe(Schema.annotateKey({ description: "Icon." })),
+	color: OptionalString.pipe(Schema.annotateKey({ description: "Color, as hex." })),
+	status: Schema.String.pipe(Schema.annotateKey({ description: "Status: Planned, Active, or Completed." })),
+	health: OptionalString.pipe(Schema.annotateKey({ description: "Health from the latest update." })),
+	health_updated_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the health last changed." })),
+	priority: Long.pipe(Schema.annotateKey({ description: "0 none, 1 urgent, 2 high, 3 medium, 4 low." })),
+	owner_id: OptionalRef.pipe(Schema.annotateKey({ description: "Initiative owner." })),
+	creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the initiative." })),
+	parent_initiative_id: OptionalRef.pipe(Schema.annotateKey({ description: "Parent initiative." })),
+	target_date: OptionalString.pipe(Schema.annotateKey({ description: "Target date, as YYYY-MM-DD." })),
+	started_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the initiative started." })),
+	completed_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the initiative was completed." })),
+	canceled_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the initiative was canceled." })),
+	label_ids: Schema.Array(Schema.String).pipe(Schema.annotateKey({ description: "Initiative labels." })),
+	visibility: Schema.String.pipe(Schema.annotateKey({ description: "Who can see the initiative." })),
+	trashed: Schema.NullOr(Schema.Boolean).pipe(Schema.annotateKey({ description: "Whether the initiative is in the trash." }))
 }).annotate({ description: "Linear initiatives, including archived and trashed ones." }).pipe(Iceberg.identifier("id"));
 const InitiativeObjectSchema = InitiativeSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 const InitiativeUpdateSchema = Schema.Struct({
 	...common("Update"),
 	_deleted: deleted("update"),
-	initiative_id: Ref.pipe(field(10, "Initiative.")),
-	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."))
+	initiative_id: Ref.pipe(Schema.annotateKey({ description: "Initiative." })),
+	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 initiative updates: status posts with a health." }).pipe(Iceberg.identifier("id"));
 const InitiativeUpdateObjectSchema = InitiativeUpdateSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 const InitiativeLabelSchema = Schema.Struct({
 	...common("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 initiative labels. Names the IDs in `initiatives.label_ids`." }).pipe(Iceberg.identifier("id"));
 const InitiativeLabelObjectSchema = InitiativeLabelSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const InitiativeRelationSchema = Schema.Struct({
 	...common("Relation"),
-	initiative_id: Ref.pipe(field(10, "Initiative the relation starts from.")),
-	related_initiative_id: Ref.pipe(field(11, "Related initiative.")),
-	sort_order: Schema.Finite.pipe(field(12, "Order.")),
-	user_id: OptionalRef.pipe(field(13, "User who made the relation."))
+	initiative_id: Ref.pipe(Schema.annotateKey({ description: "Initiative the relation starts from." })),
+	related_initiative_id: Ref.pipe(Schema.annotateKey({ description: "Related initiative." })),
+	sort_order: Schema.Finite.pipe(Schema.annotateKey({ description: "Order." })),
+	user_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the relation." }))
 }).annotate({ description: "Linear initiative relations. Deleted relations aren't seen." }).pipe(Iceberg.identifier("id"));
 const InitiativeRelationObjectSchema = InitiativeRelationSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const InitiativeToProjectSchema = Schema.Struct({
 	...common("Link"),
-	initiative_id: Ref.pipe(field(10, "Initiative.")),
-	project_id: Ref.pipe(field(11, "Project.")),
-	sort_order: Schema.String.pipe(field(12, "Order within the initiative."))
+	initiative_id: Ref.pipe(Schema.annotateKey({ description: "Initiative." })),
+	project_id: Ref.pipe(Schema.annotateKey({ description: "Project." })),
+	sort_order: Schema.String.pipe(Schema.annotateKey({ description: "Order within the initiative." }))
 }).annotate({ description: "Links between Linear initiatives and projects. Removed links aren't seen." }).pipe(Iceberg.identifier("id"));
 const InitiativeToProjectObjectSchema = InitiativeToProjectSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 //#endregion
@@ -692,115 +689,115 @@ const makeInitiativeToProjects = (client) => Resource.entity({
 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.")),
-	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.")),
-	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."))
+	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(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(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"));
 const IssueObjectSchema = IssueSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 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.")),
-	updated_description: Schema.NullOr(Schema.Boolean).pipe(field(37, "Whether the description changed.")),
-	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.")),
-	auto_closed: Schema.NullOr(Schema.Boolean).pipe(field(41, "Whether the issue was closed automatically."))
+	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(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." })),
+	auto_archived: Schema.NullOr(Schema.Boolean).pipe(Schema.annotateKey({ description: "Whether the issue was archived automatically." })),
+	auto_closed: Schema.NullOr(Schema.Boolean).pipe(Schema.annotateKey({ description: "Whether the issue was closed automatically." }))
 }).annotate({ description: "Linear issue history. One row per change to an issue." }).pipe(Iceberg.identifier("id"));
 const IssueHistoryObjectSchema = IssueHistorySchema.mapFields((fields) => Struct.omit(fields, ["version", "issue_id"]));
 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"));
 const IssueRelationObjectSchema = IssueRelationSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 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"));
 const AttachmentObjectSchema = AttachmentSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 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"));
 const IssueLabelObjectSchema = IssueLabelSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 //#endregion
@@ -983,88 +980,88 @@ const makeIssueLabels = (client) => Resource.entity({
 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.")),
-	auto_archived_at: OptionalTimestamp.pipe(field(31, "Time the project was archived automatically.")),
-	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."))
+	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(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." }))
 }).annotate({ description: "Linear projects, including archived and trashed ones." }).pipe(Iceberg.identifier("id"));
 const ProjectObjectSchema = ProjectSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 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"));
 const ProjectMilestoneObjectSchema = ProjectMilestoneSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 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"));
 const ProjectUpdateObjectSchema = ProjectUpdateSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 const ProjectStatusSchema = Schema.Struct({
 	...common("Status"),
-	name: Schema.String.pipe(field(10, "Status name.")),
-	type: Schema.String.pipe(field(11, "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."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Status name." })),
+	type: Schema.String.pipe(Schema.annotateKey({ description: "Status type: backlog, planned, started, paused, completed, or canceled." })),
+	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"));
 const ProjectStatusObjectSchema = ProjectStatusSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 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"));
 const ProjectLabelObjectSchema = ProjectLabelSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 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"));
 const ProjectRelationObjectSchema = ProjectRelationSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 //#endregion
@@ -1205,59 +1202,59 @@ const makeProjectRelations = (client) => Resource.entity({
 //#region src/schemas/releases.ts
 const ReleaseSchema = Schema.Struct({
 	...common("Release"),
-	name: Schema.String.pipe(field(10, "Release name.")),
-	description: OptionalString.pipe(field(11, "Description.")),
-	release_version: OptionalString.pipe(field(12, "Version, such as 1.2.0.")),
-	url: Schema.String.pipe(field(13, "Release URL.")),
-	commit_sha: OptionalString.pipe(field(14, "Commit SHA.")),
-	pipeline_id: Ref.pipe(field(15, "Release pipeline.")),
-	stage_id: Ref.pipe(field(16, "Release stage.")),
-	creator_id: OptionalRef.pipe(field(17, "User who made the release.")),
-	start_date: OptionalString.pipe(field(18, "Start date, as YYYY-MM-DD.")),
-	target_date: OptionalString.pipe(field(19, "Target date, as YYYY-MM-DD.")),
-	started_at: OptionalTimestamp.pipe(field(20, "Time the release started.")),
-	completed_at: OptionalTimestamp.pipe(field(21, "Time the release was completed.")),
-	canceled_at: OptionalTimestamp.pipe(field(22, "Time the release was canceled.")),
-	trashed: Schema.NullOr(Schema.Boolean).pipe(field(23, "Whether the release is in the trash."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Release name." })),
+	description: OptionalString.pipe(Schema.annotateKey({ description: "Description." })),
+	release_version: OptionalString.pipe(Schema.annotateKey({ description: "Version, such as 1.2.0." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Release URL." })),
+	commit_sha: OptionalString.pipe(Schema.annotateKey({ description: "Commit SHA." })),
+	pipeline_id: Ref.pipe(Schema.annotateKey({ description: "Release pipeline." })),
+	stage_id: Ref.pipe(Schema.annotateKey({ description: "Release stage." })),
+	creator_id: OptionalRef.pipe(Schema.annotateKey({ description: "User who made the release." })),
+	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 release started." })),
+	completed_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the release was completed." })),
+	canceled_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the release was canceled." })),
+	trashed: Schema.NullOr(Schema.Boolean).pipe(Schema.annotateKey({ description: "Whether the release is in the trash." }))
 }).annotate({ description: "Linear releases. Needs the Business plan." }).pipe(Iceberg.identifier("id"));
 const ReleaseObjectSchema = ReleaseSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const ReleaseNoteSchema = Schema.Struct({
 	...common("Release note"),
-	title: OptionalString.pipe(field(10, "Release note title.")),
+	title: OptionalString.pipe(Schema.annotateKey({ description: "Release note title." })),
 	content: Schema.NullOr(Schema.Struct({ content: OptionalString })).pipe(Schema.decodeTo(OptionalString, SchemaTransformation.transform({
 		decode: (document) => document?.content ?? null,
 		encode: (content) => content === null ? null : { content }
-	})), field(11, "Release note body in markdown.")),
-	url: Schema.String.pipe(field(12, "Release note URL.")),
-	pipeline_id: Ref.pipe(field(13, "Release pipeline.")),
-	release_ids: list(101, Ref).pipe(field(14, "Releases covered by the note."))
+	})), Schema.annotateKey({ description: "Release note body in markdown." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Release note URL." })),
+	pipeline_id: Ref.pipe(Schema.annotateKey({ description: "Release pipeline." })),
+	release_ids: Schema.Array(Ref).pipe(Schema.annotateKey({ description: "Releases covered by the note." }))
 }).annotate({ description: "Linear release notes. Needs the Business plan." }).pipe(Iceberg.identifier("id"));
 const ReleaseNoteObjectSchema = ReleaseNoteSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const ReleasePipelineSchema = Schema.Struct({
 	...common("Pipeline"),
-	name: Schema.String.pipe(field(10, "Pipeline name.")),
-	type: Schema.String.pipe(field(11, "Pipeline type.")),
-	is_production: Schema.Boolean.pipe(field(12, "Whether it releases to production.")),
-	url: Schema.String.pipe(field(13, "Pipeline URL.")),
-	include_path_patterns: list(101, Schema.String).pipe(field(14, "File paths that count toward the pipeline.")),
-	approximate_release_count: Long.pipe(field(15, "About how many releases it has.")),
-	trashed: Schema.NullOr(Schema.Boolean).pipe(field(16, "Whether the pipeline is in the trash."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Pipeline name." })),
+	type: Schema.String.pipe(Schema.annotateKey({ description: "Pipeline type." })),
+	is_production: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether it releases to production." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Pipeline URL." })),
+	include_path_patterns: Schema.Array(Schema.String).pipe(Schema.annotateKey({ description: "File paths that count toward the pipeline." })),
+	approximate_release_count: Long.pipe(Schema.annotateKey({ description: "About how many releases it has." })),
+	trashed: Schema.NullOr(Schema.Boolean).pipe(Schema.annotateKey({ description: "Whether the pipeline is in the trash." }))
 }).annotate({ description: "Linear release pipelines. Needs the Business plan." }).pipe(Iceberg.identifier("id"));
 const ReleasePipelineObjectSchema = ReleasePipelineSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const ReleaseStageSchema = Schema.Struct({
 	...common("Stage"),
-	name: Schema.String.pipe(field(10, "Stage name.")),
-	type: Schema.String.pipe(field(11, "Stage type.")),
-	color: Schema.String.pipe(field(12, "Color, as hex.")),
-	position: Schema.Finite.pipe(field(13, "Order in the pipeline.")),
-	frozen: Schema.Boolean.pipe(field(14, "Whether the stage is frozen.")),
-	pipeline_id: Ref.pipe(field(15, "Release pipeline."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Stage name." })),
+	type: Schema.String.pipe(Schema.annotateKey({ description: "Stage type." })),
+	color: Schema.String.pipe(Schema.annotateKey({ description: "Color, as hex." })),
+	position: Schema.Finite.pipe(Schema.annotateKey({ description: "Order in the pipeline." })),
+	frozen: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the stage is frozen." })),
+	pipeline_id: Ref.pipe(Schema.annotateKey({ description: "Release pipeline." }))
 }).annotate({ description: "Linear release stages. Needs the Business plan." }).pipe(Iceberg.identifier("id"));
 const ReleaseStageObjectSchema = ReleaseStageSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const IssueToReleaseSchema = Schema.Struct({
 	...common("Link"),
-	issue_id: Ref.pipe(field(10, "Issue.")),
-	release_id: Ref.pipe(field(11, "Release."))
+	issue_id: Ref.pipe(Schema.annotateKey({ description: "Issue." })),
+	release_id: Ref.pipe(Schema.annotateKey({ description: "Release." }))
 }).annotate({ description: "Links between Linear issues and releases. Needs the Business plan." }).pipe(Iceberg.identifier("id"));
 const IssueToReleaseObjectSchema = IssueToReleaseSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 //#endregion
@@ -1360,81 +1357,81 @@ const makeIssueToReleases = (client) => Resource.entity({
 //#region src/schemas/teams.ts
 const TeamSchema = Schema.Struct({
 	...common("Team"),
-	name: Schema.String.pipe(field(10, "Team name.")),
-	key: Schema.String.pipe(field(11, "Team key, used in issue IDs such as ENG-123.")),
-	display_name: Schema.String.pipe(field(12, "Name shown in Linear.")),
-	description: OptionalString.pipe(field(13, "Team description.")),
-	visibility: Schema.String.pipe(field(14, "Who can see the team.")),
-	parent_id: OptionalRef.pipe(field(15, "Parent team.")),
-	timezone: Schema.String.pipe(field(16, "Team timezone.")),
-	cycles_enabled: Schema.Boolean.pipe(field(17, "Whether the team uses cycles.")),
-	cycle_duration: Schema.Finite.pipe(field(18, "Cycle length in weeks.")),
-	cycle_cooldown_time: Schema.Finite.pipe(field(19, "Weeks between cycles.")),
-	cycle_start_day: Schema.Finite.pipe(field(20, "Day cycles start, 0 for Sunday.")),
-	triage_enabled: Schema.Boolean.pipe(field(21, "Whether the team uses triage.")),
-	issue_estimation_type: Schema.String.pipe(field(22, "Estimate scale.")),
-	default_issue_estimate: Schema.Finite.pipe(field(23, "Default estimate.")),
-	auto_archive_period: Schema.Finite.pipe(field(24, "Months before closed issues are archived.")),
-	auto_close_period: Schema.NullOr(Schema.Finite).pipe(field(25, "Months before stale issues are closed.")),
-	retired_at: OptionalTimestamp.pipe(field(26, "Time the team was retired."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Team name." })),
+	key: Schema.String.pipe(Schema.annotateKey({ description: "Team key, used in issue IDs such as ENG-123." })),
+	display_name: Schema.String.pipe(Schema.annotateKey({ description: "Name shown in Linear." })),
+	description: OptionalString.pipe(Schema.annotateKey({ description: "Team description." })),
+	visibility: Schema.String.pipe(Schema.annotateKey({ description: "Who can see the team." })),
+	parent_id: OptionalRef.pipe(Schema.annotateKey({ description: "Parent team." })),
+	timezone: Schema.String.pipe(Schema.annotateKey({ description: "Team timezone." })),
+	cycles_enabled: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the team uses cycles." })),
+	cycle_duration: Schema.Finite.pipe(Schema.annotateKey({ description: "Cycle length in weeks." })),
+	cycle_cooldown_time: Schema.Finite.pipe(Schema.annotateKey({ description: "Weeks between cycles." })),
+	cycle_start_day: Schema.Finite.pipe(Schema.annotateKey({ description: "Day cycles start, 0 for Sunday." })),
+	triage_enabled: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the team uses triage." })),
+	issue_estimation_type: Schema.String.pipe(Schema.annotateKey({ description: "Estimate scale." })),
+	default_issue_estimate: Schema.Finite.pipe(Schema.annotateKey({ description: "Default estimate." })),
+	auto_archive_period: Schema.Finite.pipe(Schema.annotateKey({ description: "Months before closed issues are archived." })),
+	auto_close_period: Schema.NullOr(Schema.Finite).pipe(Schema.annotateKey({ description: "Months before stale issues are closed." })),
+	retired_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the team was retired." }))
 }).annotate({ description: "Linear teams." }).pipe(Iceberg.identifier("id"));
 const TeamObjectSchema = TeamSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const TeamMembershipSchema = Schema.Struct({
 	...common("Membership"),
-	team_id: Ref.pipe(field(10, "Team.")),
-	user_id: Ref.pipe(field(11, "User.")),
-	owner: Schema.Boolean.pipe(field(12, "Whether the user owns the team."))
+	team_id: Ref.pipe(Schema.annotateKey({ description: "Team." })),
+	user_id: Ref.pipe(Schema.annotateKey({ description: "User." })),
+	owner: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the user owns the team." }))
 }).annotate({ description: "Linear team members. Removed members aren't seen." }).pipe(Iceberg.identifier("id"));
 const TeamMembershipObjectSchema = TeamMembershipSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const WorkflowStateSchema = Schema.Struct({
 	...common("Workflow state"),
-	name: Schema.String.pipe(field(10, "State name.")),
-	type: Schema.String.pipe(field(11, "State type: triage, backlog, unstarted, started, completed, or canceled.")),
-	color: Schema.String.pipe(field(12, "State color, as hex.")),
-	description: OptionalString.pipe(field(13, "State description.")),
-	position: Schema.Finite.pipe(field(14, "Order within the team.")),
-	team_id: Ref.pipe(field(15, "Team."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "State name." })),
+	type: Schema.String.pipe(Schema.annotateKey({ description: "State type: triage, backlog, unstarted, started, completed, or canceled." })),
+	color: Schema.String.pipe(Schema.annotateKey({ description: "State color, as hex." })),
+	description: OptionalString.pipe(Schema.annotateKey({ description: "State description." })),
+	position: Schema.Finite.pipe(Schema.annotateKey({ description: "Order within the team." })),
+	team_id: Ref.pipe(Schema.annotateKey({ description: "Team." }))
 }).annotate({ description: "Linear workflow states. Names the IDs in `issues.state_id`." }).pipe(Iceberg.identifier("id"));
 const WorkflowStateObjectSchema = WorkflowStateSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const UserSchema = Schema.Struct({
 	...common("User"),
 	_deleted: deleted("user"),
-	name: Schema.String.pipe(field(10, "Full name.")),
-	display_name: Schema.String.pipe(field(11, "Display name.")),
-	email: Schema.String.pipe(field(12, "Email address.")),
-	avatar_url: OptionalString.pipe(field(13, "Avatar image URL.")),
-	title: OptionalString.pipe(field(14, "Job title.")),
-	timezone: OptionalString.pipe(field(15, "Timezone.")),
-	active: Schema.Boolean.pipe(field(16, "Whether the user is active.")),
-	admin: Schema.Boolean.pipe(field(17, "Whether the user is an admin.")),
-	owner: Schema.Boolean.pipe(field(18, "Whether the user owns the workspace.")),
-	guest: Schema.Boolean.pipe(field(19, "Whether the user is a guest.")),
-	app: Schema.Boolean.pipe(field(20, "Whether the user is an app or agent.")),
-	last_seen: OptionalTimestamp.pipe(field(21, "Time the user was last online.")),
-	url: Schema.String.pipe(field(22, "Profile URL."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Full name." })),
+	display_name: Schema.String.pipe(Schema.annotateKey({ description: "Display name." })),
+	email: Schema.String.pipe(Schema.annotateKey({ description: "Email address." })),
+	avatar_url: OptionalString.pipe(Schema.annotateKey({ description: "Avatar image URL." })),
+	title: OptionalString.pipe(Schema.annotateKey({ description: "Job title." })),
+	timezone: OptionalString.pipe(Schema.annotateKey({ description: "Timezone." })),
+	active: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the user is active." })),
+	admin: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the user is an admin." })),
+	owner: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the user owns the workspace." })),
+	guest: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the user is a guest." })),
+	app: Schema.Boolean.pipe(Schema.annotateKey({ description: "Whether the user is an app or agent." })),
+	last_seen: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the user was last online." })),
+	url: Schema.String.pipe(Schema.annotateKey({ description: "Profile URL." }))
 }).annotate({ description: "Linear users." }).pipe(Iceberg.identifier("id"));
 const UserObjectSchema = UserSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 const ExternalUserSchema = Schema.Struct({
 	...common("External user"),
-	name: Schema.String.pipe(field(10, "Name.")),
-	display_name: Schema.String.pipe(field(11, "Display name.")),
-	email: OptionalString.pipe(field(12, "Email address.")),
-	avatar_url: OptionalString.pipe(field(13, "Avatar image URL.")),
-	last_seen: OptionalTimestamp.pipe(field(14, "Time the user was last seen."))
+	name: Schema.String.pipe(Schema.annotateKey({ description: "Name." })),
+	display_name: Schema.String.pipe(Schema.annotateKey({ description: "Display name." })),
+	email: OptionalString.pipe(Schema.annotateKey({ description: "Email address." })),
+	avatar_url: OptionalString.pipe(Schema.annotateKey({ description: "Avatar image URL." })),
+	last_seen: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the user was last seen." }))
 }).annotate({ description: "People from integrations, such as Slack, who create issues and comments." }).pipe(Iceberg.identifier("id"));
 const ExternalUserObjectSchema = ExternalUserSchema.mapFields((fields) => Struct.omit(fields, ["version"]));
 const CycleSchema = Schema.Struct({
 	...common("Cycle"),
 	_deleted: deleted("cycle"),
-	number: Schema.Finite.pipe(field(10, "Cycle number within its team.")),
-	name: OptionalString.pipe(field(11, "Cycle name.")),
-	description: OptionalString.pipe(field(12, "Cycle description.")),
-	team_id: Ref.pipe(field(13, "Team.")),
-	starts_at: Timestamp.pipe(field(14, "Time the cycle starts.")),
-	ends_at: Timestamp.pipe(field(15, "Time the cycle ends.")),
-	completed_at: OptionalTimestamp.pipe(field(16, "Time the cycle was completed.")),
-	auto_archived_at: OptionalTimestamp.pipe(field(17, "Time the cycle was archived automatically.")),
-	progress: Schema.Finite.pipe(field(18, "Share of the scope completed, from 0 to 1."))
+	number: Schema.Finite.pipe(Schema.annotateKey({ description: "Cycle number within its team." })),
+	name: OptionalString.pipe(Schema.annotateKey({ description: "Cycle name." })),
+	description: OptionalString.pipe(Schema.annotateKey({ description: "Cycle description." })),
+	team_id: Ref.pipe(Schema.annotateKey({ description: "Team." })),
+	starts_at: Timestamp.pipe(Schema.annotateKey({ description: "Time the cycle starts." })),
+	ends_at: Timestamp.pipe(Schema.annotateKey({ description: "Time the cycle ends." })),
+	completed_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the cycle was completed." })),
+	auto_archived_at: OptionalTimestamp.pipe(Schema.annotateKey({ description: "Time the cycle was archived automatically." })),
+	progress: Schema.Finite.pipe(Schema.annotateKey({ description: "Share of the scope completed, from 0 to 1." }))
 }).annotate({ description: "Linear cycles." }).pipe(Iceberg.identifier("id"));
 const CycleObjectSchema = CycleSchema.mapFields((fields) => Struct.omit(fields, ["version", "_deleted"]));
 //#endregion
@@ -1688,4 +1685,4 @@ const layerConfig = (config) => Layer.unwrap(Config.unwrap(config).pipe(Effect.m
 //#endregion
 export { InitiativeToProjectSchema as A, IssueHistorySchema as C, InitiativeLabelSchema as D, IssueSchema as E, CustomerStatusSchema as F, CustomerTierSchema as I, CommentSchema as L, DocumentSchema as M, CustomerNeedSchema as N, InitiativeRelationSchema as O, CustomerSchema as P, client_exports as R, AttachmentSchema as S, IssueRelationSchema as T, ProjectMilestoneSchema as _, CycleSchema as a, ProjectStatusSchema as b, TeamSchema as c, IssueToReleaseSchema as d, ReleaseNoteSchema as f, ProjectLabelSchema as g, ReleaseStageSchema as h, webhookPath as i, InitiativeUpdateSchema as j, InitiativeSchema as k, UserSchema as l, ReleaseSchema as m, connector_exports as n, ExternalUserSchema as o, ReleasePipelineSchema as p, layerConfig as r, TeamMembershipSchema as s, LinearConnector as t, WorkflowStateSchema as u, ProjectRelationSchema as v, IssueLabelSchema as w, ProjectUpdateSchema as x, ProjectSchema as y };
 
-//# sourceMappingURL=src-Ci3_ltan.mjs.map
+//# sourceMappingURL=src-BbzySPR7.mjs.map