@dssp/dcsp 1.0.2 → 1.0.6

package/schema.graphql

@@ -1182,6 +1182,11 @@ type Board {
 }
 
 input BoardAIChatInput {
+  """
+  Whether core board editing tools (addComponent / styling / scene actions) are available. Defaults to true. Set false for surfaces that must not modify the board — e.g. an operations chat where irreversible commands live, so reversible edits and irreversible actions never share one conversation.
+  """
+  boardTools: Boolean
+
   """
   Component categories to surface (e.g. ["3D", "form"]). Subset filter for groupings exposed in component-schemas.
   """
@@ -1195,6 +1200,11 @@ input BoardAIChatInput {
   """Current BoardModel JSON."""
   currentBoard: JSON
 
+  """
+  Host context describing what this surface is looking at (e.g. { spaceId } for a space deliberation, { boardId } for board authoring). Tools read it as ctx.state.host so the model never has to ask the user for identifiers. Client-supplied — never used for authorization; tools verify the scope belongs to the caller tenant.
+  """
+  hostContext: JSON
+
   """
   Component types the LLM is allowed to emit (e.g. ["rect", "label"]). Constrains generation to the current solution.
   """
@@ -1220,6 +1230,11 @@ input BoardAIChatInput {
   """
   model: String
 
+  """
+  Force a tool call on the first turn (toolChoice: required). Turn this on for surfaces that discuss live state: the grounding guard catches invented identifiers but not an invented situation stated without any, which only happens when the model answers without querying at all. Concept / how-to questions are unaffected — they are answered through a documentation tool.
+  """
+  requireGroundingTools: Boolean
+
   """
   Capability scopes the AI is allowed to use (e.g. 'create', 'edit', 'style'). Filters which tools are exposed to the LLM.
   """
@@ -1239,6 +1254,16 @@ input BoardAIChatInput {
   Sampling temperature override. Falls back to assistant default when omitted.
   """
   temperature: Float
+
+  """
+  Registered external tool categories this conversation may use (registerToolCategory names, e.g. ["twin", "board-import"]). Omit to allow every registered category. Applies to tool definitions AND execution, so a surface cannot call a category it was not granted.
+  """
+  toolCategories: [String!]
+
+  """
+  Id of the last message to keep from the stored history. The client keeps its own truncation when a user edits a message (the server history is intentionally preserved), so pass the last kept message id to hide the retracted span from the agent. Omit to use the whole stored history.
+  """
+  truncateAfterMessageId: String
 }
 
 type BoardAIChatOutput {
@@ -1256,12 +1281,27 @@ type BoardAIChatOutput {
   """Clarifying question when input is ambiguous."""
   followUp: String
 
+  """
+  Ungrounded identifiers mentioned by the reply — present in the answer but absent from everything the model received (prompt, board context, history, tool results). Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.
+  """
+  groundingWarnings: JSON
+
+  """
+  Reported when the stored history exceeded the prompt cap for this turn: { omitted, summarized }. The surface uses it to tell the user the conversation grew long — a new conversation is better for a different topic. Objective fact only; no topic-change detection.
+  """
+  historyFolded: JSON
+
   """BoardEditPatch."""
   patch: JSON
 
   """Persisted PatchEntry id (when patch was generated)."""
   patchId: String
 
+  """
+  Action proposals the AI recorded without executing — each carries what a tool returned alongside `proposed: true`. The surface renders a confirm button; execution is the user's act, never the assistant's. Null when nothing was proposed.
+  """
+  proposals: JSON
+
   """Conversational reply."""
   reply: String!
 
@@ -1295,6 +1335,21 @@ input BoardAIMentionPickInput {
   token: String!
 }
 
+"""A single component difference between two board versions."""
+type BoardComponentDiff {
+  """The kind of change: 'added', 'removed', or 'modified'."""
+  changeType: String!
+
+  """Names of the properties that changed (for modified components)."""
+  changedProps: [String!]
+
+  """The refid of the component (identity used for diffing)."""
+  refid: Int
+
+  """The component type (e.g. rect, text, table)."""
+  type: String
+}
+
 """Represents a board that a user has marked as a favorite."""
 type BoardFavorite {
   """The timestamp when the board was created."""
@@ -1380,6 +1435,9 @@ type BoardHistory {
   """
   action: String!
 
+  """The release note/comment left when this version was published."""
+  comment: String
+
   """The creation timestamp of the original board."""
   createdAt: DateTimeISO
 
@@ -1555,6 +1613,31 @@ input BoardTemplatePatch {
   visibility: String
 }
 
+"""
+The difference between two board versions (or a version and the current draft).
+"""
+type BoardVersionDiff {
+  """Number of components added."""
+  addedCount: Int!
+
+  """Component-level changes."""
+  componentDiffs: [BoardComponentDiff!]!
+
+  """The base version number being compared from."""
+  fromVersion: Int!
+
+  """Number of components modified."""
+  modifiedCount: Int!
+
+  """Number of components removed."""
+  removedCount: Int!
+
+  """
+  The target version number being compared to. Null means the current draft.
+  """
+  toVersion: Int
+}
+
 """동 정보"""
 type Building {
   basementFloorCount: Float
@@ -1864,6 +1947,11 @@ type ChatMessage {
 
   """Soft delete timestamp."""
   deletedAt: DateTimeISO
+
+  """
+  Ungrounded identifiers mentioned by this reply (hallucination candidates). Null when grounded.
+  """
+  groundingWarningsJson: JSON
   id: ID
 
   """
@@ -1896,8 +1984,16 @@ type ChatMessage {
 type ChatSession {
   aiClientId: String
 
+  """Id of the anchored target (board id / space id / instance id)."""
+  anchorId: String
+
+  """
+  What this conversation is anchored to: 'board' (authoring a board) | 'space' (a site and the twins running there) | 'instance' | 'none'. Absent on legacy rows — treated as 'board' when boardId is present.
+  """
+  anchorType: String
+
   """
-  Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts).
+  Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts). Kept for backward compatibility — board-anchored sessions dual-write this alongside anchorId.
   """
   boardId: String
   createdAt: DateTimeISO
@@ -1907,17 +2003,81 @@ type ChatSession {
   domain: Domain
   id: ID
 
+  """
+  Timestamp of the last message in this session (denormalized for list ordering and unread comparison — avoids per-session aggregation across the supported DB drivers).
+  """
+  lastMessageAt: DateTimeISO
+
+  """
+  Short preview of the last message, stored so the session list does not need to query messages.
+  """
+  lastMessagePreview: String
+
   """Compressed summary of older messages (for token saving)."""
   lastSummary: String
 
   """User-given name of this session (tab label / identification)."""
   name: String
+
+  """
+  Id of the last message folded into lastSummary — enables incremental summarization instead of re-reading the whole history.
+  """
+  summaryUpToMessageId: String
   updatedAt: DateTimeISO
 
   """User who last updated this session."""
   updater: User
 }
 
+"""
+Session list entry for the inbox — a session plus this viewer's unread state. Ordered by recent activity so a user can find where to go back to.
+"""
+type ChatSessionInboxEntry {
+  """Id of the anchored target."""
+  anchorId: String
+
+  """
+  What the session is anchored to: 'board' | 'space' | 'instance' | 'none'.
+  """
+  anchorType: String
+
+  """Connected board id (board-anchored sessions)."""
+  boardId: String
+
+  """Session creation timestamp."""
+  createdAt: DateTimeISO
+
+  """
+  Whether this viewer hid the session from their own list (only returned when showHidden is on).
+  """
+  hidden: Boolean
+
+  """Session id."""
+  id: ID
+
+  """Timestamp of the last message (list ordering / unread comparison)."""
+  lastMessageAt: DateTimeISO
+
+  """Short preview of the last message."""
+  lastMessagePreview: String
+
+  """
+  Whether this viewer created the session — only the creator may delete it.
+  """
+  mine: Boolean!
+
+  """User-given session name (tab label)."""
+  name: String
+
+  """
+  Whether this viewer is a participant of the session (non-participants get no unread state).
+  """
+  participant: Boolean!
+
+  """Whether this viewer has unread activity in the session."""
+  unread: Boolean!
+}
+
 """
 Participant of a ChatSession — links a User to a session with a role. Foundation for multi-user chat / per-user filtering / member display.
 """
@@ -1936,9 +2096,19 @@ type ChatSessionParticipant {
   """Domain to which this participant belongs."""
   domain: Domain
 
+  """
+  When this user hid the session from their own list. Per-user only; the session and other participants are unaffected. Activity newer than this timestamp makes it reappear.
+  """
+  hiddenAt: DateTimeISO
+
   """Unique participant id."""
   id: ID!
 
+  """
+  Point up to which this participant has read the session. Distinct from lastSeenAt (presence): a window can be open without being read, and the read point survives disconnection. Null means nothing read yet.
+  """
+  lastReadAt: DateTimeISO
+
   """Last seen / activity timestamp (presence indicator)."""
   lastSeenAt: DateTimeISO
 
@@ -3702,6 +3872,11 @@ type Department {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): [Department!]!
@@ -4377,6 +4552,26 @@ type EnvVarResolution {
   value: String
 }
 
+"""외부 시스템(세움터/올바로/키스콘) 데이터 수집 시나리오 호출 결과"""
+type ExternalDataCollectionResult {
+  """
+  시나리오 result 객체 — projectKey: value 맵. 세움터={area, floorAreaRatio, upperFloorCount, lowerFloorCount, structureType, siteType}, 올바로={totalConstructionWasteAmount}, 키스콘={constructionPeriod, constructionCost}. siteType (건축물 용도, 예 APARTMENT_COMPLEX) / structureType (구조형태) 는 BuildingComplex 의 시설유형/구조유형 속성 후보. KISCON 의 "공사유형(신설/증축)" 은 DSSP SiteType (용도분류) 와 다른 도메인이라 매핑 대상 아님.
+  """
+  data: Object
+
+  """표시 라벨 (세움터/올바로/키스콘)"""
+  label: String!
+
+  """성공 시 "완료", 실패 시 에러 메시지"""
+  message: String!
+
+  """시나리오 실행 성공 여부"""
+  ok: Boolean!
+
+  """소스 키: saeumteo | allbaro | kiscon"""
+  source: String!
+}
+
 """Entity for Favorite"""
 type Favorite {
   createdAt: DateTimeISO
@@ -4932,6 +5127,30 @@ type KpiAlert {
   message: String!
 }
 
+type KpiComprehensiveStats {
+  avgVal: Float!
+  kpiName: String
+  maxVal: Float!
+  medVal: Float!
+  minVal: Float!
+  projectCount: Int!
+  q1Val: Float!
+  q3Val: Float!
+}
+
+type KpiComprehensiveStatsByGeoGroup {
+  address: String
+  avgVal: Float!
+  geoGroup: String
+  kpiName: String
+  maxVal: Float!
+  medVal: Float!
+  minVal: Float!
+  projectCount: Int!
+  q1Val: Float!
+  q3Val: Float!
+}
+
 """History Entity of Kpi"""
 type KpiHistory {
   """Whether this KPI is active (usable) or not."""
@@ -5010,6 +5229,9 @@ type KpiMetric {
   """Unique identifier for this KPI metric."""
   id: ID!
 
+  """metric 확장 설정(input/kind/source 등). 입력 UI·소스 바인딩 등을 담는 네임스페이스."""
+  meta: Object
+
   """Metric code, unique within the domain, used in KPI formulas."""
   name: String!
 
@@ -5072,6 +5294,9 @@ input KpiMetricPatch {
   description: String
   fieldName: String
   id: ID
+
+  """확장 메타(JSON). 입력 위젯 힌트(meta.input) 등. 스키마 변경 없이 확장."""
+  meta: Object
   name: String
 
   """Aggregation period type for this metric."""
@@ -5114,6 +5339,7 @@ type KpiMetricValue {
   """
   org: String
   periodType: KpiPeriodType!
+  project: Project
   unit: String
   updatedAt: DateTimeISO
   updater: User
@@ -5169,6 +5395,13 @@ input KpiMetricValuePatch {
   valueDate: String
 }
 
+type KpiMonthlyTrend {
+  avgVal: Float!
+  geoGroup: String
+  projectCount: Int!
+  yearMonth: String!
+}
+
 """
 KPI organization scope mapping entity. Maps business entities to various scope dimensions for KPI analysis using generic reference pattern.
 """
@@ -5356,6 +5589,19 @@ enum KpiPeriodType {
   YEAR
 }
 
+type KpiProjectStat {
+  avgVal: Float!
+  categoryName: String
+  kpiName: String!
+  maxVal: Float!
+  medVal: Float!
+  minVal: Float!
+  projectCount: Int!
+  q1Val: Float!
+  q3Val: Float!
+  stddevVal: Float!
+}
+
 """
 Defines the meaning and metadata for each scope level (scope01~05) in KpiOrgScope
 """
@@ -5639,6 +5885,7 @@ type KpiValue {
 
   """Aggregation period type for this KPI value."""
   periodType: KpiPeriodType!
+  project: Project!
 
   """
   Performance score calculated from KPI value using scoreFormula or grades lookup table.
@@ -6291,6 +6538,16 @@ type Mutation {
   """Add a user as owner of the current domain."""
   addDomainOwner(reason: String, username: String!): DomainOwner!
 
+  """
+  Append a system note to a session — context that did not come from a participant typing (e.g. a conversation carried over from another surface, an external state change). The AI sees it as part of the shared history.
+  """
+  appendSessionNote(content: String!, sessionId: String!): Boolean!
+
+  """
+  Carry a conversation from another surface into this session as its own turns (user / assistant), preserving order. Use when a lightweight exchange is promoted into a persistent discussion — the participants should read it as the conversation continuing, not as a machine dump.
+  """
+  appendSessionTurns(sessionId: String!, turns: JSON!): Boolean!
+
   """To apply to all building inspection"""
   applyToAllBuildingInspection(buildingInspectionId: String!): Boolean!
 
@@ -6350,6 +6607,14 @@ type Mutation {
   """
   cloneBoard(id: String!, patch: BoardPatch!, targetGroupId: String, targetSubdomain: String!): Board!
 
+  """Collect project basic info from 세움터 (건축물대장 → 주택인허가 fallback)."""
+  collectProjectBasicInfo(address: String, projectId: String!): ExternalDataCollectionResult!
+
+  """
+  Run external data collection scenarios per system, returning per-system result.
+  """
+  collectProjectExternalData(projectId: String!): [ExternalDataCollectionResult!]!
+
   """Establishes a live connection to a configured endpoint."""
   connectConnection(name: String!): Connection!
 
@@ -6364,6 +6629,17 @@ type Mutation {
   """
   copyScenarios(ids: [String!]!): [Scenario!]!
 
+  """
+  Always create a new AI chat session anchored to a target (no idempotent reuse). For multi-session UX — 새 탭 열기.
+  """
+  createAISession(
+    anchorId: String!
+    anchorType: String!
+
+    """Optional name (defaults to auto-generated `세션 N`)."""
+    name: String
+  ): ChatSession!
+
   """To create new ActionPlan"""
   createActionPlan(actionPlan: NewActionPlan!): ActionPlan!
 
@@ -6407,16 +6683,6 @@ type Mutation {
   """Create Daily Worklog by projectId+date"""
   createBuildingInspectionDailyWorklog(patch: BuildingInspectionDailyWorklogNew!): BuildingInspectionDailyWorklog!
 
-  """
-  Always create a new AI chat session for a board (no idempotent reuse). For multi-session UX — 새 탭 열기.
-  """
-  createChatSession(
-    boardId: String!
-
-    """Optional name (defaults to auto-generated `세션 N`)."""
-    name: String
-  ): ChatSession!
-
   """To create new ChecklistItemComment"""
   createChecklistItemComment(checklistItemComment: NewChecklistItemComment!): ChecklistItemComment!
 
@@ -6663,6 +6929,11 @@ type Mutation {
   """To delegate a ActivityThread"""
   delegateActivityThread(assignee: ObjectRef, dueAt: DateTimeISO, id: String!, reason: String): ActivityThread!
 
+  """
+  Delete a chat session — creator only, since a shared deliberation cannot be un-deleted from the UI. Participants who are not the creator can hide it from their own list instead (hideAISession). Soft delete; broadcast as meta activity so every list drops it.
+  """
+  deleteAISession(sessionId: String!): Boolean!
+
   """To delete ActionPlan"""
   deleteActionPlan(id: String!): Boolean!
 
@@ -7078,6 +7349,9 @@ type Mutation {
   """To delete multiple ProjectReports"""
   deleteProjectReports(ids: [String!]!): Boolean!
 
+  """비밀번호 확인 후 프로젝트 삭제 (수퍼유저 전용, 테넌트 강등 상태에서만)"""
+  deleteProjectWithPassword(password: String!, projectId: String!): Boolean!
+
   """To delete Resource"""
   deleteResource(id: String!): Boolean!
 
@@ -7203,6 +7477,9 @@ type Mutation {
   Finalizes and generates the latest data summaries for the specified dataset. This operation aggregates collected data into summary records for reporting and analysis.
   """
   finalizeLatestDataCollection(dataSetId: String!): Boolean!
+
+  """To finalize project with KPI recalculation"""
+  finalizeProjectWithKpiRecalculation(projectId: String!): Boolean!
   generateApplianceSecret(id: String!): Appliance!
   generateApplicationSecret(id: String!): Application!
 
@@ -7222,6 +7499,11 @@ type Mutation {
   getOauth2AuthUrl(id: String!): String!
   grantRoles(customerId: String!, roles: [RolePatch!]!): Boolean!
 
+  """
+  Hide (or unhide) a session from the calling user's own list. Per-user and reversible — the session and other participants are unaffected. Activity newer than the hide makes it reappear; the inbox filter (showHidden) reveals hidden ones.
+  """
+  hideAISession(hidden: Boolean, sessionId: String!): Boolean!
+
   """To import multiple ActionPlans"""
   importActionPlans(actionPlans: [ActionPlanPatch!]!): Boolean!
 
@@ -7392,6 +7674,11 @@ type Mutation {
   """Removes one or more boards from a play group."""
   leavePlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
 
+  """
+  Mark a session as read up to now for the current user. Idempotent. Distinct from presence (lastSeenAt) — a window can be open without being read.
+  """
+  markSessionRead(sessionId: String!): Boolean!
+
   """
   완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화한다. 검수 단계 (사용자/AI 가 import 결과를 확인 후 명시적으로 호출) 에서 사용. Board.state="draft" 로 생성되므로 release mutation 으로 별도 발행 필요.
   """
@@ -7412,6 +7699,9 @@ type Mutation {
   """기존 KPI Value 인스턴스를 현재 formula/metric 값으로 재계산"""
   recalculateKpiValue(id: String!): KpiValue!
 
+  """Recalculate project KPI without finalizing (interim)."""
+  recalculateProjectKpi(projectId: String!): Boolean!
+
   """Recalculate scores for all KpiValues of a specific KPI"""
   recalculateScoresForKpi(kpiId: String!): Boolean!
 
@@ -7467,14 +7757,24 @@ type Mutation {
   rejectActivityApproval(comment: String, id: String!): ActivityApproval
 
   """Releases a board, making it public and creating a version history."""
-  releaseBoard(id: String!): Board!
+  releaseBoard(comment: String, id: String!): Board!
 
   """Release a KPI and create a version history."""
   releaseKpi(id: String!): Kpi!
 
+  """
+  Releases (publishes) a scenario, creating an immutable version snapshot. Operational execution (schedule/auto-start) runs the latest released version.
+  """
+  releaseScenario(comment: String, id: String!): Scenario!
+
   """Remove a user from the owners of the current domain."""
   removeDomainOwner(reason: String, username: String!): Boolean!
 
+  """
+  Rename a chat session. Any participant may rename it — the name is the topic label of a shared deliberation and the change is reversible. Broadcast as meta activity so every participant sees it without raising unread badges.
+  """
+  renameAISession(name: String!, sessionId: String!): Boolean!
+
   """Rename a ChatSession (tab label)."""
   renameChatSession(name: String!, sessionId: String!): Boolean!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
@@ -7505,10 +7805,22 @@ type Mutation {
   """Mark a patch as reverted (does not undo, only flags)."""
   revertPatch(patchId: String!): Boolean!
 
+  """
+  Reverts a scenario to a released version by copying that version into the current draft. The past version remains as an archive; this does not create a new version.
+  """
+  revertScenarioVersion(id: String!, version: Int!): Scenario!
+
   """
   Runs a new scenario instance once and returns the result after it finishes.
   """
-  runScenario(instanceName: String, scenarioName: String!, variables: Object): ScenarioInstanceRunResult!
+  runScenario(
+    instanceName: String
+
+    """Version to run: 'released' (default) or 'draft' (debugging)."""
+    mode: String
+    scenarioName: String!
+    variables: Object
+  ): ScenarioInstanceRunResult!
 
   """To approve ActivityApproval"""
   saveActivityApproval(comment: String, id: String!): ActivityApproval
@@ -7518,6 +7830,11 @@ type Mutation {
   sendInvitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
   singleUpload(file: Upload!): Attachment!
 
+  """
+  Start (or get existing) AI chat session anchored to a target. Idempotent — returns first existing or creates one. Use anchorType board for board authoring, space for a site (its co-located twins).
+  """
+  startAISession(anchorId: String!, anchorType: String!): ChatSession!
+
   """To start posting activity based on the schedule of the given activity"""
   startActivitySchedule(activityId: String!): Activity!
 
@@ -7525,7 +7842,7 @@ type Mutation {
   startActivityThread(id: String!, output: Object, reason: String): ActivityThread
 
   """
-  Start (or get existing) AI chat session for a board. Idempotent — returns first existing or creates one.
+  Start (or get existing) AI chat session for a board. Thin wrapper over startAISession(board).
   """
   startBoardAISession(boardId: String!): ChatSession!
 
@@ -7540,7 +7857,14 @@ type Mutation {
   startDataSummarySchedule(dataSetId: String!): DataSet!
 
   """Starts a new scenario instance, which will run in the background."""
-  startScenario(instanceName: String, scenarioName: String!, variables: Object): ScenarioInstanceStartResult!
+  startScenario(
+    instanceName: String
+
+    """Version to run: 'released' (default) or 'draft' (debugging)."""
+    mode: String
+    scenarioName: String!
+    variables: Object
+  ): ScenarioInstanceStartResult!
 
   """Starts the schedule for a specific scenario, if one is defined."""
   startScenarioSchedule(scenarioId: String!): Scenario!
@@ -7732,6 +8056,15 @@ type Mutation {
   """To modify KpiMetricValue information"""
   updateKpiMetricValue(id: String!, patch: KpiMetricValuePatch!): KpiMetricValue!
 
+  """To modify multiple assessment KpiMetricValues' value"""
+  updateKpiMetricValuesAssessment(patches: [KpiMetricValuePatch!]!): [KpiMetricValue!]!
+
+  """To modify multiple cumulative KpiMetricValues' value"""
+  updateKpiMetricValuesCumulative(patches: [KpiMetricValuePatch!]!): [KpiMetricValue!]!
+
+  """To modify multiple sentiment KpiMetricValues' value"""
+  updateKpiMetricValuesSentiment(attachment: NewAttachment!): Attachment
+
   """Update a scope dimension definition"""
   updateKpiScope(id: String!, patch: KpiScopePatch!): KpiScope!
 
@@ -8777,6 +9110,9 @@ input NewKpiMetric {
   """Name of the field in the dataset this metric maps to."""
   fieldName: String
 
+  """확장 메타(JSON). 입력 위젯 힌트(meta.input) 등. 스키마 변경 없이 확장."""
+  meta: Object
+
   """Metric code, unique within the domain, used in KPI formulas."""
   name: String!
 
@@ -9818,6 +10154,11 @@ type PagePreferenceList {
 
 """Input type for specifying pagination options in a list query."""
 input Pagination {
+  """
+  Keyset cursor: return rows positioned after this one, per the current sorting. Prefer this over page for feeds that grow at the head (event journals, logs, newest-first lists) where offset paging silently duplicates or skips rows as new rows arrive. Opaque — pass back the nextCursor the previous response returned. Wins over page when both are given.
+  """
+  after: String
+
   """The maximum number of items per page."""
   limit: Int
 
@@ -10137,6 +10478,11 @@ type Privilege {
   """The user who created the privilege."""
   creator: User
 
+  """
+  True when no module in this deployment declares this privilege anymore (@privilege directive). The bootstrap sync only adds rows, so a removed directive leaves a grantable row that does nothing. Computed per request — it answers for the asking deployment, not for all time.
+  """
+  deprecated: Boolean!
+
   """A detailed description of what the privilege allows."""
   description: String
 
@@ -10463,6 +10809,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActionPlanList!
@@ -10478,6 +10829,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityList!
@@ -10499,6 +10855,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityApprovalList!
@@ -10523,6 +10884,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityInstanceHistoryList!
@@ -10541,6 +10907,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityInstanceList!
@@ -10558,6 +10929,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityInstanceList!
@@ -10573,6 +10949,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityInstanceList!
@@ -10594,6 +10975,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityTemplateList!
@@ -10612,6 +10998,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityThreadList!
@@ -10626,6 +11017,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): AppBindingList!
@@ -10644,6 +11040,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApplianceList!
@@ -10662,6 +11063,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApplicationList!
@@ -10677,6 +11083,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityApprovalList!
@@ -10695,6 +11106,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApprovalLineList!
@@ -10710,6 +11126,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApprovalLineList!
@@ -10725,6 +11146,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityApprovalList!
@@ -10739,6 +11165,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): AttachmentList!
@@ -10772,6 +11203,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): AttributeSetList!
@@ -10793,6 +11229,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): AuthProviderList!
@@ -10829,6 +11270,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): BoardTemplateList!
@@ -10844,10 +11290,20 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): BoardTemplateList!
 
+  """
+  Computes the component-level difference between a board version and another version or the current draft. Omit toVersion to diff the base version against the current draft.
+  """
+  boardVersionDiff(id: String!, toVersion: Int, version: Int!): BoardVersionDiff!
+
   """Retrieves up to 10 historical versions of a specific board."""
   boardVersions(id: String!): [BoardHistory!]!
 
@@ -10862,8 +11318,13 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
-    """Sorting options for the list query."""
-    sortings: [Sorting!]
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
   ): BoardList!
 
   """Retrieves a paginated list of boards created by the current user."""
@@ -10877,6 +11338,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): BoardList!
@@ -10916,6 +11382,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): BuildingInspectionHistoryList!
@@ -10943,6 +11414,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): BuildingInspectionList!
@@ -10973,11 +11449,26 @@ type Query {
   """
   chatSessionByBoard(boardId: String!): ChatSession
 
+  """
+  List sessions anchored to a target with this viewer's unread state, most recent activity first. Supports free-text search over name and last preview, a mine-only filter, hidden inclusion, and paging. Uses the denormalized last-activity timestamp compared against the viewer's read point — no per-session aggregation.
+  """
+  chatSessionInbox(anchorId: String!, anchorType: String!, limit: Int, mineOnly: Boolean, offset: Int, search: String, showHidden: Boolean): [ChatSessionInboxEntry!]!
+
+  """
+  Total number of sessions matching the same filters as chatSessionInbox (before paging). Request it alongside the list so the UI can tell "end of page" from "end of data".
+  """
+  chatSessionInboxTotal(anchorId: String!, anchorType: String!, mineOnly: Boolean, search: String, showHidden: Boolean): Int!
+
   """List participants of a ChatSession (members / owner)."""
   chatSessionParticipants(sessionId: String!): [ChatSessionParticipant!]!
 
   """
-  List all AI chat sessions for a board (oldest first). Multi-session support — UI 탭으로 표시.
+  List AI chat sessions anchored to a target (oldest first). Anchor decides the nature and the history boundary of the conversation: board = authoring, space = the site and the twins running there. Board anchor also matches legacy rows that only have boardId.
+  """
+  chatSessionsByAnchor(anchorId: String!, anchorType: String!): [ChatSession!]!
+
+  """
+  List all AI chat sessions for a board (oldest first). Thin wrapper over chatSessionsByAnchor(board).
   """
   chatSessionsByBoard(boardId: String!): [ChatSession!]!
 
@@ -11019,6 +11510,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistHistoryList!
@@ -11043,6 +11539,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistItemHistoryList!
@@ -11061,6 +11562,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistItemList!
@@ -11079,6 +11585,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistTemplateItemList!
@@ -11094,6 +11605,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistTemplateList!
@@ -11109,6 +11625,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistTypeList!
@@ -11124,6 +11645,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ChecklistList!
@@ -11139,6 +11665,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApprovalLineList!
@@ -11160,6 +11691,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): CommonCodeDetailList!
@@ -11175,6 +11711,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): CommonCodeList!
@@ -11195,6 +11736,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ConnectionList!
@@ -11219,6 +11765,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ConstructionChecklistTemplateItemList!
@@ -11234,6 +11785,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ConstructionChecklistTemplateList!
@@ -11249,6 +11805,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ConstructionDetailTypeList!
@@ -11267,6 +11828,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ConstructionTypeList!
@@ -11285,6 +11851,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ContactList!
@@ -11318,6 +11889,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataArchiveList!
@@ -11340,6 +11916,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataKeySetList!
@@ -11362,6 +11943,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataOocList!
@@ -11384,6 +11970,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSampleList!
@@ -11403,6 +11994,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSampleList!
@@ -11422,6 +12018,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSampleList!
@@ -11442,6 +12043,11 @@ type Query {
     pagination: Pagination
     period: String!
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSampleList!
@@ -11464,6 +12070,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSensorList!
@@ -11489,6 +12100,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSetHistoryList!
@@ -11509,6 +12125,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSetList!
@@ -11526,6 +12147,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSetList!
@@ -11543,6 +12169,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSetList!
@@ -11566,6 +12197,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSummaryList!
@@ -11585,6 +12221,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSummaryList!
@@ -11604,6 +12245,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSummaryList!
@@ -11623,6 +12269,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DataSummaryList!
@@ -11649,6 +12300,11 @@ type Query {
     pagination: Pagination
     period: String!
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): [DynamicDataSummary!]!
@@ -11667,6 +12323,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DepartmentList
@@ -11682,6 +12343,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DepartmentList!
@@ -11705,6 +12371,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DomainLinkList!
@@ -11740,6 +12411,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DomainList!
@@ -11758,6 +12434,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityThreadList!
@@ -11773,6 +12454,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityInstanceList!
@@ -11788,6 +12474,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApplianceList!
@@ -11810,6 +12501,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): EmployeeList!
@@ -11825,6 +12521,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): EntityList!
@@ -11846,6 +12547,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): EntityColumnList!
@@ -11868,6 +12574,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): EnvVarList!
@@ -11886,6 +12597,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): BoardFavoriteList!
@@ -11901,6 +12617,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): FavoriteList!
@@ -11931,6 +12652,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): FontList!
@@ -11954,6 +12680,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): GroupList!
@@ -11961,6 +12692,11 @@ type Query {
   """To query whether I have the given permission"""
   hasPrivilege(category: String!, privilege: String!): Boolean!
 
+  """
+  Number of sessions on this anchor that the caller has hidden and that have had no activity since. Meant to be requested alongside chatSessionInbox in the same operation so the filter can say how many are folded away.
+  """
+  hiddenSessionCount(anchorId: String!, anchorType: String!): Int!
+
   """Get import session progress."""
   importSession(id: String!): ImportSession
 
@@ -11984,6 +12720,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): InspectionDrawingTypeList!
@@ -12002,6 +12743,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): InspectionPartList!
@@ -12017,6 +12763,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): InstallableActivityList!
@@ -12046,6 +12797,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): IssueList!
@@ -12077,7 +12833,9 @@ type Query {
     id: String!
   ): KpiMetricValue
 
-  """To fetch multiple KpiMetricValues"""
+  """
+  To fetch multiple KpiMetricValues (project-scoped or cross-domain admin view)
+  """
   kpiMetricValues(
     """An array of filter conditions to apply to the list query."""
     filters: [Filter!]
@@ -12087,6 +12845,12 @@ type Query {
 
     """Pagination options for the list query."""
     pagination: Pagination
+    projectId: String
+
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
 
     """Sorting options for the list query."""
     sortings: [Sorting!]
@@ -12103,6 +12867,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiMetricList!
@@ -12139,6 +12908,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiOrgScopeList!
@@ -12149,6 +12923,11 @@ type Query {
     searchTerm: String
   ): [String!]!
 
+  """
+  Get KPI stats aggregated from project data with optional sectorType/buildingUsage filters
+  """
+  kpiProjectStats(buildingUsage: String, endYearMonth: String, kpiNamePattern: String, sectorType: String, startYearMonth: String): [KpiProjectStat!]!
+
   """Fetch a scope dimension definition by ID"""
   kpiScope(id: String!): KpiScope
 
@@ -12163,6 +12942,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiScopeList!
@@ -12181,6 +12965,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiStatisticList!
@@ -12205,10 +12994,38 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiValueList!
 
+  """Get KPI box plot statistics for Y-category KPIs by geo group"""
+  kpiYValueComprehensiveStatsByGeoGroup(geoGroup: String): [KpiComprehensiveStatsByGeoGroup!]!
+
+  """Get Y-level KPI statistics by geo_group code (sigungu)"""
+  kpiYValueStatsByGeoGroup(buildingUsage: String, endYearMonth: String, geoGroup: String!, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
+  """Get KPI statistics for Y-category KPIs by specific metro area"""
+  kpiYValueStatsByMetroArea(buildingUsage: String, endYearMonth: String, metroArea: String!, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
+  """Get KPI box plot statistics for Z-category KPIs by metro area"""
+  kpiZValueComprehensiveStatsByGeoGroup(buildingUsage: String, endYearMonth: String, geoGroup: String, kpiName: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStatsByGeoGroup!]!
+
+  """Get monthly KPI trend for Z-category KPIs by metro area"""
+  kpiZValueMonthlyTrendByGeoGroup(buildingUsage: String, endYearMonth: String, kpiName: String, sectorType: String, startYearMonth: String): [KpiMonthlyTrend!]!
+
+  """
+  Get monthly KPI trend for Z-category KPIs for a specific sigungu (geo_group code)
+  """
+  kpiZValueMonthlyTrendBySigungu(buildingUsage: String, endYearMonth: String, geoGroup: String!, kpiName: String, sectorType: String, startYearMonth: String): [KpiMonthlyTrend!]!
+
+  """Get KPI statistics by sigungu (geo_group code) level"""
+  kpiZValueStatsBySigungu(buildingUsage: String, endYearMonth: String, kpiName: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStatsByGeoGroup!]!
+
   """To fetch multiple Kpis"""
   kpis(
     """An array of filter conditions to apply to the list query."""
@@ -12220,6 +13037,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiList!
@@ -12250,6 +13072,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): KpiValueList!
@@ -12268,6 +13095,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): LiteMenuList!
@@ -12283,6 +13115,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): LoginHistoryList!
@@ -12307,6 +13144,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuButtonList!
@@ -12328,6 +13170,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuColumnList!
@@ -12349,6 +13196,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuDetailButtonList!
@@ -12367,6 +13219,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuDetailColumnList!
@@ -12382,6 +13239,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuDetailList!
@@ -12397,6 +13259,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuList!
@@ -12412,6 +13279,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ApprovalLineList!
@@ -12430,6 +13302,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): LiteMenuList!
@@ -12446,6 +13323,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): MenuList!
@@ -12461,6 +13343,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): NotificationList!
@@ -12482,6 +13369,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): PagePreferenceList!
@@ -12503,6 +13395,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): UserPreferenceList!
@@ -12527,6 +13424,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): NotificationRuleList!
@@ -12542,6 +13444,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): NotificationList!
@@ -12560,6 +13467,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): Oauth2ClientList!
@@ -12585,6 +13497,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): PartnerList!
@@ -12608,6 +13525,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): PayloadLogList!
@@ -12632,6 +13554,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityInstanceList!
@@ -12653,6 +13580,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): PlayGroupList!
@@ -12674,6 +13606,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): PrinterDeviceList!
@@ -12689,6 +13626,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): PrivilegeList!
@@ -12713,6 +13655,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ProjectChecklistItemList!
@@ -12728,6 +13675,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ProjectChecklistList!
@@ -12746,10 +13698,20 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ProjectReportList!
 
+  """
+  To fetch KpiValues by project group with X prefix kpi names (latest valueDate only)
+  """
+  projectXKpiValues(projectId: String!): [KpiValue!]!
+
   """프로젝트 리스트"""
   projects(
     """An array of filter conditions to apply to the list query."""
@@ -12761,6 +13723,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ProjectList!
@@ -12785,6 +13752,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ResourceList!
@@ -12809,6 +13781,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): RoleList!
@@ -12830,10 +13807,33 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ScenarioInstanceList!
 
+  """Fetches the most recently released version (snapshot) of a scenario."""
+  scenarioPublished(id: String!): ScenarioHistory
+
+  """
+  Fetches a specific released version (snapshot) of a scenario by version number.
+  """
+  scenarioVersion(id: String!, version: Int!): ScenarioHistory
+
+  """
+  Computes the difference between a released version and either another released version or the current draft. Omit toVersion to diff the base version against the current draft.
+  """
+  scenarioVersionDiff(id: String!, toVersion: Int, version: Int!): ScenarioVersionDiff!
+
+  """
+  Fetches recent released versions (snapshots) of a scenario, newest first.
+  """
+  scenarioVersions(id: String!): [ScenarioHistory!]!
+
   """Fetches a paginated list of scenarios."""
   scenarios(
     """An array of filter conditions to apply to the list query."""
@@ -12845,6 +13845,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ScenarioList!
@@ -12858,6 +13863,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): DomainList!
@@ -12881,6 +13891,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): SettingList!
@@ -12896,6 +13911,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityList!
@@ -12917,6 +13937,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): StateRegisterList!
@@ -12935,6 +13960,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): StepList!
@@ -12958,6 +13988,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityList!
@@ -12976,6 +14011,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): SupervisorList!
@@ -13000,6 +14040,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): TaskResourceList!
@@ -13026,6 +14071,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): TaskList!
@@ -13041,6 +14091,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): TerminologyList!
@@ -13062,6 +14117,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ThemeList!
@@ -13077,10 +14137,21 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ActivityThreadList!
 
+  """Get KPI box plot statistics for Y-category KPIs for all projects"""
+  totalKpiYValueComprehensiveStats(buildingUsage: String, endYearMonth: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
+  """Get KPI box plot statistics for Z-category KPIs for all projects"""
+  totalKpiZValueComprehensiveStats(buildingUsage: String, endYearMonth: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
   """Fetches a user by their email address within the current domain."""
   user(
     """The email address of the user to fetch."""
@@ -13106,6 +14177,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): UserList!
@@ -13122,6 +14198,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): WorkShiftList!
@@ -13140,6 +14221,11 @@ type Query {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): WorkerTypeList!
@@ -13321,6 +14407,11 @@ type Scenario {
 
   """Indicates if the scenario is accessible and executable system-wide."""
   public: Boolean
+
+  """
+  The publish state of the scenario: 'draft' (has unreleased edits) or 'released'.
+  """
+  publishState: String
   publishTags: [Connection!]!
 
   """Role required to execute the scenario."""
@@ -13332,9 +14423,7 @@ type Scenario {
   """The ID of the scheduled job, if any."""
   scheduleId: String
   state: String
-
-  """The sequence of steps that make up the scenario."""
-  steps: [Step!]
+  steps: [Step!]!
 
   """The timezone for the schedule."""
   timezone: String
@@ -13350,6 +14439,88 @@ type Scenario {
 
   """The user who last updated the scenario."""
   updater: User
+
+  """
+  The latest released version number of the scenario (0 if never released).
+  """
+  version: Int
+}
+
+"""A single scenario field difference between two versions."""
+type ScenarioFieldDiff {
+  """The value after (in the target version/draft)."""
+  after: Object
+
+  """The value before (in the base version)."""
+  before: Object
+
+  """
+  The name of the field that changed (e.g. description, schedule, steps).
+  """
+  field: String!
+}
+
+"""Stores released (published) version snapshots of scenarios."""
+type ScenarioHistory {
+  """The action that created this history record."""
+  action: String!
+
+  """The release note/comment left when this version was published."""
+  comment: String
+
+  """The creation timestamp of the original scenario."""
+  createdAt: DateTimeISO
+
+  """The user who created the original scenario."""
+  creator: User
+
+  """The description of the scenario at this point in history."""
+  description: String
+
+  """The domain this scenario belonged to."""
+  domain: Domain
+
+  """Unique identifier for the scenario history record."""
+  id: ID!
+
+  """The iteration mode of the scenario at this point in history."""
+  iteration: String
+
+  """The name of the scenario at this point in history."""
+  name: String
+
+  """The ID of the original scenario this history record belongs to."""
+  originalId: String!
+
+  """Privilege required to execute the scenario."""
+  privilege: PrivilegeObject
+
+  """Role required to execute the scenario at this point."""
+  role: Role
+
+  """The schedule of the scenario at this point in history."""
+  schedule: String
+
+  """The steps of the scenario captured in this version."""
+  steps: [Step!]
+
+  """The timezone of the scenario at this point in history."""
+  timezone: String
+
+  """The time-to-live of scenario instances at this point."""
+  ttl: Int
+
+  """The type of the scenario at this point in history."""
+  type: String
+
+  """The update timestamp of the scenario at this point in history."""
+  updatedAt: DateTimeISO
+
+  """The user who published this version."""
+  updater: User
+
+  """The released version number of this snapshot."""
+  version: Int
 }
 
 """Represents a running or completed instance of a scenario."""
@@ -13558,6 +14729,47 @@ type ScenarioQueueState {
   queue: [PendingObject!]!
 }
 
+"""
+A single step difference between two scenario versions, keyed by step name.
+"""
+type ScenarioStepDiff {
+  """The step as it is in the target version/draft."""
+  after: Object
+
+  """The step as it was in the base version."""
+  before: Object
+
+  """The kind of change: 'added', 'removed', or 'modified'."""
+  changeType: String!
+
+  """
+  Field-level changes within a modified step (task, connection, params, ...).
+  """
+  fieldDiffs: [ScenarioFieldDiff!]
+
+  """The step name (identity used for diffing)."""
+  name: String
+}
+
+"""
+The difference between two scenario versions (or a version and the current draft).
+"""
+type ScenarioVersionDiff {
+  """Scenario-level field changes."""
+  fieldDiffs: [ScenarioFieldDiff!]!
+
+  """The base version number being compared from."""
+  fromVersion: Int!
+
+  """Step-level changes keyed by step name."""
+  stepDiffs: [ScenarioStepDiff!]!
+
+  """
+  The target version number being compared to. Null means the current draft.
+  """
+  toVersion: Int
+}
+
 """Types of organizational scope dimensions"""
 enum ScopeType {
   BUSINESS
@@ -13568,6 +14780,36 @@ enum ScopeType {
   TEMPORAL
 }
 
+"""
+Activity notice for a session the current user participates in — badge/list refresh only, no message body.
+"""
+type SessionActivity {
+  """User who caused the activity — clients skip badging their own."""
+  actorId: String
+
+  """Id of the anchored target."""
+  anchorId: String
+
+  """
+  What the session is anchored to: 'board' | 'space' | 'instance' | 'none'.
+  """
+  anchorType: String
+
+  """Activity timestamp (ISO)."""
+  at: String!
+
+  """
+  Kind of activity: 'message' (new message — raise the unread badge) or 'meta' (session itself changed, e.g. renamed — refresh the list but do not badge).
+  """
+  kind: String!
+
+  """One-line preview (not the full body)."""
+  preview: String
+
+  """Session that had activity."""
+  sessionId: String!
+}
+
 """Entity for Setting"""
 type Setting {
   category: String!
@@ -13882,6 +15124,11 @@ type Subscription {
   Real-time subscription for out-of-control (OOC) events. Users with supervisory roles receive immediate notifications when OOC events occur in their domain.
   """
   dataOoc: DataOoc!
+
+  """
+  Subscribes to activity in every session the current user participates in, so a closed chat surface can still show unread badges and refresh its list.
+  """
+  mySessionActivity: SessionActivity!
   notification(subjects: [String!]): Notification!
 
   """Subscribes to real-time updates for a specific play group."""
@@ -13960,6 +15207,11 @@ type Task {
     """Pagination options for the list query."""
     pagination: Pagination
 
+    """
+    A single free-text term matched across the fields the resolver declares as searchable (OR). Additive to filters: both are applied together. Prefer this over hand-assembling one search filter per field.
+    """
+    search: String
+
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): [Task!]