@things-factory/headless-twin 10.0.9 → 10.0.10

package/dist-server/service/twin-space/twin-space-representation.js.map

@@ -1 +1 @@
-{"version":3,"file":"twin-space-representation.js","sourceRoot":"","sources":["../../../server/service/twin-space/twin-space-representation.ts"],"names":[],"mappings":";;;;AAAA,qCAAkI;AAClI,+CAAyD;AAEzD,iDAA4D;AAE5D,mDAA2C;AAE3C;;;;GAIG;AAII,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CA8CnC,CAAA;AA9CY,0DAAuB;AAGzB;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,CAAC;;mDACC;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;sCACvE,cAAM;uDAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;;yDACpC;AAIjB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,yBAAS,CAAC;IAC5B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,yBAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;sCACnE,yBAAS;sDAAA;AAGjB;IADC,IAAA,oBAAU,EAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;;wDACpC;AAIhB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;;qDACxD;AAIZ;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;;qDAClD;AAIb;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;;oDAC1D;AAIZ;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1C,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;;0DACnE;AAInB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wGAAwG,EAAE,CAAC;;uDAC3J;AAIZ;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;0DAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;0DAAA;kCA7CL,uBAAuB;IAHnC,IAAA,gBAAM,GAAE;IACR,IAAA,eAAK,EAAC,qBAAqB,EAAE,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACjF,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,+EAA+E,EAAE,CAAC;GAChG,uBAAuB,CA8CnC","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID, Int } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\n\nimport { TwinSpace } from './twin-space.js'\n\n/*\n * TwinSpaceRepresentation — 공간을 보는 한 방식(map|image|board), 복수·1개 primary(공간구성 아키텍처, design/ui/space-composition.md).\n * config(simple-json): board={boardId}(board-service 참조) / image={attachmentId|boardId,width,height} / map={center,zoom,provider}.\n * 폴리곤 영역은 TwinSpaceArea(map/image), board 표현은 씬 컴포넌트가 대신.\n */\n@Entity()\n@Index('ix_twin_space_rep_0', (e: TwinSpaceRepresentation) => [e.domain, e.space])\n@ObjectType({ description: 'A way to view a Space (map | image | board). Multiple per space, one primary.' })\nexport class TwinSpaceRepresentation {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n  domain?: Domain\n\n  @RelationId((e: TwinSpaceRepresentation) => e.domain)\n  domainId?: string\n\n  @ManyToOne(type => TwinSpace)\n  @Field(type => TwinSpace, { nullable: true, description: 'Owning space.' })\n  space?: TwinSpace\n\n  @RelationId((e: TwinSpaceRepresentation) => e.space)\n  spaceId?: string\n\n  @Column()\n  @Field({ description: 'Representation type: map | image | board.' })\n  type: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Representation name.' })\n  name?: string\n\n  @Column({ type: 'int', nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Display order.' })\n  seq?: number\n\n  @Column({ nullable: true, default: false })\n  @Field({ nullable: true, description: 'Whether this is the primary representation.' })\n  isPrimary?: boolean\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Type config: board {boardId} / image {attachmentId|boardId,width,height} / map {center,zoom,provider}.' })\n  config?: any\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n}\n"]}
+{"version":3,"file":"twin-space-representation.js","sourceRoot":"","sources":["../../../server/service/twin-space/twin-space-representation.ts"],"names":[],"mappings":";;;;AAAA,qCAAkI;AAClI,+CAAyD;AAEzD,iDAA4D;AAE5D,mDAA2C;AAE3C;;;;GAIG;AAII,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CA8CnC,CAAA;AA9CY,0DAAuB;AAGzB;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,CAAC;;mDACC;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;sCACvE,cAAM;uDAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;;yDACpC;AAIjB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,yBAAS,CAAC;IAC5B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,yBAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;sCACnE,yBAAS;sDAAA;AAGjB;IADC,IAAA,oBAAU,EAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;;wDACpC;AAIhB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;;qDACxD;AAIZ;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;;qDAClD;AAIb;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;;oDAC1D;AAIZ;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1C,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;;0DACnE;AAInB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wGAAwG,EAAE,CAAC;;uDAC3J;AAIZ;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;0DAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;0DAAA;kCA7CL,uBAAuB;IAHnC,IAAA,gBAAM,GAAE;IACR,IAAA,eAAK,EAAC,qBAAqB,EAAE,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACjF,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,+EAA+E,EAAE,CAAC;GAChG,uBAAuB,CA8CnC","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID, Int } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\n\nimport { TwinSpace } from './twin-space.js'\n\n/*\n * TwinSpaceRepresentation — 공간을 보는 한 방식(map|image|model), 복수·1개 primary(공간구성 아키텍처, design/ui/space-composition.md).\n * config(simple-json): model={boardId}(board-service 참조) / image={attachmentId|boardId,width,height} / map={center,zoom,provider}.\n * 폴리곤 영역은 TwinSpaceArea(map/image), model 표현은 씬 컴포넌트가 대신.\n */\n@Entity()\n@Index('ix_twin_space_rep_0', (e: TwinSpaceRepresentation) => [e.domain, e.space])\n@ObjectType({ description: 'A way to view a Space (map | image | model). Multiple per space, one primary.' })\nexport class TwinSpaceRepresentation {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n  domain?: Domain\n\n  @RelationId((e: TwinSpaceRepresentation) => e.domain)\n  domainId?: string\n\n  @ManyToOne(type => TwinSpace)\n  @Field(type => TwinSpace, { nullable: true, description: 'Owning space.' })\n  space?: TwinSpace\n\n  @RelationId((e: TwinSpaceRepresentation) => e.space)\n  spaceId?: string\n\n  @Column()\n  @Field({ description: 'Representation type: map | image | model.' })\n  type: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Representation name.' })\n  name?: string\n\n  @Column({ type: 'int', nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Display order.' })\n  seq?: number\n\n  @Column({ nullable: true, default: false })\n  @Field({ nullable: true, description: 'Whether this is the primary representation.' })\n  isPrimary?: boolean\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Type config: model {boardId} / image {attachmentId|boardId,width,height} / map {center,zoom,provider}.' })\n  config?: any\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n}\n"]}

package/dist-server/service/twin-space/twin-space-resolver.d.ts

@@ -1,9 +1,71 @@
 export declare class TwinSpaceResolver {
+    /**
+     * 이 테넌트의 현장 목록.
+     *
+     * ── 세 번만 묻는다 (2026-08-13) ──────────────────────────────────────────
+     * 예전에는 현장마다 표현 수를 세고 인스턴스를 조회했다 — 현장 13곳이면 **질의 27번**이고, 첫
+     * 호출이 2.4초였다(헤더가 뜰 때마다 이 목록을 읽는다). 규모가 커지면 그대로 자란다.
+     *
+     * 이제 세 번 묻고 메모리에서 맞춘다: 현장 · 표현(공간 id 만) · 인스턴스(필요한 컬럼만).
+     * 표현은 **id 만 실어 온다**(`loadRelationIds`) — 설정 blob 을 읽어 세는 것은 낭비다.
+     */
     twinSpaces(context: ResolverContext): Promise<any[]>;
     /** 단건 — 표현(+영역) 트리 포함. */
     twinSpace(spaceId: string, context: ResolverContext): Promise<any | null>;
     saveTwinSpace(spaceId: string, patch: any, context: ResolverContext): Promise<boolean>;
-    deleteTwinSpace(spaceId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * 공간 삭제 — **이 공간의 트윈이 있으면 거절한다.** 그래서 트윈이 현장을 잃는 일은 없다.
+     *
+     * ── 왜 모양을 바꿨나 (2026-08-13) ────────────────────────────────────────
+     * 예전에는 `Boolean` 을 돌려주고 거절은 **한국어 문장을 던졌다.** 두 가지가 틀렸다:
+     *  ① 서버가 화면의 말을 정했다 — 일본어·스페인어 사용자에게 한국어가 새어 나간다.
+     *  ② 던진 예외를 화면이 받지 않아 **아무 일도 없는 것처럼** 보였다. 사용자는 삭제를 눌렀고
+     *     화면은 그대로였다. 거절을 조용히 하는 것은 실패보다 나쁘다.
+     * 이제 `{ok, errorCode, errorParams}` 로 낸다 — 화면이 `twin.compose.del.<code>` 로 말을 만든다.
+     */
+    deleteTwinSpace(spaceId: string, context: ResolverContext): Promise<any>;
+    /**
+     * 이미 있는 트윈을 이 현장으로 가져온다 — **소속 갱신**(이력 이전이 아니다).
+     *
+     * 저널·투영 행은 `instanceId` 로 매여 있어 트윈을 따라오고, 구역·표현은 공간의 것이라 남는다
+     * (근거·판정: `move-space.ts`). 그래서 이 뮤테이션이 쓰는 것은 두 곳뿐이다 —
+     * 레지스트리의 `spaceId` 와 저장된 model 의 `spaceId`(커널·보드가 같은 공간을 가리켜야 한다).
+     * 새 공간의 시간대로 `utcOffsetMinutes` 도 다시 파생한다(공간이 시간의 기준이다).
+     *
+     * `dryRun` 은 **같은 판정을 미리** 보여 준다 — 화면이 잃을 것을 먼저 말하고 사용자가 정한다.
+     * 판정을 두 벌로 두면 미리보기와 실제가 어긋나므로 한 함수를 두 번 부른다.
+     */
+    moveTwinToSpace(instanceId: string, spaceId: string, context: ResolverContext, dryRun?: boolean): Promise<any>;
+    /**
+     * 트윈을 현장에서 뗀다 — **어느 현장에도 속하지 않음**으로 되돌린다.
+     *
+     * 더하기·옮기기만 있으면 잘못 넣은 것을 되돌릴 수 없다. 떼도 저널·로케이션·설비는 트윈에 남고
+     * (`instanceId` 로 매여 있다), 구역·표현은 옛 현장에 남는다. 잃는 것은 **볼 무대**다 —
+     * 판정이 그것을 말한다(`judgeDetachTwinSpace`). `dryRun` 은 같은 판정을 미리 낸다.
+     */
+    detachTwinFromSpace(instanceId: string, context: ResolverContext, dryRun?: boolean): Promise<any>;
+    /**
+     * 공간 ↔ 트윈 ↔ 가시화 정합성 점검 — **사실을 모아 순수 판정에 넘긴다.**
+     *
+     * 세 축은 서로를 id 로만 가리키고 DB 가 그 참조를 지켜 주지 않는다. 트윈을 옮기거나 떼거나 원본을
+     * 다시 읽으면 아무 오류 없이 **가리킬 것이 없는 도형**과 **소속 없는 로케이션**이 남는다. 사람이
+     * 눈으로 대조하던 일을 기계가 한다(판정·근거: `space-integrity.ts`).
+     *
+     * `spaceId` 를 주면 그 현장만, 없으면 테넌트 전체를 본다.
+     */
+    twinSpaceIntegrity(context: ResolverContext, spaceId?: string): Promise<any[]>;
+    /**
+     * 기계적으로 고칠 수 있는 어긋남만 고친다 — **사람의 판단이 필요한 것은 손대지 않는다.**
+     *
+     * 지금 고치는 것은 하나다: **대표 표현 포인터**. 공간이 없는 표현 id 를 가리키고 있으면, 행의
+     * `isPrimary` 가 켜진 표현(없으면 첫 표현)으로 다시 가리키고, 표현이 없으면 비운다. 근거가 있고
+     * 답이 하나뿐인 부류라 자동으로 고쳐도 사실을 바꾸지 않는다.
+     *
+     * 폴리곤이 없는 구역·개체를 가리키는 것은 **고치지 않는다.** 그 도형을 지워야 하는지, 트윈을 다시
+     * 데려와야 하는지, 구역을 다시 그려야 하는지는 사람이 정할 일이다 — 기계가 고르면 사용자가 그린
+     * 도형이 조용히 사라진다.
+     */
+    repairTwinSpaceIntegrity(context: ResolverContext, spaceId?: string): Promise<any>;
     twinAreas(spaceId: string, context: ResolverContext): Promise<any[]>;
     saveTwinArea(spaceId: string, areaId: string, patch: any, context: ResolverContext): Promise<boolean>;
     deleteTwinArea(spaceId: string, areaId: string, context: ResolverContext): Promise<boolean>;

package/dist-server/service/twin-space/twin-space-resolver.js

@@ -9,26 +9,62 @@ const twin_space_representation_js_1 = require("./twin-space-representation.js")
 const twin_space_area_js_1 = require("./twin-space-area.js");
 const twin_area_js_1 = require("./twin-area.js");
 const twin_instance_js_1 = require("../twin-instance/twin-instance.js");
+const twin_audit_event_js_1 = require("../twin-audit/twin-audit-event.js");
+const index_js_1 = require("../../engine/index.js");
+const move_space_js_1 = require("./move-space.js");
+const space_integrity_js_1 = require("./space-integrity.js");
 /*
  * 공간 구성 채널(design/ui/space-composition.md) — Site(Space) + 복수 표현(Representation) + 영역(Area).
- * board 내용은 board-service Board 에(표현 config.boardId 참조, 중복 저장 금지). 모두 domain 스코프.
+ * model 내용은 board-service Board 에(표현 config.boardId 참조, 중복 저장 금지). 모두 domain 스코프.
  */
 let TwinSpaceResolver = class TwinSpaceResolver {
     /* ── Space(Site) ────────────────────────────────────────────────── */
+    /**
+     * 이 테넌트의 현장 목록.
+     *
+     * ── 세 번만 묻는다 (2026-08-13) ──────────────────────────────────────────
+     * 예전에는 현장마다 표현 수를 세고 인스턴스를 조회했다 — 현장 13곳이면 **질의 27번**이고, 첫
+     * 호출이 2.4초였다(헤더가 뜰 때마다 이 목록을 읽는다). 규모가 커지면 그대로 자란다.
+     *
+     * 이제 세 번 묻고 메모리에서 맞춘다: 현장 · 표현(공간 id 만) · 인스턴스(필요한 컬럼만).
+     * 표현은 **id 만 실어 온다**(`loadRelationIds`) — 설정 blob 을 읽어 세는 것은 낭비다.
+     */
     async twinSpaces(context) {
         const domainId = context.state.domain.id;
-        const rows = await (0, shell_1.getRepository)(twin_space_js_1.TwinSpace).find({ where: { domain: { id: domainId } }, order: { createdAt: 'ASC' } });
-        const out = [];
-        for (const r of rows) {
-            const representationCount = await (0, shell_1.getRepository)(twin_space_representation_js_1.TwinSpaceRepresentation).count({ where: { domain: { id: domainId }, space: { id: r.id } } });
-            // 벤치 여부·원본 참조 — 인스턴스 purpose 근거(1급). 사본 공간을 헤더 선택기에서 구별·선택 가능하게.
-            const insts = await (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance).find({ where: { domain: { id: domainId }, spaceId: r.spaceId } });
-            const benchInst = insts.find(i => i.purpose === 'bench');
-            const bench = !!benchInst;
-            const copyOf = benchInst?.copyOf;
-            out.push({ spaceId: r.spaceId, name: r.name, description: r.description, geo: r.geo, timezone: r.timezone, primaryRepresentationId: r.primaryRepresentationId, content: r.content, representationCount, bench, copyOf });
+        const [rows, reps, insts] = await Promise.all([
+            (0, shell_1.getRepository)(twin_space_js_1.TwinSpace).find({ where: { domain: { id: domainId } }, order: { createdAt: 'ASC' } }),
+            /* 관계를 **조인해서** 읽는다 — `loadRelationIds`+`select` 조합은 관계 자리를 비워 두어
+               표현 수가 전부 0 이 됐다(2026-08-13 실측으로 잡음). 조인 한 번이 현장마다 세는 것보다 싸다. */
+            (0, shell_1.getRepository)(twin_space_representation_js_1.TwinSpaceRepresentation).find({ where: { domain: { id: domainId } }, relations: { space: true } }),
+            (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance).find({ where: { domain: { id: domainId } }, select: { instanceId: true, spaceId: true, purpose: true, copyOf: true } })
+        ]);
+        const repCount = new Map();
+        for (const rep of reps) {
+            const sid = rep.space?.id;
+            if (sid)
+                repCount.set(sid, (repCount.get(sid) ?? 0) + 1);
         }
-        return out;
+        /* 벤치 여부·원본 참조 — 인스턴스 purpose 근거(1급). 사본 현장을 헤더 선택기에서 구별·선택 가능하게. */
+        const benchOf = new Map();
+        for (const i of insts)
+            if (i.purpose === 'bench' && i.spaceId && !benchOf.has(i.spaceId))
+                benchOf.set(i.spaceId, { copyOf: i.copyOf ?? undefined });
+        return rows.map(r => {
+            const bench = benchOf.get(r.spaceId);
+            return {
+                spaceId: r.spaceId,
+                name: r.name,
+                description: r.description,
+                geo: r.geo,
+                timezone: r.timezone,
+                primaryRepresentationId: r.primaryRepresentationId,
+                extentX: r.extentX,
+                extentY: r.extentY,
+                representationCount: repCount.get(r.id) ?? 0,
+                bench: !!bench,
+                copyOf: bench?.copyOf
+            };
+        });
     }
     /** 단건 — 표현(+영역) 트리 포함. */
     async twinSpace(spaceId, context) {
@@ -42,7 +78,7 @@ let TwinSpaceResolver = class TwinSpaceResolver {
             const areas = await (0, shell_1.getRepository)(twin_space_area_js_1.TwinSpaceArea).find({ where: { domain: { id: domainId }, representation: { id: rep.id } }, order: { createdAt: 'ASC' } });
             representations.push({ id: rep.id, type: rep.type, name: rep.name, seq: rep.seq, isPrimary: rep.isPrimary, config: rep.config, areas: areas.map(a => ({ id: a.id, name: a.name, type: a.type, geometry: a.geometry, drillTo: a.drillTo, binding: a.binding, style: a.style })) });
         }
-        return { spaceId: r.spaceId, name: r.name, description: r.description, geo: r.geo, timezone: r.timezone, primaryRepresentationId: r.primaryRepresentationId, content: r.content, representations };
+        return { spaceId: r.spaceId, name: r.name, description: r.description, geo: r.geo, timezone: r.timezone, primaryRepresentationId: r.primaryRepresentationId, extentX: r.extentX, extentY: r.extentY, representations };
     }
     async saveTwinSpace(spaceId, patch, context) {
         const repo = (0, shell_1.getRepository)(twin_space_js_1.TwinSpace);
@@ -53,13 +89,29 @@ let TwinSpaceResolver = class TwinSpaceResolver {
         await repo.save(repo.create({ ...(existing ?? {}), ...clean, domain: { id: domainId }, spaceId }));
         return true;
     }
+    /**
+     * 공간 삭제 — **이 공간의 트윈이 있으면 거절한다.** 그래서 트윈이 현장을 잃는 일은 없다.
+     *
+     * ── 왜 모양을 바꿨나 (2026-08-13) ────────────────────────────────────────
+     * 예전에는 `Boolean` 을 돌려주고 거절은 **한국어 문장을 던졌다.** 두 가지가 틀렸다:
+     *  ① 서버가 화면의 말을 정했다 — 일본어·스페인어 사용자에게 한국어가 새어 나간다.
+     *  ② 던진 예외를 화면이 받지 않아 **아무 일도 없는 것처럼** 보였다. 사용자는 삭제를 눌렀고
+     *     화면은 그대로였다. 거절을 조용히 하는 것은 실패보다 나쁘다.
+     * 이제 `{ok, errorCode, errorParams}` 로 낸다 — 화면이 `twin.compose.del.<code>` 로 말을 만든다.
+     */
     async deleteTwinSpace(spaceId, context) {
         const domainId = context.state.domain.id;
         // 라이프사이클 가드 — 이 공간에 바인딩된 트윈 인스턴스가 있으면 삭제 차단(dangling 방지).
         // spaceId 컬럼(space #3) 로 직접 질의 — 전 인스턴스 로드+JS필터 제거(효율·1급 질의).
         const bound = await (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance).find({ where: { domain: { id: domainId }, spaceId } });
         if (bound.length) {
-            throw new Error(`공간 "${spaceId}" 에 트윈 인스턴스 ${bound.length}개가 바인딩돼 있어 삭제할 수 없습니다. 먼저 트윈을 제거하세요 (${bound.map(i => i.instanceId).join(', ')}).`);
+            const twins = bound.map(i => i.name || i.instanceId);
+            return {
+                ok: false,
+                errorCode: 'space-has-twins',
+                errorParams: { spaceId, count: bound.length, twins: twins.slice(0, 5).join(', ') },
+                error: `space "${spaceId}" still has ${bound.length} twin(s) — remove or move them first (${twins.join(', ')})`
+            };
         }
         const space = await (0, shell_1.getRepository)(twin_space_js_1.TwinSpace).findOne({ where: { domain: { id: domainId }, spaceId } });
         if (space) {
@@ -70,7 +122,245 @@ let TwinSpaceResolver = class TwinSpaceResolver {
             await (0, shell_1.getRepository)(twin_area_js_1.TwinArea).delete({ domain: { id: domainId }, space: { id: space.id } }); // 논리 area 도 함께 정리
         }
         await (0, shell_1.getRepository)(twin_space_js_1.TwinSpace).delete({ domain: { id: domainId }, spaceId });
-        return true;
+        return { ok: true };
+    }
+    /**
+     * 이미 있는 트윈을 이 현장으로 가져온다 — **소속 갱신**(이력 이전이 아니다).
+     *
+     * 저널·투영 행은 `instanceId` 로 매여 있어 트윈을 따라오고, 구역·표현은 공간의 것이라 남는다
+     * (근거·판정: `move-space.ts`). 그래서 이 뮤테이션이 쓰는 것은 두 곳뿐이다 —
+     * 레지스트리의 `spaceId` 와 저장된 model 의 `spaceId`(커널·보드가 같은 공간을 가리켜야 한다).
+     * 새 공간의 시간대로 `utcOffsetMinutes` 도 다시 파생한다(공간이 시간의 기준이다).
+     *
+     * `dryRun` 은 **같은 판정을 미리** 보여 준다 — 화면이 잃을 것을 먼저 말하고 사용자가 정한다.
+     * 판정을 두 벌로 두면 미리보기와 실제가 어긋나므로 한 함수를 두 번 부른다.
+     */
+    async moveTwinToSpace(instanceId, spaceId, context, dryRun) {
+        const domainId = context.state.domain.id;
+        const instRepo = (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance);
+        const spaceRepo = (0, shell_1.getRepository)(twin_space_js_1.TwinSpace);
+        const inst = await instRepo.findOne({ where: { domain: { id: domainId }, instanceId } });
+        const from = inst?.spaceId ? await spaceRepo.findOne({ where: { domain: { id: domainId }, spaceId: inst.spaceId } }) : null;
+        const to = await spaceRepo.findOne({ where: { domain: { id: domainId }, spaceId } });
+        /* 판정에 필요한 사실만 모아 넘긴다 — 판정 자체는 순수 모듈이 한다. */
+        const toAreaIds = to
+            ? (await (0, shell_1.getRepository)(twin_area_js_1.TwinArea).find({ where: { domain: { id: domainId }, space: { id: to.id } } })).map(a => a.areaId)
+            : [];
+        const fromRepresentationCount = from
+            ? await (0, shell_1.getRepository)(twin_space_representation_js_1.TwinSpaceRepresentation).count({ where: { domain: { id: domainId }, space: { id: from.id } } })
+            : 0;
+        const model = inst?.model ?? {};
+        const areaRefs = (model.locations ?? []).map((l) => l?.parentId);
+        const judgement = (0, move_space_js_1.judgeMoveTwinSpace)({
+            instanceId: inst?.instanceId,
+            fromSpaceId: inst?.spaceId,
+            toSpaceId: spaceId,
+            toSpaceExists: !!to,
+            purpose: inst?.purpose,
+            running: !!inst && !!index_js_1.TwinEngine.runtime(domainId, instanceId),
+            fromTimezone: from?.timezone ?? undefined,
+            toTimezone: to?.timezone ?? undefined,
+            areaRefs,
+            toAreaIds,
+            fromRepresentationCount
+        });
+        if (judgement.refusal) {
+            const r = judgement.refusal;
+            return { ok: false, error: r.message, errorCode: r.code, errorParams: r.params, warnings: [] };
+        }
+        if (dryRun)
+            return { ok: true, dryRun: true, warnings: judgement.warnings };
+        /* 두 곳을 함께 쓴다 — 레지스트리와 model 이 다른 공간을 가리키면 보드·커널이 갈라진다. */
+        const moved = { ...model, spaceId };
+        const withTime = await index_js_1.TwinEngine.withSpaceTimeBase(moved, domainId, spaceId);
+        await instRepo.save(instRepo.create({ ...inst, spaceId, model: withTime }));
+        /*
+         * 감사 기록 — 소속을 바꾼 것은 사람의 결정이고, 나중에 "왜 이 트윈이 저 현장에 있나" 를 묻게 된다.
+         * 기록이 실패해도 이전 결과는 돌려준다(감사가 본업을 막지 않는다). 다만 삼키지 않고 로그에 남긴다.
+         */
+        try {
+            const repo = (0, shell_1.getRepository)(twin_audit_event_js_1.TwinAuditEvent);
+            await repo.save(repo.create({
+                domain: context.state.domain,
+                instanceId,
+                commandType: 'twin.moveToSpace',
+                accepted: true,
+                origin: 'user',
+                actorId: context.state.user?.id,
+                args: { from: inst?.spaceId ?? null, to: spaceId, warnings: judgement.warnings.map(w => w.code) }
+            }));
+        }
+        catch (err) {
+            console.error(`[twin-space] move audit not recorded for "${instanceId}"`, err);
+        }
+        return { ok: true, warnings: judgement.warnings };
+    }
+    /**
+     * 트윈을 현장에서 뗀다 — **어느 현장에도 속하지 않음**으로 되돌린다.
+     *
+     * 더하기·옮기기만 있으면 잘못 넣은 것을 되돌릴 수 없다. 떼도 저널·로케이션·설비는 트윈에 남고
+     * (`instanceId` 로 매여 있다), 구역·표현은 옛 현장에 남는다. 잃는 것은 **볼 무대**다 —
+     * 판정이 그것을 말한다(`judgeDetachTwinSpace`). `dryRun` 은 같은 판정을 미리 낸다.
+     */
+    async detachTwinFromSpace(instanceId, context, dryRun) {
+        const domainId = context.state.domain.id;
+        const instRepo = (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance);
+        const inst = await instRepo.findOne({ where: { domain: { id: domainId }, instanceId } });
+        const from = inst?.spaceId
+            ? await (0, shell_1.getRepository)(twin_space_js_1.TwinSpace).findOne({ where: { domain: { id: domainId }, spaceId: inst.spaceId } })
+            : null;
+        const fromRepresentationCount = from
+            ? await (0, shell_1.getRepository)(twin_space_representation_js_1.TwinSpaceRepresentation).count({ where: { domain: { id: domainId }, space: { id: from.id } } })
+            : 0;
+        const judgement = (0, move_space_js_1.judgeDetachTwinSpace)({
+            instanceId: inst?.instanceId,
+            fromSpaceId: inst?.spaceId,
+            purpose: inst?.purpose,
+            fromRepresentationCount,
+            fromTimezone: from?.timezone ?? undefined
+        });
+        if (judgement.refusal) {
+            const r = judgement.refusal;
+            return { ok: false, error: r.message, errorCode: r.code, errorParams: r.params, warnings: [] };
+        }
+        if (dryRun)
+            return { ok: true, dryRun: true, warnings: judgement.warnings };
+        /* 두 곳을 함께 비운다 — 레지스트리와 model 이 어긋나면 어느 쪽이 사실인지 알 수 없다.
+           시간 기준(utcOffsetMinutes)은 **남긴다**: 지우면 조용히 UTC 로 읽힌다(판정이 그렇게 말했다). */
+        const { spaceId: _dropped, ...model } = inst?.model ?? {};
+        await instRepo.update({ id: inst.id }, { spaceId: null, model });
+        try {
+            const repo = (0, shell_1.getRepository)(twin_audit_event_js_1.TwinAuditEvent);
+            await repo.save(repo.create({
+                domain: context.state.domain,
+                instanceId,
+                commandType: 'twin.detachFromSpace',
+                accepted: true,
+                origin: 'user',
+                actorId: context.state.user?.id,
+                args: { from: inst?.spaceId ?? null, warnings: judgement.warnings.map(w => w.code) }
+            }));
+        }
+        catch (err) {
+            console.error(`[twin-space] detach audit not recorded for "${instanceId}"`, err);
+        }
+        return { ok: true, warnings: judgement.warnings };
+    }
+    /**
+     * 공간 ↔ 트윈 ↔ 가시화 정합성 점검 — **사실을 모아 순수 판정에 넘긴다.**
+     *
+     * 세 축은 서로를 id 로만 가리키고 DB 가 그 참조를 지켜 주지 않는다. 트윈을 옮기거나 떼거나 원본을
+     * 다시 읽으면 아무 오류 없이 **가리킬 것이 없는 도형**과 **소속 없는 로케이션**이 남는다. 사람이
+     * 눈으로 대조하던 일을 기계가 한다(판정·근거: `space-integrity.ts`).
+     *
+     * `spaceId` 를 주면 그 현장만, 없으면 테넌트 전체를 본다.
+     */
+    async twinSpaceIntegrity(context, spaceId) {
+        const domainId = context.state.domain.id;
+        const spaceRows = await (0, shell_1.getRepository)(twin_space_js_1.TwinSpace).find({ where: { domain: { id: domainId } } });
+        const instRows = await (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance).find({ where: { domain: { id: domainId } } });
+        const repRows = await (0, shell_1.getRepository)(twin_space_representation_js_1.TwinSpaceRepresentation).find({ where: { domain: { id: domainId } }, relations: ['space'] });
+        const areaRows = await (0, shell_1.getRepository)(twin_area_js_1.TwinArea).find({ where: { domain: { id: domainId } }, relations: ['space'] });
+        const polyRows = await (0, shell_1.getRepository)(twin_space_area_js_1.TwinSpaceArea).find({ where: { domain: { id: domainId } }, relations: ['representation'] });
+        const areasBySpace = {};
+        for (const a of areaRows) {
+            const sid = a.space?.spaceId;
+            if (!sid)
+                continue;
+            (areasBySpace[sid] ??= []).push(a.areaId);
+        }
+        /*
+         * 폴리곤 바인딩의 실제 모양은 `{ groupId?, locationId?, locationIds? }` 다(지도 저작기 기준).
+         * 여러 로케이션을 묶은 도형은 **각각을 따로** 본다 — 하나만 끊겨도 그 도형은 반쯤 거짓이 된다.
+         */
+        const polysByRep = {};
+        for (const p of polyRows) {
+            const rid = p.representation?.id;
+            if (!rid)
+                continue;
+            const b = p.binding ?? {};
+            const list = polysByRep[rid] ??= [];
+            if (b.groupId)
+                list.push({ id: p.id, groupId: b.groupId });
+            const targets = [...(b.locationId ? [b.locationId] : []), ...(Array.isArray(b.locationIds) ? b.locationIds : [])];
+            for (const t of targets)
+                list.push({ id: p.id, targetKind: 'location', targetId: t });
+        }
+        /* 보드 id 는 표현 config 가 들고 있다 — 존재 확인은 보드 서비스의 일이므로, 여기서는 표현이
+           가리키는 값이 있는지만 본다(없는 보드까지 보려면 board-service 를 물어야 한다: 아래 주석). */
+        const boardIds = repRows.map(r => r.config?.boardId).filter(Boolean);
+        const findings = (0, space_integrity_js_1.checkSpaceIntegrity)({
+            spaces: spaceRows.map(s => ({ spaceId: s.spaceId, primaryRepresentationId: s.primaryRepresentationId })),
+            instances: instRows.map(i => {
+                const model = i.model ?? {};
+                /*
+                 * 어휘가 맞는지는 **실행 중인 트윈만** 답할 수 있다 — 커널이 무엇을 버렸는지는 런타임의 사실이다.
+                 * 정지한 트윈은 `undefined`(모른다)로 둔다. 저널을 다시 접어 알아내지는 않는다: 이 질의는
+                 * 테넌트 전체를 훑으므로 트윈마다 폴드를 걸면 정합성 점검이 가장 무거운 질의가 된다.
+                 */
+                const live = index_js_1.TwinEngine.isRunning(domainId, i.instanceId)
+                    ? index_js_1.TwinEngine.snapshot(domainId, i.instanceId)
+                    : undefined;
+                return {
+                    instanceId: i.instanceId,
+                    spaceId: i.spaceId,
+                    modelSpaceId: model.spaceId,
+                    purpose: i.purpose,
+                    locationIds: (model.locations ?? []).map((l) => l?.id).filter(Boolean),
+                    equipmentIds: (model.equipment ?? []).map((e) => e?.id).filter(Boolean),
+                    areaRefs: (model.locations ?? []).map((l) => l?.parentId),
+                    ...(Array.isArray(live?.unhandled) ? { unhandled: live.unhandled } : {})
+                };
+            }),
+            representations: repRows.map(r => ({
+                id: r.id,
+                spaceId: r.space?.spaceId ?? '',
+                type: r.type,
+                boardId: r.config?.boardId ?? null,
+                polygons: polysByRep[r.id] ?? []
+            })),
+            areasBySpace,
+            boardIds
+        });
+        const scoped = spaceId ? findings.filter(f => f.spaceId === spaceId || (!f.spaceId && !spaceId)) : findings;
+        return (0, space_integrity_js_1.sortFindings)(scoped);
+    }
+    /**
+     * 기계적으로 고칠 수 있는 어긋남만 고친다 — **사람의 판단이 필요한 것은 손대지 않는다.**
+     *
+     * 지금 고치는 것은 하나다: **대표 표현 포인터**. 공간이 없는 표현 id 를 가리키고 있으면, 행의
+     * `isPrimary` 가 켜진 표현(없으면 첫 표현)으로 다시 가리키고, 표현이 없으면 비운다. 근거가 있고
+     * 답이 하나뿐인 부류라 자동으로 고쳐도 사실을 바꾸지 않는다.
+     *
+     * 폴리곤이 없는 구역·개체를 가리키는 것은 **고치지 않는다.** 그 도형을 지워야 하는지, 트윈을 다시
+     * 데려와야 하는지, 구역을 다시 그려야 하는지는 사람이 정할 일이다 — 기계가 고르면 사용자가 그린
+     * 도형이 조용히 사라진다.
+     */
+    async repairTwinSpaceIntegrity(context, spaceId) {
+        const domainId = context.state.domain.id;
+        const spaceRepo = (0, shell_1.getRepository)(twin_space_js_1.TwinSpace);
+        const repRepo = (0, shell_1.getRepository)(twin_space_representation_js_1.TwinSpaceRepresentation);
+        const spaces = await spaceRepo.find({
+            where: spaceId ? { domain: { id: domainId }, spaceId } : { domain: { id: domainId } }
+        });
+        const repaired = [];
+        for (const space of spaces) {
+            const reps = await repRepo.find({ where: { domain: { id: domainId }, space: { id: space.id } }, order: { seq: 'ASC' } });
+            const pointer = (space.primaryRepresentationId ?? '').trim();
+            if (pointer && reps.some(r => r.id === pointer))
+                continue; /* 이미 옳다 */
+            const primary = reps.find(r => r.isPrimary) ?? reps[0];
+            const next = primary?.id ?? null;
+            if (pointer === (next ?? ''))
+                continue;
+            await spaceRepo.save(spaceRepo.create({ ...space, primaryRepresentationId: next }));
+            if (primary)
+                for (const r of reps)
+                    if (!!r.isPrimary !== (r.id === primary.id))
+                        await repRepo.save(repRepo.create({ ...r, isPrimary: r.id === primary.id }));
+            repaired.push({ spaceId: space.spaceId, code: 'primary-representation-missing', from: pointer || null, to: next });
+        }
+        return { ok: true, repaired, count: repaired.length };
     }
     /* ── Area(논리 구역, 표현 무관·공유·계층) — area 단일화 space #2 ─────── */
     async twinAreas(spaceId, context) {
@@ -196,13 +486,61 @@ tslib_1.__decorate([
 ], TwinSpaceResolver.prototype, "saveTwinSpace", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
-    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'Delete a Space and its representations/areas.' }),
+    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, {
+        description: 'Delete a Space and its representations/areas. Refused while twins still live in it (a twin never loses its site this way). Returns {ok, errorCode, errorParams}.'
+    }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('spaceId')),
     tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", [String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], TwinSpaceResolver.prototype, "deleteTwinSpace", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, {
+        description: 'Move an existing twin into a space (co-locate it as another lens). The journal and projected rows follow the twin; areas and representations stay with the old space. dryRun returns the same judgement without writing. Returns {ok, warnings, errorCode}.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('instanceId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('spaceId')),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('dryRun', { nullable: true, description: 'Judge only — report refusal/warnings without moving.' })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object, Boolean]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinSpaceResolver.prototype, "moveTwinToSpace", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, {
+        description: 'Detach a twin from its space (it ends up on no site). The journal and projected rows stay with the twin; areas and representations stay with the space. dryRun returns the same judgement without writing. Returns {ok, warnings, errorCode}.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('instanceId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('dryRun', { nullable: true, description: 'Judge only — report refusal/warnings without detaching.' })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, Boolean]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinSpaceResolver.prototype, "detachTwinFromSpace", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => [shell_1.ScalarObject], {
+        description: 'Check space ↔ twin ↔ visualization integrity: dangling site refs, registry/model mismatch, polygons binding areas or entities that are not there, primary representation, unbound board representations. Pass spaceId to check one site.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('spaceId', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinSpaceResolver.prototype, "twinSpaceIntegrity", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, {
+        description: 'Repair mechanically fixable space integrity findings (currently: a primary representation pointer that points nowhere). Dangling polygon bindings are left alone — that is a human decision. Returns {repaired:[{spaceId, code}], skipped}.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('spaceId', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinSpaceResolver.prototype, "repairTwinSpaceIntegrity", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Query)(returns => [shell_1.ScalarObject], { description: 'List logical areas (representation-agnostic hierarchy) of a space. (area unification)' }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('spaceId')),
@@ -234,7 +572,7 @@ tslib_1.__decorate([
 ], TwinSpaceResolver.prototype, "deleteTwinArea", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
-    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, { description: 'Create/update a representation (map|image|board). Returns {id}.' }),
+    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, { description: 'Create/update a representation (map|image|model). Returns {id}.' }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('spaceId')),
     tslib_1.__param(1, (0, type_graphql_1.Arg)('rep', type => shell_1.ScalarObject)),
     tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
@@ -263,7 +601,7 @@ tslib_1.__decorate([
 ], TwinSpaceResolver.prototype, "setPrimaryRepresentation", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
-    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, { description: 'Create/update a polygon area (geometry + drillTo board + binding). Returns {id}.' }),
+    (0, type_graphql_1.Mutation)(returns => shell_1.ScalarObject, { description: 'Create/update a polygon area (geometry + drillTo model + binding). Returns {id}.' }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('representationId')),
     tslib_1.__param(1, (0, type_graphql_1.Arg)('area', type => shell_1.ScalarObject)),
     tslib_1.__param(2, (0, type_graphql_1.Ctx)()),