@dssp/dkpi 1.0.27 → 1.0.30

package/schema.graphql

@@ -70,10 +70,19 @@ type Activity {
   client: User
   createdAt: DateTimeISO
   creator: User
+
+  """Which input values an approver judges by, and the part each one plays"""
+  decisionKeys: [ActivityDecisionKeyItem!]
   description: String
   domain: Domain
   id: ID!
   issuerRole: Role
+
+  """Display name for a person. `name` is the callback key."""
+  label: String
+
+  """i18n key the label is translated from, computed from name"""
+  labelTKey: String!
   model: [ActivityModelItem!]
 
   """
@@ -82,6 +91,11 @@ type Activity {
   multiple: String
   name: String
   priority: Float
+
+  """
+  true when a rejection closes the case for good — it cannot be restarted
+  """
+  rejectionIsFinal: Boolean
   reportSource: String
 
   """The type of report to be shown when a task is approved"""
@@ -126,6 +140,11 @@ type ActivityApproval {
   approver: User
   approverRole: Role
   comment: String
+
+  """
+  When the opinion was said. Empty means nothing was said — silence is not consent.
+  """
+  commentedAt: DateTimeISO
   createdAt: DateTimeISO
   creator: User
   derivedApprovals: [ActivityApproval!]!
@@ -138,6 +157,11 @@ type ActivityApproval {
 
   """delegator approval"""
   originalApproval: ActivityApproval
+
+  """
+  In what capacity: approval decides, reference only comments. Empty means approval.
+  """
+  participation: String
   round: Float
   terminatedAt: DateTimeISO
   terminator: User
@@ -151,15 +175,67 @@ type ActivityApprovalList {
   total: Int!
 }
 
+"""Entity for ActivityDecisionKeyItem"""
+type ActivityDecisionKeyItem {
+  """
+  Dotted path to the value inside the instance's input, e.g. 'shift.passes'
+  """
+  inputPath: String!
+
+  """Developer-facing note. Never shown on a screen."""
+  name: String
+
+  """sentence placeholder → inputPath"""
+  params: Object
+  role: ActivityDecisionRole!
+
+  """i18n key for the label. Without it the screen shows no label."""
+  tKey: String
+
+  """Unit to print after the value, when the activity fixes the unit"""
+  unit: String
+
+  """i18n key for the value sentence: approval.<door>.<inputPath>"""
+  valueTKey: String
+}
+
+"""the part an input value plays on the approval screen"""
+enum ActivityDecisionRole {
+  consequence
+  currentState
+  evidence
+  headline
+  reason
+  reversibility
+  subject
+}
+
 type ActivityEvent {
+  basis: ActivityEventDateBasis
   date: DateTimeISO
   id: String
   name: String
   priority: Float
-  state: String
+  state: ActivityEventStatus
   type: String
 }
 
+"""what the date of an Activity Event means"""
+enum ActivityEventDateBasis {
+  Due
+  HandedOver
+  Terminated
+}
+
+"""state enumeration of a Activity Event"""
+enum ActivityEventStatus {
+  Aborted
+  Approved
+  Done
+  Pending
+  Rejected
+}
+
 """Entity for ActivityInstance"""
 type ActivityInstance {
   activity: Activity
@@ -190,6 +266,9 @@ type ActivityInstance {
   priority: Float
   reason: String
   refBy: String
+
+  """true when a rejection closes this case for good"""
+  rejectionIsFinal: Boolean
   startedAt: DateTimeISO
   starter: User
   state: String
@@ -297,6 +376,14 @@ input ActivityInstanceIssue {
   priority: Float
   reason: String
   refBy: String
+
+  """true when a rejection closes this case for good"""
+  rejectionIsFinal: Boolean
+
+  """
+  true when the caller expects this to go through an approval line — issuing fails if the line is empty
+  """
+  requireApproval: Boolean
   supervisoryRole: ObjectRef
   threadsMax: Int
   threadsMin: Int
@@ -345,6 +432,7 @@ input ActivityPatch {
   assigneeRole: ObjectRef
   assignees: Object
   cuFlag: String
+  decisionKeys: Object
   description: String
   id: ID
   issuerRole: ObjectRef
@@ -352,6 +440,11 @@ input ActivityPatch {
   multiple: String
   name: String
   priority: Float
+
+  """
+  true when a rejection closes the case for good — it cannot be restarted
+  """
+  rejectionIsFinal: Boolean
   reportSource: String
   reportType: String
   schedule: String
@@ -369,6 +462,37 @@ input ActivityPatch {
   viewType: String
 }
 
+"""What the registering module declares about an installable activity"""
+type ActivityReadiness {
+  """What is still missing, when the stage is partial"""
+  gaps: [String!]
+
+  """Result of the last recorded run of those tests"""
+  lastRun: ActivityTestRecord
+
+  """Anything a reader needs that the fields above do not carry"""
+  notes: String
+
+  """Working, partial, or declared only"""
+  stage: ActivityReadinessStage
+
+  """
+  Repo-relative test files that cover this activity. Named so the claim can be checked.
+  """
+  tests: [String!]
+}
+
+"""
+how far along an installable activity is, as declared by the module that registers it
+"""
+enum ActivityReadinessStage {
+  Declared
+  NotWorklist
+  Partial
+  Planned
+  Working
+}
+
 """Entity for ActivitySearchKeyItem"""
 type ActivitySearchKeyItem {
   description: String
@@ -436,6 +560,21 @@ input ActivityTemplatePatch {
   visibility: String
 }
 
+"""Recorded result of the test run that covers an installable activity"""
+type ActivityTestRecord {
+  """When that run happened, ISO 8601"""
+  at: String
+
+  """The command that produced this record"""
+  command: String
+
+  """How many of the covering tests passed"""
+  passed: Float
+
+  """How many covering tests ran"""
+  total: Float
+}
+
 """Entity for ActivityThread"""
 type ActivityThread {
   activityApprovals: [ActivityApproval!]!
@@ -497,6 +636,46 @@ input ActivityThreadSave {
   output: Object
 }
 
+"""
+Whether this deployment has an AI, and what its registrations are missing.
+"""
+type AiCapabilityView {
+  """The default model this deployment would use."""
+  model: String
+
+  """Which provider answers."""
+  provider: String
+
+  """
+  Why it is not configured: no-config · no-provider · unknown-provider · no-adapter.
+  """
+  reason: String
+
+  """
+  'configured' or 'not-configured'. A screen that has not asked yet knows a third state of its own: it does not know.
+  """
+  state: String!
+
+  """
+  Tools with no declared privilege, and modes offering work their tools cannot do.
+  """
+  warnings: [AiRegistrationWarning!]!
+}
+
+"""
+A registration that was accepted but is not yet what the contract asks for.
+"""
+type AiRegistrationWarning {
+  """What is missing, as a code — never prose a screen has to parse."""
+  code: String!
+
+  """The same thing in a sentence, for whoever reads a boot log."""
+  message: String!
+
+  """Which registration it is about (category, tool, mode, slash)."""
+  params: JSON!
+}
+
 """
 A flexible scalar type that can represent any GraphQL value, including String, Boolean, Int, Float, Object, or List. Use this type for fields or arguments that may accept or return various data types.
 """
@@ -528,6 +707,11 @@ type AppBinding {
   """Locale or language preference for the user."""
   locale: String
 
+  """
+  When the account was locked. With the configured lock duration this says when it lifts.
+  """
+  lockedAt: DateTimeISO
+
   """Full name of the user."""
   name: String
 
@@ -778,6 +962,8 @@ type ApprovalLine {
 """Entity for approval line item"""
 type ApprovalLineItem {
   approver: OrgMemberTarget
+  notifyAfter: Int
+  participation: ApprovalParticipation
   type: String
   value: String
 }
@@ -816,12 +1002,159 @@ input ApprovalLinePatch {
   ownerType: ApprovalLineOwnerType
 }
 
+"""
+in what capacity this member joins the approval line: approval decides, reference only comments
+"""
+enum ApprovalParticipation {
+  Approval
+  Reference
+}
+
 type AssigneeItem {
   assignee: OrgMemberTarget
   type: OrgMemberTargetType
   value: String
 }
 
+"""One turn of a conversation that has no document of its own."""
+input AssistantChatInput {
+  """
+  What this surface is looking at (e.g. { figureId } while modelling). Tools read it so the model never has to ask the user for identifiers. Client-supplied — never used for authorization; a tool verifies the scope belongs to the caller tenant.
+  """
+  hostContext: JSON
+
+  """
+  Conversation, newest last. For a persisted session only the last user message is appended; the rest is read from storage.
+  """
+  messages: [AssistantMessageInput!]!
+
+  """
+  Which conversation this is. The persona, the tool categories, the model and the limits come from the mode the app server registered (ADR-0061 decision 7) — a caller choosing its own tool categories would be a caller choosing its own authority.
+  """
+  mode: AssistantModeInput!
+
+  """ChatSession id. Omit for a one-off question with no persistence."""
+  sessionId: String
+
+  """
+  Last message to keep from the stored history. The client keeps its own truncation when a user edits a message, so pass the last kept id to hide the retracted span from the model.
+  """
+  truncateAfterMessageId: String
+}
+
+type AssistantChatOutput {
+  """Stored ChatMessage id of the reply."""
+  assistantMessageId: String
+
+  """AI client identifier (provider:model)."""
+  clientId: String!
+
+  """
+  Identifiers in the reply that appear in nothing the model received. Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.
+  """
+  groundingWarnings: JSON
+
+  """
+  Set when this turn did not fit: { omitted, summarized } — how many earlier messages the model did not see, and whether a summary stood in for them. Without it the person watches the conversation lose its beginning in silence, while the model is told.
+  """
+  historyFolded: JSON
+
+  """
+  Tool names offered to the model this turn. A surface that expected a category and sees it missing here knows the registration did not happen, rather than reading a vague answer as a refusal.
+  """
+  offeredTools: [String!]
+
+  """
+  Actions a tool recorded without executing — each carries what the tool returned alongside `proposed: true`. The surface renders a confirm button; executing is the user's act.
+  """
+  proposals: JSON
+
+  """The reply, including the notice when the loop stopped early."""
+  reply: String!
+
+  """Echo of the session id, when persisted."""
+  sessionId: String
+
+  """
+  Tool usages during the turn — {name, arguments, result, kind}. The surface shows them foldably.
+  """
+  toolUsages: JSON
+
+  """Stored ChatMessage id of the user input."""
+  userMessageId: String
+}
+
+input AssistantMessageInput {
+  """Message content"""
+  content: String!
+
+  """Role: 'user' or 'assistant'"""
+  role: String!
+}
+
+"""A conversation a screen may open for what it is showing."""
+type AssistantModeChoice {
+  """Whether this is the one to open when the person has not chosen."""
+  isDefault: Boolean!
+
+  """The mode kind to open."""
+  kind: String!
+
+  """
+  What to call it where a person chooses — already in the words of this request.
+  """
+  label: String!
+}
+
+"""Which conversation this is, and what it is about."""
+input AssistantModeInput {
+  """
+  A mode kind the app server registered — `<app>.<surface>`, e.g. "twin.space".
+  """
+  kind: String!
+
+  """
+  What this conversation is about — the space, the station, the model being edited. With `kind` it is the conversation's lifetime: when either changes the screen closes the conversation and starts another.
+  """
+  target: String
+}
+
+"""One `/` sentence, in the words of this request."""
+type AssistantModeSlashView {
+  """One line about what it does."""
+  description: String!
+
+  """Short name shown in the list."""
+  name: String!
+
+  """The sentence that lands in the input."""
+  template: String!
+}
+
+"""What a conversation offers on screen."""
+type AssistantModeView {
+  """What `@` offers."""
+  catalogEntries: JSON!
+
+  """The line under an empty conversation."""
+  footerNotice: String
+
+  """The mode kind this describes."""
+  kind: String!
+
+  """What the empty input says — what this conversation is for."""
+  placeholder: String
+
+  """Follow-up chips for a proposal that arrived without its own."""
+  proposalChoices: JSON!
+
+  """What `/` offers."""
+  slashTemplates: [AssistantModeSlashView!]!
+
+  """The line shown once the host reports a proposal staged."""
+  stagedNotice: String
+}
+
 type Attachment {
   category: String
   createdAt: DateTimeISO!
@@ -1182,6 +1515,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 +1533,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 +1563,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,14 +1587,29 @@ 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 {
   """
-  Ephemeral scene actions (selection/view/mode) — sequence of BoardActionOp. Applied via board-action-execute event on the host. Distinct from `patch` which carries persistent model changes.
+  Ephemeral scene actions (selection/view/mode) — sequence of SceneActionOp. Applied via scene-action-execute event on the host. Distinct from `patch` which carries persistent model changes.
   """
   actions: JSON
 
+  """
+  Grounded analysis contract for this turn: scope, evidence-backed claims, limitations, proposal and explicit approval boundary. Null when the turn did not perform an analysis.
+  """
+  analysis: JSON
+
   """Persisted ChatMessage id of the AI reply."""
   assistantMessageId: String
 
@@ -1256,12 +1619,27 @@ type BoardAIChatOutput {
   """Clarifying question when input is ambiguous."""
   followUp: String
 
-  """BoardEditPatch."""
+  """
+  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
+
+  """SceneEditPatch."""
   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 +1673,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 +1773,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 +1951,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
@@ -1851,8 +2272,24 @@ input BuildingPatch {
   name: String
 }
 
+"""채팅 실시간 이벤트"""
+type ChatEvent {
+  action: String
+  event: String!
+  lastReadAt: DateTimeISO
+  message: ChatRoomMessage
+  messageId: ID
+  roomId: ID!
+  userId: ID
+}
+
 """A single chat message in a ChatSession."""
 type ChatMessage {
+  """
+  Who this turn was for: 'assistant' | 'room'. Written by the door that stored it, never sent by the client.
+  """
+  addressee: String
+
   """Message content"""
   content: String!
 
@@ -1864,6 +2301,16 @@ type ChatMessage {
 
   """Soft delete timestamp."""
   deletedAt: DateTimeISO
+
+  """
+  GraphQL doors the tools behind this answer went through. Empty for what people typed. A reader who does not pass all of them gets a one-line notice in place of the content.
+  """
+  doors: [String!]
+
+  """
+  Ungrounded identifiers mentioned by this reply (hallucination candidates). Null when grounded.
+  """
+  groundingWarningsJson: JSON
   id: ID
 
   """
@@ -1871,6 +2318,11 @@ type ChatMessage {
   """
   parentMessageId: String
 
+  """
+  True when the content was replaced because this reader does not pass the row doors.
+  """
+  redacted: Boolean
+
   """ImportSession.id this message triggered (if any)."""
   relatedImportSessionId: String
 
@@ -1892,40 +2344,183 @@ type ChatMessage {
   updater: User
 }
 
-"""AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장)."""
-type ChatSession {
-  aiClientId: String
-
-  """
-  Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts).
-  """
-  boardId: String
+"""채팅 대화방"""
+type ChatRoom {
   createdAt: DateTimeISO
-
-  """User who created this session."""
   creator: User
   domain: Domain
-  id: ID
-
-  """Compressed summary of older messages (for token saving)."""
-  lastSummary: String
+  id: ID!
+  lastMessageAt: DateTimeISO
+  lastMessagePreview: String
 
-  """User-given name of this session (tab label / identification)."""
+  """대화방 멤버 목록"""
+  members: [ChatRoomMember!]!
   name: String
-  updatedAt: DateTimeISO
 
-  """User who last updated this session."""
-  updater: User
+  """내가 안 읽은 메시지 수"""
+  unreadCount: Float!
+  updatedAt: DateTimeISO
 }
 
-"""
-Participant of a ChatSession — links a User to a session with a role. Foundation for multi-user chat / per-user filtering / member display.
-"""
-type ChatSessionParticipant {
-  """Joined-at timestamp."""
+"""채팅 대화방 멤버"""
+type ChatRoomMember {
   createdAt: DateTimeISO
+  domain: Domain
+  id: ID!
+  lastReadAt: DateTimeISO
 
-  """
+  """온라인 여부 (하트비트 60초 이내)"""
+  online: Boolean!
+  room: ChatRoom
+  user: User
+  userId: ID
+}
+
+"""채팅 메시지"""
+type ChatRoomMessage {
+  """첨부파일 목록"""
+  attachments: [Attachment!]!
+  createdAt: DateTimeISO
+  deletedAt: DateTimeISO
+  domain: Domain
+  editedAt: DateTimeISO
+  id: ID!
+  message: String
+  replyTo: ChatRoomMessage
+  room: ChatRoom
+  sender: User
+  type: ChatRoomMessageType
+}
+
+"""채팅 메시지 타입 (TEXT=일반, SYSTEM=초대/나가기/이름변경 안내)"""
+enum ChatRoomMessageType {
+  SYSTEM
+  TEXT
+}
+
+"""
+One AI conversation, anchored to what it is about. An anchor may have several — threads, one per person, one per context.
+"""
+type ChatSession {
+  aiClientId: String
+
+  """Id of the anchored target (board id / space id / instance id)."""
+  anchorId: String
+
+  """
+  What this conversation is anchored to: 'board' | 'figure' (authoring a Figure) | 'space' | 'instance' | 'domain' | '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). Kept for backward compatibility — board-anchored sessions dual-write this alongside anchorId.
+  """
+  boardId: String
+  createdAt: DateTimeISO
+
+  """User who created this session."""
+  creator: User
+  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
+
+  """
+  Doors of the message the preview came from — the session list passes the same gate as the conversation.
+  """
+  lastMessageDoors: [String!]
+
+  """
+  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
+
+  """
+  Who may read this conversation: 'open' (anyone in the domain) or 'private' (participants only).
+  """
+  visibility: String!
+}
+
+"""
+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!
+
+  """
+  True when the preview was replaced because this reader does not pass the doors of the message it came from.
+  """
+  previewRedacted: 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.
+"""
+type ChatSessionParticipant {
+  """Joined-at timestamp."""
+  createdAt: DateTimeISO
+
+  """
   User who created this participant record (typically session owner who invited).
   """
   creator: User
@@ -1936,9 +2531,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
 
@@ -2090,6 +2695,13 @@ type ChecklistItem {
   updater: User
 }
 
+input ChecklistItemAiJudgment {
+  id: ID!
+
+  """AI 판정 결과 (T: 적합, F: 부적합, null: 미판정)"""
+  supervisoryConfirmStatus: ChecklistItemConfirmStatus
+}
+
 """Entity for ChecklistItemComment"""
 type ChecklistItemComment {
   checklistItem: ChecklistItem
@@ -2106,6 +2718,12 @@ input ChecklistItemCommentPatch {
   id: ID
 }
 
+"""적합 상태"""
+enum ChecklistItemConfirmStatus {
+  F
+  T
+}
+
 """History Entity of ChecklistItem"""
 type ChecklistItemHistory {
   checklistHistory: ChecklistHistory
@@ -3689,6 +4307,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!]!
@@ -3972,6 +4595,46 @@ input DomainUserRoleInput {
   users: [NewUserByDomainWizardInput!]!
 }
 
+"""Entity for DrawingBundle"""
+type DrawingBundle {
+  analyzedAt: DateTimeISO
+  archPageCount: Float
+  archPdf: Attachment
+  createdAt: DateTimeISO
+  creator: User
+  domain: Domain
+  drawings: Object
+  error: String
+  grid: Object
+  id: ID!
+  manifest: Object
+  packages: Object
+  pages: [Attachment!]
+  project: Project
+  status: DrawingBundleStatus
+  structPageCount: Float
+  structPdf: Attachment
+  updatedAt: DateTimeISO
+  updater: User
+  version: String
+}
+
+input DrawingBundlePatch {
+  """건축 도면 PDF 업로드"""
+  archPdfUpload: Upload
+  projectId: String
+
+  """구조 도면 PDF 업로드"""
+  structPdfUpload: Upload
+}
+
+enum DrawingBundleStatus {
+  ANALYZING
+  DONE
+  FAILED
+  NONE
+}
+
 """
 Represents a dynamic data summary with flexible key-value pairs for different summary periods.
 """
@@ -4367,7 +5030,7 @@ type EnvVarResolution {
 """외부 시스템(세움터/올바로/키스콘) 데이터 수집 시나리오 호출 결과"""
 type ExternalDataCollectionResult {
   """
-  시나리오 result 객체 — projectKey: value 맵. 세움터={area, floorAreaRatio, upperFloorCount, lowerFloorCount, structureType, siteType}, 올바로={totalConstructionWasteAmount}, 키스콘={constructionPeriod, constructionCost}. siteType (건축물 용도, 예 APARTMENT_COMPLEX) / structureType (구조형태) 는 BuildingComplex 의 시설유형/구조유형 속성 후보. KISCON 의 "공사유형(신설/증축)" 은 DSSP SiteType (용도분류) 와 다른 도메인이라 매핑 대상 아님.
+  시나리오 result 객체 — projectKey: value 맵. 세움터={area, floorAreaRatio, upperFloorCount, lowerFloorCount, structureType, siteType}, 올바로={totalConstructionWasteAmount}, 키스콘={constructionPeriod, constructionCost}, 시공감리={area, floorAreaRatio, upperFloorCount, lowerFloorCount, constructionCost, workerCount, designChangeCount, constructionPeriod, actualConstructionPeriod, actualConstructionCost, accidentRate, accidentSeverityRate, inspectionCount, inspectionFailCount}. siteType (건축물 용도, 예 APARTMENT_COMPLEX) / structureType (구조형태) 는 BuildingComplex 의 시설유형/구조유형 속성 후보. KISCON 의 "공사유형(신설/증축)" 은 DSSP SiteType (용도분류) 와 다른 도메인이라 매핑 대상 아님.
   """
   data: Object
 
@@ -4672,8 +5335,28 @@ input InspectionPartPatch {
 type InstallableActivity {
   activity: Activity
   activityType: String
+
+  """
+  How many approval steps this activity has in this domain. Steps, not people; references excluded.
+  """
+  approvalSteps: Int
   category: String
+  decisionKeys: [ActivityDecisionKeyItem!]
   description: String
+
+  """
+  What this work is, for the person who receives it. Plain sentences; translated through guideTKeys.
+  """
+  guide: [String!]
+
+  """One i18n key per guide line, in order, computed from name"""
+  guideTKeys: [String!]!
+
+  """What to call this work on screen, when the key is not readable"""
+  label: String
+
+  """i18n key the label is translated from, computed from name"""
+  labelTKey: String!
   model: [ActivityModelItem!]
 
   """
@@ -4685,6 +5368,13 @@ type InstallableActivity {
 
   """Provider information of the Activity"""
   provider: String
+  readiness: ActivityReadiness
+
+  """One i18n key per readiness.gaps line, in order, computed from name"""
+  readinessGapTKeys: [String!]!
+
+  """i18n key readiness.notes is translated from, computed from name"""
+  readinessNotesTKey: String!
 
   """Release information of the Activity"""
   release: String
@@ -6350,6 +7040,19 @@ type Mutation {
   """Add a user as owner of the current domain."""
   addDomainOwner(reason: String, username: String!): DomainOwner!
 
+  """To announce a work shift arrangement that starts later"""
+  announceWorkShift(effectiveFrom: DateTimeISO!, patches: [WorkShiftPatch!]!): WorkShiftRevision!
+
+  """
+  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, preserving order. A person's turns are stored as theirs, addressed to the room. An assistant turn is stored as the assistant's only when it names its original (sourceSessionId, sourceMessageId) and the server can read it; otherwise it is kept as a quotation on a system row — roles are the server's to write (ADR-0070).
+  """
+  appendSessionTurns(sessionId: String!, turns: JSON!): Boolean!
+
   """To apply to all building inspection"""
   applyToAllBuildingInspection(buildingInspectionId: String!): Boolean!
 
@@ -6365,6 +7068,11 @@ type Mutation {
     reason: String
   ): ActivityInstance!
 
+  """
+  Ask the assistant a question on a surface that has no document of its own. Tools come from the registry; with a sessionId the conversation is persisted.
+  """
+  assistantChat(input: AssistantChatInput!): AssistantChatOutput!
+
   """
   Attaches an existing contact to an employee. The contact is identified by its ID and the employee is identified by their ID.
   """
@@ -6401,6 +7109,12 @@ type Mutation {
   calculateRegionalStatistics(periodType: KpiPeriodType! = MONTH, valueDate: String!): [KpiStatistic!]!
   cancelInvitation(email: EmailAddress!, reference: String!, type: String!): Boolean!
 
+  """To cancel an announced work shift arrangement"""
+  cancelWorkShiftAnnouncement(id: String!): Boolean!
+
+  """온라인 상태 하트비트"""
+  chatHeartbeat: Boolean!
+
   """To clear translations cache"""
   clearTranslationsCache: Boolean!
 
@@ -6409,7 +7123,7 @@ type Mutation {
   """
   cloneBoard(id: String!, patch: BoardPatch!, targetGroupId: String, targetSubdomain: String!): Board!
 
-  """Run only 건축물관리대장조회 scenario for project basic info collection."""
+  """Collect project basic info from 세움터 (건축물대장 → 주택인허가 fallback)."""
   collectProjectBasicInfo(address: String, projectId: String!): ExternalDataCollectionResult!
 
   """
@@ -6417,6 +7131,11 @@ type Mutation {
   """
   collectProjectExternalData(projectId: String!): [ExternalDataCollectionResult!]!
 
+  """
+  Copy project basic information from the construction supervision platform (DCSP), same database.
+  """
+  collectProjectSupervisionData(projectId: String!): ExternalDataCollectionResult!
+
   """Establishes a live connection to a configured endpoint."""
   connectConnection(name: String!): Connection!
 
@@ -6431,6 +7150,19 @@ type Mutation {
   """
   copyScenarios(ids: [String!]!): [Scenario!]!
 
+  """
+  Always create a new AI chat session anchored to a target (no idempotent reuse). For multi-session UX — opening another tab.
+  """
+  createAISession(
+    anchorId: String!
+    anchorType: String!
+
+    """
+    Optional name. Defaults to a generated one, numbered within the anchor.
+    """
+    name: String
+  ): ChatSession!
+
   """To create new ActionPlan"""
   createActionPlan(actionPlan: NewActionPlan!): ActionPlan!
 
@@ -6474,15 +7206,8 @@ 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!
+  """대화방 생성 (1:1은 기존 방이 있으면 재사용)"""
+  createChatRoom(name: String, userIds: [String!]!): ChatRoom!
 
   """To create new ChecklistItemComment"""
   createChecklistItemComment(checklistItemComment: NewChecklistItemComment!): ChecklistItemComment!
@@ -6672,7 +7397,7 @@ type Mutation {
   createProject(project: NewProject!): Project!
 
   """프로젝트 체크리스트 생성"""
-  createProjectChecklist(constructionDetailTypeId: String!, constructionTypeId: String!, items: [ProjectChecklistItemInput!]!, name: String!, projectId: String!, siteSpecPdfUrl: String): ProjectChecklist!
+  createProjectChecklist(constructionDetailTypeId: String!, constructionTypeId: String!, items: [ProjectChecklistItemInput!]!, name: String!, projectId: String!): ProjectChecklist!
 
   """To create new ProjectReport"""
   createProjectReport(projectReport: NewProjectReport!): ProjectReport!
@@ -6680,8 +7405,11 @@ type Mutation {
   """To create new Resource"""
   createResource(resource: NewResource!): Resource!
 
-  """To create new user"""
-  createRole(role: NewRole!): User!
+  """To create new role"""
+  createRole(role: NewRole!): Role!
+
+  """To create a role from a role template"""
+  createRoleFromTemplate(name: String, templateId: String!): Role!
 
   """Creates a new scenario."""
   createScenario(scenario: NewScenario!): Scenario!
@@ -6730,6 +7458,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!
 
@@ -6804,6 +7537,9 @@ type Mutation {
   """To delete multiple Buildings"""
   deleteBuildings(ids: [String!]!): Boolean!
 
+  """메시지 삭제 (본인 메시지만, 소프트 삭제)"""
+  deleteChatRoomMessage(id: String!): Boolean!
+
   """To delete ChecklistItemComment"""
   deleteChecklistItemComment(id: String!): Boolean!
 
@@ -7145,6 +7881,9 @@ type Mutation {
   """To delete multiple ProjectReports"""
   deleteProjectReports(ids: [String!]!): Boolean!
 
+  """비밀번호 확인 후 프로젝트 삭제 (수퍼유저 전용, 테넌트 강등 상태에서만)"""
+  deleteProjectWithPassword(password: String!, projectId: String!): Boolean!
+
   """To delete Resource"""
   deleteResource(id: String!): Boolean!
 
@@ -7292,6 +8031,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!
 
@@ -7435,6 +8179,9 @@ type Mutation {
     """The username or email of the user to inactivate."""
     username: String!
   ): Boolean!
+
+  """대화방에 멤버 초대"""
+  inviteChatMembers(roomId: String!, userIds: [String!]!): Boolean!
   inviteCustomer(customerDomainName: String!): Boolean!
 
   """
@@ -7459,9 +8206,20 @@ type Mutation {
   """Adds one or more boards to a play group."""
   joinPlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
 
+  """대화방 나가기 (마지막 멤버가 나가면 방 삭제)"""
+  leaveChatRoom(roomId: String!): Boolean!
+
   """Removes one or more boards from a play group."""
   leavePlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
 
+  """대화방 읽음 처리 (읽음 워터마크 갱신)"""
+  markChatRoomRead(roomId: String!): Boolean!
+
+  """
+  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 으로 별도 발행 필요.
   """
@@ -7540,14 +8298,27 @@ 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!
+
+  """대화방 이름 변경"""
+  renameChatRoom(name: String!, roomId: String!): ChatRoom!
+
   """Rename a ChatSession (tab label)."""
   renameChatSession(name: String!, sessionId: String!): Boolean!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
@@ -7558,6 +8329,11 @@ type Mutation {
   """Sets the custom playback order for boards in a play group."""
   reorderPlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
 
+  """
+  What the host did with a proposal the assistant made. The host calls this once per card it was asked to run; the server records it as a system row, so the panel shows it, a refreshed panel still shows it, and the model reads on its next turn that its proposal was refused instead of assuming it landed (ADR-0070).
+  """
+  reportProposalOutcome(outcome: JSON!, proposalKey: String!, sessionId: String!): Boolean!
+
   """
   Resets a user's password to the default value. Use this mutation to restore access to a user who has forgotten their password.
   """
@@ -7578,19 +8354,55 @@ 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!
+
+  """To revoke an appliance's access credential"""
+  revokeApplianceCredential(id: String!): Appliance!
+
   """
   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
 
   """To save ActivityThread information"""
   saveActivityThread(id: String!, save: ActivityThreadSave!): ActivityThread!
+
+  """도면 PDF 저장 및 분석 요청"""
+  saveAndAnalyzeDrawingBundle(drawingBundle: DrawingBundlePatch!): DrawingBundle!
+
+  """
+  Say something to the people in this session. The turn is stored as the speaker's, addressed to the room, and the assistant is not called — it reads the line as context the next time someone asks it something. Returns the stored message id, or null when there was nothing to say (ADR-0070).
+  """
+  sayToRoom(content: String!, sessionId: String!): String
+
+  """메시지 전송 (텍스트/첨부/답장)"""
+  sendChatRoomMessage(files: [Upload!], message: String, replyToId: String, roomId: String!): ChatRoomMessage!
   sendInvitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
+
+  """
+  Open this conversation to everyone in the domain, or close it to its participants. Only the owner may change it. Opening exposes what is already written — the screen says so before asking. Door checks on assistant answers are unaffected (ADR-0073).
+  """
+  setSessionVisibility(sessionId: String!, visibility: String!): Boolean!
   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!
 
@@ -7598,7 +8410,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!
 
@@ -7613,7 +8425,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!
@@ -7638,6 +8457,9 @@ type Mutation {
   """To submit a ActivityThread"""
   submitActivityThread(id: String!, output: Object, reason: String): ActivityThread!
 
+  """프로젝트 공사 시방서를 매칭 엔진에 등록"""
+  syncProjectSiteSpecs(projectId: String!, specFiles: [SiteSpecFileInput!]!): Int!
+
   """To synchronize auth-providers users"""
   synchronizeAuthProviderUsers(id: String!): Boolean!
 
@@ -7718,9 +8540,15 @@ type Mutation {
   """Update Daily Worklog"""
   updateBuildingInspectionDailyWorklog(patch: BuildingInspectionDailyWorklogPatch!): BuildingInspectionDailyWorklog!
 
+  """메시지 수정 (본인 메시지만)"""
+  updateChatRoomMessage(id: String!, message: String!): ChatRoomMessage!
+
   """To modify ChecklistItemComment information"""
   updateChecklistItemComment(id: String!, patch: ChecklistItemCommentPatch!): ChecklistItemComment!
 
+  """To update checklist items with AI inspection judgments"""
+  updateChecklistItemsAiJudgment(items: [ChecklistItemAiJudgment!]!): Boolean!
+
   """To modify CommonCode information"""
   updateCommonCode(name: String!, patch: CommonCodePatch!): CommonCode!
 
@@ -8001,6 +8829,9 @@ type Mutation {
   """To modify multiple Resources' information"""
   updateMultipleResource(patches: [ResourcePatch!]!): [Resource!]!
 
+  """To create or update multiple roles at once"""
+  updateMultipleRole(patches: [RolePatch!]!): [Role!]!
+
   """
   Updates multiple scenarios at once. Can be used to create or update records.
   """
@@ -8085,7 +8916,7 @@ type Mutation {
   updateProject(project: ProjectPatch!): Project!
 
   """프로젝트 체크리스트 수정"""
-  updateProjectChecklist(id: String!, items: [ProjectChecklistItemInput!]!, name: String!, siteSpecPdfUrl: String): ProjectChecklist!
+  updateProjectChecklist(id: String!, items: [ProjectChecklistItemInput!]!, name: String!): ProjectChecklist!
 
   """프로젝트 도면 업데이트"""
   updateProjectPlan(project: ProjectPatch!): Project!
@@ -8190,12 +9021,18 @@ input NewActivity {
   approvalLine: Object
   assigneeRole: ObjectRef
   assignees: Object
+  decisionKeys: Object
   description: String
   issuerRole: ObjectRef
   model: Object
   multiple: String
   name: String!
   priority: Float
+
+  """
+  true when a rejection closes the case for good — it cannot be restarted
+  """
+  rejectionIsFinal: Boolean
   reportSource: String
   reportType: String
   schedule: String
@@ -9900,6 +10737,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
 
@@ -10010,7 +10852,7 @@ type PatchEntry {
   createdAt: DateTimeISO
   id: ID
 
-  """BoardEditOp[] (parsed JSON array)."""
+  """SceneEditOp[] (parsed JSON array)."""
   opsJson: JSON!
 
   """Whether this patch was reverted."""
@@ -10219,6 +11061,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
 
@@ -10286,6 +11133,11 @@ input ProfileInput {
 
 """프로젝트"""
 type Project {
+  accidentRate: Float
+  accidentSeverityRate: Float
+  actualConstructionCost: Float
+  actualEndDate: String
+  actualStartDate: String
   buildingComplex: BuildingComplex
   buildingUsage: String
   code: String
@@ -10296,6 +11148,7 @@ type Project {
   documentNaming: String
   domain: Domain
   endDate: String
+  facilityType: String
   geoGroup: String
   id: ID!
   inputType: String
@@ -10305,6 +11158,7 @@ type Project {
   mainPhoto: Attachment
   name: String!
   postalCode: String
+  projectScale: String
   projectType: String
   robotCount: Float
   robotProgressRate: Float
@@ -10390,6 +11244,21 @@ type ProjectManagerOutput {
 }
 
 input ProjectPatch {
+  """재해율 (%)"""
+  accidentRate: Float
+
+  """재해강도율"""
+  accidentSeverityRate: Float
+
+  """실제공사비 (억원)"""
+  actualConstructionCost: Float
+
+  """실제 준공일"""
+  actualEndDate: String
+
+  """실제 착공일"""
+  actualStartDate: String
+
   """연관된 건물 복합체 정보 (선택 사항)"""
   buildingComplex: BuildingComplexPatch
 
@@ -10402,6 +11271,9 @@ input ProjectPatch {
   """프로젝트 준공일정"""
   endDate: String
 
+  """시설물 유형 (ISO 12006-2 관점 8분류)"""
+  facilityType: String
+
   """지역 구분 코드 (시군구 식별, 통계 그룹핑용)"""
   geoGroup: String
 
@@ -10423,6 +11295,9 @@ input ProjectPatch {
   """우편 코드 (5자리)"""
   postalCode: String
 
+  """공사 규모 (공사예정금액 5구간, 억원)"""
+  projectScale: String
+
   """로봇 작업 대수"""
   robotCount: Int
 
@@ -10545,6 +11420,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!
@@ -10560,6 +11440,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!
@@ -10581,6 +11466,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!
@@ -10605,6 +11495,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!
@@ -10623,6 +11518,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!
@@ -10640,6 +11540,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!
@@ -10655,6 +11560,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!
@@ -10676,6 +11586,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!
@@ -10694,9 +11609,19 @@ 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!
+
+  """
+  Whether this deployment has an AI configured, and which registrations are incomplete. Read this before offering to ask the assistant — do not find out by failing.
+  """
+  aiCapability: AiCapabilityView!
   appBinding(id: String!): AppBinding!
   appBindings(
     """An array of filter conditions to apply to the list query."""
@@ -10708,6 +11633,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!
@@ -10726,6 +11656,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!
@@ -10744,10 +11679,35 @@ 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!
 
+  """To fetch completed approvals where I participated"""
+  approvalCompletedList(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """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!
+
   """To fetch the approvals(ActivityApprovals) which has done by me"""
   approvalDoneList(
     """An array of filter conditions to apply to the list query."""
@@ -10759,6 +11719,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!
@@ -10777,6 +11742,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!
@@ -10792,6 +11762,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!
@@ -10807,9 +11782,46 @@ 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!
+
+  """
+  To fetch the approvals where I am a reference — I may comment, I do not decide
+  """
+  approvalReferenceList(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """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!
+
+  """
+  What this conversation offers on screen — `/` sentences, the `@` catalog and the notices, translated.
+  """
+  assistantMode(kind: String!): AssistantModeView!
+
+  """
+  Conversations that stand for this kind of subject, the default first. A screen showing one subject opens the head of this list and offers the rest; a single entry means there is nothing to choose.
+  """
+  assistantModes(subject: String!): [AssistantModeChoice!]!
   attachment(id: String!): Attachment!
   attachments(
     """An array of filter conditions to apply to the list query."""
@@ -10821,6 +11833,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!
@@ -10854,6 +11871,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!
@@ -10875,6 +11897,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!
@@ -10891,8 +11918,10 @@ type Query {
   """Finds a single board by its name."""
   boardByName(name: String!): Board
 
-  """Retrieves the most recently published version of a board."""
-  boardPublished(id: String!): BoardHistory!
+  """
+  Retrieves the most recently published version of a board, or null if none was published.
+  """
+  boardPublished(id: String!): BoardHistory
 
   """To fetch a BoardSettings"""
   boardSettings(names: [String!]): [BoardSetting!]!
@@ -10911,6 +11940,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!
@@ -10926,10 +11960,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!]!
 
@@ -10944,6 +11988,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!
@@ -10959,6 +12008,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!
@@ -10998,6 +12052,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!
@@ -11025,6 +12084,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!
@@ -11044,9 +12108,24 @@ type Query {
   """List chat messages of a session, oldest first."""
   chatMessages(limit: Int = 100, offset: Int = 0, sessionId: String!): [ChatMessage!]!
 
+  """현재 로그인 유저 id (채팅 본인 식별용)"""
+  chatMyUserId: String!
+
+  """현재 온라인인 유저 id 목록 (멤버 탭 온라인 표시용)"""
+  chatOnlineUserIds: [String!]!
+
   """List patch entries of a session, newest first."""
   chatPatches(limit: Int = 100, sessionId: String!): [PatchEntry!]!
 
+  """대화방 단건 조회 (멤버만 가능)"""
+  chatRoom(id: String!): ChatRoom!
+
+  """대화방 메시지 조회 (최신순, before 커서로 과거 페이징, searchText로 검색)"""
+  chatRoomMessages(before: DateTimeISO, limit: Int, roomId: String!, searchText: String): [ChatRoomMessage!]!
+
+  """내가 멤버인 대화방 목록 (최근 메시지순)"""
+  chatRooms: [ChatRoom!]!
+
   """Get AI chat session by id."""
   chatSession(id: String!): ChatSession
 
@@ -11055,14 +12134,32 @@ 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!]!
 
+  """전체 안읽은 메시지 수 (플로팅 아이콘 뱃지용)"""
+  chatUnreadTotal: Float!
+
   """
   Checks if the system is configured to provide a default password for new users.
   """
@@ -11073,9 +12170,6 @@ type Query {
   """
   checkResettablePasswordToDefault: Boolean!
 
-  """To fetch the preset of role for new user"""
-  checkRolePreset: [Role!]!
-
   """
   Checks if the current authenticated user belongs to the current domain.
   """
@@ -11101,6 +12195,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!
@@ -11125,6 +12224,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!
@@ -11143,6 +12247,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!
@@ -11161,6 +12270,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!
@@ -11176,6 +12290,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!
@@ -11191,6 +12310,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!
@@ -11206,6 +12330,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!
@@ -11221,6 +12350,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!
@@ -11242,6 +12376,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!
@@ -11257,6 +12396,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!
@@ -11277,6 +12421,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!
@@ -11301,6 +12450,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!
@@ -11316,6 +12470,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!
@@ -11331,6 +12490,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!
@@ -11349,6 +12513,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!
@@ -11367,6 +12536,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!
@@ -11400,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!]
   ): DataArchiveList!
@@ -11422,6 +12601,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!
@@ -11444,6 +12628,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!
@@ -11466,6 +12655,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!
@@ -11485,6 +12679,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!
@@ -11504,6 +12703,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!
@@ -11524,6 +12728,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!
@@ -11546,6 +12755,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!
@@ -11571,6 +12785,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!
@@ -11591,6 +12810,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!
@@ -11608,6 +12832,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!
@@ -11625,6 +12854,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!
@@ -11648,6 +12882,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!
@@ -11667,6 +12906,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!
@@ -11686,6 +12930,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!
@@ -11705,6 +12954,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!
@@ -11731,6 +12985,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!]!
@@ -11749,6 +13008,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
@@ -11764,6 +13028,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!
@@ -11787,6 +13056,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!
@@ -11800,7 +13074,7 @@ type Query {
   domainTypes: [String!]!
 
   """
-  List users in the current domain for `@` mention popup. board-ai 권한이면 누구나 멘션용 검색 가능 (관리자 전용 users() 와 별도).
+  List users in the current domain for the `@` mention popup. Anyone with the chat privilege may search here; this is separate from the admin-only users().
   """
   domainUsersForMention(
     limit: Int = 50
@@ -11822,6 +13096,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!
@@ -11840,6 +13119,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!
@@ -11855,10 +13139,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!]
   ): ActivityInstanceList!
 
+  """프로젝트의 도면 번들 조회 (links 제외)"""
+  drawingBundle(projectId: String!): DrawingBundle
+
+  """도면 번들의 하이퍼링크 목록"""
+  drawingBundleLinks(projectId: String!): Object
+
   """To fetch multiple appliance"""
   edges(
     """An array of filter conditions to apply to the list query."""
@@ -11870,6 +13165,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!
@@ -11892,6 +13192,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!
@@ -11907,6 +13212,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!
@@ -11928,6 +13238,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!
@@ -11950,6 +13265,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!
@@ -11968,6 +13288,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!
@@ -11983,6 +13308,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!
@@ -12013,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!]
   ): FontList!
@@ -12036,6 +13371,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!
@@ -12043,6 +13383,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
 
@@ -12066,6 +13411,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!
@@ -12084,6 +13434,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!
@@ -12099,6 +13454,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!
@@ -12128,6 +13488,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!
@@ -12159,7 +13524,9 @@ type Query {
     id: String!
   ): KpiMetricValue
 
-  """To fetch multiple KpiMetricValues (cross-domain admin view)"""
+  """
+  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!]
@@ -12169,6 +13536,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!]
@@ -12185,6 +13558,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!
@@ -12221,6 +13599,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!
@@ -12234,7 +13617,7 @@ type Query {
   """
   Get KPI stats aggregated from project data with optional sectorType/buildingUsage filters
   """
-  kpiProjectStats(buildingUsage: String, endYearMonth: String, kpiNamePattern: String, sectorType: String, startYearMonth: String): [KpiProjectStat!]!
+  kpiProjectStats(buildingUsage: String, endYearMonth: String, facilityType: String, kpiNamePattern: String, projectScale: String, sectorType: String, startYearMonth: String): [KpiProjectStat!]!
 
   """Fetch a scope dimension definition by ID"""
   kpiScope(id: String!): KpiScope
@@ -12250,6 +13633,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!
@@ -12268,6 +13656,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!
@@ -12292,6 +13685,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!
@@ -12300,24 +13698,24 @@ type Query {
   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!]!
+  kpiYValueStatsByGeoGroup(buildingUsage: String, endYearMonth: String, facilityType: String, geoGroup: String!, projectScale: 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!]!
+  kpiYValueStatsByMetroArea(buildingUsage: String, endYearMonth: String, facilityType: String, metroArea: String!, projectScale: 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!]!
+  kpiZValueComprehensiveStatsByGeoGroup(buildingUsage: String, endYearMonth: String, facilityType: String, geoGroup: String, kpiName: String, projectScale: 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!]!
+  kpiZValueMonthlyTrendByGeoGroup(buildingUsage: String, endYearMonth: String, facilityType: String, kpiName: String, projectScale: 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!]!
+  kpiZValueMonthlyTrendBySigungu(buildingUsage: String, endYearMonth: String, facilityType: String, geoGroup: String!, kpiName: String, projectScale: 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!]!
+  kpiZValueStatsBySigungu(buildingUsage: String, endYearMonth: String, facilityType: String, kpiName: String, projectScale: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStatsByGeoGroup!]!
 
   """To fetch multiple Kpis"""
   kpis(
@@ -12330,6 +13728,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!
@@ -12360,6 +13763,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!
@@ -12378,6 +13786,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!
@@ -12393,6 +13806,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!
@@ -12417,6 +13835,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!
@@ -12438,6 +13861,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!
@@ -12459,6 +13887,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!
@@ -12477,6 +13910,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!
@@ -12492,6 +13930,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!
@@ -12507,6 +13950,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!
@@ -12522,10 +13970,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!]
   ): ApprovalLineList!
 
+  """
+  Fetches the caller's own employee records in this domain. Empty when the caller is not an employee.
+  """
+  myEmployees: [Employee!]!
+
   """To fetch current user's Favorites"""
   myFavorites: [Favorite!]!
 
@@ -12540,6 +13998,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!
@@ -12556,6 +14019,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!
@@ -12571,6 +14039,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!
@@ -12592,6 +14065,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!
@@ -12613,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!]
   ): UserPreferenceList!
@@ -12637,6 +14120,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!
@@ -12652,6 +14140,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!
@@ -12670,6 +14163,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!
@@ -12695,6 +14193,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!
@@ -12718,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!]
   ): PayloadLogList!
@@ -12742,6 +14250,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!
@@ -12763,6 +14276,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!
@@ -12784,6 +14302,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!
@@ -12799,6 +14322,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!
@@ -12823,6 +14351,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!
@@ -12838,6 +14371,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!
@@ -12856,6 +14394,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!]
   ): ProjectReportList!
@@ -12876,6 +14419,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!
@@ -12900,6 +14448,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!
@@ -12913,6 +14466,12 @@ type Query {
   """To fetch privileges of a role"""
   rolePrivileges(roleId: String!): [RolePrivilege!]!
 
+  """To fetch one role template by id"""
+  roleTemplate(id: String!): RoleTemplateView
+
+  """To fetch the role templates this installation offers"""
+  roleTemplates: [RoleTemplateView!]!
+
   """To fetch multiple users"""
   roles(
     """An array of filter conditions to apply to the list query."""
@@ -12924,6 +14483,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!
@@ -12945,10 +14509,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."""
@@ -12960,6 +14547,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!
@@ -12973,6 +14565,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!
@@ -12996,6 +14593,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!
@@ -13011,6 +14613,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!
@@ -13032,6 +14639,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!
@@ -13050,6 +14662,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!
@@ -13073,6 +14690,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!
@@ -13091,6 +14713,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!
@@ -13115,6 +14742,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!
@@ -13141,6 +14773,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!
@@ -13156,6 +14793,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!
@@ -13177,6 +14819,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!
@@ -13192,15 +14839,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!]
   ): ActivityThreadList!
 
   """Get KPI box plot statistics for Y-category KPIs for all projects"""
-  totalKpiYValueComprehensiveStats(buildingUsage: String, endYearMonth: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+  totalKpiYValueComprehensiveStats(buildingUsage: String, endYearMonth: String, facilityType: String, projectScale: 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!]!
+  totalKpiZValueComprehensiveStats(buildingUsage: String, endYearMonth: String, facilityType: String, projectScale: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
 
   """Fetches a user by their email address within the current domain."""
   user(
@@ -13227,11 +14879,36 @@ 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!
   vendors: [Domain!]!
 
+  """To fetch work shift arrangements that used to be in force"""
+  workShiftRevisions(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """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!]
+  ): WorkShiftRevisionList!
+
   """To fetch multiple WorkShifts"""
   workShifts(
     """An array of filter conditions to apply to the list query."""
@@ -13243,6 +14920,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!
@@ -13261,6 +14943,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!
@@ -13327,6 +15014,7 @@ type Role {
 
   """The name of the role."""
   name: String
+  privilegeCount: Int!
 
   """Privileges granted by this role."""
   privileges: [Privilege!]
@@ -13390,6 +15078,11 @@ type RolePrivilege {
   """The category of the privilege."""
   category: String
 
+  """
+  True when no module in this deployment declares this privilege anymore (@privilege directive). Computed per request — it answers for the asking deployment, not for all time.
+  """
+  deprecated: Boolean!
+
   """A description of the privilege."""
   description: String
 
@@ -13400,6 +15093,51 @@ type RolePrivilege {
   name: String
 }
 
+"""One module and the axes a role template grants on it."""
+type RoleTemplateGrantView {
+  """The privilege axes granted on that category."""
+  axes: [String!]!
+
+  """The privilege category — what is guarded."""
+  category: String!
+
+  """Axes named by the template that this installation does not declare."""
+  missingAxes: [String!]!
+}
+
+"""A role template offered by this installation."""
+type RoleTemplateView {
+  """
+  Whether a role already carries this template's default name in the current domain.
+  """
+  defaultNameTaken: Boolean!
+
+  """A description of the seat this template creates."""
+  description: String
+
+  """The modules and axes this template grants."""
+  grants: [RoleTemplateGrantView!]!
+
+  """
+  Whether this template grants nothing on purpose, rather than by omission.
+  """
+  grantsNothingDeliberately: Boolean!
+
+  """Declaration key, namespaced by the declaring application."""
+  id: String!
+
+  """
+  How many privileges the template names that this installation does not have.
+  """
+  missingCount: Int!
+
+  """The role name this template creates in a domain."""
+  name: String!
+
+  """How many privileges this template would actually grant here."""
+  privilegeCount: Int!
+}
+
 type RoomFinishDetail {
   box: String
   dwgId: String
@@ -13442,6 +15180,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."""
@@ -13453,9 +15196,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
@@ -13471,6 +15212,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."""
@@ -13679,6 +15502,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
@@ -13689,6 +15553,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!
@@ -13717,6 +15611,11 @@ input SettingPatch {
   value: String
 }
 
+input SiteSpecFileInput {
+  name: String!
+  url: String!
+}
+
 """현장 유형"""
 enum SiteType {
   APARTMENT_COMPLEX
@@ -13987,6 +15886,9 @@ type Subscription {
   """
   boardPatchActivity(boardId: String!): PatchEntry!
 
+  """채팅 실시간 이벤트 구독 — 내가 멤버인 대화방의 이벤트만 수신"""
+  chatEvent: ChatEvent!
+
   """
   Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.
   """
@@ -14003,6 +15905,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."""
@@ -14081,6 +15988,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!]
@@ -14405,6 +16317,11 @@ type User {
   """Locale or language preference for the user."""
   locale: String
 
+  """
+  When the account was locked. With the configured lock duration this says when it lifts.
+  """
+  lockedAt: DateTimeISO
+
   """Full name of the user."""
   name: String
 
@@ -14556,6 +16473,11 @@ type UsersAuthProviders {
 type WorkShift {
   createdAt: DateTimeISO
   creator: User
+
+  """
+  Weekdays this shift runs on as a CSV of 0(Sun)..6(Sat). Empty means every day
+  """
+  daysOfWeek: String
   description: String
   domain: Domain!
   fromDate: Float
@@ -14581,6 +16503,10 @@ type WorkShiftList {
 }
 
 input WorkShiftPatch {
+  """
+  Weekdays this shift runs on as a CSV of 0(Sun)..6(Sat). Empty means every day
+  """
+  daysOfWeek: String
   description: String
   fromDate: Float!
   fromTime: String!
@@ -14589,6 +16515,24 @@ input WorkShiftPatch {
   toTime: String!
 }
 
+"""A work shift arrangement that used to be in force"""
+type WorkShiftRevision {
+  createdAt: DateTimeISO
+  creator: User
+  domain: Domain!
+  effectiveFrom: DateTimeISO!
+  effectiveTo: DateTimeISO
+  id: ID!
+
+  """the shift set that was in force, as JSON text"""
+  shifts: String!
+}
+
+type WorkShiftRevisionList {
+  items: [WorkShiftRevision!]!
+  total: Int!
+}
+
 """작업자 타입"""
 type WorkerType {
   createdAt: DateTimeISO