@things-factory/board-import 10.0.0-beta.108

package/dist-server/service/extraction/pipeline.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHybrid = extractHybrid;
+const source_router_1 = require("./source-router");
+async function extractHybrid(input, ctx = {}, filename) {
+    const kind = await (0, source_router_1.detectSourceKind)(input, filename);
+    const set = (0, source_router_1.getExtractorSet)(kind);
+    if (!set) {
+        throw new Error(`[board-import/extraction] '${kind}' ExtractorSet 미등록 — registerExtractorSet 로 주입 필요`);
+    }
+    // 1. 기하(위치) + 2. 라벨(식별/스케일 단서) — 공유 추출.
+    const primitives = await set.geometry.extract(input, ctx);
+    const labels = set.labels ? await set.labels.extract(input, ctx) : [];
+    // 3. 시안 생성 — 전략 있으면 N안, 없으면 단일 default.
+    let drafts = set.variants
+        ? await set.variants.interpret(primitives, labels, set, ctx)
+        : [{ id: 'default', label: 'default', entities: await fuse(primitives, labels, set, ctx) }];
+    if (drafts.length === 0)
+        drafts = [{ id: 'default', label: 'default', entities: [] }];
+    // 4. 시안별 스케일 보정 + 5. 레이아웃 정리.
+    for (const d of drafts) {
+        if (set.scale)
+            applyScale(d.entities, await set.scale.calibrate(labels, primitives, ctx));
+        if (set.refiner)
+            d.entities = set.refiner.refine(d.entities, ctx);
+    }
+    return {
+        entities: drafts[0].entities,
+        variants: drafts,
+        bbox: outerBbox(drafts[0].entities),
+        sourceKind: kind
+    };
+}
+// ── 기본 융합 (스캐폴딩) ────────────────────────────────────────────────────────
+// 기하 프리미티브 → UniversalEntity, 가장 가까운 라벨을 name 으로 앵커.
+// TODO(본격): region 별 set.recognizer.recognize → attribs.semanticType/componentType + categoryHint.
+async function fuse(primitives, labels, set, ctx) {
+    return Promise.all(primitives.map(async (p, i) => {
+        const lbl = nearestLabel(p, labels);
+        if (p.entity) {
+            // 벡터: 이미 완전한 엔티티(타입/속성 보유) — 무손실 사용. name 없으면 근접 라벨로 보강.
+            const e = p.entity;
+            if (!e.attribs.name && lbl)
+                e.attribs = { ...e.attribs, name: lbl.text };
+            return e;
+        }
+        const e = primitiveToEntity(p, i);
+        if (lbl)
+            e.attribs.name = lbl.text;
+        // CV 등 bare 프리미티브 — Recognizer 로 의미(componentType) 부여. (좌표 아님)
+        if (set.recognizer) {
+            const region = lbl ? { ...p, meta: { ...p.meta, label: lbl.text } } : p;
+            const r = await set.recognizer.recognize(region, ctx);
+            if (r.componentType) {
+                e.attribs.semanticType = r.componentType;
+                e.attribs.confidence = r.confidence;
+            }
+            if (r.attribs)
+                Object.assign(e.attribs, r.attribs);
+        }
+        return e;
+    }));
+}
+function primitiveToEntity(p, i) {
+    const w = p.bbox.max.x - p.bbox.min.x;
+    const h = p.bbox.max.y - p.bbox.min.y;
+    return {
+        uid: `ext-${i}`,
+        kind: 'shape',
+        position: { x: p.bbox.min.x, y: p.bbox.min.y },
+        size: { width: w, height: h },
+        bbox: p.bbox,
+        attribs: {}
+    };
+}
+function center(b) {
+    return { x: (b.min.x + b.max.x) / 2, y: (b.min.y + b.max.y) / 2 };
+}
+function nearestLabel(p, labels) {
+    if (!labels.length)
+        return undefined;
+    const c = center(p.bbox);
+    let best;
+    let bestD = Infinity;
+    for (const l of labels) {
+        const lc = center(l.bbox);
+        const d = (lc.x - c.x) ** 2 + (lc.y - c.y) ** 2;
+        if (d < bestD) {
+            bestD = d;
+            best = l;
+        }
+    }
+    return best;
+}
+function applyScale(entities, s) {
+    const f = s.unitsPerPixel;
+    const ox = s.origin.x;
+    const oy = s.origin.y;
+    for (const e of entities) {
+        e.position = { x: (e.position.x - ox) * f, y: (e.position.y - oy) * f };
+        if (e.size)
+            e.size = { width: e.size.width * f, height: e.size.height * f };
+        e.bbox = {
+            min: { x: (e.bbox.min.x - ox) * f, y: (e.bbox.min.y - oy) * f },
+            max: { x: (e.bbox.max.x - ox) * f, y: (e.bbox.max.y - oy) * f }
+        };
+    }
+}
+function outerBbox(entities) {
+    if (!entities.length)
+        return { min: { x: 0, y: 0 }, max: { x: 0, y: 0 } };
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const e of entities) {
+        minX = Math.min(minX, e.bbox.min.x);
+        minY = Math.min(minY, e.bbox.min.y);
+        maxX = Math.max(maxX, e.bbox.max.x);
+        maxY = Math.max(maxY, e.bbox.max.y);
+    }
+    return { min: { x: minX, y: minY }, max: { x: maxX, y: maxY } };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist-server/service/extraction/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../server/service/extraction/pipeline.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 하이브리드 추출 파이프라인 (골격) — Phase Board-AI §3.8.\n *\n *   detect → geometry + labels → [VariantStrategy 또는 단일 fuse] → 시안별 scale → refine\n *\n * 기하는 *공유* (정확) → 시안들은 해석만 다름 → 3안 선택 UX 보존하되 셋 다 레이아웃 정상.\n * impl 은 ExtractorSet 으로 주입 (스캐폴딩엔 stub). 기존 어댑터 경로와 독립.\n */\nimport type { UniversalEntity, BoundingBox, AdapterInput } from '../types/index'\nimport type {\n  SourceKind,\n  ExtractorSet,\n  GeometricPrimitive,\n  Label,\n  VariantDraft,\n  ScaleResult,\n  ExtractionContext\n} from './contracts'\nimport { detectSourceKind, getExtractorSet } from './source-router'\n\nexport interface HybridExtractResult {\n  /** default 시안 entities (= variants[0]). */\n  entities: UniversalEntity[]\n  /** 다중 시안 (선택 UX). */\n  variants: VariantDraft[]\n  bbox: BoundingBox\n  sourceKind: SourceKind\n}\n\nexport async function extractHybrid(\n  input: AdapterInput,\n  ctx: ExtractionContext = {},\n  filename?: string\n): Promise<HybridExtractResult> {\n  const kind = await detectSourceKind(input, filename)\n  const set = getExtractorSet(kind)\n  if (!set) {\n    throw new Error(`[board-import/extraction] '${kind}' ExtractorSet 미등록 — registerExtractorSet 로 주입 필요`)\n  }\n\n  // 1. 기하(위치) + 2. 라벨(식별/스케일 단서) — 공유 추출.\n  const primitives = await set.geometry.extract(input, ctx)\n  const labels: Label[] = set.labels ? await set.labels.extract(input, ctx) : []\n\n  // 3. 시안 생성 — 전략 있으면 N안, 없으면 단일 default.\n  let drafts: VariantDraft[] = set.variants\n    ? await set.variants.interpret(primitives, labels, set, ctx)\n    : [{ id: 'default', label: 'default', entities: await fuse(primitives, labels, set, ctx) }]\n  if (drafts.length === 0) drafts = [{ id: 'default', label: 'default', entities: [] }]\n\n  // 4. 시안별 스케일 보정 + 5. 레이아웃 정리.\n  for (const d of drafts) {\n    if (set.scale) applyScale(d.entities, await set.scale.calibrate(labels, primitives, ctx))\n    if (set.refiner) d.entities = set.refiner.refine(d.entities, ctx)\n  }\n\n  return {\n    entities: drafts[0].entities,\n    variants: drafts,\n    bbox: outerBbox(drafts[0].entities),\n    sourceKind: kind\n  }\n}\n\n// ── 기본 융합 (스캐폴딩) ────────────────────────────────────────────────────────\n// 기하 프리미티브 → UniversalEntity, 가장 가까운 라벨을 name 으로 앵커.\n// TODO(본격): region 별 set.recognizer.recognize → attribs.semanticType/componentType + categoryHint.\nasync function fuse(\n  primitives: GeometricPrimitive[],\n  labels: Label[],\n  set: ExtractorSet,\n  ctx?: ExtractionContext\n): Promise<UniversalEntity[]> {\n  return Promise.all(\n    primitives.map(async (p, i) => {\n      const lbl = nearestLabel(p, labels)\n\n      if (p.entity) {\n        // 벡터: 이미 완전한 엔티티(타입/속성 보유) — 무손실 사용. name 없으면 근접 라벨로 보강.\n        const e = p.entity\n        if (!e.attribs.name && lbl) e.attribs = { ...e.attribs, name: lbl.text }\n        return e\n      }\n\n      const e = primitiveToEntity(p, i)\n      if (lbl) e.attribs.name = lbl.text\n\n      // CV 등 bare 프리미티브 — Recognizer 로 의미(componentType) 부여. (좌표 아님)\n      if (set.recognizer) {\n        const region = lbl ? { ...p, meta: { ...p.meta, label: lbl.text } } : p\n        const r = await set.recognizer.recognize(region, ctx)\n        if (r.componentType) {\n          e.attribs.semanticType = r.componentType\n          e.attribs.confidence = r.confidence\n        }\n        if (r.attribs) Object.assign(e.attribs, r.attribs)\n      }\n      return e\n    })\n  )\n}\n\nfunction primitiveToEntity(p: GeometricPrimitive, i: number): UniversalEntity {\n  const w = p.bbox.max.x - p.bbox.min.x\n  const h = p.bbox.max.y - p.bbox.min.y\n  return {\n    uid: `ext-${i}`,\n    kind: 'shape',\n    position: { x: p.bbox.min.x, y: p.bbox.min.y },\n    size: { width: w, height: h },\n    bbox: p.bbox,\n    attribs: {}\n  }\n}\n\nfunction center(b: BoundingBox) {\n  return { x: (b.min.x + b.max.x) / 2, y: (b.min.y + b.max.y) / 2 }\n}\n\nfunction nearestLabel(p: GeometricPrimitive, labels: Label[]): Label | undefined {\n  if (!labels.length) return undefined\n  const c = center(p.bbox)\n  let best: Label | undefined\n  let bestD = Infinity\n  for (const l of labels) {\n    const lc = center(l.bbox)\n    const d = (lc.x - c.x) ** 2 + (lc.y - c.y) ** 2\n    if (d < bestD) {\n      bestD = d\n      best = l\n    }\n  }\n  return best\n}\n\nfunction applyScale(entities: UniversalEntity[], s: ScaleResult): void {\n  const f = s.unitsPerPixel\n  const ox = s.origin.x\n  const oy = s.origin.y\n  for (const e of entities) {\n    e.position = { x: (e.position.x - ox) * f, y: (e.position.y - oy) * f }\n    if (e.size) e.size = { width: e.size.width * f, height: e.size.height * f }\n    e.bbox = {\n      min: { x: (e.bbox.min.x - ox) * f, y: (e.bbox.min.y - oy) * f },\n      max: { x: (e.bbox.max.x - ox) * f, y: (e.bbox.max.y - oy) * f }\n    }\n  }\n}\n\nfunction outerBbox(entities: UniversalEntity[]): BoundingBox {\n  if (!entities.length) return { min: { x: 0, y: 0 }, max: { x: 0, y: 0 } }\n  let minX = Infinity\n  let minY = Infinity\n  let maxX = -Infinity\n  let maxY = -Infinity\n  for (const e of entities) {\n    minX = Math.min(minX, e.bbox.min.x)\n    minY = Math.min(minY, e.bbox.min.y)\n    maxX = Math.max(maxX, e.bbox.max.x)\n    maxY = Math.max(maxY, e.bbox.max.y)\n  }\n  return { min: { x: minX, y: minY }, max: { x: maxX, y: maxY } }\n}\n"]}

package/dist-server/service/extraction/source-router.d.ts

@@ -0,0 +1,17 @@
+import type { AdapterInput } from '../types/index';
+import type { SourceKind, ExtractorSet } from './contracts';
+/**
+ * 입력 → 소스 분류. 현재는 확장자 기반의 1차 분류.
+ *  - pdf: vector 우선 가정 (실제론 vector/raster 페이지 판별 필요 — 추후).
+ *  - 비트맵: 일단 raster-topdown. top-down vs photo 세분은 VLM 1-pass 분류로 (추후).
+ */
+export declare function detectSourceKind(_input: AdapterInput, filename?: string): Promise<SourceKind>;
+export type ExtractorSetFactory = () => ExtractorSet;
+/** 소스별 추출기 묶음 등록 (impl 주입 지점). */
+export declare function registerExtractorSet(kind: SourceKind, factory: ExtractorSetFactory): void;
+/** 소스별 추출기 묶음 조회. 미등록 시 undefined. */
+export declare function getExtractorSet(kind: SourceKind): ExtractorSet | undefined;
+/** 등록된 소스 종류 (진단/검사용). */
+export declare function registeredSourceKinds(): SourceKind[];
+/** 등록 초기화 (테스트 격리 / 재구성용). */
+export declare function clearExtractorSets(): void;

package/dist-server/service/extraction/source-router.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectSourceKind = detectSourceKind;
+exports.registerExtractorSet = registerExtractorSet;
+exports.getExtractorSet = getExtractorSet;
+exports.registeredSourceKinds = registeredSourceKinds;
+exports.clearExtractorSets = clearExtractorSets;
+const VECTOR_EXT = new Set(['dxf', 'svg', 'ifc']);
+const RASTER_EXT = new Set(['png', 'jpg', 'jpeg', 'webp', 'gif', 'bmp']);
+/**
+ * 입력 → 소스 분류. 현재는 확장자 기반의 1차 분류.
+ *  - pdf: vector 우선 가정 (실제론 vector/raster 페이지 판별 필요 — 추후).
+ *  - 비트맵: 일단 raster-topdown. top-down vs photo 세분은 VLM 1-pass 분류로 (추후).
+ */
+async function detectSourceKind(_input, filename) {
+    const ext = (filename?.split('.').pop() || '').toLowerCase();
+    if (VECTOR_EXT.has(ext) || ext === 'pdf')
+        return 'vector';
+    if (RASTER_EXT.has(ext))
+        return 'raster-topdown';
+    return 'unknown';
+}
+const _registry = new Map();
+/** 소스별 추출기 묶음 등록 (impl 주입 지점). */
+function registerExtractorSet(kind, factory) {
+    _registry.set(kind, factory);
+}
+/** 소스별 추출기 묶음 조회. 미등록 시 undefined. */
+function getExtractorSet(kind) {
+    return _registry.get(kind)?.();
+}
+/** 등록된 소스 종류 (진단/검사용). */
+function registeredSourceKinds() {
+    return [..._registry.keys()];
+}
+/** 등록 초기화 (테스트 격리 / 재구성용). */
+function clearExtractorSets() {
+    _registry.clear();
+}
+//# sourceMappingURL=source-router.js.map

package/dist-server/service/extraction/source-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-router.js","sourceRoot":"","sources":["../../../server/service/extraction/source-router.ts"],"names":[],"mappings":";;AAeA,4CAKC;AAOD,oDAEC;AAGD,0CAEC;AAGD,sDAEC;AAGD,gDAEC;AArCD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;AACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;AAExE;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAAC,MAAoB,EAAE,QAAiB;IAC5E,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IAC5D,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAA;IACzD,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAChD,OAAO,SAAS,CAAA;AAClB,CAAC;AAID,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmC,CAAA;AAE5D,kCAAkC;AAClC,SAAgB,oBAAoB,CAAC,IAAgB,EAAE,OAA4B;IACjF,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC9B,CAAC;AAED,sCAAsC;AACtC,SAAgB,eAAe,CAAC,IAAgB;IAC9C,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;AAChC,CAAC;AAED,0BAA0B;AAC1B,SAAgB,qBAAqB;IACnC,OAAO,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;AAC9B,CAAC;AAED,8BAA8B;AAC9B,SAAgB,kBAAkB;IAChC,SAAS,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC","sourcesContent":["/*\n * 소스 라우팅 — 입력(+파일명)을 SourceKind 로 분류하고, 그 경로의 ExtractorSet 을 돌려준다.\n * impl 묶음은 register 로 주입 (스캐폴딩 단계엔 stub 묶음). 기존 어댑터 경로는 무관/보존.\n */\nimport type { AdapterInput } from '../types/index'\nimport type { SourceKind, ExtractorSet } from './contracts'\n\nconst VECTOR_EXT = new Set(['dxf', 'svg', 'ifc'])\nconst RASTER_EXT = new Set(['png', 'jpg', 'jpeg', 'webp', 'gif', 'bmp'])\n\n/**\n * 입력 → 소스 분류. 현재는 확장자 기반의 1차 분류.\n *  - pdf: vector 우선 가정 (실제론 vector/raster 페이지 판별 필요 — 추후).\n *  - 비트맵: 일단 raster-topdown. top-down vs photo 세분은 VLM 1-pass 분류로 (추후).\n */\nexport async function detectSourceKind(_input: AdapterInput, filename?: string): Promise<SourceKind> {\n  const ext = (filename?.split('.').pop() || '').toLowerCase()\n  if (VECTOR_EXT.has(ext) || ext === 'pdf') return 'vector'\n  if (RASTER_EXT.has(ext)) return 'raster-topdown'\n  return 'unknown'\n}\n\nexport type ExtractorSetFactory = () => ExtractorSet\n\nconst _registry = new Map<SourceKind, ExtractorSetFactory>()\n\n/** 소스별 추출기 묶음 등록 (impl 주입 지점). */\nexport function registerExtractorSet(kind: SourceKind, factory: ExtractorSetFactory): void {\n  _registry.set(kind, factory)\n}\n\n/** 소스별 추출기 묶음 조회. 미등록 시 undefined. */\nexport function getExtractorSet(kind: SourceKind): ExtractorSet | undefined {\n  return _registry.get(kind)?.()\n}\n\n/** 등록된 소스 종류 (진단/검사용). */\nexport function registeredSourceKinds(): SourceKind[] {\n  return [..._registry.keys()]\n}\n\n/** 등록 초기화 (테스트 격리 / 재구성용). */\nexport function clearExtractorSets(): void {\n  _registry.clear()\n}\n"]}

package/dist-server/service/extraction/stubs.d.ts

@@ -0,0 +1,18 @@
+import type { UniversalEntity } from '../types/index';
+import type { GeometryExtractor, LabelExtractor, LayoutRefiner, GeometricPrimitive, Label, ExtractionContext } from './contracts';
+export declare class CvGeometryExtractor implements GeometryExtractor {
+    readonly id = "cv-geometry";
+    extract(): Promise<GeometricPrimitive[]>;
+}
+export declare class CloudOcrLabelExtractor implements LabelExtractor {
+    readonly id = "cloud-ocr";
+    extract(): Promise<Label[]>;
+}
+/**
+ * 레이아웃 정리 stub — 정렬/스냅/겹침해소는 미구현이라 *그대로 통과*(no-op).
+ * (throw 가 아니라 안전한 항등 — refiner 미구현이어도 파이프라인이 깨지지 않도록.)
+ */
+export declare class IdentityLayoutRefiner implements LayoutRefiner {
+    readonly id = "identity";
+    refine(entities: UniversalEntity[], _ctx?: ExtractionContext): UniversalEntity[];
+}

package/dist-server/service/extraction/stubs.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityLayoutRefiner = exports.CloudOcrLabelExtractor = exports.CvGeometryExtractor = void 0;
+const NI = (what) => {
+    throw new Error(`[board-import/extraction] ${what} 미구현 (스캐폴딩) — Phase B 본격 테스트 단계에서 구현`);
+};
+class CvGeometryExtractor {
+    constructor() {
+        this.id = 'cv-geometry';
+    }
+    async extract() {
+        return NI('CvGeometryExtractor.extract (OpenCV 선/사각/연결성분)');
+    }
+}
+exports.CvGeometryExtractor = CvGeometryExtractor;
+class CloudOcrLabelExtractor {
+    constructor() {
+        this.id = 'cloud-ocr';
+    }
+    async extract() {
+        return NI('CloudOcrLabelExtractor.extract (GCP Vision / Textract)');
+    }
+}
+exports.CloudOcrLabelExtractor = CloudOcrLabelExtractor;
+/**
+ * 레이아웃 정리 stub — 정렬/스냅/겹침해소는 미구현이라 *그대로 통과*(no-op).
+ * (throw 가 아니라 안전한 항등 — refiner 미구현이어도 파이프라인이 깨지지 않도록.)
+ */
+class IdentityLayoutRefiner {
+    constructor() {
+        this.id = 'identity';
+    }
+    refine(entities, _ctx) {
+        return entities;
+    }
+}
+exports.IdentityLayoutRefiner = IdentityLayoutRefiner;
+//# sourceMappingURL=stubs.js.map

package/dist-server/service/extraction/stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../../server/service/extraction/stubs.ts"],"names":[],"mappings":";;;AAkBA,MAAM,EAAE,GAAG,CAAC,IAAY,EAAS,EAAE;IACjC,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,sCAAsC,CAAC,CAAA;AAC1F,CAAC,CAAA;AAED,MAAa,mBAAmB;IAAhC;QACW,OAAE,GAAG,aAAa,CAAA;IAI7B,CAAC;IAHC,KAAK,CAAC,OAAO;QACX,OAAO,EAAE,CAAC,gDAAgD,CAAC,CAAA;IAC7D,CAAC;CACF;AALD,kDAKC;AAED,MAAa,sBAAsB;IAAnC;QACW,OAAE,GAAG,WAAW,CAAA;IAI3B,CAAC;IAHC,KAAK,CAAC,OAAO;QACX,OAAO,EAAE,CAAC,wDAAwD,CAAC,CAAA;IACrE,CAAC;CACF;AALD,wDAKC;AAED;;;GAGG;AACH,MAAa,qBAAqB;IAAlC;QACW,OAAE,GAAG,UAAU,CAAA;IAI1B,CAAC;IAHC,MAAM,CAAC,QAA2B,EAAE,IAAwB;QAC1D,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AALD,sDAKC","sourcesContent":["/*\n * 스캐폴딩 stub 구현 — 구조가 컴파일·배선되도록 자리만 잡는다.\n * 남은 stub (본격 테스트 단계에서 소스 적합 impl 로 교체):\n *   CvGeometryExtractor   → OpenCV(선/사각/연결성분) 또는 Python 사이드카\n *   CloudOcrLabelExtractor → GCP Vision / AWS Textract / Tesseract\n * 미구현 stub 은 호출 시 명확히 throw — 실수로 live 경로에 붙어도 즉시 드러난다.\n * (실구현: VectorGeometryExtractor / GridSnapLayoutRefiner / VlmRecognizer / LabelScaleCalibrator)\n */\nimport type { UniversalEntity } from '../types/index'\nimport type {\n  GeometryExtractor,\n  LabelExtractor,\n  LayoutRefiner,\n  GeometricPrimitive,\n  Label,\n  ExtractionContext\n} from './contracts'\n\nconst NI = (what: string): never => {\n  throw new Error(`[board-import/extraction] ${what} 미구현 (스캐폴딩) — Phase B 본격 테스트 단계에서 구현`)\n}\n\nexport class CvGeometryExtractor implements GeometryExtractor {\n  readonly id = 'cv-geometry'\n  async extract(): Promise<GeometricPrimitive[]> {\n    return NI('CvGeometryExtractor.extract (OpenCV 선/사각/연결성분)')\n  }\n}\n\nexport class CloudOcrLabelExtractor implements LabelExtractor {\n  readonly id = 'cloud-ocr'\n  async extract(): Promise<Label[]> {\n    return NI('CloudOcrLabelExtractor.extract (GCP Vision / Textract)')\n  }\n}\n\n/**\n * 레이아웃 정리 stub — 정렬/스냅/겹침해소는 미구현이라 *그대로 통과*(no-op).\n * (throw 가 아니라 안전한 항등 — refiner 미구현이어도 파이프라인이 깨지지 않도록.)\n */\nexport class IdentityLayoutRefiner implements LayoutRefiner {\n  readonly id = 'identity'\n  refine(entities: UniversalEntity[], _ctx?: ExtractionContext): UniversalEntity[] {\n    return entities\n  }\n}\n"]}

package/dist-server/service/extraction/vector-geometry.d.ts

@@ -0,0 +1,7 @@
+import type { AdapterInput } from '../types/index';
+import type { GeometryExtractor, GeometricPrimitive, ExtractionContext } from './contracts';
+export declare class VectorGeometryExtractor implements GeometryExtractor {
+    readonly id = "vector-geometry";
+    private readonly dxf;
+    extract(input: AdapterInput, _ctx?: ExtractionContext): Promise<GeometricPrimitive[]>;
+}

package/dist-server/service/extraction/vector-geometry.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorGeometryExtractor = void 0;
+const dxf_adapter_1 = require("../adapters/dxf-adapter");
+class VectorGeometryExtractor {
+    constructor() {
+        this.id = 'vector-geometry';
+        this.dxf = new dxf_adapter_1.DxfAdapter();
+    }
+    async extract(input, _ctx) {
+        // 현재 DXF 만 지원. (SVG/IFC 확장 시 detect 로 어댑터 선택.)
+        const result = await this.dxf.parse(input);
+        return result.entities.map(e => ({
+            kind: e.kind === 'path' ? 'line' : 'rect',
+            bbox: e.bbox,
+            entity: e // 무손실 보존 — fuse 가 그대로 사용
+        }));
+    }
+}
+exports.VectorGeometryExtractor = VectorGeometryExtractor;
+//# sourceMappingURL=vector-geometry.js.map

package/dist-server/service/extraction/vector-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-geometry.js","sourceRoot":"","sources":["../../../server/service/extraction/vector-geometry.ts"],"names":[],"mappings":";;;AAUA,yDAAoD;AAEpD,MAAa,uBAAuB;IAApC;QACW,OAAE,GAAG,iBAAiB,CAAA;QACd,QAAG,GAAG,IAAI,wBAAU,EAAE,CAAA;IAWzC,CAAC;IATC,KAAK,CAAC,OAAO,CAAC,KAAmB,EAAE,IAAwB;QACzD,+CAA+C;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAE,MAAgB,CAAC,CAAC,CAAE,MAAgB;YAC/D,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,yBAAyB;SACpC,CAAC,CAAC,CAAA;IACL,CAAC;CACF;AAbD,0DAaC","sourcesContent":["/*\n * VectorGeometryExtractor — 벡터 소스(DXF 등)를 *직접 파싱*해 정밀 기하 추출.\n * Phase Board-AI §3.8 의 \"벡터 = 1순위 정밀 경로\". 기존 DxfAdapter 를 흡수(델리게이트):\n * DXF entity 는 이미 위치+크기+회전+attribs(name/layer/shape) 를 가진 UniversalEntity 이므로,\n * 각 엔티티를 GeometricPrimitive.entity 로 그대로 실어 *무손실* 전달한다.\n *\n * 추후: SVG / IFC 어댑터를 detect 로 분기해 같은 방식으로 흡수.\n */\nimport type { AdapterInput } from '../types/index'\nimport type { GeometryExtractor, GeometricPrimitive, ExtractionContext } from './contracts'\nimport { DxfAdapter } from '../adapters/dxf-adapter'\n\nexport class VectorGeometryExtractor implements GeometryExtractor {\n  readonly id = 'vector-geometry'\n  private readonly dxf = new DxfAdapter()\n\n  async extract(input: AdapterInput, _ctx?: ExtractionContext): Promise<GeometricPrimitive[]> {\n    // 현재 DXF 만 지원. (SVG/IFC 확장 시 detect 로 어댑터 선택.)\n    const result = await this.dxf.parse(input)\n    return result.entities.map(e => ({\n      kind: e.kind === 'path' ? ('line' as const) : ('rect' as const),\n      bbox: e.bbox,\n      entity: e // 무손실 보존 — fuse 가 그대로 사용\n    }))\n  }\n}\n"]}

package/dist-server/service/extraction/vlm-recognizer.d.ts

@@ -0,0 +1,18 @@
+import { type AIClient } from '@things-factory/ai-client-base';
+import type { Recognizer, RecognitionResult, GeometricPrimitive, ExtractionContext } from './contracts';
+interface RawRecognition {
+    componentType?: string | null;
+    confidence?: number;
+    attribs?: Record<string, any>;
+}
+export declare class VlmRecognizer implements Recognizer {
+    private readonly client?;
+    readonly id = "vlm-recognizer";
+    constructor(client?: AIClient);
+    recognize(region: GeometricPrimitive, ctx?: ExtractionContext): Promise<RecognitionResult>;
+}
+/** region 신호 + 카탈로그 → 인식 프롬프트. */
+export declare function buildPrompt(region: GeometricPrimitive, ctx?: ExtractionContext): string;
+/** 응답 정규화 + 카탈로그 그라운딩 + confidence 클램프. */
+export declare function normalize(raw: RawRecognition | null | undefined, catalog?: string[]): RecognitionResult;
+export {};

package/dist-server/service/extraction/vlm-recognizer.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VlmRecognizer = void 0;
+exports.buildPrompt = buildPrompt;
+exports.normalize = normalize;
+/*
+ * VlmRecognizer — region 이 *어떤 컴포넌트인지* 식별 (Phase Board-AI §3.8 의 Recognizer).
+ *
+ * 좌표/레이아웃은 절대 추정하지 않는다(그건 Geometry/CV 의 몫). VLM/LLM 의 강점인
+ * *의미 인식* 만: 주어진 신호(라벨·모양·크기·레이어) + 카탈로그 → componentType.
+ * 카탈로그(ctx.catalog) 가 있으면 그 안의 값만 허용(그라운딩).
+ *
+ * provider 는 ai-client-base 의 AIClient. 생성자 주입 가능(테스트), 미주입 시 기본 클라이언트.
+ */
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+const SYSTEM = '당신은 시설 도면의 한 영역(region)이 어떤 보드 컴포넌트 type 인지 판정하는 분류기다. ' +
+    '좌표/위치/크기를 추정하지 말고, 주어진 신호(라벨/모양/크기/레이어)와 카탈로그만으로 *type* 만 판정한다. ' +
+    'STRICT JSON 만 반환(마크다운/주석 금지).';
+class VlmRecognizer {
+    constructor(client) {
+        this.client = client;
+        this.id = 'vlm-recognizer';
+    }
+    async recognize(region, ctx) {
+        const client = this.client ?? (0, ai_client_base_1.getDefaultAIClient)();
+        if (!client) {
+            throw new Error('[board-import/extraction] VlmRecognizer 는 AIClient 가 필요합니다 (setDefaultAIClient / config.aiClient).');
+        }
+        const raw = await client.generateJSON(buildPrompt(region, ctx), {
+            systemPrompt: SYSTEM,
+            temperature: 0,
+            maxTokens: 300
+        });
+        return normalize(raw, ctx?.catalog);
+    }
+}
+exports.VlmRecognizer = VlmRecognizer;
+/** region 신호 + 카탈로그 → 인식 프롬프트. */
+function buildPrompt(region, ctx) {
+    const w = region.bbox.max.x - region.bbox.min.x;
+    const h = region.bbox.max.y - region.bbox.min.y;
+    const aspect = h !== 0 ? w / h : 0;
+    const a = region.entity?.attribs ?? {};
+    const m = region.meta ?? {};
+    const signals = [`kind=${region.kind}`, `size=${round(w)}x${round(h)}`, `aspect=${aspect.toFixed(2)}`];
+    const name = a.name ?? m.name ?? m.label;
+    if (name)
+        signals.push(`label="${name}"`);
+    if (a.shape ?? m.shape)
+        signals.push(`shape=${a.shape ?? m.shape}`);
+    if (a.layer ?? m.layer)
+        signals.push(`layer=${a.layer ?? m.layer}`);
+    if (a.text ?? m.text)
+        signals.push(`text="${a.text ?? m.text}"`);
+    const catalogLine = ctx?.catalog && ctx.catalog.length
+        ? `\n카탈로그(이 중에서만 선택, 맞는 게 없으면 componentType=null):\n${ctx.catalog.join(', ')}`
+        : '\n카탈로그 미지정 — 가장 적절한 컴포넌트 type 을 자유롭게 판정.';
+    const hint = ctx?.userPrompt ? `\n사용자 힌트: ${ctx.userPrompt}` : '';
+    return (`다음 영역의 신호로 보드 컴포넌트 type 을 판정하라.\n신호: ${signals.join(', ')}${catalogLine}${hint}\n` +
+        `반환 JSON: { "componentType": string|null, "confidence": 0..1, "attribs": { ... } }`);
+}
+/** 응답 정규화 + 카탈로그 그라운딩 + confidence 클램프. */
+function normalize(raw, catalog) {
+    let type = typeof raw?.componentType === 'string' && raw.componentType.trim() ? raw.componentType.trim() : undefined;
+    // 카탈로그 있으면 그 안의 값만 허용 — 그라운딩(환각 type 차단).
+    if (type && catalog && catalog.length && !catalog.includes(type))
+        type = undefined;
+    let conf = typeof raw?.confidence === 'number' && Number.isFinite(raw.confidence) ? raw.confidence : 0.5;
+    conf = Math.max(0, Math.min(1, conf));
+    if (!type)
+        conf = Math.min(conf, 0.3); // 타입 미상이면 신뢰도 상한
+    const attribs = raw?.attribs && typeof raw.attribs === 'object' ? raw.attribs : undefined;
+    return { componentType: type, confidence: conf, attribs };
+}
+function round(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=vlm-recognizer.js.map

package/dist-server/service/extraction/vlm-recognizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vlm-recognizer.js","sourceRoot":"","sources":["../../../server/service/extraction/vlm-recognizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * VlmRecognizer — region 이 *어떤 컴포넌트인지* 식별 (Phase Board-AI §3.8 의 Recognizer).\n *\n * 좌표/레이아웃은 절대 추정하지 않는다(그건 Geometry/CV 의 몫). VLM/LLM 의 강점인\n * *의미 인식* 만: 주어진 신호(라벨·모양·크기·레이어) + 카탈로그 → componentType.\n * 카탈로그(ctx.catalog) 가 있으면 그 안의 값만 허용(그라운딩).\n *\n * provider 는 ai-client-base 의 AIClient. 생성자 주입 가능(테스트), 미주입 시 기본 클라이언트.\n */\nimport { getDefaultAIClient, type AIClient } from '@things-factory/ai-client-base'\nimport type { Recognizer, RecognitionResult, GeometricPrimitive, ExtractionContext } from './contracts'\n\ninterface RawRecognition {\n  componentType?: string | null\n  confidence?: number\n  attribs?: Record<string, any>\n}\n\nconst SYSTEM =\n  '당신은 시설 도면의 한 영역(region)이 어떤 보드 컴포넌트 type 인지 판정하는 분류기다. ' +\n  '좌표/위치/크기를 추정하지 말고, 주어진 신호(라벨/모양/크기/레이어)와 카탈로그만으로 *type* 만 판정한다. ' +\n  'STRICT JSON 만 반환(마크다운/주석 금지).'\n\nexport class VlmRecognizer implements Recognizer {\n  readonly id = 'vlm-recognizer'\n\n  constructor(private readonly client?: AIClient) {}\n\n  async recognize(region: GeometricPrimitive, ctx?: ExtractionContext): Promise<RecognitionResult> {\n    const client = this.client ?? getDefaultAIClient()\n    if (!client) {\n      throw new Error('[board-import/extraction] VlmRecognizer 는 AIClient 가 필요합니다 (setDefaultAIClient / config.aiClient).')\n    }\n    const raw = await client.generateJSON<RawRecognition>(buildPrompt(region, ctx), {\n      systemPrompt: SYSTEM,\n      temperature: 0,\n      maxTokens: 300\n    })\n    return normalize(raw, ctx?.catalog)\n  }\n}\n\n/** region 신호 + 카탈로그 → 인식 프롬프트. */\nexport function buildPrompt(region: GeometricPrimitive, ctx?: ExtractionContext): string {\n  const w = region.bbox.max.x - region.bbox.min.x\n  const h = region.bbox.max.y - region.bbox.min.y\n  const aspect = h !== 0 ? w / h : 0\n  const a = region.entity?.attribs ?? {}\n  const m = region.meta ?? {}\n\n  const signals: string[] = [`kind=${region.kind}`, `size=${round(w)}x${round(h)}`, `aspect=${aspect.toFixed(2)}`]\n  const name = a.name ?? m.name ?? m.label\n  if (name) signals.push(`label=\"${name}\"`)\n  if (a.shape ?? m.shape) signals.push(`shape=${a.shape ?? m.shape}`)\n  if (a.layer ?? m.layer) signals.push(`layer=${a.layer ?? m.layer}`)\n  if (a.text ?? m.text) signals.push(`text=\"${a.text ?? m.text}\"`)\n\n  const catalogLine =\n    ctx?.catalog && ctx.catalog.length\n      ? `\\n카탈로그(이 중에서만 선택, 맞는 게 없으면 componentType=null):\\n${ctx.catalog.join(', ')}`\n      : '\\n카탈로그 미지정 — 가장 적절한 컴포넌트 type 을 자유롭게 판정.'\n  const hint = ctx?.userPrompt ? `\\n사용자 힌트: ${ctx.userPrompt}` : ''\n\n  return (\n    `다음 영역의 신호로 보드 컴포넌트 type 을 판정하라.\\n신호: ${signals.join(', ')}${catalogLine}${hint}\\n` +\n    `반환 JSON: { \"componentType\": string|null, \"confidence\": 0..1, \"attribs\": { ... } }`\n  )\n}\n\n/** 응답 정규화 + 카탈로그 그라운딩 + confidence 클램프. */\nexport function normalize(raw: RawRecognition | null | undefined, catalog?: string[]): RecognitionResult {\n  let type =\n    typeof raw?.componentType === 'string' && raw.componentType.trim() ? raw.componentType.trim() : undefined\n  // 카탈로그 있으면 그 안의 값만 허용 — 그라운딩(환각 type 차단).\n  if (type && catalog && catalog.length && !catalog.includes(type)) type = undefined\n\n  let conf = typeof raw?.confidence === 'number' && Number.isFinite(raw.confidence) ? raw.confidence : 0.5\n  conf = Math.max(0, Math.min(1, conf))\n  if (!type) conf = Math.min(conf, 0.3) // 타입 미상이면 신뢰도 상한\n\n  const attribs = raw?.attribs && typeof raw.attribs === 'object' ? raw.attribs : undefined\n  return { componentType: type, confidence: conf, attribs }\n}\n\nfunction round(n: number): number {\n  return Math.round(n * 100) / 100\n}\n"]}

package/dist-server/service/import-session/import-actions.d.ts

@@ -0,0 +1,79 @@
+/**
+ * board-import 의 ResolverContext 무관 service-level 함수.
+ *
+ * import-session-resolver 의 mutation/query 핵심 로직을 typeorm getRepository /
+ * ResolverContext 외부 의존성을 인자로 분리해 단위 테스트 + LLM tool builder 에서
+ * 재사용 가능하도록 추출. materializeFromSession 의 패턴 동일.
+ *
+ * 호출자 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출 후 deps 채워 호출
+ *   - import-tools.ts: ToolDispatchHelpers 가 builder 호출 시 ctx 에서 추출
+ */
+import type { ImportSession } from './import-session';
+export interface SessionRepoLike {
+    findOneBy(criteria: any): Promise<ImportSession | null>;
+    save(entity: any): Promise<ImportSession>;
+    find(options: any): Promise<ImportSession[]>;
+}
+export interface ImportActionsContext {
+    domain: {
+        id: string;
+        [k: string]: any;
+    };
+    user: any;
+}
+export interface StartImportJobInput {
+    attachmentId: string;
+    chatSessionId?: string;
+    scopes?: string[];
+    normalizeOrigin?: boolean;
+    flipY?: boolean;
+    scale?: number;
+    applyBinding?: boolean;
+    parseOptions?: any;
+    /**
+     * 사용자 자유서술 — 도면 설명 / 강조 부분 / 분류 힌트 등.
+     * VLM 이 view type 분류 + entity 추출 양쪽 패스에 모두 추가 컨텍스트로 사용.
+     */
+    userPrompt?: string;
+}
+/**
+ * 비동기 import job 시작. ImportSession 즉시 반환, 백그라운드에서 worker 실행.
+ *
+ * resolver 와 LLM tool builder 양쪽이 공유하는 진입점. side-effect 인 worker 가동도
+ * 본 함수에 묶음 — 사용자 입장에선 "단일 호출 = import 시작" 의미.
+ *
+ * `startWorker` 는 의존성 주입 — default 는 setImmediate(runImportJob). 단위 테스트는
+ * noop 주입해 worker chain 이 jest 환경에서 평가되지 않도록 한다 (typeorm DataSource init
+ * 안 된 환경에서 entity decorator 평가 시 fail 회피).
+ */
+export declare function startImportJobAsync(input: StartImportJobInput, context: ImportActionsContext, sessionRepo: SessionRepoLike, startWorker?: (sessionId: string) => void): Promise<ImportSession>;
+/**
+ * 단일 ImportSession 조회 (도메인 격리). 미존재면 null.
+ */
+export declare function fetchImportSession(sessionId: string, context: ImportActionsContext, sessionRepo: SessionRepoLike): Promise<ImportSession | null>;
+/**
+ * 한 ChatSession 안에서 발동된 ImportSession 목록 (최신순 50개). board-ai 의 chat 흐름이
+ * "이 chat 의 import 들 보여줘" 같은 호출에서 사용.
+ */
+export declare function listImportSessionsByChatSession(chatSessionId: string, context: ImportActionsContext, sessionRepo: SessionRepoLike): Promise<ImportSession[]>;
+/**
+ * 등록된 FormatAdapter 들의 능력 정보. context 무관 (인스턴스만 inspect).
+ * 외부 RPC 의존성도 없어 LLM 이 안전하게 호출 가능한 read tool.
+ */
+export interface AdapterInfo {
+    format: string;
+    supportedExtensions: string[];
+    capabilities: {
+        has2D: boolean;
+        has3D: boolean;
+        hasSemanticLabels: boolean;
+        hasTextLabels: boolean;
+        hasAttributes: boolean;
+    };
+}
+export declare function describeAdapter(adapter: {
+    format: string;
+    supportedExtensions: string[];
+    capabilities: any;
+}): AdapterInfo;

package/dist-server/service/import-session/import-actions.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * board-import 의 ResolverContext 무관 service-level 함수.
+ *
+ * import-session-resolver 의 mutation/query 핵심 로직을 typeorm getRepository /
+ * ResolverContext 외부 의존성을 인자로 분리해 단위 테스트 + LLM tool builder 에서
+ * 재사용 가능하도록 추출. materializeFromSession 의 패턴 동일.
+ *
+ * 호출자 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출 후 deps 채워 호출
+ *   - import-tools.ts: ToolDispatchHelpers 가 builder 호출 시 ctx 에서 추출
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startImportJobAsync = startImportJobAsync;
+exports.fetchImportSession = fetchImportSession;
+exports.listImportSessionsByChatSession = listImportSessionsByChatSession;
+exports.describeAdapter = describeAdapter;
+// ── service 함수들 ────────────────────────────────────────────────────
+/**
+ * 비동기 import job 시작. ImportSession 즉시 반환, 백그라운드에서 worker 실행.
+ *
+ * resolver 와 LLM tool builder 양쪽이 공유하는 진입점. side-effect 인 worker 가동도
+ * 본 함수에 묶음 — 사용자 입장에선 "단일 호출 = import 시작" 의미.
+ *
+ * `startWorker` 는 의존성 주입 — default 는 setImmediate(runImportJob). 단위 테스트는
+ * noop 주입해 worker chain 이 jest 환경에서 평가되지 않도록 한다 (typeorm DataSource init
+ * 안 된 환경에서 entity decorator 평가 시 fail 회피).
+ */
+async function startImportJobAsync(input, context, sessionRepo, startWorker = defaultStartWorker) {
+    const session = await sessionRepo.save({
+        domain: context.domain,
+        attachmentId: input.attachmentId,
+        chatSessionId: input.chatSessionId,
+        status: 'queued',
+        progress: 0,
+        message: 'Queued',
+        optionsJson: JSON.stringify({
+            scopes: input.scopes,
+            normalizeOrigin: input.normalizeOrigin,
+            flipY: input.flipY,
+            scale: input.scale,
+            applyBinding: input.applyBinding,
+            parseOptions: input.parseOptions,
+            userPrompt: input.userPrompt
+        }),
+        creator: context.user
+    });
+    // 백그라운드 worker 시작 — 의존성 주입으로 분리 (테스트 격리 + lazy require).
+    startWorker(session.id);
+    return session;
+}
+/**
+ * Default startWorker — setImmediate(runImportJob). worker module 은 lazy require 로
+ * module-level 평가 chain (attachment-base STORAGE, pipeline 의 adapters 등) 을 회피.
+ */
+function defaultStartWorker(sessionId) {
+    setImmediate(() => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { runImportJob } = require('./import-worker');
+        runImportJob(sessionId).catch((err) => {
+            console.error('[board-import] runImportJob unhandled:', err);
+        });
+    });
+}
+/**
+ * 단일 ImportSession 조회 (도메인 격리). 미존재면 null.
+ */
+async function fetchImportSession(sessionId, context, sessionRepo) {
+    return await sessionRepo.findOneBy({
+        id: sessionId,
+        domain: { id: context.domain.id }
+    });
+}
+/**
+ * 한 ChatSession 안에서 발동된 ImportSession 목록 (최신순 50개). board-ai 의 chat 흐름이
+ * "이 chat 의 import 들 보여줘" 같은 호출에서 사용.
+ */
+async function listImportSessionsByChatSession(chatSessionId, context, sessionRepo) {
+    return await sessionRepo.find({
+        where: { chatSessionId, domain: { id: context.domain.id } },
+        order: { createdAt: 'DESC' },
+        take: 50
+    });
+}
+function describeAdapter(adapter) {
+    return {
+        format: adapter.format,
+        supportedExtensions: [...adapter.supportedExtensions],
+        capabilities: {
+            has2D: !!adapter.capabilities.has2D,
+            has3D: !!adapter.capabilities.has3D,
+            hasSemanticLabels: !!adapter.capabilities.hasSemanticLabels,
+            hasTextLabels: !!adapter.capabilities.hasTextLabels,
+            hasAttributes: !!adapter.capabilities.hasAttributes
+        }
+    };
+}
+//# sourceMappingURL=import-actions.js.map

package/dist-server/service/import-session/import-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-actions.js","sourceRoot":"","sources":["../../../server/service/import-session/import-actions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA+CH,kDA4BC;AAmBD,gDASC;AAMD,0EAUC;AAkBD,0CAgBC;AAtHD,sEAAsE;AAEtE;;;;;;;;;GASG;AACI,KAAK,UAAU,mBAAmB,CACvC,KAA0B,EAC1B,OAA6B,EAC7B,WAA4B,EAC5B,cAA2C,kBAAkB;IAE7D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC;QACrC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;QACF,OAAO,EAAE,OAAO,CAAC,IAAI;KACf,CAAC,CAAA;IAET,yDAAyD;IACzD,WAAW,CAAC,OAAO,CAAC,EAAG,CAAC,CAAA;IACxB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,YAAY,CAAC,GAAG,EAAE;QAChB,8DAA8D;QAC9D,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACnD,YAAY,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YAC3C,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,OAA6B,EAC7B,WAA4B;IAE5B,OAAO,MAAM,WAAW,CAAC,SAAS,CAAC;QACjC,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;KAClC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,+BAA+B,CACnD,aAAqB,EACrB,OAA6B,EAC7B,WAA4B;IAE5B,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC;QAC5B,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE;QAC3D,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;QAC5B,IAAI,EAAE,EAAE;KACT,CAAC,CAAA;AACJ,CAAC;AAkBD,SAAgB,eAAe,CAAC,OAI/B;IACC,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,mBAAmB,EAAE,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACrD,YAAY,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK;YACnC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK;YACnC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,iBAAiB;YAC3D,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa;YACnD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa;SACpD;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * board-import 의 ResolverContext 무관 service-level 함수.\n *\n * import-session-resolver 의 mutation/query 핵심 로직을 typeorm getRepository /\n * ResolverContext 외부 의존성을 인자로 분리해 단위 테스트 + LLM tool builder 에서\n * 재사용 가능하도록 추출. materializeFromSession 의 패턴 동일.\n *\n * 호출자 책임:\n *   - resolver: getRepository / context.state 에서 도메인/유저 추출 후 deps 채워 호출\n *   - import-tools.ts: ToolDispatchHelpers 가 builder 호출 시 ctx 에서 추출\n */\n\n// type-only import — module level 에서 typeorm decorator chain 을 평가하지 않는다.\n// 단위 테스트 환경이 typeorm DataSource init 전에도 service 함수 검증할 수 있게 함.\nimport type { ImportSession } from './import-session'\n\n// ── 입력/의존성 타입 ──────────────────────────────────────────────────\n\nexport interface SessionRepoLike {\n  findOneBy(criteria: any): Promise<ImportSession | null>\n  save(entity: any): Promise<ImportSession>\n  find(options: any): Promise<ImportSession[]>\n}\n\nexport interface ImportActionsContext {\n  domain: { id: string; [k: string]: any }\n  user: any\n}\n\nexport interface StartImportJobInput {\n  attachmentId: string\n  chatSessionId?: string\n  scopes?: string[]\n  normalizeOrigin?: boolean\n  flipY?: boolean\n  scale?: number\n  applyBinding?: boolean\n  parseOptions?: any\n  /**\n   * 사용자 자유서술 — 도면 설명 / 강조 부분 / 분류 힌트 등.\n   * VLM 이 view type 분류 + entity 추출 양쪽 패스에 모두 추가 컨텍스트로 사용.\n   */\n  userPrompt?: string\n}\n\n// ── service 함수들 ────────────────────────────────────────────────────\n\n/**\n * 비동기 import job 시작. ImportSession 즉시 반환, 백그라운드에서 worker 실행.\n *\n * resolver 와 LLM tool builder 양쪽이 공유하는 진입점. side-effect 인 worker 가동도\n * 본 함수에 묶음 — 사용자 입장에선 \"단일 호출 = import 시작\" 의미.\n *\n * `startWorker` 는 의존성 주입 — default 는 setImmediate(runImportJob). 단위 테스트는\n * noop 주입해 worker chain 이 jest 환경에서 평가되지 않도록 한다 (typeorm DataSource init\n * 안 된 환경에서 entity decorator 평가 시 fail 회피).\n */\nexport async function startImportJobAsync(\n  input: StartImportJobInput,\n  context: ImportActionsContext,\n  sessionRepo: SessionRepoLike,\n  startWorker: (sessionId: string) => void = defaultStartWorker\n): Promise<ImportSession> {\n  const session = await sessionRepo.save({\n    domain: context.domain,\n    attachmentId: input.attachmentId,\n    chatSessionId: input.chatSessionId,\n    status: 'queued',\n    progress: 0,\n    message: 'Queued',\n    optionsJson: JSON.stringify({\n      scopes: input.scopes,\n      normalizeOrigin: input.normalizeOrigin,\n      flipY: input.flipY,\n      scale: input.scale,\n      applyBinding: input.applyBinding,\n      parseOptions: input.parseOptions,\n      userPrompt: input.userPrompt\n    }),\n    creator: context.user\n  } as any)\n\n  // 백그라운드 worker 시작 — 의존성 주입으로 분리 (테스트 격리 + lazy require).\n  startWorker(session.id!)\n  return session\n}\n\n/**\n * Default startWorker — setImmediate(runImportJob). worker module 은 lazy require 로\n * module-level 평가 chain (attachment-base STORAGE, pipeline 의 adapters 등) 을 회피.\n */\nfunction defaultStartWorker(sessionId: string): void {\n  setImmediate(() => {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { runImportJob } = require('./import-worker')\n    runImportJob(sessionId).catch((err: Error) => {\n      console.error('[board-import] runImportJob unhandled:', err)\n    })\n  })\n}\n\n/**\n * 단일 ImportSession 조회 (도메인 격리). 미존재면 null.\n */\nexport async function fetchImportSession(\n  sessionId: string,\n  context: ImportActionsContext,\n  sessionRepo: SessionRepoLike\n): Promise<ImportSession | null> {\n  return await sessionRepo.findOneBy({\n    id: sessionId,\n    domain: { id: context.domain.id }\n  })\n}\n\n/**\n * 한 ChatSession 안에서 발동된 ImportSession 목록 (최신순 50개). board-ai 의 chat 흐름이\n * \"이 chat 의 import 들 보여줘\" 같은 호출에서 사용.\n */\nexport async function listImportSessionsByChatSession(\n  chatSessionId: string,\n  context: ImportActionsContext,\n  sessionRepo: SessionRepoLike\n): Promise<ImportSession[]> {\n  return await sessionRepo.find({\n    where: { chatSessionId, domain: { id: context.domain.id } },\n    order: { createdAt: 'DESC' },\n    take: 50\n  })\n}\n\n/**\n * 등록된 FormatAdapter 들의 능력 정보. context 무관 (인스턴스만 inspect).\n * 외부 RPC 의존성도 없어 LLM 이 안전하게 호출 가능한 read tool.\n */\nexport interface AdapterInfo {\n  format: string\n  supportedExtensions: string[]\n  capabilities: {\n    has2D: boolean\n    has3D: boolean\n    hasSemanticLabels: boolean\n    hasTextLabels: boolean\n    hasAttributes: boolean\n  }\n}\n\nexport function describeAdapter(adapter: {\n  format: string\n  supportedExtensions: string[]\n  capabilities: any\n}): AdapterInfo {\n  return {\n    format: adapter.format,\n    supportedExtensions: [...adapter.supportedExtensions],\n    capabilities: {\n      has2D: !!adapter.capabilities.has2D,\n      has3D: !!adapter.capabilities.has3D,\n      hasSemanticLabels: !!adapter.capabilities.hasSemanticLabels,\n      hasTextLabels: !!adapter.capabilities.hasTextLabels,\n      hasAttributes: !!adapter.capabilities.hasAttributes\n    }\n  }\n}\n"]}