@dssp/dssp 1.0.0-alpha.66 → 1.0.0-alpha.74

package/schema.graphql

@@ -838,6 +838,7 @@ type Attachment {
   refType: String
   size: String!
   tags: Object
+  thumbnail: String
   updatedAt: DateTimeISO!
   updater: User
 }
@@ -1146,6 +1147,16 @@ type Board {
   """A list of play groups that this board is a part of."""
   playGroups: [PlayGroup!]
 
+  """
+  Sort order for display. Lower values appear first. Supports fractional values for insertion.
+  """
+  sortOrder: Float
+
+  """
+  Source ImportSession id (board-import) when this board was generated from a drawing/image import.
+  """
+  sourceImportSessionId: String
+
   """The state of the board, can be 'draft' or 'released'."""
   state: String
 
@@ -1165,6 +1176,120 @@ type Board {
   version: Float
 }
 
+input BoardAIChatInput {
+  """
+  Component categories to surface (e.g. ["3D", "form"]). Subset filter for groupings exposed in component-schemas.
+  """
+  categories: [String!]
+
+  """
+  Component schemas — array of { type, description?, group?, properties? } so the LLM knows valid props per type.
+  """
+  componentSchemas: JSON
+
+  """Current BoardModel JSON."""
+  currentBoard: JSON
+
+  """
+  Component types the LLM is allowed to emit (e.g. ["rect", "label"]). Constrains generation to the current solution.
+  """
+  knownTypes: [String!]
+
+  """
+  Max output tokens override per LLM call. Falls back to assistant default when omitted.
+  """
+  maxTokens: Float
+
+  """
+  Explicit #mention picks from popup — {token, refid}. User text stays clean (#token only); these picks let server resolve deterministically without exposing refid in the user-visible message. Tokens not in this list fall back to free name/id/type matching.
+  """
+  mentions: [BoardAIMentionPickInput!]
+
+  """
+  Conversation history (latest user message at the end). For persisted sessions, only the last user message is appended; older are loaded from DB.
+  """
+  messages: [BoardAILLMMessageInput!]!
+
+  """
+  AI model identifier override (e.g. "claude-opus-4-7"). Falls back to the configured default when omitted.
+  """
+  model: String
+
+  """
+  Capability scopes the AI is allowed to use (e.g. 'create', 'edit', 'style'). Filters which tools are exposed to the LLM.
+  """
+  scopes: [String!]
+
+  """
+  Refids of components currently selected in the modeller (universal numeric handle, things-scene auto-assigned). For "selected" / "선택한" intent. Note: distinct from `id` which is a data-binding name.
+  """
+  selectedRefids: [Int!]
+
+  """
+  ChatSession id. Omit for ad-hoc (no persistence). When given, messages/patches are persisted.
+  """
+  sessionId: String
+
+  """
+  Sampling temperature override. Falls back to assistant default when omitted.
+  """
+  temperature: Float
+}
+
+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.
+  """
+  actions: JSON
+
+  """Persisted ChatMessage id of the AI reply."""
+  assistantMessageId: String
+
+  """AI client identifier (provider:model)."""
+  clientId: String!
+
+  """Clarifying question when input is ambiguous."""
+  followUp: String
+
+  """BoardEditPatch."""
+  patch: JSON
+
+  """Persisted PatchEntry id (when patch was generated)."""
+  patchId: String
+
+  """Conversational reply."""
+  reply: String!
+
+  """Echo of session id (when persisted)."""
+  sessionId: String
+
+  """
+  Tool usages collected during agentic loop — sequence of {name, arguments, result, kind}. UI fold-able box for transparency / debug.
+  """
+  toolUsages: JSON
+
+  """Persisted ChatMessage id of the user input."""
+  userMessageId: String
+}
+
+input BoardAILLMMessageInput {
+  """Message content"""
+  content: String!
+
+  """Role: 'user' or 'assistant'"""
+  role: String!
+}
+
+input BoardAIMentionPickInput {
+  """
+  Refid explicitly picked from popup. Server uses this for deterministic resolution — bypasses fallback name/id/type matching for this token.
+  """
+  refid: Int!
+
+  """Token used by user (e.g. "경광등1" — the part after #)."""
+  token: String!
+}
+
 """Represents a board that a user has marked as a favorite."""
 type BoardFavorite {
   """The timestamp when the board was created."""
@@ -1200,6 +1325,16 @@ type BoardFavorite {
   """A list of play groups that this board is a part of."""
   playGroups: [PlayGroup!]
 
+  """
+  Sort order for display. Lower values appear first. Supports fractional values for insertion.
+  """
+  sortOrder: Float
+
+  """
+  Source ImportSession id (board-import) when this board was generated from a drawing/image import.
+  """
+  sourceImportSessionId: String
+
   """The state of the board, can be 'draft' or 'released'."""
   state: String
 
@@ -1297,6 +1432,16 @@ type BoardList {
   total: Int!
 }
 
+type BoardMetaSuggestion {
+  """
+  Suggested detailed description — combines user prompt, AI importStrategy narrative, and category distribution stats.
+  """
+  description: String!
+
+  """Suggested short board name (collision-free with current domain)."""
+  name: String!
+}
+
 """Input for updating (patching) an existing board."""
 input BoardPatch {
   """The new description for the board."""
@@ -1505,6 +1650,7 @@ type BuildingInspection {
   creator: User
   deletedAt: DateTimeISO
   drawingMarker: String
+  failCount: Float
   id: ID!
   manager: ProjectManagerOutput
   memo: String
@@ -1573,6 +1719,7 @@ type BuildingInspectionHistory {
   createdAt: DateTimeISO
   creator: User
   drawingMarker: String
+  failCount: Float
   id: ID!
   loggedAt: DateTimeISO
   manager: ProjectManagerOutput
@@ -1602,6 +1749,9 @@ type BuildingInspectionSummary {
   """검측 통과 수"""
   pass: Int!
 
+  """재검측 대기 수 (failCount > 0 인 WAIT/OVERALL_WAIT)"""
+  reWait: Int
+
   """검측 요청 수"""
   request: Int!
 
@@ -1636,6 +1786,9 @@ input BuildingInspectionsOfBuildingLevel {
 input BuildingInspectionsOfProject {
   limit: Float
   projectId: String!
+
+  """상태 필터 (WAIT, REQUEST, FAIL, RE_WAIT, PASS)"""
+  statusFilter: String
 }
 
 """층 정보"""
@@ -1683,6 +1836,113 @@ input BuildingPatch {
   name: String
 }
 
+"""A single chat message in a ChatSession."""
+type ChatMessage {
+  """Message content"""
+  content: String!
+
+  """Creation timestamp."""
+  createdAt: DateTimeISO
+
+  """User who triggered this message."""
+  creator: User
+
+  """Soft delete timestamp."""
+  deletedAt: DateTimeISO
+  id: ID
+
+  """
+  Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.
+  """
+  parentMessageId: String
+
+  """ImportSession.id this message triggered (if any)."""
+  relatedImportSessionId: String
+
+  """PatchEntry.id this message triggered (if any)."""
+  relatedPatchId: String
+
+  """'user' | 'assistant' | 'system'"""
+  role: String!
+
+  """
+  Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.
+  """
+  toolUsagesJson: JSON
+
+  """Last update timestamp (relevant once message editing is supported)."""
+  updatedAt: DateTimeISO
+
+  """Last user to update this message (for future edit support)."""
+  updater: User
+}
+
+"""AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장)."""
+type ChatSession {
+  aiClientId: String
+
+  """
+  Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts).
+  """
+  boardId: String
+  createdAt: DateTimeISO
+
+  """User who created this session."""
+  creator: User
+  domain: Domain
+  id: ID
+
+  """Compressed summary of older messages (for token saving)."""
+  lastSummary: String
+
+  """User-given name of this session (tab label / identification)."""
+  name: String
+  updatedAt: DateTimeISO
+
+  """User who last updated this session."""
+  updater: User
+}
+
+"""
+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
+
+  """Soft delete (= left session) timestamp."""
+  deletedAt: DateTimeISO
+
+  """Domain to which this participant belongs."""
+  domain: Domain
+
+  """Unique participant id."""
+  id: ID!
+
+  """Last seen / activity timestamp (presence indicator)."""
+  lastSeenAt: DateTimeISO
+
+  """Role of this participant: owner | member | viewer."""
+  role: String!
+
+  """The ChatSession this participation belongs to."""
+  session: ChatSession
+
+  """Last update timestamp (role change / lastSeenAt bump)."""
+  updatedAt: DateTimeISO
+
+  """Last user to update this participant record (e.g., role change)."""
+  updater: User
+
+  """The user participating in the session."""
+  user: User
+}
+
 type Checklist {
   buildingInspection: BuildingInspection!
   checklistAttachments(description: String): [Attachment!]!
@@ -3517,6 +3777,27 @@ type DomainList {
   total: Int
 }
 
+"""An ownership record binding a User to a Domain (multi-owner support)."""
+type DomainOwner {
+  """Domain that the user owns."""
+  domain: Domain!
+
+  """When the ownership was granted."""
+  grantedAt: DateTimeISO!
+
+  """User who granted this ownership (audit)."""
+  grantedBy: User
+
+  """Unique identifier."""
+  id: ID!
+
+  """Optional reason/memo for granting ownership."""
+  reason: String
+
+  """User who owns the domain."""
+  user: User!
+}
+
 """Input type for updating an existing domain entity."""
 input DomainPatch {
   """Additional attributes for the domain in key-value pairs."""
@@ -4076,6 +4357,70 @@ input GroupPatch {
   name: String
 }
 
+input ImportBoardAsyncInput {
+  """Apply Stage 4 (data binding)."""
+  applyBinding: Boolean
+
+  """
+  Attachment id of the source drawing file (uploaded via attachment-base).
+  """
+  attachmentId: String!
+
+  """ChatSession id when triggered from board-ai chat."""
+  chatSessionId: String
+
+  """Flip Y axis (CAD Y-up → scene Y-down)."""
+  flipY: Boolean
+
+  """Normalize coordinates so minX,minY=0"""
+  normalizeOrigin: Boolean
+
+  """Adapter parse options (excludeLayers, maxEntities, ...)."""
+  parseOptions: JSON
+
+  """Scale factor (e.g. 1 for mm:1unit)."""
+  scale: Float
+
+  """Registry scopes to use (board-import)."""
+  scopes: [String!]
+
+  """
+  User-provided context / hints about the drawing — passed to VLM as additional guidance. e.g. "fab lithography zone, central rectangles are stockers, thin lines are OHT rails."
+  """
+  userPrompt: String
+}
+
+"""도면 → 보드 변환 작업의 영속 단위 (비동기 진행상태 추적)."""
+type ImportSession {
+  """Attachment id (the source drawing file)"""
+  attachmentId: String!
+
+  """ChatSession id when triggered from chat (board-ai)."""
+  chatSessionId: String
+  completedAt: DateTimeISO
+  createdAt: DateTimeISO
+  creator: User
+  domain: Domain
+  id: ID
+  message: String
+
+  """Options used (parsed JSON)."""
+  options: JSON
+
+  """Progress percentage 0..100"""
+  progress: Float!
+
+  """Result (parsed JSON): { boardModel, stats, warnings }."""
+  result: JSON
+
+  """queued | parsing | mapping | assembling | binding | completed | failed"""
+  status: String!
+
+  """Total entities counted (when known)."""
+  totalEntities: Int
+  updatedAt: DateTimeISO
+}
+
 """
 Enumeration for inherited value types: None, Only, or Include. Used to specify how values are inherited in queries or filters.
 """
@@ -4249,6 +4594,11 @@ enum IssueStatus {
   STATUS_B
 }
 
+"""
+The `JSON` scalar type represents JSON values as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf).
+"""
+scalar JSON @specifiedBy(url: "http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf")
+
 """
 A field whose value is a JSON Web Token (JWT): https://jwt.io/introduction.
 """
@@ -4329,6 +4679,11 @@ type Kpi {
   """
   scoreFormula: String
 
+  """
+  value → score 변환 방식. NONE: 미설정, DIRECT: value=score(변환 없음), FORMULA: scoreFormula 수식, LOOKUP: grade table(1D), CUSTOM: 2D 룩업 등 특수 변환.
+  """
+  scoreType: KpiScoreType
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: String
   targetValue: Float
@@ -4353,6 +4708,11 @@ type Kpi {
     orgScope: String
   ): KpiValue
 
+  """
+  value 획득 방식. MEASURED: 외부 시스템 수집 측정값, ASSESSED: 감리자 직접 평가(1~5), CALCULATED: formula 자동 계산, COMPOSITE: 다차원 룩업 결과.
+  """
+  valueType: KpiValueType
+
   """
   Version number of the KPI. Increments on each modification. When the KPI is released, a snapshot is saved in kpi-history and the status becomes RELEASED. Editing after release increases the version and sets status to DRAFT.
   """
@@ -4521,7 +4881,7 @@ input KpiMetricPatch {
   """데이터 수집 방식"""
   collectType: KpiMetricCollectType
   cuFlag: String
-  dataSetId: ID
+  dataSet: ObjectRef
   description: String
   fieldName: String
   id: ID
@@ -4764,6 +5124,9 @@ input KpiPatch {
   """
   scoreFormula: String
 
+  """value → score 변환 방식."""
+  scoreType: KpiScoreType
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: KpiStatus
 
@@ -4773,6 +5136,9 @@ input KpiPatch {
   """Timezone for the KPI schedule."""
   timezone: String
 
+  """value 획득 방식."""
+  valueType: KpiValueType
+
   """
   Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
   """
@@ -4896,6 +5262,16 @@ input KpiScopePatch {
   validationPattern: String
 }
 
+"""
+value → score 변환 방식. DIRECT: value=score(변환 없음), FORMULA: scoreFormula 수식 적용, LOOKUP: grade table(1D) 매핑, CUSTOM: 2D 룩업 등 특수 변환.
+"""
+enum KpiScoreType {
+  CUSTOM
+  DIRECT
+  FORMULA
+  LOOKUP
+}
+
 """
 KPI Statistics Entity - Stores comprehensive statistical information for KPIs and Categories including central tendency measures (mean, median), dispersion metrics (standard deviation, variance), range indicators (min, max), and percentile distributions (25th, 75th percentiles, IQR). Supports both KPI and Category targets with flexible period-based aggregation (daily, weekly, monthly, yearly). Includes extensible JSON fields for additional metrics and metadata for calculation tracking.
 """
@@ -5166,6 +5542,16 @@ input KpiValuePatch {
   version: Int
 }
 
+"""
+value 획득 방식. MEASURED: 외부 시스템 수집 측정값, ASSESSED: 감리자 직접 평가(1~5), CALCULATED: formula 자동 계산, COMPOSITE: 다차원 복합 입력 결과.
+"""
+enum KpiValueType {
+  ASSESSED
+  CALCULATED
+  COMPOSITE
+  MEASURED
+}
+
 type KpiValuesObject {
   kpiName: String!
   value: Float!
@@ -5307,6 +5693,33 @@ input ManagerPatch {
   userId: ID
 }
 
+input MaterializeImportSessionInput {
+  """Optional Board description."""
+  description: String
+
+  """Optional Group id to attach the Board to."""
+  groupId: ID
+
+  """New Board name."""
+  name: String!
+
+  """ImportSession id (must be in completed state)."""
+  sessionId: ID!
+
+  """
+  Base64 thumbnail. If omitted, board-service default empty thumbnail is used.
+  """
+  thumbnail: String
+
+  """Board type — 'main' | 'sub' | 'popup'. Default 'main'."""
+  type: String
+
+  """
+  ImportSession 의 결과 시안 중 하나의 id. 'as-is' / 'scene' / 'auto-fit'. 미지정 시 default variant (보통 'scene') 사용.
+  """
+  variantId: String
+}
+
 """Entity for Menu"""
 type Menu {
   buttons: [MenuButton!]!
@@ -5685,6 +6098,9 @@ type Mutation {
     username: String!
   ): Boolean!
 
+  """Add a user as owner of the current domain."""
+  addDomainOwner(reason: String, username: String!): DomainOwner!
+
   """To apply to all building inspection"""
   applyToAllBuildingInspection(buildingInspectionId: String!): Boolean!
 
@@ -5705,6 +6121,14 @@ type Mutation {
   """
   attachContact(contactId: String!, id: String!): Employee!
 
+  """
+  썸네일이 없는 기존 첨부파일들에 대해 서버에서 썸네일을 일괄 생성한다. 한 호출당 limit 개까지만 처리하며, remaining > 0 이면 반복 호출 필요.
+  """
+  backfillAttachmentThumbnails(limit: Int = 20): ThumbnailBackfillResult!
+
+  """AI 주도 보드 모델링 — 자연어 채팅으로 보드 생성·구조편집·스타일링. sessionId 로 영속 컨텍스트."""
+  boardAIChat(input: BoardAIChatInput!): BoardAIChatOutput!
+
   """Bulk create or update KPI org-scope mappings."""
   bulkUpsertKpiOrgScopes(
     """Array of org-scope mapping data for bulk upsert."""
@@ -5793,6 +6217,16 @@ type Mutation {
   """Create Daily Worklog by projectId+date"""
   createBuildingInspectionDailyWorklog(patch: BuildingInspectionDailyWorklogNew!): BuildingInspectionDailyWorklog!
 
+  """
+  Always create a new AI chat session for a board (no idempotent reuse). For multi-session UX — 새 탭 열기.
+  """
+  createChatSession(
+    boardId: String!
+
+    """Optional name (defaults to auto-generated `세션 N`)."""
+    name: String
+  ): ChatSession!
+
   """To create new ChecklistItemComment"""
   createChecklistItemComment(checklistItemComment: NewChecklistItemComment!): ChecklistItemComment!
 
@@ -6524,6 +6958,9 @@ type Mutation {
   """To delete multiple WorkerTypes"""
   deleteWorkerTypes(ids: [String!]!): Boolean!
 
+  """프로젝트 테넌트 강등 (Domain soft-delete, Project.code 보존)"""
+  demoteProjectTenant(projectId: String!): Boolean!
+
   """
   Detaches an existing contact from an employee. The employee is identified by their ID.
   """
@@ -6597,6 +7034,9 @@ type Mutation {
     attributes: [AttributeSetPatch!]!
   ): Boolean!
 
+  """도면 → 보드 변환을 비동기로 시작. 즉시 ImportSession 반환, 백그라운드에서 처리."""
+  importBoardAsync(input: ImportBoardAsyncInput!): ImportSession!
+
   """Imports multiple boards from JSON files."""
   importBoards(files: [Upload!]!, groupId: String!, overwrite: Boolean!): [Board!]!
 
@@ -6740,6 +7180,11 @@ type Mutation {
 
   """Removes one or more boards from a play group."""
   leavePlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
+
+  """
+  완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화한다. 검수 단계 (사용자/AI 가 import 결과를 확인 후 명시적으로 호출) 에서 사용. Board.state="draft" 로 생성되므로 release mutation 으로 별도 발행 필요.
+  """
+  materializeImportSession(input: MaterializeImportSessionInput!): Board!
   multipleUpload(files: [Upload!]!): [Attachment!]!
 
   """
@@ -6747,12 +7192,20 @@ type Mutation {
   """
   pickActivityInstance(id: String!): ActivityThread
 
+  """프로젝트를 테넌트로 승격 (관리번호 발번 + project 카테고리 Domain 생성)"""
+  promoteProjectToTenant(projectId: String!): Project!
+
   """기존 KPI Value 인스턴스를 현재 formula/metric 값으로 재계산"""
   recalculateKpiValue(id: String!): KpiValue!
 
   """Recalculate scores for all KpiValues of a specific KPI"""
   recalculateScoresForKpi(kpiId: String!): Boolean!
 
+  """
+  Record a patch from user direct edit. Adds a system message so AI sees the change next turn.
+  """
+  recordDirectPatch(ops: JSON!, sessionId: String!, summary: String): PatchEntry!
+
   """Record a metric value by metric name, value, meta, and org."""
   recordKpiMetricValue(
     """Extended or non-numeric information (JSON)."""
@@ -6804,8 +7257,17 @@ type Mutation {
 
   """Release a KPI and create a version history."""
   releaseKpi(id: String!): Kpi!
+
+  """Remove a user from the owners of the current domain."""
+  removeDomainOwner(reason: String, username: String!): Boolean!
+
+  """Rename a ChatSession (tab label)."""
+  renameChatSession(name: String!, sessionId: String!): Boolean!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
 
+  """Reorders a board between two adjacent boards by ID."""
+  reorderBoard(id: String!, nextId: String, prevId: String): Boolean!
+
   """Sets the custom playback order for boards in a play group."""
   reorderPlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
 
@@ -6826,6 +7288,9 @@ type Mutation {
   """Revert a KPI to a specific historical version."""
   revertKpiVersion(id: String!, version: Float!): Kpi!
 
+  """Mark a patch as reverted (does not undo, only flags)."""
+  revertPatch(patchId: String!): Boolean!
+
   """
   Runs a new scenario instance once and returns the result after it finishes.
   """
@@ -6845,6 +7310,11 @@ type Mutation {
   """To start ActivityThread"""
   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.
+  """
+  startBoardAISession(boardId: String!): ChatSession!
+
   """
   Starts automated data collection scheduling for the specified dataset. This mutation registers a cron-based schedule that automatically triggers data collection tasks according to the dataset configuration.
   """
@@ -8006,6 +8476,9 @@ input NewKpi {
   """
   scoreFormula: String
 
+  """value → score 변환 방식."""
+  scoreType: KpiScoreType
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: KpiStatus
 
@@ -8015,6 +8488,9 @@ input NewKpi {
   """Timezone for the KPI schedule."""
   timezone: String
 
+  """value 획득 방식."""
+  valueType: KpiValueType
+
   """
   Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
   """
@@ -8039,8 +8515,8 @@ input NewKpiMetric {
   """데이터 수집 방식"""
   collectType: KpiMetricCollectType
 
-  """ID of the source dataset for this metric."""
-  dataSetId: ID
+  """Source dataset for this metric."""
+  dataSet: ObjectRef
 
   """User-friendly name or description of the metric."""
   description: String
@@ -9189,6 +9665,26 @@ type PasswordRule {
   useTightPattern: Boolean
 }
 
+"""One board edit operation history (cascade-deleted with ChatSession)."""
+type PatchEntry {
+  """AI confidence 0..1 (null for user-direct)."""
+  confidence: Float
+  createdAt: DateTimeISO
+  id: ID
+
+  """BoardEditOp[] (parsed JSON array)."""
+  opsJson: JSON!
+
+  """Whether this patch was reverted."""
+  reverted: Boolean!
+
+  """'ai' | 'user-direct' | 'import'"""
+  source: String!
+
+  """Short human summary of this patch."""
+  summary: String
+}
+
 """Logs the request and response payloads for API interactions."""
 type PayloadLog {
   """The timestamp when the log entry was created."""
@@ -9453,6 +9949,8 @@ input ProfileInput {
 """프로젝트"""
 type Project {
   buildingComplex: BuildingComplex
+  buildingUsage: String
+  code: String
   completeReport: Attachment
   createdAt: DateTimeISO
   creator: User
@@ -9474,10 +9972,14 @@ type Project {
   robotProgressRate: Float
   rootTasks: [Task!]
   scheduleTable: Attachment
+  sectorType: String
   startDate: String
   state: String!
   structuralSafetyRate: Float
   tasks: [Task!]
+
+  """활성 테넌트 Domain (extType=project). 미승격 또는 강등 상태이면 null"""
+  tenantDomain: Domain
   totalProgress: Float
   updatedAt: DateTimeISO
   updater: User
@@ -9505,6 +10007,9 @@ input ProjectPatch {
   """연관된 건물 복합체 정보 (선택 사항)"""
   buildingComplex: BuildingComplexPatch
 
+  """건물 용도 (RESIDENTIAL: 주거, NON_RESIDENTIAL: 비주거)"""
+  buildingUsage: String
+
   """프로젝트 문서 네이밍"""
   documentNaming: String
 
@@ -9532,6 +10037,9 @@ input ProjectPatch {
   """로봇 작업 진행율 (%)"""
   robotProgressRate: Float
 
+  """발주 유형 (PUBLIC: 공공, PRIVATE: 민간)"""
+  sectorType: String
+
   """프로젝트 착공일정"""
   startDate: String
 
@@ -9967,8 +10475,14 @@ type Query {
     sortings: [Sorting!]
   ): AuthProviderList!
 
-  """Finds a single board by its ID."""
-  board(id: String!): Board!
+  """
+  Finds a single board by its ID. If cachedUpdatedAt matches, model is omitted.
+  """
+  board(
+    """Client cache timestamp — if matches, model field is omitted"""
+    cachedUpdatedAt: String
+    id: String!
+  ): Board!
 
   """Finds a single board by its name."""
   boardByName(name: String!): Board
@@ -10045,6 +10559,11 @@ type Query {
     sortings: [Sorting!]
   ): BoardList!
 
+  """
+  Retrieves boards that have been updated or soft-deleted since the given timestamp.
+  """
+  boardsUpdatedSince(since: DateTimeISO!): [Board!]!
+
   """To fetch a building"""
   building(id: String!): Building
 
@@ -10106,6 +10625,28 @@ type Query {
   """To fetch a building level"""
   buildingLevel(id: String!): BuildingLevel
 
+  """List chat messages of a session, oldest first."""
+  chatMessages(limit: Int = 100, offset: Int = 0, sessionId: String!): [ChatMessage!]!
+
+  """List patch entries of a session, newest first."""
+  chatPatches(limit: Int = 100, sessionId: String!): [PatchEntry!]!
+
+  """Get AI chat session by id."""
+  chatSession(id: String!): ChatSession
+
+  """
+  Get AI chat session by board id (returns first match — backward compat single-session lookup).
+  """
+  chatSessionByBoard(boardId: String!): ChatSession
+
+  """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 탭으로 표시.
+  """
+  chatSessionsByBoard(boardId: String!): [ChatSession!]!
+
   """
   Checks if the system is configured to provide a default password for new users.
   """
@@ -10801,11 +11342,24 @@ type Query {
     sortings: [Sorting!]
   ): DomainLinkList!
 
+  """List owners of the current domain."""
+  domainOwners: [DomainOwner!]!
+
   """
   Fetches the list of available domain types from configuration. Only superusers are granted this privilege.
   """
   domainTypes: [String!]!
 
+  """
+  List users in the current domain for `@` mention popup. board-ai 권한이면 누구나 멘션용 검색 가능 (관리자 전용 users() 와 별도).
+  """
+  domainUsersForMention(
+    limit: Int = 50
+
+    """Substring to match against name/email (case-insensitive). Empty → all."""
+    query: String
+  ): [User!]!
+
   """
   Fetches all domain entities with pagination and filtering options. Only superusers are granted this privilege.
   """
@@ -11026,6 +11580,12 @@ type Query {
   """To query whether I have the given permission"""
   hasPrivilege(category: String!, privilege: String!): Boolean!
 
+  """Get import session progress."""
+  importSession(id: String!): ImportSession
+
+  """List recent import sessions for a chat session."""
+  importSessionsByChatSession(chatSessionId: String!): [ImportSession!]!
+
   """BuildingInspection By ChecklistItemId"""
   inspectionByChecklistItemId: BuildingInspection!
 
@@ -11088,6 +11648,9 @@ type Query {
   invitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
   invitations(reference: String!, type: String!): InvitationList!
 
+  """Check if a user is an owner of the current domain."""
+  isDomainOwner(username: String!): Boolean!
+
   """To fetch a Issue"""
   issue(id: String!): Issue
 
@@ -11948,6 +12511,14 @@ type Query {
     sortings: [Sorting!]
   ): StepList!
 
+  """
+  도메인 안에서 충돌하지 않는 Board name + 상세 description 제안. name 은 짧고 심플 (30자 이내, 충돌 회피 (n) suffix), description 은 자세히 (사용자 prompt + AI importStrategy + 카테고리 분포 통계 합성).
+  """
+  suggestBoardMeta(input: SuggestBoardNameInput!): BoardMetaSuggestion!
+
+  """@deprecated suggestBoardMeta 사용 권장. 단순 string name 만 반환하는 구버전 query."""
+  suggestBoardName(input: SuggestBoardNameInput!): String!
+
   """To fetch the list of activities that I can report on"""
   supervisableActivities(
     """An array of filter conditions to apply to the list query."""
@@ -12888,6 +13459,16 @@ type Subscription {
   scenarioQueueState: ScenarioQueueState!
 }
 
+input SuggestBoardNameInput {
+  """명시 hint. session 정보보다 우선. 사용자가 직접 적은 메모를 기반으로 추천받고 싶을 때."""
+  hint: String
+
+  """
+  ImportSession id — 있으면 거기서 userPrompt / VLM reasoning / attachment.name 추출.
+  """
+  sessionId: ID
+}
+
 """Entity for Supervisor"""
 type Supervisor {
   active: Boolean
@@ -13189,6 +13770,21 @@ input ThemePatch {
   value: Object
 }
 
+"""썸네일 백필 결과"""
+type ThumbnailBackfillResult {
+  """이번 호출에서 처리 시도한 첨부 개수"""
+  attempted: Int!
+
+  """실패(생성 실패/콘텐츠 없음 등) 개수"""
+  failed: Int!
+
+  """이번 처리 후에도 남아있는 썸네일 미생성 후보 개수 (대략치). 0 이면 완료"""
+  remaining: Int!
+
+  """썸네일 생성·저장 성공 개수"""
+  succeeded: Int!
+}
+
 input UpdateBuildingInspection {
   drawingMarker: String
   id: String!