From 79f7ad8ba3513b0118ec617febd1e4d7efecb466 Mon Sep 17 00:00:00 2001
From: Abhimanyu Saharan <asaharan@onemindservices.com>
Date: Tue, 10 Feb 2026 00:17:21 +0530
Subject: [PATCH] refactor: add descriptive comments for various response
 payload interfaces

---
 .../src/api/generated/activity/activity.ts    |   3 +
 frontend/src/api/generated/agent/agent.ts     |  21 ++
 frontend/src/api/generated/agents/agents.ts   |   8 +
 .../src/api/generated/approvals/approvals.ts  |   4 +
 frontend/src/api/generated/auth/auth.ts       |   1 +
 .../board-group-memory/board-group-memory.ts  |   6 +
 .../generated/board-groups/board-groups.ts    |   7 +
 .../generated/board-memory/board-memory.ts    |   3 +
 .../board-onboarding/board-onboarding.ts      |   5 +
 frontend/src/api/generated/boards/boards.ts   |   7 +
 frontend/src/api/generated/default/default.ts |   3 +
 .../src/api/generated/gateways/gateways.ts    |  61 ++--
 frontend/src/api/generated/metrics/metrics.ts |   1 +
 .../api/generated/model/activityEventRead.ts  |   3 +
 .../model/activityTaskCommentFeedItemRead.ts  |   3 +
 .../src/api/generated/model/agentCreate.ts    |   3 +
 .../src/api/generated/model/agentHeartbeat.ts |   3 +
 .../generated/model/agentHeartbeatCreate.ts   |   3 +
 .../src/api/generated/model/agentNudge.ts     |   3 +
 frontend/src/api/generated/model/agentRead.ts |   3 +
 .../src/api/generated/model/agentUpdate.ts    |   3 +
 .../src/api/generated/model/approvalCreate.ts |   3 +
 .../src/api/generated/model/approvalRead.ts   |   3 +
 .../src/api/generated/model/approvalUpdate.ts |   3 +
 .../api/generated/model/blockedTaskDetail.ts  |   3 +
 .../api/generated/model/blockedTaskError.ts   |   3 +
 .../src/api/generated/model/boardCreate.ts    |   5 +-
 .../model/boardGroupBoardSnapshot.ts          |   3 +
 .../api/generated/model/boardGroupCreate.ts   |   3 +
 .../model/boardGroupHeartbeatApply.ts         |   3 +
 .../model/boardGroupHeartbeatApplyResult.ts   |   3 +
 .../generated/model/boardGroupMemoryCreate.ts |   3 +
 .../generated/model/boardGroupMemoryRead.ts   |   3 +
 .../src/api/generated/model/boardGroupRead.ts |   3 +
 .../api/generated/model/boardGroupSnapshot.ts |   3 +
 .../generated/model/boardGroupTaskSummary.ts  |   3 +
 .../api/generated/model/boardGroupUpdate.ts   |   3 +
 .../api/generated/model/boardMemoryCreate.ts  |   3 +
 .../api/generated/model/boardMemoryRead.ts    |   3 +
 .../model/boardOnboardingAgentComplete.ts     |   6 +-
 .../boardOnboardingAgentCompleteStatus.ts     |  13 +
 .../model/boardOnboardingAgentQuestion.ts     |   3 +
 .../generated/model/boardOnboardingAnswer.ts  |   3 +
 .../generated/model/boardOnboardingConfirm.ts |   3 +
 .../model/boardOnboardingLeadAgentDraft.ts    |   3 +
 .../model/boardOnboardingQuestionOption.ts    |   3 +
 .../generated/model/boardOnboardingRead.ts    |   3 +
 .../generated/model/boardOnboardingStart.ts   |   3 +
 .../model/boardOnboardingUserProfile.ts       |   3 +
 frontend/src/api/generated/model/boardRead.ts |   3 +
 .../src/api/generated/model/boardSnapshot.ts  |   3 +
 .../src/api/generated/model/boardUpdate.ts    |   3 +
 .../src/api/generated/model/dashboardKpis.ts  |   3 +
 .../api/generated/model/dashboardMetrics.ts   |   3 +
 ...rdMetricsApiV1MetricsDashboardGetParams.ts |   4 +-
 ...MetricsApiV1MetricsDashboardGetRangeKey.ts |  14 +
 .../generated/model/dashboardRangeSeries.ts   |   3 +
 .../generated/model/dashboardSeriesPoint.ts   |   3 +
 .../api/generated/model/dashboardSeriesSet.ts |   3 +
 .../api/generated/model/dashboardWipPoint.ts  |   3 +
 .../model/dashboardWipRangeSeries.ts          |   3 +
 .../generated/model/dashboardWipSeriesSet.ts  |   3 +
 .../model/gatewayCommandsResponse.ts          |   3 +
 .../src/api/generated/model/gatewayCreate.ts  |   3 +
 .../model/gatewayLeadBroadcastBoardResult.ts  |   3 +
 .../model/gatewayLeadBroadcastRequest.ts      |   3 +
 .../model/gatewayLeadBroadcastResponse.ts     |   3 +
 .../model/gatewayLeadMessageRequest.ts        |   3 +
 .../model/gatewayLeadMessageResponse.ts       |   3 +
 .../model/gatewayMainAskUserRequest.ts        |   3 +
 .../model/gatewayMainAskUserResponse.ts       |   3 +
 .../src/api/generated/model/gatewayRead.ts    |   3 +
 .../generated/model/gatewayResolveQuery.ts    |  16 ++
 .../model/gatewaySessionHistoryResponse.ts    |   3 +
 .../model/gatewaySessionMessageRequest.ts     |   3 +
 .../generated/model/gatewaySessionResponse.ts |   3 +
 .../model/gatewaySessionsResponse.ts          |   3 +
 .../model/gatewayTemplatesSyncError.ts        |   3 +
 .../model/gatewayTemplatesSyncResult.ts       |   3 +
 .../src/api/generated/model/gatewayUpdate.ts  |   3 +
 .../generated/model/gatewaysStatusResponse.ts |   3 +
 frontend/src/api/generated/model/index.ts     |   3 +
 .../src/api/generated/model/okResponse.ts     |   3 +
 .../model/organizationActiveUpdate.ts         |   3 +
 .../model/organizationBoardAccessRead.ts      |   3 +
 .../model/organizationBoardAccessSpec.ts      |   3 +
 .../api/generated/model/organizationCreate.ts |   3 +
 .../model/organizationInviteAccept.ts         |   3 +
 .../model/organizationInviteCreate.ts         |   3 +
 .../generated/model/organizationInviteRead.ts |   3 +
 .../generated/model/organizationListItem.ts   |   3 +
 .../model/organizationMemberAccessUpdate.ts   |   3 +
 .../generated/model/organizationMemberRead.ts |   3 +
 .../model/organizationMemberUpdate.ts         |   3 +
 .../api/generated/model/organizationRead.ts   |   3 +
 .../generated/model/organizationUserRead.ts   |   3 +
 .../api/generated/model/soulUpdateRequest.ts  |   3 +
 .../model/soulsDirectoryMarkdownResponse.ts   |   3 +
 .../model/soulsDirectorySearchResponse.ts     |   3 +
 .../generated/model/soulsDirectorySoulRef.ts  |   3 +
 .../src/api/generated/model/taskCardRead.ts   |   3 +
 .../api/generated/model/taskCommentCreate.ts  |   3 +
 .../api/generated/model/taskCommentRead.ts    |   3 +
 .../src/api/generated/model/taskCreate.ts     |   3 +
 frontend/src/api/generated/model/taskRead.ts  |   3 +
 .../src/api/generated/model/taskUpdate.ts     |   3 +
 frontend/src/api/generated/model/userRead.ts  |   3 +
 .../src/api/generated/model/userUpdate.ts     |   3 +
 .../generated/organizations/organizations.ts  | 265 ++++++++++++++++++
 .../souls-directory/souls-directory.ts        |   3 +
 frontend/src/api/generated/tasks/tasks.ts     |   7 +
 111 files changed, 697 insertions(+), 33 deletions(-)
 create mode 100644 frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts
 create mode 100644 frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRangeKey.ts
 create mode 100644 frontend/src/api/generated/model/gatewayResolveQuery.ts

diff --git a/frontend/src/api/generated/activity/activity.ts b/frontend/src/api/generated/activity/activity.ts
index 99491bff..f788e7ea 100644
--- a/frontend/src/api/generated/activity/activity.ts
+++ b/frontend/src/api/generated/activity/activity.ts
@@ -31,6 +31,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List activity events visible to the calling actor.
  * @summary List Activity
  */
 export type listActivityApiV1ActivityGetResponse200 = {
@@ -241,6 +242,7 @@ export function useListActivityApiV1ActivityGet<
 }
 
 /**
+ * List task-comment feed items for accessible boards.
  * @summary List Task Comment Feed
  */
 export type listTaskCommentFeedApiV1ActivityTaskCommentsGetResponse200 = {
@@ -489,6 +491,7 @@ export function useListTaskCommentFeedApiV1ActivityTaskCommentsGet<
 }
 
 /**
+ * Stream task-comment events for accessible boards.
  * @summary Stream Task Comment Feed
  */
 export type streamTaskCommentFeedApiV1ActivityTaskCommentsStreamGetResponse200 =
diff --git a/frontend/src/api/generated/agent/agent.ts b/frontend/src/api/generated/agent/agent.ts
index 13c61f9c..48ae798c 100644
--- a/frontend/src/api/generated/agent/agent.ts
+++ b/frontend/src/api/generated/agent/agent.ts
@@ -66,6 +66,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List boards visible to the authenticated agent.
  * @summary List Boards
  */
 export type listBoardsApiV1AgentBoardsGetResponse200 = {
@@ -276,6 +277,7 @@ export function useListBoardsApiV1AgentBoardsGet<
 }
 
 /**
+ * Return a board if the authenticated agent can access it.
  * @summary Get Board
  */
 export type getBoardApiV1AgentBoardsBoardIdGetResponse200 = {
@@ -478,6 +480,7 @@ export function useGetBoardApiV1AgentBoardsBoardIdGet<
 }
 
 /**
+ * List agents, optionally filtered to a board.
  * @summary List Agents
  */
 export type listAgentsApiV1AgentAgentsGetResponse200 = {
@@ -688,6 +691,7 @@ export function useListAgentsApiV1AgentAgentsGet<
 }
 
 /**
+ * Create an agent on the caller's board.
  * @summary Create Agent
  */
 export type createAgentApiV1AgentAgentsPostResponse200 = {
@@ -805,6 +809,7 @@ export const useCreateAgentApiV1AgentAgentsPost = <
   );
 };
 /**
+ * List tasks on a board with optional status and assignment filters.
  * @summary List Tasks
  */
 export type listTasksApiV1AgentBoardsBoardIdTasksGetResponse200 = {
@@ -1037,6 +1042,7 @@ export function useListTasksApiV1AgentBoardsBoardIdTasksGet<
 }
 
 /**
+ * Create a task on the board as the lead agent.
  * @summary Create Task
  */
 export type createTaskApiV1AgentBoardsBoardIdTasksPostResponse200 = {
@@ -1163,6 +1169,7 @@ export const useCreateTaskApiV1AgentBoardsBoardIdTasksPost = <
   );
 };
 /**
+ * Update a task after board-level access checks.
  * @summary Update Task
  */
 export type updateTaskApiV1AgentBoardsBoardIdTasksTaskIdPatchResponse200 = {
@@ -1303,6 +1310,7 @@ export const useUpdateTaskApiV1AgentBoardsBoardIdTasksTaskIdPatch = <
   );
 };
 /**
+ * List comments for a task visible to the authenticated agent.
  * @summary List Task Comments
  */
 export type listTaskCommentsApiV1AgentBoardsBoardIdTasksTaskIdCommentsGetResponse200 =
@@ -1636,6 +1644,7 @@ export function useListTaskCommentsApiV1AgentBoardsBoardIdTasksTaskIdCommentsGet
 }
 
 /**
+ * Create a task comment on behalf of the authenticated agent.
  * @summary Create Task Comment
  */
 export type createTaskCommentApiV1AgentBoardsBoardIdTasksTaskIdCommentsPostResponse200 =
@@ -1795,6 +1804,7 @@ export const useCreateTaskCommentApiV1AgentBoardsBoardIdTasksTaskIdCommentsPost
     );
   };
 /**
+ * List board memory entries with optional chat filtering.
  * @summary List Board Memory
  */
 export type listBoardMemoryApiV1AgentBoardsBoardIdMemoryGetResponse200 = {
@@ -2057,6 +2067,7 @@ export function useListBoardMemoryApiV1AgentBoardsBoardIdMemoryGet<
 }
 
 /**
+ * Create a board memory entry.
  * @summary Create Board Memory
  */
 export type createBoardMemoryApiV1AgentBoardsBoardIdMemoryPostResponse200 = {
@@ -2196,6 +2207,7 @@ export const useCreateBoardMemoryApiV1AgentBoardsBoardIdMemoryPost = <
   );
 };
 /**
+ * List approvals for a board.
  * @summary List Approvals
  */
 export type listApprovalsApiV1AgentBoardsBoardIdApprovalsGetResponse200 = {
@@ -2463,6 +2475,7 @@ export function useListApprovalsApiV1AgentBoardsBoardIdApprovalsGet<
 }
 
 /**
+ * Create a board approval request.
  * @summary Create Approval
  */
 export type createApprovalApiV1AgentBoardsBoardIdApprovalsPostResponse200 = {
@@ -2602,6 +2615,7 @@ export const useCreateApprovalApiV1AgentBoardsBoardIdApprovalsPost = <
   );
 };
 /**
+ * Apply onboarding updates for a board.
  * @summary Update Onboarding
  */
 export type updateOnboardingApiV1AgentBoardsBoardIdOnboardingPostResponse200 = {
@@ -2763,6 +2777,7 @@ export const useUpdateOnboardingApiV1AgentBoardsBoardIdOnboardingPost = <
   );
 };
 /**
+ * Send a direct nudge message to a board agent.
  * @summary Nudge Agent
  */
 export type nudgeAgentApiV1AgentBoardsBoardIdAgentsAgentIdNudgePostResponse200 =
@@ -2918,6 +2933,7 @@ export const useNudgeAgentApiV1AgentBoardsBoardIdAgentsAgentIdNudgePost = <
   );
 };
 /**
+ * Record heartbeat status for the authenticated agent.
  * @summary Agent Heartbeat
  */
 export type agentHeartbeatApiV1AgentHeartbeatPostResponse200 = {
@@ -3037,6 +3053,7 @@ export const useAgentHeartbeatApiV1AgentHeartbeatPost = <
   );
 };
 /**
+ * Fetch the target agent's SOUL.md content from the gateway.
  * @summary Get Agent Soul
  */
 export type getAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulGetResponse200 =
@@ -3320,6 +3337,7 @@ export function useGetAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulGet<
 }
 
 /**
+ * Update an agent's SOUL.md content in DB and gateway.
  * @summary Update Agent Soul
  */
 export type updateAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulPutResponse200 =
@@ -3480,6 +3498,7 @@ export const useUpdateAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulPut = <
   );
 };
 /**
+ * Route a lead's ask-user request through the gateway main agent.
  * @summary Ask User Via Gateway Main
  */
 export type askUserViaGatewayMainApiV1AgentBoardsBoardIdGatewayMainAskUserPostResponse200 =
@@ -3636,6 +3655,7 @@ export const useAskUserViaGatewayMainApiV1AgentBoardsBoardIdGatewayMainAskUserPo
     );
   };
 /**
+ * Send a gateway-main message to a single board lead agent.
  * @summary Message Gateway Board Lead
  */
 export type messageGatewayBoardLeadApiV1AgentGatewayBoardsBoardIdLeadMessagePostResponse200 =
@@ -3792,6 +3812,7 @@ export const useMessageGatewayBoardLeadApiV1AgentGatewayBoardsBoardIdLeadMessage
     );
   };
 /**
+ * Broadcast a gateway-main message to multiple board leads.
  * @summary Broadcast Gateway Lead Message
  */
 export type broadcastGatewayLeadMessageApiV1AgentGatewayLeadsBroadcastPostResponse200 =
diff --git a/frontend/src/api/generated/agents/agents.ts b/frontend/src/api/generated/agents/agents.ts
index e1ace2e7..277c396a 100644
--- a/frontend/src/api/generated/agents/agents.ts
+++ b/frontend/src/api/generated/agents/agents.ts
@@ -39,6 +39,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List agents visible to the active organization admin.
  * @summary List Agents
  */
 export type listAgentsApiV1AgentsGetResponse200 = {
@@ -246,6 +247,7 @@ export function useListAgentsApiV1AgentsGet<
 }
 
 /**
+ * Create and provision an agent.
  * @summary Create Agent
  */
 export type createAgentApiV1AgentsPostResponse200 = {
@@ -363,6 +365,7 @@ export const useCreateAgentApiV1AgentsPost = <
   );
 };
 /**
+ * Stream agent updates as SSE events.
  * @summary Stream Agents
  */
 export type streamAgentsApiV1AgentsStreamGetResponse200 = {
@@ -574,6 +577,7 @@ export function useStreamAgentsApiV1AgentsStreamGet<
 }
 
 /**
+ * Get a single agent by id.
  * @summary Get Agent
  */
 export type getAgentApiV1AgentsAgentIdGetResponse200 = {
@@ -773,6 +777,7 @@ export function useGetAgentApiV1AgentsAgentIdGet<
 }
 
 /**
+ * Update agent metadata and optionally reprovision.
  * @summary Update Agent
  */
 export type updateAgentApiV1AgentsAgentIdPatchResponse200 = {
@@ -933,6 +938,7 @@ export const useUpdateAgentApiV1AgentsAgentIdPatch = <
   );
 };
 /**
+ * Delete an agent and clean related task state.
  * @summary Delete Agent
  */
 export type deleteAgentApiV1AgentsAgentIdDeleteResponse200 = {
@@ -1049,6 +1055,7 @@ export const useDeleteAgentApiV1AgentsAgentIdDelete = <
   );
 };
 /**
+ * Record a heartbeat for a specific agent.
  * @summary Heartbeat Agent
  */
 export type heartbeatAgentApiV1AgentsAgentIdHeartbeatPostResponse200 = {
@@ -1176,6 +1183,7 @@ export const useHeartbeatAgentApiV1AgentsAgentIdHeartbeatPost = <
   );
 };
 /**
+ * Heartbeat an existing agent or create/provision one if needed.
  * @summary Heartbeat Or Create Agent
  */
 export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse200 = {
diff --git a/frontend/src/api/generated/approvals/approvals.ts b/frontend/src/api/generated/approvals/approvals.ts
index 1af53078..6d5a1dfb 100644
--- a/frontend/src/api/generated/approvals/approvals.ts
+++ b/frontend/src/api/generated/approvals/approvals.ts
@@ -35,6 +35,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List approvals for a board, optionally filtering by status.
  * @summary List Approvals
  */
 export type listApprovalsApiV1BoardsBoardIdApprovalsGetResponse200 = {
@@ -287,6 +288,7 @@ export function useListApprovalsApiV1BoardsBoardIdApprovalsGet<
 }
 
 /**
+ * Create an approval for a board.
  * @summary Create Approval
  */
 export type createApprovalApiV1BoardsBoardIdApprovalsPostResponse200 = {
@@ -414,6 +416,7 @@ export const useCreateApprovalApiV1BoardsBoardIdApprovalsPost = <
   );
 };
 /**
+ * Stream approval updates for a board using server-sent events.
  * @summary Stream Approvals
  */
 export type streamApprovalsApiV1BoardsBoardIdApprovalsStreamGetResponse200 = {
@@ -696,6 +699,7 @@ export function useStreamApprovalsApiV1BoardsBoardIdApprovalsStreamGet<
 }
 
 /**
+ * Update an approval's status and resolution timestamp.
  * @summary Update Approval
  */
 export type updateApprovalApiV1BoardsBoardIdApprovalsApprovalIdPatchResponse200 =
diff --git a/frontend/src/api/generated/auth/auth.ts b/frontend/src/api/generated/auth/auth.ts
index 0b30a252..fd56bc0d 100644
--- a/frontend/src/api/generated/auth/auth.ts
+++ b/frontend/src/api/generated/auth/auth.ts
@@ -19,6 +19,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Return the authenticated user profile from token claims.
  * @summary Bootstrap User
  */
 export type bootstrapUserApiV1AuthBootstrapPostResponse200 = {
diff --git a/frontend/src/api/generated/board-group-memory/board-group-memory.ts b/frontend/src/api/generated/board-group-memory/board-group-memory.ts
index 48cf9d94..628c8f99 100644
--- a/frontend/src/api/generated/board-group-memory/board-group-memory.ts
+++ b/frontend/src/api/generated/board-group-memory/board-group-memory.ts
@@ -36,6 +36,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List board-group memory entries for a specific group.
  * @summary List Board Group Memory
  */
 export type listBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryGetResponse200 = {
@@ -328,6 +329,7 @@ export function useListBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryGet<
 }
 
 /**
+ * Create a board-group memory entry and notify chat recipients.
  * @summary Create Board Group Memory
  */
 export type createBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryPostResponse200 =
@@ -477,6 +479,7 @@ export const useCreateBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryPost = <
   );
 };
 /**
+ * Stream memory entries for a board group via server-sent events.
  * @summary Stream Board Group Memory
  */
 export type streamBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryStreamGetResponse200 =
@@ -798,6 +801,7 @@ export function useStreamBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryStreamGet<
 }
 
 /**
+ * List memory entries for the board's linked group.
  * @summary List Board Group Memory For Board
  */
 export type listBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryGetResponse200 =
@@ -1119,6 +1123,7 @@ export function useListBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryGet<
 }
 
 /**
+ * Create a group memory entry from a board context and notify recipients.
  * @summary Create Board Group Memory For Board
  */
 export type createBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryPostResponse200 =
@@ -1275,6 +1280,7 @@ export const useCreateBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryPost
     );
   };
 /**
+ * Stream memory entries for the board's linked group.
  * @summary Stream Board Group Memory For Board
  */
 export type streamBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryStreamGetResponse200 =
diff --git a/frontend/src/api/generated/board-groups/board-groups.ts b/frontend/src/api/generated/board-groups/board-groups.ts
index 19d4ddb9..e21c3d87 100644
--- a/frontend/src/api/generated/board-groups/board-groups.ts
+++ b/frontend/src/api/generated/board-groups/board-groups.ts
@@ -39,6 +39,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List board groups in the active organization.
  * @summary List Board Groups
  */
 export type listBoardGroupsApiV1BoardGroupsGetResponse200 = {
@@ -250,6 +251,7 @@ export function useListBoardGroupsApiV1BoardGroupsGet<
 }
 
 /**
+ * Create a board group in the active organization.
  * @summary Create Board Group
  */
 export type createBoardGroupApiV1BoardGroupsPostResponse200 = {
@@ -368,6 +370,7 @@ export const useCreateBoardGroupApiV1BoardGroupsPost = <
   );
 };
 /**
+ * Get a board group by id.
  * @summary Get Board Group
  */
 export type getBoardGroupApiV1BoardGroupsGroupIdGetResponse200 = {
@@ -576,6 +579,7 @@ export function useGetBoardGroupApiV1BoardGroupsGroupIdGet<
 }
 
 /**
+ * Update a board group.
  * @summary Update Board Group
  */
 export type updateBoardGroupApiV1BoardGroupsGroupIdPatchResponse200 = {
@@ -703,6 +707,7 @@ export const useUpdateBoardGroupApiV1BoardGroupsGroupIdPatch = <
   );
 };
 /**
+ * Delete a board group.
  * @summary Delete Board Group
  */
 export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse200 = {
@@ -825,6 +830,7 @@ export const useDeleteBoardGroupApiV1BoardGroupsGroupIdDelete = <
   );
 };
 /**
+ * Get a snapshot across boards in a group.
  * @summary Get Board Group Snapshot
  */
 export type getBoardGroupSnapshotApiV1BoardGroupsGroupIdSnapshotGetResponse200 =
@@ -1127,6 +1133,7 @@ export function useGetBoardGroupSnapshotApiV1BoardGroupsGroupIdSnapshotGet<
 }
 
 /**
+ * Apply heartbeat settings to agents in a board group.
  * @summary Apply Board Group Heartbeat
  */
 export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse200 =
diff --git a/frontend/src/api/generated/board-memory/board-memory.ts b/frontend/src/api/generated/board-memory/board-memory.ts
index 286fea26..946e3bfc 100644
--- a/frontend/src/api/generated/board-memory/board-memory.ts
+++ b/frontend/src/api/generated/board-memory/board-memory.ts
@@ -34,6 +34,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List board memory entries, optionally filtering chat entries.
  * @summary List Board Memory
  */
 export type listBoardMemoryApiV1BoardsBoardIdMemoryGetResponse200 = {
@@ -281,6 +282,7 @@ export function useListBoardMemoryApiV1BoardsBoardIdMemoryGet<
 }
 
 /**
+ * Create a board memory entry and notify chat targets when needed.
  * @summary Create Board Memory
  */
 export type createBoardMemoryApiV1BoardsBoardIdMemoryPostResponse200 = {
@@ -408,6 +410,7 @@ export const useCreateBoardMemoryApiV1BoardsBoardIdMemoryPost = <
   );
 };
 /**
+ * Stream board memory events over server-sent events.
  * @summary Stream Board Memory
  */
 export type streamBoardMemoryApiV1BoardsBoardIdMemoryStreamGetResponse200 = {
diff --git a/frontend/src/api/generated/board-onboarding/board-onboarding.ts b/frontend/src/api/generated/board-onboarding/board-onboarding.ts
index f063822b..0bb349be 100644
--- a/frontend/src/api/generated/board-onboarding/board-onboarding.ts
+++ b/frontend/src/api/generated/board-onboarding/board-onboarding.ts
@@ -36,6 +36,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Get the latest onboarding session for a board.
  * @summary Get Onboarding
  */
 export type getOnboardingApiV1BoardsBoardIdOnboardingGetResponse200 = {
@@ -274,6 +275,7 @@ export function useGetOnboardingApiV1BoardsBoardIdOnboardingGet<
 }
 
 /**
+ * Start onboarding and send instructions to the gateway main agent.
  * @summary Start Onboarding
  */
 export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse200 = {
@@ -415,6 +417,7 @@ export const useStartOnboardingApiV1BoardsBoardIdOnboardingStartPost = <
   );
 };
 /**
+ * Send a user onboarding answer to the gateway main agent.
  * @summary Answer Onboarding
  */
 export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse200 =
@@ -564,6 +567,7 @@ export const useAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost = <
   );
 };
 /**
+ * Store onboarding updates submitted by the gateway main agent.
  * @summary Agent Onboarding Update
  */
 export type agentOnboardingUpdateApiV1BoardsBoardIdOnboardingAgentPostResponse200 =
@@ -738,6 +742,7 @@ export const useAgentOnboardingUpdateApiV1BoardsBoardIdOnboardingAgentPost = <
   );
 };
 /**
+ * Confirm onboarding results and provision the board lead agent.
  * @summary Confirm Onboarding
  */
 export type confirmOnboardingApiV1BoardsBoardIdOnboardingConfirmPostResponse200 =
diff --git a/frontend/src/api/generated/boards/boards.ts b/frontend/src/api/generated/boards/boards.ts
index 45c838a8..a5d7e717 100644
--- a/frontend/src/api/generated/boards/boards.ts
+++ b/frontend/src/api/generated/boards/boards.ts
@@ -38,6 +38,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List boards visible to the current organization member.
  * @summary List Boards
  */
 export type listBoardsApiV1BoardsGetResponse200 = {
@@ -245,6 +246,7 @@ export function useListBoardsApiV1BoardsGet<
 }
 
 /**
+ * Create a board in the active organization.
  * @summary Create Board
  */
 export type createBoardApiV1BoardsPostResponse200 = {
@@ -362,6 +364,7 @@ export const useCreateBoardApiV1BoardsPost = <
   );
 };
 /**
+ * Get a board by id.
  * @summary Get Board
  */
 export type getBoardApiV1BoardsBoardIdGetResponse200 = {
@@ -561,6 +564,7 @@ export function useGetBoardApiV1BoardsBoardIdGet<
 }
 
 /**
+ * Update mutable board properties.
  * @summary Update Board
  */
 export type updateBoardApiV1BoardsBoardIdPatchResponse200 = {
@@ -680,6 +684,7 @@ export const useUpdateBoardApiV1BoardsBoardIdPatch = <
   );
 };
 /**
+ * Delete a board and all dependent records.
  * @summary Delete Board
  */
 export type deleteBoardApiV1BoardsBoardIdDeleteResponse200 = {
@@ -796,6 +801,7 @@ export const useDeleteBoardApiV1BoardsBoardIdDelete = <
   );
 };
 /**
+ * Get a board snapshot view model.
  * @summary Get Board Snapshot
  */
 export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse200 = {
@@ -1034,6 +1040,7 @@ export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
 }
 
 /**
+ * Get a grouped snapshot across related boards.
  * @summary Get Board Group Snapshot
  */
 export type getBoardGroupSnapshotApiV1BoardsBoardIdGroupSnapshotGetResponse200 =
diff --git a/frontend/src/api/generated/default/default.ts b/frontend/src/api/generated/default/default.ts
index 9c2ddab6..d6ec918f 100644
--- a/frontend/src/api/generated/default/default.ts
+++ b/frontend/src/api/generated/default/default.ts
@@ -28,6 +28,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Lightweight liveness probe endpoint.
  * @summary Health
  */
 export type healthHealthGetResponse200 = {
@@ -189,6 +190,7 @@ export function useHealthHealthGet<
 }
 
 /**
+ * Alias liveness probe endpoint for platform compatibility.
  * @summary Healthz
  */
 export type healthzHealthzGetResponse200 = {
@@ -354,6 +356,7 @@ export function useHealthzHealthzGet<
 }
 
 /**
+ * Readiness probe endpoint for service orchestration checks.
  * @summary Readyz
  */
 export type readyzReadyzGetResponse200 = {
diff --git a/frontend/src/api/generated/gateways/gateways.ts b/frontend/src/api/generated/gateways/gateways.ts
index 6948d903..8da6e524 100644
--- a/frontend/src/api/generated/gateways/gateways.ts
+++ b/frontend/src/api/generated/gateways/gateways.ts
@@ -24,13 +24,13 @@ import type {
   GatewayCommandsResponse,
   GatewayCreate,
   GatewayRead,
+  GatewayResolveQuery,
   GatewaySessionHistoryResponse,
   GatewaySessionMessageRequest,
   GatewaySessionResponse,
   GatewaySessionsResponse,
   GatewayTemplatesSyncResult,
   GatewayUpdate,
-  GatewaysStatusApiV1GatewaysStatusGetParams,
   GatewaysStatusResponse,
   GetGatewaySessionApiV1GatewaysSessionsSessionIdGetParams,
   GetSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGetParams,
@@ -48,6 +48,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Return gateway connectivity and session status.
  * @summary Gateways Status
  */
 export type gatewaysStatusApiV1GatewaysStatusGetResponse200 = {
@@ -73,48 +74,36 @@ export type gatewaysStatusApiV1GatewaysStatusGetResponse =
   | gatewaysStatusApiV1GatewaysStatusGetResponseSuccess
   | gatewaysStatusApiV1GatewaysStatusGetResponseError;
 
-export const getGatewaysStatusApiV1GatewaysStatusGetUrl = (
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
-) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `/api/v1/gateways/status?${stringifiedParams}`
-    : `/api/v1/gateways/status`;
+export const getGatewaysStatusApiV1GatewaysStatusGetUrl = () => {
+  return `/api/v1/gateways/status`;
 };
 
 export const gatewaysStatusApiV1GatewaysStatusGet = async (
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: RequestInit,
 ): Promise<gatewaysStatusApiV1GatewaysStatusGetResponse> => {
   return customFetch<gatewaysStatusApiV1GatewaysStatusGetResponse>(
-    getGatewaysStatusApiV1GatewaysStatusGetUrl(params),
+    getGatewaysStatusApiV1GatewaysStatusGetUrl(),
     {
       ...options,
       method: "GET",
+      headers: { "Content-Type": "application/json", ...options?.headers },
+      body: JSON.stringify(gatewayResolveQuery),
     },
   );
 };
 
 export const getGatewaysStatusApiV1GatewaysStatusGetQueryKey = (
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery?: GatewayResolveQuery,
 ) => {
-  return [`/api/v1/gateways/status`, ...(params ? [params] : [])] as const;
+  return [`/api/v1/gateways/status`, gatewayResolveQuery] as const;
 };
 
 export const getGatewaysStatusApiV1GatewaysStatusGetQueryOptions = <
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -130,12 +119,15 @@ export const getGatewaysStatusApiV1GatewaysStatusGetQueryOptions = <
 
   const queryKey =
     queryOptions?.queryKey ??
-    getGatewaysStatusApiV1GatewaysStatusGetQueryKey(params);
+    getGatewaysStatusApiV1GatewaysStatusGetQueryKey(gatewayResolveQuery);
 
   const queryFn: QueryFunction<
     Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>
   > = ({ signal }) =>
-    gatewaysStatusApiV1GatewaysStatusGet(params, { signal, ...requestOptions });
+    gatewaysStatusApiV1GatewaysStatusGet(gatewayResolveQuery, {
+      signal,
+      ...requestOptions,
+    });
 
   return { queryKey, queryFn, ...queryOptions } as UseQueryOptions<
     Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
@@ -154,7 +146,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params: undefined | GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options: {
     query: Partial<
       UseQueryOptions<
@@ -181,7 +173,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -208,7 +200,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -231,7 +223,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -247,7 +239,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   queryKey: DataTag<QueryKey, TData, TError>;
 } {
   const queryOptions = getGatewaysStatusApiV1GatewaysStatusGetQueryOptions(
-    params,
+    gatewayResolveQuery,
     options,
   );
 
@@ -260,6 +252,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
 }
 
 /**
+ * List sessions for a gateway associated with a board.
  * @summary List Gateway Sessions
  */
 export type listGatewaySessionsApiV1GatewaysSessionsGetResponse200 = {
@@ -492,6 +485,7 @@ export function useListGatewaySessionsApiV1GatewaysSessionsGet<
 }
 
 /**
+ * Get a specific gateway session by key.
  * @summary Get Gateway Session
  */
 export type getGatewaySessionApiV1GatewaysSessionsSessionIdGetResponse200 = {
@@ -774,6 +768,7 @@ export function useGetGatewaySessionApiV1GatewaysSessionsSessionIdGet<
 }
 
 /**
+ * Fetch chat history for a gateway session.
  * @summary Get Session History
  */
 export type getSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGetResponse200 =
@@ -1081,6 +1076,7 @@ export function useGetSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGet<
 }
 
 /**
+ * Send a message into a specific gateway session.
  * @summary Send Gateway Session Message
  */
 export type sendGatewaySessionMessageApiV1GatewaysSessionsSessionIdMessagePostResponse200 =
@@ -1278,6 +1274,7 @@ export const useSendGatewaySessionMessageApiV1GatewaysSessionsSessionIdMessagePo
     );
   };
 /**
+ * Return supported gateway protocol methods and events.
  * @summary Gateway Commands
  */
 export type gatewayCommandsApiV1GatewaysCommandsGetResponse200 = {
@@ -1452,6 +1449,7 @@ export function useGatewayCommandsApiV1GatewaysCommandsGet<
 }
 
 /**
+ * List gateways for the caller's organization.
  * @summary List Gateways
  */
 export type listGatewaysApiV1GatewaysGetResponse200 = {
@@ -1662,6 +1660,7 @@ export function useListGatewaysApiV1GatewaysGet<
 }
 
 /**
+ * Create a gateway and provision or refresh its main agent.
  * @summary Create Gateway
  */
 export type createGatewayApiV1GatewaysPostResponse200 = {
@@ -1779,6 +1778,7 @@ export const useCreateGatewayApiV1GatewaysPost = <
   );
 };
 /**
+ * Return one gateway by id for the caller's organization.
  * @summary Get Gateway
  */
 export type getGatewayApiV1GatewaysGatewayIdGetResponse200 = {
@@ -1986,6 +1986,7 @@ export function useGetGatewayApiV1GatewaysGatewayIdGet<
 }
 
 /**
+ * Patch a gateway and refresh the main-agent provisioning state.
  * @summary Update Gateway
  */
 export type updateGatewayApiV1GatewaysGatewayIdPatchResponse200 = {
@@ -2113,6 +2114,7 @@ export const useUpdateGatewayApiV1GatewaysGatewayIdPatch = <
   );
 };
 /**
+ * Delete a gateway in the caller's organization.
  * @summary Delete Gateway
  */
 export type deleteGatewayApiV1GatewaysGatewayIdDeleteResponse200 = {
@@ -2232,6 +2234,7 @@ export const useDeleteGatewayApiV1GatewaysGatewayIdDelete = <
   );
 };
 /**
+ * Sync templates for a gateway and optionally rotate runtime settings.
  * @summary Sync Gateway Templates
  */
 export type syncGatewayTemplatesApiV1GatewaysGatewayIdTemplatesSyncPostResponse200 =
diff --git a/frontend/src/api/generated/metrics/metrics.ts b/frontend/src/api/generated/metrics/metrics.ts
index 3c9c6177..480d6185 100644
--- a/frontend/src/api/generated/metrics/metrics.ts
+++ b/frontend/src/api/generated/metrics/metrics.ts
@@ -28,6 +28,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Return dashboard KPIs and time-series data for accessible boards.
  * @summary Dashboard Metrics
  */
 export type dashboardMetricsApiV1MetricsDashboardGetResponse200 = {
diff --git a/frontend/src/api/generated/model/activityEventRead.ts b/frontend/src/api/generated/model/activityEventRead.ts
index 18e1e8c5..4e832211 100644
--- a/frontend/src/api/generated/model/activityEventRead.ts
+++ b/frontend/src/api/generated/model/activityEventRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Serialized activity event payload returned by activity endpoints.
+ */
 export interface ActivityEventRead {
   id: string;
   event_type: string;
diff --git a/frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts b/frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts
index a53132e3..e12582fd 100644
--- a/frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts
+++ b/frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Denormalized task-comment feed item enriched with task and board fields.
+ */
 export interface ActivityTaskCommentFeedItemRead {
   id: string;
   created_at: string;
diff --git a/frontend/src/api/generated/model/agentCreate.ts b/frontend/src/api/generated/model/agentCreate.ts
index 5a9d0876..17a9e768 100644
--- a/frontend/src/api/generated/model/agentCreate.ts
+++ b/frontend/src/api/generated/model/agentCreate.ts
@@ -7,6 +7,9 @@
 import type { AgentCreateHeartbeatConfig } from "./agentCreateHeartbeatConfig";
 import type { AgentCreateIdentityProfile } from "./agentCreateIdentityProfile";
 
+/**
+ * Payload for creating a new agent.
+ */
 export interface AgentCreate {
   board_id?: string | null;
   /** @minLength 1 */
diff --git a/frontend/src/api/generated/model/agentHeartbeat.ts b/frontend/src/api/generated/model/agentHeartbeat.ts
index bbef5271..80ef3761 100644
--- a/frontend/src/api/generated/model/agentHeartbeat.ts
+++ b/frontend/src/api/generated/model/agentHeartbeat.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Heartbeat status payload sent by agents.
+ */
 export interface AgentHeartbeat {
   status?: string | null;
 }
diff --git a/frontend/src/api/generated/model/agentHeartbeatCreate.ts b/frontend/src/api/generated/model/agentHeartbeatCreate.ts
index 29283425..d6e6b75b 100644
--- a/frontend/src/api/generated/model/agentHeartbeatCreate.ts
+++ b/frontend/src/api/generated/model/agentHeartbeatCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Heartbeat payload used to create an agent lazily.
+ */
 export interface AgentHeartbeatCreate {
   status?: string | null;
   /** @minLength 1 */
diff --git a/frontend/src/api/generated/model/agentNudge.ts b/frontend/src/api/generated/model/agentNudge.ts
index 1b57a129..87603e4b 100644
--- a/frontend/src/api/generated/model/agentNudge.ts
+++ b/frontend/src/api/generated/model/agentNudge.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Nudge message payload for pinging an agent.
+ */
 export interface AgentNudge {
   /** @minLength 1 */
   message: string;
diff --git a/frontend/src/api/generated/model/agentRead.ts b/frontend/src/api/generated/model/agentRead.ts
index 9cf0df4e..4ebba7bd 100644
--- a/frontend/src/api/generated/model/agentRead.ts
+++ b/frontend/src/api/generated/model/agentRead.ts
@@ -7,6 +7,9 @@
 import type { AgentReadHeartbeatConfig } from "./agentReadHeartbeatConfig";
 import type { AgentReadIdentityProfile } from "./agentReadIdentityProfile";
 
+/**
+ * Public agent representation returned by the API.
+ */
 export interface AgentRead {
   board_id?: string | null;
   /** @minLength 1 */
diff --git a/frontend/src/api/generated/model/agentUpdate.ts b/frontend/src/api/generated/model/agentUpdate.ts
index 73f74045..c9a6a1f1 100644
--- a/frontend/src/api/generated/model/agentUpdate.ts
+++ b/frontend/src/api/generated/model/agentUpdate.ts
@@ -7,6 +7,9 @@
 import type { AgentUpdateHeartbeatConfig } from "./agentUpdateHeartbeatConfig";
 import type { AgentUpdateIdentityProfile } from "./agentUpdateIdentityProfile";
 
+/**
+ * Payload for patching an existing agent.
+ */
 export interface AgentUpdate {
   board_id?: string | null;
   is_gateway_main?: boolean | null;
diff --git a/frontend/src/api/generated/model/approvalCreate.ts b/frontend/src/api/generated/model/approvalCreate.ts
index 3172f0a2..6f8c9afc 100644
--- a/frontend/src/api/generated/model/approvalCreate.ts
+++ b/frontend/src/api/generated/model/approvalCreate.ts
@@ -8,6 +8,9 @@ import type { ApprovalCreatePayload } from "./approvalCreatePayload";
 import type { ApprovalCreateRubricScores } from "./approvalCreateRubricScores";
 import type { ApprovalCreateStatus } from "./approvalCreateStatus";
 
+/**
+ * Payload for creating a new approval request.
+ */
 export interface ApprovalCreate {
   action_type: string;
   task_id?: string | null;
diff --git a/frontend/src/api/generated/model/approvalRead.ts b/frontend/src/api/generated/model/approvalRead.ts
index 8049d94e..8740d689 100644
--- a/frontend/src/api/generated/model/approvalRead.ts
+++ b/frontend/src/api/generated/model/approvalRead.ts
@@ -8,6 +8,9 @@ import type { ApprovalReadPayload } from "./approvalReadPayload";
 import type { ApprovalReadRubricScores } from "./approvalReadRubricScores";
 import type { ApprovalReadStatus } from "./approvalReadStatus";
 
+/**
+ * Approval payload returned from read endpoints.
+ */
 export interface ApprovalRead {
   action_type: string;
   task_id?: string | null;
diff --git a/frontend/src/api/generated/model/approvalUpdate.ts b/frontend/src/api/generated/model/approvalUpdate.ts
index d7c35209..14b68185 100644
--- a/frontend/src/api/generated/model/approvalUpdate.ts
+++ b/frontend/src/api/generated/model/approvalUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for mutating approval status.
+ */
 export interface ApprovalUpdate {
   status?: "pending" | "approved" | "rejected" | null;
 }
diff --git a/frontend/src/api/generated/model/blockedTaskDetail.ts b/frontend/src/api/generated/model/blockedTaskDetail.ts
index a3ad4179..1ceebfad 100644
--- a/frontend/src/api/generated/model/blockedTaskDetail.ts
+++ b/frontend/src/api/generated/model/blockedTaskDetail.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Error detail payload listing blocking dependency task identifiers.
+ */
 export interface BlockedTaskDetail {
   message: string;
   blocked_by_task_ids?: string[];
diff --git a/frontend/src/api/generated/model/blockedTaskError.ts b/frontend/src/api/generated/model/blockedTaskError.ts
index e8294c59..c71edc00 100644
--- a/frontend/src/api/generated/model/blockedTaskError.ts
+++ b/frontend/src/api/generated/model/blockedTaskError.ts
@@ -6,6 +6,9 @@
  */
 import type { BlockedTaskDetail } from "./blockedTaskDetail";
 
+/**
+ * Top-level blocked-task error response envelope.
+ */
 export interface BlockedTaskError {
   detail: BlockedTaskDetail;
 }
diff --git a/frontend/src/api/generated/model/boardCreate.ts b/frontend/src/api/generated/model/boardCreate.ts
index f03000fb..effeacea 100644
--- a/frontend/src/api/generated/model/boardCreate.ts
+++ b/frontend/src/api/generated/model/boardCreate.ts
@@ -6,10 +6,13 @@
  */
 import type { BoardCreateSuccessMetrics } from "./boardCreateSuccessMetrics";
 
+/**
+ * Payload for creating a board.
+ */
 export interface BoardCreate {
   name: string;
   slug: string;
-  gateway_id: string;
+  gateway_id?: string | null;
   board_group_id?: string | null;
   board_type?: string;
   objective?: string | null;
diff --git a/frontend/src/api/generated/model/boardGroupBoardSnapshot.ts b/frontend/src/api/generated/model/boardGroupBoardSnapshot.ts
index ba5056c0..2308bbee 100644
--- a/frontend/src/api/generated/model/boardGroupBoardSnapshot.ts
+++ b/frontend/src/api/generated/model/boardGroupBoardSnapshot.ts
@@ -8,6 +8,9 @@ import type { BoardGroupBoardSnapshotTaskCounts } from "./boardGroupBoardSnapsho
 import type { BoardGroupTaskSummary } from "./boardGroupTaskSummary";
 import type { BoardRead } from "./boardRead";
 
+/**
+ * Board-level rollup embedded within a board-group snapshot.
+ */
 export interface BoardGroupBoardSnapshot {
   board: BoardRead;
   task_counts?: BoardGroupBoardSnapshotTaskCounts;
diff --git a/frontend/src/api/generated/model/boardGroupCreate.ts b/frontend/src/api/generated/model/boardGroupCreate.ts
index 9368515f..8c3dcc67 100644
--- a/frontend/src/api/generated/model/boardGroupCreate.ts
+++ b/frontend/src/api/generated/model/boardGroupCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a board group.
+ */
 export interface BoardGroupCreate {
   name: string;
   slug: string;
diff --git a/frontend/src/api/generated/model/boardGroupHeartbeatApply.ts b/frontend/src/api/generated/model/boardGroupHeartbeatApply.ts
index 46e3cda5..28b9444e 100644
--- a/frontend/src/api/generated/model/boardGroupHeartbeatApply.ts
+++ b/frontend/src/api/generated/model/boardGroupHeartbeatApply.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Request payload for heartbeat policy updates.
+ */
 export interface BoardGroupHeartbeatApply {
   every: string;
   target?: string | null;
diff --git a/frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts b/frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts
index d540a8ce..2ff8158b 100644
--- a/frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts
+++ b/frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts
@@ -6,6 +6,9 @@
  */
 import type { BoardGroupHeartbeatApplyResultRequested } from "./boardGroupHeartbeatApplyResultRequested";
 
+/**
+ * Result payload describing agents updated by a heartbeat request.
+ */
 export interface BoardGroupHeartbeatApplyResult {
   board_group_id: string;
   requested: BoardGroupHeartbeatApplyResultRequested;
diff --git a/frontend/src/api/generated/model/boardGroupMemoryCreate.ts b/frontend/src/api/generated/model/boardGroupMemoryCreate.ts
index b8c7453a..de1af46c 100644
--- a/frontend/src/api/generated/model/boardGroupMemoryCreate.ts
+++ b/frontend/src/api/generated/model/boardGroupMemoryCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a board-group memory entry.
+ */
 export interface BoardGroupMemoryCreate {
   /** @minLength 1 */
   content: string;
diff --git a/frontend/src/api/generated/model/boardGroupMemoryRead.ts b/frontend/src/api/generated/model/boardGroupMemoryRead.ts
index b315e341..7e4e8b32 100644
--- a/frontend/src/api/generated/model/boardGroupMemoryRead.ts
+++ b/frontend/src/api/generated/model/boardGroupMemoryRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Serialized board-group memory entry returned from read endpoints.
+ */
 export interface BoardGroupMemoryRead {
   id: string;
   board_group_id: string;
diff --git a/frontend/src/api/generated/model/boardGroupRead.ts b/frontend/src/api/generated/model/boardGroupRead.ts
index a1e8f514..3e507583 100644
--- a/frontend/src/api/generated/model/boardGroupRead.ts
+++ b/frontend/src/api/generated/model/boardGroupRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Board-group payload returned from read endpoints.
+ */
 export interface BoardGroupRead {
   name: string;
   slug: string;
diff --git a/frontend/src/api/generated/model/boardGroupSnapshot.ts b/frontend/src/api/generated/model/boardGroupSnapshot.ts
index c25c125c..4c057278 100644
--- a/frontend/src/api/generated/model/boardGroupSnapshot.ts
+++ b/frontend/src/api/generated/model/boardGroupSnapshot.ts
@@ -7,6 +7,9 @@
 import type { BoardGroupBoardSnapshot } from "./boardGroupBoardSnapshot";
 import type { BoardGroupRead } from "./boardGroupRead";
 
+/**
+ * Top-level board-group snapshot response payload.
+ */
 export interface BoardGroupSnapshot {
   group?: BoardGroupRead | null;
   boards?: BoardGroupBoardSnapshot[];
diff --git a/frontend/src/api/generated/model/boardGroupTaskSummary.ts b/frontend/src/api/generated/model/boardGroupTaskSummary.ts
index 8bfd002e..a6255336 100644
--- a/frontend/src/api/generated/model/boardGroupTaskSummary.ts
+++ b/frontend/src/api/generated/model/boardGroupTaskSummary.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Task summary row used inside board-group snapshot responses.
+ */
 export interface BoardGroupTaskSummary {
   id: string;
   board_id: string;
diff --git a/frontend/src/api/generated/model/boardGroupUpdate.ts b/frontend/src/api/generated/model/boardGroupUpdate.ts
index e904279e..d2de8627 100644
--- a/frontend/src/api/generated/model/boardGroupUpdate.ts
+++ b/frontend/src/api/generated/model/boardGroupUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial board-group updates.
+ */
 export interface BoardGroupUpdate {
   name?: string | null;
   slug?: string | null;
diff --git a/frontend/src/api/generated/model/boardMemoryCreate.ts b/frontend/src/api/generated/model/boardMemoryCreate.ts
index 1aff6e46..a617a479 100644
--- a/frontend/src/api/generated/model/boardMemoryCreate.ts
+++ b/frontend/src/api/generated/model/boardMemoryCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a board memory entry.
+ */
 export interface BoardMemoryCreate {
   /** @minLength 1 */
   content: string;
diff --git a/frontend/src/api/generated/model/boardMemoryRead.ts b/frontend/src/api/generated/model/boardMemoryRead.ts
index 8730e84c..e10bec26 100644
--- a/frontend/src/api/generated/model/boardMemoryRead.ts
+++ b/frontend/src/api/generated/model/boardMemoryRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Serialized board memory entry returned from read endpoints.
+ */
 export interface BoardMemoryRead {
   id: string;
   board_id: string;
diff --git a/frontend/src/api/generated/model/boardOnboardingAgentComplete.ts b/frontend/src/api/generated/model/boardOnboardingAgentComplete.ts
index 084b0213..a5ac5b8a 100644
--- a/frontend/src/api/generated/model/boardOnboardingAgentComplete.ts
+++ b/frontend/src/api/generated/model/boardOnboardingAgentComplete.ts
@@ -7,13 +7,17 @@
 import type { BoardOnboardingAgentCompleteSuccessMetrics } from "./boardOnboardingAgentCompleteSuccessMetrics";
 import type { BoardOnboardingLeadAgentDraft } from "./boardOnboardingLeadAgentDraft";
 import type { BoardOnboardingUserProfile } from "./boardOnboardingUserProfile";
+import { BoardOnboardingAgentCompleteStatus } from "./boardOnboardingAgentCompleteStatus";
 
+/**
+ * Complete onboarding draft produced by the onboarding assistant.
+ */
 export interface BoardOnboardingAgentComplete {
   board_type: string;
   objective?: string | null;
   success_metrics?: BoardOnboardingAgentCompleteSuccessMetrics;
   target_date?: string | null;
-  status: "complete";
+  status: BoardOnboardingAgentCompleteStatus;
   user_profile?: BoardOnboardingUserProfile | null;
   lead_agent?: BoardOnboardingLeadAgentDraft | null;
 }
diff --git a/frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts b/frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts
new file mode 100644
index 00000000..365fed88
--- /dev/null
+++ b/frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts
@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Mission Control API
+ * OpenAPI spec version: 0.1.0
+ */
+
+export type BoardOnboardingAgentCompleteStatus =
+  (typeof BoardOnboardingAgentCompleteStatus)[keyof typeof BoardOnboardingAgentCompleteStatus];
+
+export const BoardOnboardingAgentCompleteStatus = {
+  complete: "complete",
+} as const;
diff --git a/frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts b/frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts
index 6904ef01..ea92cef2 100644
--- a/frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts
+++ b/frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts
@@ -6,6 +6,9 @@
  */
 import type { BoardOnboardingQuestionOption } from "./boardOnboardingQuestionOption";
 
+/**
+ * Question payload emitted by the onboarding assistant.
+ */
 export interface BoardOnboardingAgentQuestion {
   /** @minLength 1 */
   question: string;
diff --git a/frontend/src/api/generated/model/boardOnboardingAnswer.ts b/frontend/src/api/generated/model/boardOnboardingAnswer.ts
index 9a5e4ea4..8c787b58 100644
--- a/frontend/src/api/generated/model/boardOnboardingAnswer.ts
+++ b/frontend/src/api/generated/model/boardOnboardingAnswer.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * User answer payload for a single onboarding question.
+ */
 export interface BoardOnboardingAnswer {
   /** @minLength 1 */
   answer: string;
diff --git a/frontend/src/api/generated/model/boardOnboardingConfirm.ts b/frontend/src/api/generated/model/boardOnboardingConfirm.ts
index af198322..63e2c914 100644
--- a/frontend/src/api/generated/model/boardOnboardingConfirm.ts
+++ b/frontend/src/api/generated/model/boardOnboardingConfirm.ts
@@ -6,6 +6,9 @@
  */
 import type { BoardOnboardingConfirmSuccessMetrics } from "./boardOnboardingConfirmSuccessMetrics";
 
+/**
+ * Payload used to confirm generated onboarding draft fields.
+ */
 export interface BoardOnboardingConfirm {
   board_type: string;
   objective?: string | null;
diff --git a/frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts b/frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts
index 75903eaa..12d6fb3d 100644
--- a/frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts
+++ b/frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts
@@ -6,6 +6,9 @@
  */
 import type { BoardOnboardingLeadAgentDraftIdentityProfile } from "./boardOnboardingLeadAgentDraftIdentityProfile";
 
+/**
+ * Editable lead-agent draft configuration.
+ */
 export interface BoardOnboardingLeadAgentDraft {
   name?: string | null;
   identity_profile?: BoardOnboardingLeadAgentDraftIdentityProfile;
diff --git a/frontend/src/api/generated/model/boardOnboardingQuestionOption.ts b/frontend/src/api/generated/model/boardOnboardingQuestionOption.ts
index aab7ec6b..80a1168b 100644
--- a/frontend/src/api/generated/model/boardOnboardingQuestionOption.ts
+++ b/frontend/src/api/generated/model/boardOnboardingQuestionOption.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Selectable option for an onboarding question.
+ */
 export interface BoardOnboardingQuestionOption {
   /** @minLength 1 */
   id: string;
diff --git a/frontend/src/api/generated/model/boardOnboardingRead.ts b/frontend/src/api/generated/model/boardOnboardingRead.ts
index ce409e74..509b7382 100644
--- a/frontend/src/api/generated/model/boardOnboardingRead.ts
+++ b/frontend/src/api/generated/model/boardOnboardingRead.ts
@@ -7,6 +7,9 @@
 import type { BoardOnboardingAgentComplete } from "./boardOnboardingAgentComplete";
 import type { BoardOnboardingReadMessages } from "./boardOnboardingReadMessages";
 
+/**
+ * Stored onboarding session state returned by API endpoints.
+ */
 export interface BoardOnboardingRead {
   id: string;
   board_id: string;
diff --git a/frontend/src/api/generated/model/boardOnboardingStart.ts b/frontend/src/api/generated/model/boardOnboardingStart.ts
index 714382be..95253520 100644
--- a/frontend/src/api/generated/model/boardOnboardingStart.ts
+++ b/frontend/src/api/generated/model/boardOnboardingStart.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Start signal for initializing onboarding conversation.
+ */
 export interface BoardOnboardingStart {
   [key: string]: unknown;
 }
diff --git a/frontend/src/api/generated/model/boardOnboardingUserProfile.ts b/frontend/src/api/generated/model/boardOnboardingUserProfile.ts
index bbee0600..f40ced34 100644
--- a/frontend/src/api/generated/model/boardOnboardingUserProfile.ts
+++ b/frontend/src/api/generated/model/boardOnboardingUserProfile.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * User-profile preferences gathered during onboarding.
+ */
 export interface BoardOnboardingUserProfile {
   preferred_name?: string | null;
   pronouns?: string | null;
diff --git a/frontend/src/api/generated/model/boardRead.ts b/frontend/src/api/generated/model/boardRead.ts
index f1706fed..04f6029f 100644
--- a/frontend/src/api/generated/model/boardRead.ts
+++ b/frontend/src/api/generated/model/boardRead.ts
@@ -6,6 +6,9 @@
  */
 import type { BoardReadSuccessMetrics } from "./boardReadSuccessMetrics";
 
+/**
+ * Board payload returned from read endpoints.
+ */
 export interface BoardRead {
   name: string;
   slug: string;
diff --git a/frontend/src/api/generated/model/boardSnapshot.ts b/frontend/src/api/generated/model/boardSnapshot.ts
index ac1b39cb..27f27a13 100644
--- a/frontend/src/api/generated/model/boardSnapshot.ts
+++ b/frontend/src/api/generated/model/boardSnapshot.ts
@@ -10,6 +10,9 @@ import type { BoardMemoryRead } from "./boardMemoryRead";
 import type { BoardRead } from "./boardRead";
 import type { TaskCardRead } from "./taskCardRead";
 
+/**
+ * Aggregated board payload used by board snapshot endpoints.
+ */
 export interface BoardSnapshot {
   board: BoardRead;
   tasks: TaskCardRead[];
diff --git a/frontend/src/api/generated/model/boardUpdate.ts b/frontend/src/api/generated/model/boardUpdate.ts
index 0cc89c4f..07b3cb5d 100644
--- a/frontend/src/api/generated/model/boardUpdate.ts
+++ b/frontend/src/api/generated/model/boardUpdate.ts
@@ -6,6 +6,9 @@
  */
 import type { BoardUpdateSuccessMetrics } from "./boardUpdateSuccessMetrics";
 
+/**
+ * Payload for partial board updates.
+ */
 export interface BoardUpdate {
   name?: string | null;
   slug?: string | null;
diff --git a/frontend/src/api/generated/model/dashboardKpis.ts b/frontend/src/api/generated/model/dashboardKpis.ts
index 72fdd827..e291d462 100644
--- a/frontend/src/api/generated/model/dashboardKpis.ts
+++ b/frontend/src/api/generated/model/dashboardKpis.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Topline dashboard KPI summary values.
+ */
 export interface DashboardKpis {
   active_agents: number;
   tasks_in_progress: number;
diff --git a/frontend/src/api/generated/model/dashboardMetrics.ts b/frontend/src/api/generated/model/dashboardMetrics.ts
index 9fe0efee..e0d0a305 100644
--- a/frontend/src/api/generated/model/dashboardMetrics.ts
+++ b/frontend/src/api/generated/model/dashboardMetrics.ts
@@ -9,6 +9,9 @@ import type { DashboardMetricsRange } from "./dashboardMetricsRange";
 import type { DashboardSeriesSet } from "./dashboardSeriesSet";
 import type { DashboardWipSeriesSet } from "./dashboardWipSeriesSet";
 
+/**
+ * Complete dashboard metrics response payload.
+ */
 export interface DashboardMetrics {
   range: DashboardMetricsRange;
   generated_at: string;
diff --git a/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetParams.ts b/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetParams.ts
index 381b4ec7..85bf4244 100644
--- a/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetParams.ts
+++ b/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetParams.ts
@@ -4,8 +4,8 @@
  * Mission Control API
  * OpenAPI spec version: 0.1.0
  */
-import type { DashboardMetricsApiV1MetricsDashboardGetRange } from "./dashboardMetricsApiV1MetricsDashboardGetRange";
+import type { DashboardMetricsApiV1MetricsDashboardGetRangeKey } from "./dashboardMetricsApiV1MetricsDashboardGetRangeKey";
 
 export type DashboardMetricsApiV1MetricsDashboardGetParams = {
-  range?: DashboardMetricsApiV1MetricsDashboardGetRange;
+  range_key?: DashboardMetricsApiV1MetricsDashboardGetRangeKey;
 };
diff --git a/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRangeKey.ts b/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRangeKey.ts
new file mode 100644
index 00000000..624de6e9
--- /dev/null
+++ b/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRangeKey.ts
@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Mission Control API
+ * OpenAPI spec version: 0.1.0
+ */
+
+export type DashboardMetricsApiV1MetricsDashboardGetRangeKey =
+  (typeof DashboardMetricsApiV1MetricsDashboardGetRangeKey)[keyof typeof DashboardMetricsApiV1MetricsDashboardGetRangeKey];
+
+export const DashboardMetricsApiV1MetricsDashboardGetRangeKey = {
+  "24h": "24h",
+  "7d": "7d",
+} as const;
diff --git a/frontend/src/api/generated/model/dashboardRangeSeries.ts b/frontend/src/api/generated/model/dashboardRangeSeries.ts
index b9dfc206..5d2066ef 100644
--- a/frontend/src/api/generated/model/dashboardRangeSeries.ts
+++ b/frontend/src/api/generated/model/dashboardRangeSeries.ts
@@ -8,6 +8,9 @@ import type { DashboardRangeSeriesBucket } from "./dashboardRangeSeriesBucket";
 import type { DashboardRangeSeriesRange } from "./dashboardRangeSeriesRange";
 import type { DashboardSeriesPoint } from "./dashboardSeriesPoint";
 
+/**
+ * Series payload for a single range/bucket combination.
+ */
 export interface DashboardRangeSeries {
   range: DashboardRangeSeriesRange;
   bucket: DashboardRangeSeriesBucket;
diff --git a/frontend/src/api/generated/model/dashboardSeriesPoint.ts b/frontend/src/api/generated/model/dashboardSeriesPoint.ts
index 8d1d585a..7bbe61de 100644
--- a/frontend/src/api/generated/model/dashboardSeriesPoint.ts
+++ b/frontend/src/api/generated/model/dashboardSeriesPoint.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Single numeric time-series point.
+ */
 export interface DashboardSeriesPoint {
   period: string;
   value: number;
diff --git a/frontend/src/api/generated/model/dashboardSeriesSet.ts b/frontend/src/api/generated/model/dashboardSeriesSet.ts
index 529b8d38..14b903ed 100644
--- a/frontend/src/api/generated/model/dashboardSeriesSet.ts
+++ b/frontend/src/api/generated/model/dashboardSeriesSet.ts
@@ -6,6 +6,9 @@
  */
 import type { DashboardRangeSeries } from "./dashboardRangeSeries";
 
+/**
+ * Primary vs comparison pair for generic series metrics.
+ */
 export interface DashboardSeriesSet {
   primary: DashboardRangeSeries;
   comparison: DashboardRangeSeries;
diff --git a/frontend/src/api/generated/model/dashboardWipPoint.ts b/frontend/src/api/generated/model/dashboardWipPoint.ts
index 2f47f974..8016ba51 100644
--- a/frontend/src/api/generated/model/dashboardWipPoint.ts
+++ b/frontend/src/api/generated/model/dashboardWipPoint.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Work-in-progress point split by task status buckets.
+ */
 export interface DashboardWipPoint {
   period: string;
   inbox: number;
diff --git a/frontend/src/api/generated/model/dashboardWipRangeSeries.ts b/frontend/src/api/generated/model/dashboardWipRangeSeries.ts
index 9c34d786..05ab83fe 100644
--- a/frontend/src/api/generated/model/dashboardWipRangeSeries.ts
+++ b/frontend/src/api/generated/model/dashboardWipRangeSeries.ts
@@ -8,6 +8,9 @@ import type { DashboardWipPoint } from "./dashboardWipPoint";
 import type { DashboardWipRangeSeriesBucket } from "./dashboardWipRangeSeriesBucket";
 import type { DashboardWipRangeSeriesRange } from "./dashboardWipRangeSeriesRange";
 
+/**
+ * WIP series payload for a single range/bucket combination.
+ */
 export interface DashboardWipRangeSeries {
   range: DashboardWipRangeSeriesRange;
   bucket: DashboardWipRangeSeriesBucket;
diff --git a/frontend/src/api/generated/model/dashboardWipSeriesSet.ts b/frontend/src/api/generated/model/dashboardWipSeriesSet.ts
index 55ad1ab1..b54316fb 100644
--- a/frontend/src/api/generated/model/dashboardWipSeriesSet.ts
+++ b/frontend/src/api/generated/model/dashboardWipSeriesSet.ts
@@ -6,6 +6,9 @@
  */
 import type { DashboardWipRangeSeries } from "./dashboardWipRangeSeries";
 
+/**
+ * Primary vs comparison pair for WIP status series metrics.
+ */
 export interface DashboardWipSeriesSet {
   primary: DashboardWipRangeSeries;
   comparison: DashboardWipRangeSeries;
diff --git a/frontend/src/api/generated/model/gatewayCommandsResponse.ts b/frontend/src/api/generated/model/gatewayCommandsResponse.ts
index cf902c2d..e142ed97 100644
--- a/frontend/src/api/generated/model/gatewayCommandsResponse.ts
+++ b/frontend/src/api/generated/model/gatewayCommandsResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway command catalog and protocol metadata.
+ */
 export interface GatewayCommandsResponse {
   protocol_version: number;
   methods: string[];
diff --git a/frontend/src/api/generated/model/gatewayCreate.ts b/frontend/src/api/generated/model/gatewayCreate.ts
index 4d360df9..fee4cac0 100644
--- a/frontend/src/api/generated/model/gatewayCreate.ts
+++ b/frontend/src/api/generated/model/gatewayCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a gateway configuration.
+ */
 export interface GatewayCreate {
   name: string;
   url: string;
diff --git a/frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts b/frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts
index a94de05f..f6f39d7c 100644
--- a/frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts
+++ b/frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Per-board result entry for a lead broadcast operation.
+ */
 export interface GatewayLeadBroadcastBoardResult {
   board_id: string;
   lead_agent_id?: string | null;
diff --git a/frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts b/frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts
index 551fe970..f87a6419 100644
--- a/frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts
+++ b/frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts
@@ -6,6 +6,9 @@
  */
 import type { GatewayLeadBroadcastRequestKind } from "./gatewayLeadBroadcastRequestKind";
 
+/**
+ * Request payload for broadcasting a message to multiple board leads.
+ */
 export interface GatewayLeadBroadcastRequest {
   kind?: GatewayLeadBroadcastRequestKind;
   correlation_id?: string | null;
diff --git a/frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts b/frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts
index 92b96aed..f7bdcb6f 100644
--- a/frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts
+++ b/frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts
@@ -6,6 +6,9 @@
  */
 import type { GatewayLeadBroadcastBoardResult } from "./gatewayLeadBroadcastBoardResult";
 
+/**
+ * Aggregate response for a lead broadcast operation.
+ */
 export interface GatewayLeadBroadcastResponse {
   ok?: boolean;
   sent?: number;
diff --git a/frontend/src/api/generated/model/gatewayLeadMessageRequest.ts b/frontend/src/api/generated/model/gatewayLeadMessageRequest.ts
index d2dd085e..4d124e75 100644
--- a/frontend/src/api/generated/model/gatewayLeadMessageRequest.ts
+++ b/frontend/src/api/generated/model/gatewayLeadMessageRequest.ts
@@ -6,6 +6,9 @@
  */
 import type { GatewayLeadMessageRequestKind } from "./gatewayLeadMessageRequestKind";
 
+/**
+ * Request payload for sending a message to a board lead agent.
+ */
 export interface GatewayLeadMessageRequest {
   kind?: GatewayLeadMessageRequestKind;
   correlation_id?: string | null;
diff --git a/frontend/src/api/generated/model/gatewayLeadMessageResponse.ts b/frontend/src/api/generated/model/gatewayLeadMessageResponse.ts
index 4dce94ef..acc519b1 100644
--- a/frontend/src/api/generated/model/gatewayLeadMessageResponse.ts
+++ b/frontend/src/api/generated/model/gatewayLeadMessageResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Response payload for a lead-message dispatch attempt.
+ */
 export interface GatewayLeadMessageResponse {
   ok?: boolean;
   board_id: string;
diff --git a/frontend/src/api/generated/model/gatewayMainAskUserRequest.ts b/frontend/src/api/generated/model/gatewayMainAskUserRequest.ts
index fdb10721..bbb614e7 100644
--- a/frontend/src/api/generated/model/gatewayMainAskUserRequest.ts
+++ b/frontend/src/api/generated/model/gatewayMainAskUserRequest.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Request payload for asking the end user via a main gateway agent.
+ */
 export interface GatewayMainAskUserRequest {
   correlation_id?: string | null;
   /** @minLength 1 */
diff --git a/frontend/src/api/generated/model/gatewayMainAskUserResponse.ts b/frontend/src/api/generated/model/gatewayMainAskUserResponse.ts
index 25367a43..3399f063 100644
--- a/frontend/src/api/generated/model/gatewayMainAskUserResponse.ts
+++ b/frontend/src/api/generated/model/gatewayMainAskUserResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Response payload for user-question dispatch via gateway main agent.
+ */
 export interface GatewayMainAskUserResponse {
   ok?: boolean;
   board_id: string;
diff --git a/frontend/src/api/generated/model/gatewayRead.ts b/frontend/src/api/generated/model/gatewayRead.ts
index d6b12431..4e626449 100644
--- a/frontend/src/api/generated/model/gatewayRead.ts
+++ b/frontend/src/api/generated/model/gatewayRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway payload returned from read endpoints.
+ */
 export interface GatewayRead {
   name: string;
   url: string;
diff --git a/frontend/src/api/generated/model/gatewayResolveQuery.ts b/frontend/src/api/generated/model/gatewayResolveQuery.ts
new file mode 100644
index 00000000..f84bee2a
--- /dev/null
+++ b/frontend/src/api/generated/model/gatewayResolveQuery.ts
@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Mission Control API
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * Query parameters used to resolve which gateway to target.
+ */
+export interface GatewayResolveQuery {
+  board_id?: string | null;
+  gateway_url?: string | null;
+  gateway_token?: string | null;
+  gateway_main_session_key?: string | null;
+}
diff --git a/frontend/src/api/generated/model/gatewaySessionHistoryResponse.ts b/frontend/src/api/generated/model/gatewaySessionHistoryResponse.ts
index ea6226f5..3af15ed7 100644
--- a/frontend/src/api/generated/model/gatewaySessionHistoryResponse.ts
+++ b/frontend/src/api/generated/model/gatewaySessionHistoryResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway session history response payload.
+ */
 export interface GatewaySessionHistoryResponse {
   history: unknown[];
 }
diff --git a/frontend/src/api/generated/model/gatewaySessionMessageRequest.ts b/frontend/src/api/generated/model/gatewaySessionMessageRequest.ts
index 4d1c135e..b51497b6 100644
--- a/frontend/src/api/generated/model/gatewaySessionMessageRequest.ts
+++ b/frontend/src/api/generated/model/gatewaySessionMessageRequest.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Request payload for sending a message into a gateway session.
+ */
 export interface GatewaySessionMessageRequest {
   /** @minLength 1 */
   content: string;
diff --git a/frontend/src/api/generated/model/gatewaySessionResponse.ts b/frontend/src/api/generated/model/gatewaySessionResponse.ts
index 16c347cd..d06e6549 100644
--- a/frontend/src/api/generated/model/gatewaySessionResponse.ts
+++ b/frontend/src/api/generated/model/gatewaySessionResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Single gateway session response payload.
+ */
 export interface GatewaySessionResponse {
   session: unknown;
 }
diff --git a/frontend/src/api/generated/model/gatewaySessionsResponse.ts b/frontend/src/api/generated/model/gatewaySessionsResponse.ts
index 126b131b..4b5164c1 100644
--- a/frontend/src/api/generated/model/gatewaySessionsResponse.ts
+++ b/frontend/src/api/generated/model/gatewaySessionsResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway sessions list response payload.
+ */
 export interface GatewaySessionsResponse {
   sessions: unknown[];
   main_session_key?: string | null;
diff --git a/frontend/src/api/generated/model/gatewayTemplatesSyncError.ts b/frontend/src/api/generated/model/gatewayTemplatesSyncError.ts
index 62d81f47..4a0ea553 100644
--- a/frontend/src/api/generated/model/gatewayTemplatesSyncError.ts
+++ b/frontend/src/api/generated/model/gatewayTemplatesSyncError.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Per-agent error entry from a gateway template sync operation.
+ */
 export interface GatewayTemplatesSyncError {
   agent_id?: string | null;
   agent_name?: string | null;
diff --git a/frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts b/frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts
index c30aa543..332b92b2 100644
--- a/frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts
+++ b/frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts
@@ -6,6 +6,9 @@
  */
 import type { GatewayTemplatesSyncError } from "./gatewayTemplatesSyncError";
 
+/**
+ * Summary payload returned by gateway template sync endpoints.
+ */
 export interface GatewayTemplatesSyncResult {
   gateway_id: string;
   include_main: boolean;
diff --git a/frontend/src/api/generated/model/gatewayUpdate.ts b/frontend/src/api/generated/model/gatewayUpdate.ts
index 05727865..a834f80b 100644
--- a/frontend/src/api/generated/model/gatewayUpdate.ts
+++ b/frontend/src/api/generated/model/gatewayUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial gateway updates.
+ */
 export interface GatewayUpdate {
   name?: string | null;
   url?: string | null;
diff --git a/frontend/src/api/generated/model/gatewaysStatusResponse.ts b/frontend/src/api/generated/model/gatewaysStatusResponse.ts
index 033d8daa..ac728bfd 100644
--- a/frontend/src/api/generated/model/gatewaysStatusResponse.ts
+++ b/frontend/src/api/generated/model/gatewaysStatusResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Aggregated gateway status response including session metadata.
+ */
 export interface GatewaysStatusResponse {
   connected: boolean;
   gateway_url: string;
diff --git a/frontend/src/api/generated/model/index.ts b/frontend/src/api/generated/model/index.ts
index 26ab4015..0f832836 100644
--- a/frontend/src/api/generated/model/index.ts
+++ b/frontend/src/api/generated/model/index.ts
@@ -49,6 +49,7 @@ export * from "./boardGroupUpdate";
 export * from "./boardMemoryCreate";
 export * from "./boardMemoryRead";
 export * from "./boardOnboardingAgentComplete";
+export * from "./boardOnboardingAgentCompleteStatus";
 export * from "./boardOnboardingAgentCompleteSuccessMetrics";
 export * from "./boardOnboardingAgentQuestion";
 export * from "./boardOnboardingAnswer";
@@ -73,6 +74,7 @@ export * from "./dashboardKpis";
 export * from "./dashboardMetrics";
 export * from "./dashboardMetricsApiV1MetricsDashboardGetParams";
 export * from "./dashboardMetricsApiV1MetricsDashboardGetRange";
+export * from "./dashboardMetricsApiV1MetricsDashboardGetRangeKey";
 export * from "./dashboardMetricsRange";
 export * from "./dashboardRangeSeries";
 export * from "./dashboardRangeSeriesBucket";
@@ -100,6 +102,7 @@ export * from "./gatewayLeadMessageResponse";
 export * from "./gatewayMainAskUserRequest";
 export * from "./gatewayMainAskUserResponse";
 export * from "./gatewayRead";
+export * from "./gatewayResolveQuery";
 export * from "./gatewaySessionHistoryResponse";
 export * from "./gatewaySessionMessageRequest";
 export * from "./gatewaySessionResponse";
diff --git a/frontend/src/api/generated/model/okResponse.ts b/frontend/src/api/generated/model/okResponse.ts
index 9481d814..f9e01125 100644
--- a/frontend/src/api/generated/model/okResponse.ts
+++ b/frontend/src/api/generated/model/okResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Standard success response payload.
+ */
 export interface OkResponse {
   ok?: boolean;
 }
diff --git a/frontend/src/api/generated/model/organizationActiveUpdate.ts b/frontend/src/api/generated/model/organizationActiveUpdate.ts
index bf2a1ba4..017c13f0 100644
--- a/frontend/src/api/generated/model/organizationActiveUpdate.ts
+++ b/frontend/src/api/generated/model/organizationActiveUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for switching the active organization context.
+ */
 export interface OrganizationActiveUpdate {
   organization_id: string;
 }
diff --git a/frontend/src/api/generated/model/organizationBoardAccessRead.ts b/frontend/src/api/generated/model/organizationBoardAccessRead.ts
index 9fc841f0..9c527132 100644
--- a/frontend/src/api/generated/model/organizationBoardAccessRead.ts
+++ b/frontend/src/api/generated/model/organizationBoardAccessRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Board access payload returned from read endpoints.
+ */
 export interface OrganizationBoardAccessRead {
   id: string;
   board_id: string;
diff --git a/frontend/src/api/generated/model/organizationBoardAccessSpec.ts b/frontend/src/api/generated/model/organizationBoardAccessSpec.ts
index 49371849..d469b213 100644
--- a/frontend/src/api/generated/model/organizationBoardAccessSpec.ts
+++ b/frontend/src/api/generated/model/organizationBoardAccessSpec.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Board access specification used in member/invite mutation payloads.
+ */
 export interface OrganizationBoardAccessSpec {
   board_id: string;
   can_read?: boolean;
diff --git a/frontend/src/api/generated/model/organizationCreate.ts b/frontend/src/api/generated/model/organizationCreate.ts
index 2eeb1fdd..0d80fd8f 100644
--- a/frontend/src/api/generated/model/organizationCreate.ts
+++ b/frontend/src/api/generated/model/organizationCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a new organization.
+ */
 export interface OrganizationCreate {
   name: string;
 }
diff --git a/frontend/src/api/generated/model/organizationInviteAccept.ts b/frontend/src/api/generated/model/organizationInviteAccept.ts
index 54384c7c..a53ff556 100644
--- a/frontend/src/api/generated/model/organizationInviteAccept.ts
+++ b/frontend/src/api/generated/model/organizationInviteAccept.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for accepting an organization invite token.
+ */
 export interface OrganizationInviteAccept {
   token: string;
 }
diff --git a/frontend/src/api/generated/model/organizationInviteCreate.ts b/frontend/src/api/generated/model/organizationInviteCreate.ts
index 8a45ef35..57fe6ed0 100644
--- a/frontend/src/api/generated/model/organizationInviteCreate.ts
+++ b/frontend/src/api/generated/model/organizationInviteCreate.ts
@@ -6,6 +6,9 @@
  */
 import type { OrganizationBoardAccessSpec } from "./organizationBoardAccessSpec";
 
+/**
+ * Payload for creating an organization invite.
+ */
 export interface OrganizationInviteCreate {
   invited_email: string;
   role?: string;
diff --git a/frontend/src/api/generated/model/organizationInviteRead.ts b/frontend/src/api/generated/model/organizationInviteRead.ts
index 7e5d5831..6e198f4c 100644
--- a/frontend/src/api/generated/model/organizationInviteRead.ts
+++ b/frontend/src/api/generated/model/organizationInviteRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Organization invite payload returned from read endpoints.
+ */
 export interface OrganizationInviteRead {
   id: string;
   organization_id: string;
diff --git a/frontend/src/api/generated/model/organizationListItem.ts b/frontend/src/api/generated/model/organizationListItem.ts
index 12e8626d..f109262f 100644
--- a/frontend/src/api/generated/model/organizationListItem.ts
+++ b/frontend/src/api/generated/model/organizationListItem.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Organization list row for current user memberships.
+ */
 export interface OrganizationListItem {
   id: string;
   name: string;
diff --git a/frontend/src/api/generated/model/organizationMemberAccessUpdate.ts b/frontend/src/api/generated/model/organizationMemberAccessUpdate.ts
index 2436482a..4167a25d 100644
--- a/frontend/src/api/generated/model/organizationMemberAccessUpdate.ts
+++ b/frontend/src/api/generated/model/organizationMemberAccessUpdate.ts
@@ -6,6 +6,9 @@
  */
 import type { OrganizationBoardAccessSpec } from "./organizationBoardAccessSpec";
 
+/**
+ * Payload for replacing organization member access permissions.
+ */
 export interface OrganizationMemberAccessUpdate {
   all_boards_read?: boolean;
   all_boards_write?: boolean;
diff --git a/frontend/src/api/generated/model/organizationMemberRead.ts b/frontend/src/api/generated/model/organizationMemberRead.ts
index 5fba6c8a..9b92b44c 100644
--- a/frontend/src/api/generated/model/organizationMemberRead.ts
+++ b/frontend/src/api/generated/model/organizationMemberRead.ts
@@ -7,6 +7,9 @@
 import type { OrganizationBoardAccessRead } from "./organizationBoardAccessRead";
 import type { OrganizationUserRead } from "./organizationUserRead";
 
+/**
+ * Organization member payload including board-level access overrides.
+ */
 export interface OrganizationMemberRead {
   id: string;
   organization_id: string;
diff --git a/frontend/src/api/generated/model/organizationMemberUpdate.ts b/frontend/src/api/generated/model/organizationMemberUpdate.ts
index 8ed18173..9db99bf8 100644
--- a/frontend/src/api/generated/model/organizationMemberUpdate.ts
+++ b/frontend/src/api/generated/model/organizationMemberUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial updates to organization member role.
+ */
 export interface OrganizationMemberUpdate {
   role?: string | null;
 }
diff --git a/frontend/src/api/generated/model/organizationRead.ts b/frontend/src/api/generated/model/organizationRead.ts
index f9f89f15..ffa94118 100644
--- a/frontend/src/api/generated/model/organizationRead.ts
+++ b/frontend/src/api/generated/model/organizationRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Organization payload returned by read endpoints.
+ */
 export interface OrganizationRead {
   id: string;
   name: string;
diff --git a/frontend/src/api/generated/model/organizationUserRead.ts b/frontend/src/api/generated/model/organizationUserRead.ts
index 1cdf8207..6bc9b2ae 100644
--- a/frontend/src/api/generated/model/organizationUserRead.ts
+++ b/frontend/src/api/generated/model/organizationUserRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Embedded user fields included in organization member payloads.
+ */
 export interface OrganizationUserRead {
   id: string;
   email?: string | null;
diff --git a/frontend/src/api/generated/model/soulUpdateRequest.ts b/frontend/src/api/generated/model/soulUpdateRequest.ts
index 0a04a175..8cf619fe 100644
--- a/frontend/src/api/generated/model/soulUpdateRequest.ts
+++ b/frontend/src/api/generated/model/soulUpdateRequest.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for updating an agent SOUL document.
+ */
 export interface SoulUpdateRequest {
   content: string;
   source_url?: string | null;
diff --git a/frontend/src/api/generated/model/soulsDirectoryMarkdownResponse.ts b/frontend/src/api/generated/model/soulsDirectoryMarkdownResponse.ts
index af2cb8a5..54f07e8c 100644
--- a/frontend/src/api/generated/model/soulsDirectoryMarkdownResponse.ts
+++ b/frontend/src/api/generated/model/soulsDirectoryMarkdownResponse.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Response payload containing rendered markdown for a soul.
+ */
 export interface SoulsDirectoryMarkdownResponse {
   handle: string;
   slug: string;
diff --git a/frontend/src/api/generated/model/soulsDirectorySearchResponse.ts b/frontend/src/api/generated/model/soulsDirectorySearchResponse.ts
index 8b6c49e0..d2a4fd61 100644
--- a/frontend/src/api/generated/model/soulsDirectorySearchResponse.ts
+++ b/frontend/src/api/generated/model/soulsDirectorySearchResponse.ts
@@ -6,6 +6,9 @@
  */
 import type { SoulsDirectorySoulRef } from "./soulsDirectorySoulRef";
 
+/**
+ * Response wrapper for directory search results.
+ */
 export interface SoulsDirectorySearchResponse {
   items: SoulsDirectorySoulRef[];
 }
diff --git a/frontend/src/api/generated/model/soulsDirectorySoulRef.ts b/frontend/src/api/generated/model/soulsDirectorySoulRef.ts
index a93f7e79..d7700505 100644
--- a/frontend/src/api/generated/model/soulsDirectorySoulRef.ts
+++ b/frontend/src/api/generated/model/soulsDirectorySoulRef.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Reference metadata for a soul entry in the directory index.
+ */
 export interface SoulsDirectorySoulRef {
   handle: string;
   slug: string;
diff --git a/frontend/src/api/generated/model/taskCardRead.ts b/frontend/src/api/generated/model/taskCardRead.ts
index b5639c94..287fc9df 100644
--- a/frontend/src/api/generated/model/taskCardRead.ts
+++ b/frontend/src/api/generated/model/taskCardRead.ts
@@ -6,6 +6,9 @@
  */
 import type { TaskCardReadStatus } from "./taskCardReadStatus";
 
+/**
+ * Task read model enriched with assignee and approval counters.
+ */
 export interface TaskCardRead {
   title: string;
   description?: string | null;
diff --git a/frontend/src/api/generated/model/taskCommentCreate.ts b/frontend/src/api/generated/model/taskCommentCreate.ts
index 8da36449..c67516bd 100644
--- a/frontend/src/api/generated/model/taskCommentCreate.ts
+++ b/frontend/src/api/generated/model/taskCommentCreate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a task comment.
+ */
 export interface TaskCommentCreate {
   /** @minLength 1 */
   message: string;
diff --git a/frontend/src/api/generated/model/taskCommentRead.ts b/frontend/src/api/generated/model/taskCommentRead.ts
index cc564640..09fed42b 100644
--- a/frontend/src/api/generated/model/taskCommentRead.ts
+++ b/frontend/src/api/generated/model/taskCommentRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Task comment payload returned from read endpoints.
+ */
 export interface TaskCommentRead {
   id: string;
   message: string | null;
diff --git a/frontend/src/api/generated/model/taskCreate.ts b/frontend/src/api/generated/model/taskCreate.ts
index 64f12f9b..12b163eb 100644
--- a/frontend/src/api/generated/model/taskCreate.ts
+++ b/frontend/src/api/generated/model/taskCreate.ts
@@ -6,6 +6,9 @@
  */
 import type { TaskCreateStatus } from "./taskCreateStatus";
 
+/**
+ * Payload for creating a task.
+ */
 export interface TaskCreate {
   title: string;
   description?: string | null;
diff --git a/frontend/src/api/generated/model/taskRead.ts b/frontend/src/api/generated/model/taskRead.ts
index f80a2904..30cf7de7 100644
--- a/frontend/src/api/generated/model/taskRead.ts
+++ b/frontend/src/api/generated/model/taskRead.ts
@@ -6,6 +6,9 @@
  */
 import type { TaskReadStatus } from "./taskReadStatus";
 
+/**
+ * Task payload returned from read endpoints.
+ */
 export interface TaskRead {
   title: string;
   description?: string | null;
diff --git a/frontend/src/api/generated/model/taskUpdate.ts b/frontend/src/api/generated/model/taskUpdate.ts
index b5296255..3a613e08 100644
--- a/frontend/src/api/generated/model/taskUpdate.ts
+++ b/frontend/src/api/generated/model/taskUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial task updates.
+ */
 export interface TaskUpdate {
   title?: string | null;
   description?: string | null;
diff --git a/frontend/src/api/generated/model/userRead.ts b/frontend/src/api/generated/model/userRead.ts
index 3011c34e..25f97152 100644
--- a/frontend/src/api/generated/model/userRead.ts
+++ b/frontend/src/api/generated/model/userRead.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Full user payload returned by API responses.
+ */
 export interface UserRead {
   clerk_user_id: string;
   email?: string | null;
diff --git a/frontend/src/api/generated/model/userUpdate.ts b/frontend/src/api/generated/model/userUpdate.ts
index dbb1978d..0697c43f 100644
--- a/frontend/src/api/generated/model/userUpdate.ts
+++ b/frontend/src/api/generated/model/userUpdate.ts
@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial user profile updates.
+ */
 export interface UserUpdate {
   name?: string | null;
   preferred_name?: string | null;
diff --git a/frontend/src/api/generated/organizations/organizations.ts b/frontend/src/api/generated/organizations/organizations.ts
index bea68794..c97daa31 100644
--- a/frontend/src/api/generated/organizations/organizations.ts
+++ b/frontend/src/api/generated/organizations/organizations.ts
@@ -26,6 +26,7 @@ import type {
   LimitOffsetPageTypeVarCustomizedOrganizationMemberRead,
   ListOrgInvitesApiV1OrganizationsMeInvitesGetParams,
   ListOrgMembersApiV1OrganizationsMeMembersGetParams,
+  OkResponse,
   OrganizationActiveUpdate,
   OrganizationCreate,
   OrganizationInviteAccept,
@@ -43,6 +44,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Create an organization and assign the caller as owner.
  * @summary Create Organization
  */
 export type createOrganizationApiV1OrganizationsPostResponse200 = {
@@ -163,6 +165,7 @@ export const useCreateOrganizationApiV1OrganizationsPost = <
   );
 };
 /**
+ * List organizations where the current user is a member.
  * @summary List My Organizations
  */
 export type listMyOrganizationsApiV1OrganizationsMeListGetResponse200 = {
@@ -369,6 +372,7 @@ export function useListMyOrganizationsApiV1OrganizationsMeListGet<
 }
 
 /**
+ * Set the caller's active organization.
  * @summary Set Active Org
  */
 export type setActiveOrgApiV1OrganizationsMeActivePatchResponse200 = {
@@ -489,6 +493,7 @@ export const useSetActiveOrgApiV1OrganizationsMeActivePatch = <
   );
 };
 /**
+ * Return the caller's active organization.
  * @summary Get My Org
  */
 export type getMyOrgApiV1OrganizationsMeGetResponse200 = {
@@ -661,6 +666,109 @@ export function useGetMyOrgApiV1OrganizationsMeGet<
 }
 
 /**
+ * Delete the active organization and related entities.
+ * @summary Delete My Org
+ */
+export type deleteMyOrgApiV1OrganizationsMeDeleteResponse200 = {
+  data: OkResponse;
+  status: 200;
+};
+
+export type deleteMyOrgApiV1OrganizationsMeDeleteResponseSuccess =
+  deleteMyOrgApiV1OrganizationsMeDeleteResponse200 & {
+    headers: Headers;
+  };
+export type deleteMyOrgApiV1OrganizationsMeDeleteResponse =
+  deleteMyOrgApiV1OrganizationsMeDeleteResponseSuccess;
+
+export const getDeleteMyOrgApiV1OrganizationsMeDeleteUrl = () => {
+  return `/api/v1/organizations/me`;
+};
+
+export const deleteMyOrgApiV1OrganizationsMeDelete = async (
+  options?: RequestInit,
+): Promise<deleteMyOrgApiV1OrganizationsMeDeleteResponse> => {
+  return customFetch<deleteMyOrgApiV1OrganizationsMeDeleteResponse>(
+    getDeleteMyOrgApiV1OrganizationsMeDeleteUrl(),
+    {
+      ...options,
+      method: "DELETE",
+    },
+  );
+};
+
+export const getDeleteMyOrgApiV1OrganizationsMeDeleteMutationOptions = <
+  TError = unknown,
+  TContext = unknown,
+>(options?: {
+  mutation?: UseMutationOptions<
+    Awaited<ReturnType<typeof deleteMyOrgApiV1OrganizationsMeDelete>>,
+    TError,
+    void,
+    TContext
+  >;
+  request?: SecondParameter<typeof customFetch>;
+}): UseMutationOptions<
+  Awaited<ReturnType<typeof deleteMyOrgApiV1OrganizationsMeDelete>>,
+  TError,
+  void,
+  TContext
+> => {
+  const mutationKey = ["deleteMyOrgApiV1OrganizationsMeDelete"];
+  const { mutation: mutationOptions, request: requestOptions } = options
+    ? options.mutation &&
+      "mutationKey" in options.mutation &&
+      options.mutation.mutationKey
+      ? options
+      : { ...options, mutation: { ...options.mutation, mutationKey } }
+    : { mutation: { mutationKey }, request: undefined };
+
+  const mutationFn: MutationFunction<
+    Awaited<ReturnType<typeof deleteMyOrgApiV1OrganizationsMeDelete>>,
+    void
+  > = () => {
+    return deleteMyOrgApiV1OrganizationsMeDelete(requestOptions);
+  };
+
+  return { mutationFn, ...mutationOptions };
+};
+
+export type DeleteMyOrgApiV1OrganizationsMeDeleteMutationResult = NonNullable<
+  Awaited<ReturnType<typeof deleteMyOrgApiV1OrganizationsMeDelete>>
+>;
+
+export type DeleteMyOrgApiV1OrganizationsMeDeleteMutationError = unknown;
+
+/**
+ * @summary Delete My Org
+ */
+export const useDeleteMyOrgApiV1OrganizationsMeDelete = <
+  TError = unknown,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<ReturnType<typeof deleteMyOrgApiV1OrganizationsMeDelete>>,
+      TError,
+      void,
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<ReturnType<typeof deleteMyOrgApiV1OrganizationsMeDelete>>,
+  TError,
+  void,
+  TContext
+> => {
+  return useMutation(
+    getDeleteMyOrgApiV1OrganizationsMeDeleteMutationOptions(options),
+    queryClient,
+  );
+};
+/**
+ * Get the caller's membership record in the active organization.
  * @summary Get My Membership
  */
 export type getMyMembershipApiV1OrganizationsMeMemberGetResponse200 = {
@@ -862,6 +970,7 @@ export function useGetMyMembershipApiV1OrganizationsMeMemberGet<
 }
 
 /**
+ * List members for the active organization.
  * @summary List Org Members
  */
 export type listOrgMembersApiV1OrganizationsMeMembersGetResponse200 = {
@@ -1110,6 +1219,7 @@ export function useListOrgMembersApiV1OrganizationsMeMembersGet<
 }
 
 /**
+ * Get a specific organization member by id.
  * @summary Get Org Member
  */
 export type getOrgMemberApiV1OrganizationsMeMembersMemberIdGetResponse200 = {
@@ -1365,6 +1475,7 @@ export function useGetOrgMemberApiV1OrganizationsMeMembersMemberIdGet<
 }
 
 /**
+ * Update a member's role in the organization.
  * @summary Update Org Member
  */
 export type updateOrgMemberApiV1OrganizationsMeMembersMemberIdPatchResponse200 =
@@ -1514,6 +1625,156 @@ export const useUpdateOrgMemberApiV1OrganizationsMeMembersMemberIdPatch = <
   );
 };
 /**
+ * Remove a member from the active organization.
+ * @summary Remove Org Member
+ */
+export type removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse200 =
+  {
+    data: OkResponse;
+    status: 200;
+  };
+
+export type removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse422 =
+  {
+    data: HTTPValidationError;
+    status: 422;
+  };
+
+export type removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponseSuccess =
+  removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse200 & {
+    headers: Headers;
+  };
+export type removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponseError =
+  removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse422 & {
+    headers: Headers;
+  };
+
+export type removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse =
+  | removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponseSuccess
+  | removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponseError;
+
+export const getRemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteUrl = (
+  memberId: string,
+) => {
+  return `/api/v1/organizations/me/members/${memberId}`;
+};
+
+export const removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete = async (
+  memberId: string,
+  options?: RequestInit,
+): Promise<removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse> => {
+  return customFetch<removeOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteResponse>(
+    getRemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteUrl(memberId),
+    {
+      ...options,
+      method: "DELETE",
+    },
+  );
+};
+
+export const getRemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteMutationOptions =
+  <TError = HTTPValidationError, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<
+          typeof removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete
+        >
+      >,
+      TError,
+      { memberId: string },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  }): UseMutationOptions<
+    Awaited<
+      ReturnType<
+        typeof removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete
+      >
+    >,
+    TError,
+    { memberId: string },
+    TContext
+  > => {
+    const mutationKey = [
+      "removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete",
+    ];
+    const { mutation: mutationOptions, request: requestOptions } = options
+      ? options.mutation &&
+        "mutationKey" in options.mutation &&
+        options.mutation.mutationKey
+        ? options
+        : { ...options, mutation: { ...options.mutation, mutationKey } }
+      : { mutation: { mutationKey }, request: undefined };
+
+    const mutationFn: MutationFunction<
+      Awaited<
+        ReturnType<
+          typeof removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete
+        >
+      >,
+      { memberId: string }
+    > = (props) => {
+      const { memberId } = props ?? {};
+
+      return removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete(
+        memberId,
+        requestOptions,
+      );
+    };
+
+    return { mutationFn, ...mutationOptions };
+  };
+
+export type RemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteMutationResult =
+  NonNullable<
+    Awaited<
+      ReturnType<
+        typeof removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete
+      >
+    >
+  >;
+
+export type RemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Remove Org Member
+ */
+export const useRemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDelete = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<
+          typeof removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete
+        >
+      >,
+      TError,
+      { memberId: string },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<
+    ReturnType<typeof removeOrgMemberApiV1OrganizationsMeMembersMemberIdDelete>
+  >,
+  TError,
+  { memberId: string },
+  TContext
+> => {
+  return useMutation(
+    getRemoveOrgMemberApiV1OrganizationsMeMembersMemberIdDeleteMutationOptions(
+      options,
+    ),
+    queryClient,
+  );
+};
+/**
+ * Update board-level access settings for a member.
  * @summary Update Member Access
  */
 export type updateMemberAccessApiV1OrganizationsMeMembersMemberIdAccessPutResponse200 =
@@ -1670,6 +1931,7 @@ export const useUpdateMemberAccessApiV1OrganizationsMeMembersMemberIdAccessPut =
     );
   };
 /**
+ * List pending invites for the active organization.
  * @summary List Org Invites
  */
 export type listOrgInvitesApiV1OrganizationsMeInvitesGetResponse200 = {
@@ -1918,6 +2180,7 @@ export function useListOrgInvitesApiV1OrganizationsMeInvitesGet<
 }
 
 /**
+ * Create an organization invite for an email address.
  * @summary Create Org Invite
  */
 export type createOrgInviteApiV1OrganizationsMeInvitesPostResponse200 = {
@@ -2045,6 +2308,7 @@ export const useCreateOrgInviteApiV1OrganizationsMeInvitesPost = <
   );
 };
 /**
+ * Revoke a pending invite from the active organization.
  * @summary Revoke Org Invite
  */
 export type revokeOrgInviteApiV1OrganizationsMeInvitesInviteIdDeleteResponse200 =
@@ -2193,6 +2457,7 @@ export const useRevokeOrgInviteApiV1OrganizationsMeInvitesInviteIdDelete = <
   );
 };
 /**
+ * Accept an invite and return resulting membership.
  * @summary Accept Org Invite
  */
 export type acceptOrgInviteApiV1OrganizationsInvitesAcceptPostResponse200 = {
diff --git a/frontend/src/api/generated/souls-directory/souls-directory.ts b/frontend/src/api/generated/souls-directory/souls-directory.ts
index d775353b..c6969a91 100644
--- a/frontend/src/api/generated/souls-directory/souls-directory.ts
+++ b/frontend/src/api/generated/souls-directory/souls-directory.ts
@@ -29,6 +29,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Search souls-directory entries by handle/slug query text.
  * @summary Search
  */
 export type searchApiV1SoulsDirectorySearchGetResponse200 = {
@@ -243,6 +244,7 @@ export function useSearchApiV1SoulsDirectorySearchGet<
 }
 
 /**
+ * Fetch markdown content for a validated souls-directory handle and slug.
  * @summary Get Markdown
  */
 export type getMarkdownApiV1SoulsDirectoryHandleSlugGetResponse200 = {
@@ -480,6 +482,7 @@ export function useGetMarkdownApiV1SoulsDirectoryHandleSlugGet<
 }
 
 /**
+ * Fetch markdown content for a validated souls-directory handle and slug.
  * @summary Get Markdown
  */
 export type getMarkdownApiV1SoulsDirectoryHandleSlugMdGetResponse200 = {
diff --git a/frontend/src/api/generated/tasks/tasks.ts b/frontend/src/api/generated/tasks/tasks.ts
index 3b321fb8..356b64b5 100644
--- a/frontend/src/api/generated/tasks/tasks.ts
+++ b/frontend/src/api/generated/tasks/tasks.ts
@@ -41,6 +41,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Stream task and task-comment events as SSE payloads.
  * @summary Stream Tasks
  */
 export type streamTasksApiV1BoardsBoardIdTasksStreamGetResponse200 = {
@@ -293,6 +294,7 @@ export function useStreamTasksApiV1BoardsBoardIdTasksStreamGet<
 }
 
 /**
+ * List board tasks with optional status and assignment filters.
  * @summary List Tasks
  */
 export type listTasksApiV1BoardsBoardIdTasksGetResponse200 = {
@@ -524,6 +526,7 @@ export function useListTasksApiV1BoardsBoardIdTasksGet<
 }
 
 /**
+ * Create a task and initialize dependency rows.
  * @summary Create Task
  */
 export type createTaskApiV1BoardsBoardIdTasksPostResponse200 = {
@@ -653,6 +656,7 @@ export const useCreateTaskApiV1BoardsBoardIdTasksPost = <
   );
 };
 /**
+ * Update task status, assignment, comment, and dependency state.
  * @summary Update Task
  */
 export type updateTaskApiV1BoardsBoardIdTasksTaskIdPatchResponse200 = {
@@ -791,6 +795,7 @@ export const useUpdateTaskApiV1BoardsBoardIdTasksTaskIdPatch = <
   );
 };
 /**
+ * Delete a task and related records.
  * @summary Delete Task
  */
 export type deleteTaskApiV1BoardsBoardIdTasksTaskIdDeleteResponse200 = {
@@ -916,6 +921,7 @@ export const useDeleteTaskApiV1BoardsBoardIdTasksTaskIdDelete = <
   );
 };
 /**
+ * List comments for a task in chronological order.
  * @summary List Task Comments
  */
 export type listTaskCommentsApiV1BoardsBoardIdTasksTaskIdCommentsGetResponse200 =
@@ -1235,6 +1241,7 @@ export function useListTaskCommentsApiV1BoardsBoardIdTasksTaskIdCommentsGet<
 }
 
 /**
+ * Create a task comment and notify relevant agents.
  * @summary Create Task Comment
  */
 export type createTaskCommentApiV1BoardsBoardIdTasksTaskIdCommentsPostResponse200 =