@things-factory/board-import 10.0.0-beta.71 → 10.0.0-beta.73

package/dist-server/service/import-session/materialize-from-session.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * materializeFromSession — ImportSession.result.boardModel → 신규 Board 영속화의 **순수 비즈니스
+ * 로직**. typeorm `getRepository` / `ResolverContext` 같은 외부 의존성을 인자로 분리해서 단위
+ * 테스트 가능하도록 구성. resolver 측 mutation 은 IO (repo, ctx) 만 wiring 해서 이 함수를 호출.
+ *
+ * 호출 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출
+ *   - 이 함수: 검증 → 정책 적용 → save 호출 → 결과 반환
+ *
+ * 정책:
+ *   - ImportSession.status 가 'completed' 가 아니면 거절
+ *   - result.boardModel 이 없으면 거절
+ *   - Board.name 이 같은 도메인에 이미 있으면 거절 (createBoard 와 동일 정책)
+ *   - 새 보드는 sortOrder = (현재 최소 sortOrder - 1) 또는 0 (createBoard 와 동일 정책)
+ *   - state='draft', sourceImportSessionId=session.id, model=JSON.stringify(boardModel)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materializeFromSession = materializeFromSession;
+const EMPTY_THUMBNAIL = 'data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==';
+/**
+ * ImportSession 결과를 새 Board 로 저장. 검증 실패 시 throw, 성공 시 저장된 Board 반환.
+ */
+async function materializeFromSession(session, input, context, deps) {
+    if (!session) {
+        throw new Error(`ImportSession ${input.sessionId} not found`);
+    }
+    if (session.status !== 'completed') {
+        throw new Error(`ImportSession ${input.sessionId} is not completed (status=${session.status}); cannot materialize.`);
+    }
+    const boardModel = pickVariantBoardModel(session.result, input.variantId);
+    if (!boardModel) {
+        throw new Error(`ImportSession ${input.sessionId} has no boardModel in result.`);
+    }
+    const existing = await deps.boardRepo.findOneBy({
+        name: input.name,
+        domain: { id: context.domain.id }
+    });
+    if (existing) {
+        throw new Error(`Board name '${input.name}' is already taken`);
+    }
+    const group = input.groupId ? (await deps.groupRepo.findOneBy({ id: input.groupId })) ?? undefined : undefined;
+    const nextSortOrder = await resolveNextSortOrder(deps.boardRepo, context.domain.id);
+    return await deps.boardRepo.save({
+        domain: context.domain,
+        name: input.name,
+        description: input.description,
+        type: input.type ?? 'main',
+        thumbnail: input.thumbnail || EMPTY_THUMBNAIL,
+        model: JSON.stringify(boardModel),
+        sourceImportSessionId: session.id,
+        group,
+        sortOrder: nextSortOrder,
+        state: 'draft',
+        creator: context.user,
+        updater: context.user
+    });
+}
+/**
+ * 시안 (variant) 선택 — 사용자가 명시한 variantId > session.result.defaultVariantId > 첫 variant
+ * > 구버전 호환 (session.result.boardModel).
+ */
+function pickVariantBoardModel(result, variantId) {
+    if (!result)
+        return undefined;
+    const variants = Array.isArray(result.variants) ? result.variants : [];
+    if (variants.length > 0) {
+        if (variantId) {
+            const found = variants.find(v => v.id === variantId);
+            if (found?.boardModel)
+                return found.boardModel;
+        }
+        if (result.defaultVariantId) {
+            const found = variants.find(v => v.id === result.defaultVariantId);
+            if (found?.boardModel)
+                return found.boardModel;
+        }
+        if (variants[0]?.boardModel)
+            return variants[0].boardModel;
+    }
+    // back-compat — 구버전 ImportSession (variants 미존재) 의 단일 boardModel
+    return result.boardModel;
+}
+/**
+ * sortOrder = MIN(sortOrder) - 1, 미존재 시 0. createBoard 의 "맨 앞에 배치" 정책과 동일.
+ * createQueryBuilder 미지원 환경 (예: 단위 테스트의 minimal mock) 에서는 0 fallback.
+ */
+async function resolveNextSortOrder(repo, domainId) {
+    if (!repo.createQueryBuilder)
+        return 0;
+    try {
+        const raw = await repo
+            .createQueryBuilder('board')
+            .select('MIN(board.sortOrder)', 'minSortOrder')
+            .where('board.domain = :domainId', { domainId })
+            .getRawOne();
+        const min = raw?.minSortOrder;
+        return typeof min === 'number' && Number.isFinite(min) ? min - 1 : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=materialize-from-session.js.map

package/dist-server/service/import-session/materialize-from-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-from-session.js","sourceRoot":"","sources":["../../../server/service/import-session/materialize-from-session.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * materializeFromSession — ImportSession.result.boardModel → 신규 Board 영속화의 **순수 비즈니스\n * 로직**. typeorm `getRepository` / `ResolverContext` 같은 외부 의존성을 인자로 분리해서 단위\n * 테스트 가능하도록 구성. resolver 측 mutation 은 IO (repo, ctx) 만 wiring 해서 이 함수를 호출.\n *\n * 호출 책임:\n *   - resolver: getRepository / context.state 에서 도메인/유저 추출\n *   - 이 함수: 검증 → 정책 적용 → save 호출 → 결과 반환\n *\n * 정책:\n *   - ImportSession.status 가 'completed' 가 아니면 거절\n *   - result.boardModel 이 없으면 거절\n *   - Board.name 이 같은 도메인에 이미 있으면 거절 (createBoard 와 동일 정책)\n *   - 새 보드는 sortOrder = (현재 최소 sortOrder - 1) 또는 0 (createBoard 와 동일 정책)\n *   - state='draft', sourceImportSessionId=session.id, model=JSON.stringify(boardModel)\n */\n\nconst EMPTY_THUMBNAIL = 'data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw=='\n\nexport interface MaterializeRequest {\n  sessionId: string\n  name: string\n  description?: string\n  groupId?: string\n  type?: 'main' | 'sub' | 'popup'\n  thumbnail?: string\n  /** 사용자가 선택한 시안 id. 미지정 시 session.result.defaultVariantId 또는 첫 variant. */\n  variantId?: string\n}\n\nexport interface SessionLike {\n  id: string\n  status: string\n  result?: {\n    boardModel?: any\n    variants?: Array<{ id: string; boardModel: any }>\n    defaultVariantId?: string\n  } | null\n}\n\nexport interface BoardRepoLike {\n  findOneBy(criteria: any): Promise<any | null>\n  save(entity: any): Promise<any>\n  /** sortOrder 결정용 — 미존재 시 0 으로 fallback. */\n  createQueryBuilder?(alias: string): {\n    select(expr: string, alias: string): any\n    where(cond: string, params: any): any\n    getRawOne(): Promise<any>\n  }\n}\n\nexport interface GroupRepoLike {\n  findOneBy(criteria: any): Promise<any | null>\n}\n\nexport interface MaterializeContext {\n  domain: { id: string; [k: string]: any }\n  user: any\n}\n\nexport interface MaterializeDeps {\n  boardRepo: BoardRepoLike\n  groupRepo: GroupRepoLike\n}\n\n/**\n * ImportSession 결과를 새 Board 로 저장. 검증 실패 시 throw, 성공 시 저장된 Board 반환.\n */\nexport async function materializeFromSession(\n  session: SessionLike | null,\n  input: MaterializeRequest,\n  context: MaterializeContext,\n  deps: MaterializeDeps\n): Promise<any> {\n  if (!session) {\n    throw new Error(`ImportSession ${input.sessionId} not found`)\n  }\n  if (session.status !== 'completed') {\n    throw new Error(\n      `ImportSession ${input.sessionId} is not completed (status=${session.status}); cannot materialize.`\n    )\n  }\n  const boardModel = pickVariantBoardModel(session.result, input.variantId)\n  if (!boardModel) {\n    throw new Error(`ImportSession ${input.sessionId} has no boardModel in result.`)\n  }\n\n  const existing = await deps.boardRepo.findOneBy({\n    name: input.name,\n    domain: { id: context.domain.id }\n  })\n  if (existing) {\n    throw new Error(`Board name '${input.name}' is already taken`)\n  }\n\n  const group = input.groupId ? (await deps.groupRepo.findOneBy({ id: input.groupId })) ?? undefined : undefined\n\n  const nextSortOrder = await resolveNextSortOrder(deps.boardRepo, context.domain.id)\n\n  return await deps.boardRepo.save({\n    domain: context.domain,\n    name: input.name,\n    description: input.description,\n    type: input.type ?? 'main',\n    thumbnail: input.thumbnail || EMPTY_THUMBNAIL,\n    model: JSON.stringify(boardModel),\n    sourceImportSessionId: session.id,\n    group,\n    sortOrder: nextSortOrder,\n    state: 'draft',\n    creator: context.user,\n    updater: context.user\n  })\n}\n\n/**\n * 시안 (variant) 선택 — 사용자가 명시한 variantId > session.result.defaultVariantId > 첫 variant\n * > 구버전 호환 (session.result.boardModel).\n */\nfunction pickVariantBoardModel(\n  result: SessionLike['result'],\n  variantId?: string\n): any | undefined {\n  if (!result) return undefined\n  const variants = Array.isArray(result.variants) ? result.variants : []\n  if (variants.length > 0) {\n    if (variantId) {\n      const found = variants.find(v => v.id === variantId)\n      if (found?.boardModel) return found.boardModel\n    }\n    if (result.defaultVariantId) {\n      const found = variants.find(v => v.id === result.defaultVariantId)\n      if (found?.boardModel) return found.boardModel\n    }\n    if (variants[0]?.boardModel) return variants[0].boardModel\n  }\n  // back-compat — 구버전 ImportSession (variants 미존재) 의 단일 boardModel\n  return result.boardModel\n}\n\n/**\n * sortOrder = MIN(sortOrder) - 1, 미존재 시 0. createBoard 의 \"맨 앞에 배치\" 정책과 동일.\n * createQueryBuilder 미지원 환경 (예: 단위 테스트의 minimal mock) 에서는 0 fallback.\n */\nasync function resolveNextSortOrder(repo: BoardRepoLike, domainId: string): Promise<number> {\n  if (!repo.createQueryBuilder) return 0\n  try {\n    const raw = await repo\n      .createQueryBuilder('board')\n      .select('MIN(board.sortOrder)', 'minSortOrder')\n      .where('board.domain = :domainId', { domainId })\n      .getRawOne()\n    const min = raw?.minSortOrder\n    return typeof min === 'number' && Number.isFinite(min) ? min - 1 : 0\n  } catch {\n    return 0\n  }\n}\n"]}

package/dist-server/service/import-session/suggest-board-name.d.ts

@@ -0,0 +1,80 @@
+/**
+ * suggestBoardName — ImportSession 으로부터 새 Board 의 후보 이름을 추천한다.
+ *
+ * 정책:
+ *   1) base 후보 우선순위: input.hint → session.options.userPrompt → session.result.metadata.viewTypeReasoning
+ *      → attachment.name stem → 'Imported board'
+ *   2) base 정규화: 확장자 제거, _-. → 공백, 다중 공백 단일화, 50자 절단, trim
+ *   3) 도메인 격리 + 단일 LIKE query: `WHERE domain_id = ? AND (name = base OR name LIKE 'base (%)')`
+ *      한 번에 충돌 후보 다 가져오고 메모리에서 사용 가능한 가장 작은 (n) 결정
+ *   4) 결과: base 가 충돌 없으면 base, 있으면 'base (2)' / 'base (3)' / ...
+ *
+ * materializeFromSession 과 동일한 *RepoLike 패턴 — typeorm 의존성 주입으로 단위테스트 가능.
+ */
+export interface SuggestBoardNameInput {
+    /** ImportSession id — 옵션. 있으면 거기서 hint / attachment 정보 추출. */
+    sessionId?: string;
+    /**
+     * 명시 hint. session 정보보다 우선. 사용자가 wizard 에서 직접 메모를 쳐서 그것 기반 추천을
+     * 받고 싶을 때 사용.
+     */
+    hint?: string;
+}
+export interface SessionForSuggest {
+    id: string;
+    attachmentId?: string;
+    optionsJson?: string | null;
+    resultJson?: string | null;
+}
+export interface AttachmentForSuggest {
+    id: string;
+    name?: string;
+}
+export interface SuggestSessionRepoLike {
+    findOneBy(criteria: any): Promise<SessionForSuggest | null>;
+}
+export interface SuggestAttachmentRepoLike {
+    findOneBy(criteria: any): Promise<AttachmentForSuggest | null>;
+}
+export interface SuggestBoardRepoLike {
+    /**
+     * 도메인 격리된 LIKE 쿼리. find({ where: { name: Like('base%'), domain: { id } } }) 형태로
+     * 호출자가 wiring. typeorm Like operator 노출을 피하기 위해 단순 string 으로 받음.
+     */
+    findExistingNames(opts: {
+        domainId: string;
+        basePrefix: string;
+    }): Promise<string[]>;
+}
+export interface SuggestContext {
+    domain: {
+        id: string;
+        [k: string]: any;
+    };
+}
+export interface SuggestDeps {
+    sessionRepo: SuggestSessionRepoLike;
+    attachmentRepo: SuggestAttachmentRepoLike;
+    boardRepo: SuggestBoardRepoLike;
+}
+export declare function suggestBoardName(input: SuggestBoardNameInput, context: SuggestContext, deps: SuggestDeps): Promise<string>;
+/**
+ * Board 이름 + 설명을 함께 추천. 이름은 짧고 심플 (운영 카드/리스트 표시용),
+ * 설명은 자세히 (사용자 hint + AI importStrategy + 통계 요약).
+ *
+ * 정책:
+ *   - **name**: hint / userPrompt / VLM reasoning / attachment stem 에서 짧은 base 추출 후
+ *     30자 이내로 자르고, 충돌 검사 + (n) suffix
+ *   - **description**: userPrompt + AI importStrategy + (있으면) reasoning + 카테고리 분포
+ *     를 자연어 단락으로 합성. 없으면 빈 문자열
+ */
+export interface SuggestBoardMetaResult {
+    name: string;
+    description: string;
+}
+export declare function suggestBoardMeta(input: SuggestBoardNameInput, context: SuggestContext, deps: SuggestDeps): Promise<SuggestBoardMetaResult>;
+/**
+ * existingNames 안에서 base 가 그대로 비어있으면 base 반환, 아니면 'base (2)', '(3)', ...
+ * case-insensitive 비교 (postgres ilike 호환).
+ */
+export declare function pickAvailableSuffix(base: string, existingNames: string[]): string;

package/dist-server/service/import-session/suggest-board-name.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * suggestBoardName — ImportSession 으로부터 새 Board 의 후보 이름을 추천한다.
+ *
+ * 정책:
+ *   1) base 후보 우선순위: input.hint → session.options.userPrompt → session.result.metadata.viewTypeReasoning
+ *      → attachment.name stem → 'Imported board'
+ *   2) base 정규화: 확장자 제거, _-. → 공백, 다중 공백 단일화, 50자 절단, trim
+ *   3) 도메인 격리 + 단일 LIKE query: `WHERE domain_id = ? AND (name = base OR name LIKE 'base (%)')`
+ *      한 번에 충돌 후보 다 가져오고 메모리에서 사용 가능한 가장 작은 (n) 결정
+ *   4) 결과: base 가 충돌 없으면 base, 있으면 'base (2)' / 'base (3)' / ...
+ *
+ * materializeFromSession 과 동일한 *RepoLike 패턴 — typeorm 의존성 주입으로 단위테스트 가능.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestBoardName = suggestBoardName;
+exports.suggestBoardMeta = suggestBoardMeta;
+exports.pickAvailableSuffix = pickAvailableSuffix;
+const FALLBACK = 'Imported board';
+async function suggestBoardName(input, context, deps) {
+    const base = await resolveBaseName(input, context, deps);
+    const cleaned = sanitize(base) || FALLBACK;
+    const existingNames = await deps.boardRepo.findExistingNames({
+        domainId: context.domain.id,
+        basePrefix: cleaned
+    });
+    return pickAvailableSuffix(cleaned, existingNames);
+}
+async function suggestBoardMeta(input, context, deps) {
+    // 보드 정체성 = AI 가 도면을 보고 식별한 subject. import 처리 메타 (importStrategy /
+    // categoryDist / userPrompt — AI 에게 한 지시) 와는 별 차원이라 영속 데이터에 섞지 않는다.
+    const { subjectName, subjectDescription } = await resolveSubject(input, context, deps);
+    // name: subjectName > input.hint > attachment.name stem > FALLBACK
+    // 사용자가 명시 hint 를 줬으면 그것이 우선 (직접 의도). VLM subjectName 은 그 다음.
+    const baseName = (input.hint && input.hint.trim() && firstSentence(input.hint)) ||
+        subjectName ||
+        (await resolveAttachmentStem(input, context, deps)) ||
+        FALLBACK;
+    const cleanedName = shortenName(sanitize(baseName) || FALLBACK);
+    const existingNames = await deps.boardRepo.findExistingNames({
+        domainId: context.domain.id,
+        basePrefix: cleanedName
+    });
+    const name = pickAvailableSuffix(cleanedName, existingNames);
+    // description: subjectDescription > input.hint (full) > 빈 문자열
+    // AI 가 도면을 본 자세한 묘사가 있으면 그것이 가장 가치 있음.
+    const description = subjectDescription || (input.hint && input.hint.trim()) || '';
+    return { name, description };
+}
+/** AI 가 도면을 보고 식별한 subject (보드 정체성) — VLM 응답의 subjectName / subjectDescription. */
+async function resolveSubject(input, context, deps) {
+    if (!input.sessionId)
+        return {};
+    const session = await deps.sessionRepo.findOneBy({
+        id: input.sessionId,
+        domain: { id: context.domain.id }
+    });
+    if (!session)
+        return {};
+    const result = parseJsonSafe(session.resultJson);
+    const subjectName = typeof result?.metadata?.subjectName === 'string'
+        ? result.metadata.subjectName.trim()
+        : undefined;
+    const subjectDescription = typeof result?.metadata?.subjectDescription === 'string'
+        ? result.metadata.subjectDescription.trim()
+        : undefined;
+    return { subjectName, subjectDescription };
+}
+/** subject 미산출 시 fallback — attachment.name stem 만. */
+async function resolveAttachmentStem(input, context, deps) {
+    if (!input.sessionId)
+        return undefined;
+    const session = await deps.sessionRepo.findOneBy({
+        id: input.sessionId,
+        domain: { id: context.domain.id }
+    });
+    if (!session?.attachmentId)
+        return undefined;
+    const att = await deps.attachmentRepo.findOneBy({
+        id: session.attachmentId,
+        domain: { id: context.domain.id }
+    });
+    return stemOf(att?.name) || undefined;
+}
+/**
+ * 짧은 이름 — 단순 30자 단위로 단어 경계에서 자르기. 너무 길면 그대로 자르되 단어 보존.
+ */
+function shortenName(s) {
+    if (s.length <= 30)
+        return s;
+    // 30자 이내 마지막 공백에서 자르기
+    const truncated = s.slice(0, 30);
+    const lastSpace = truncated.lastIndexOf(' ');
+    if (lastSpace > 10)
+        return truncated.slice(0, lastSpace).trim();
+    return truncated.trim();
+}
+// ── helpers ──────────────────────────────────────────────────────────
+async function resolveBaseName(input, context, deps) {
+    // 1) 명시 hint
+    if (input.hint && input.hint.trim())
+        return firstSentence(input.hint);
+    // 2) session 정보
+    if (input.sessionId) {
+        const session = await deps.sessionRepo.findOneBy({
+            id: input.sessionId,
+            domain: { id: context.domain.id }
+        });
+        if (session) {
+            // 2a) userPrompt 우선
+            const opts = parseJsonSafe(session.optionsJson);
+            const userPrompt = typeof opts?.userPrompt === 'string' ? opts.userPrompt.trim() : '';
+            if (userPrompt)
+                return firstSentence(userPrompt);
+            // 2b) VLM reasoning
+            const result = parseJsonSafe(session.resultJson);
+            const reasoning = typeof result?.boardModel?.importMeta?.viewTypeReasoning === 'string'
+                ? result.boardModel.importMeta.viewTypeReasoning.trim()
+                : typeof result?.metadata?.viewTypeReasoning === 'string'
+                    ? result.metadata.viewTypeReasoning.trim()
+                    : '';
+            if (reasoning)
+                return firstSentence(reasoning);
+            // 2c) attachment name stem
+            if (session.attachmentId) {
+                const att = await deps.attachmentRepo.findOneBy({
+                    id: session.attachmentId,
+                    domain: { id: context.domain.id }
+                });
+                const stem = stemOf(att?.name);
+                if (stem)
+                    return stem;
+            }
+        }
+    }
+    return FALLBACK;
+}
+function parseJsonSafe(s) {
+    if (!s)
+        return undefined;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+function firstSentence(text) {
+    // 첫 문장 종결 부호 또는 줄바꿈까지. 미발견 시 전체.
+    const m = text.match(/^([^.\n!?]{1,120})[.\n!?]?/);
+    return (m?.[1] ?? text).trim();
+}
+function stemOf(name) {
+    if (!name)
+        return '';
+    // 마지막 . 이후 (확장자) 제거. 점이 여러 번이면 가장 마지막만.
+    const lastDot = name.lastIndexOf('.');
+    if (lastDot > 0)
+        return name.slice(0, lastDot);
+    return name;
+}
+/**
+ * 정규화: _-. → 공백, 다중 공백 단일화, trim, 50자 절단.
+ * 결과가 빈 문자열이면 '' 반환 (호출자가 fallback).
+ */
+function sanitize(s) {
+    if (!s)
+        return '';
+    let cleaned = s.replace(/[_\-.]+/g, ' ').replace(/\s+/g, ' ').trim();
+    if (cleaned.length > 50)
+        cleaned = cleaned.slice(0, 50).trim();
+    return cleaned;
+}
+/**
+ * existingNames 안에서 base 가 그대로 비어있으면 base 반환, 아니면 'base (2)', '(3)', ...
+ * case-insensitive 비교 (postgres ilike 호환).
+ */
+function pickAvailableSuffix(base, existingNames) {
+    const lower = base.toLowerCase();
+    const taken = new Set();
+    for (const name of existingNames) {
+        if (typeof name === 'string')
+            taken.add(name.toLowerCase());
+    }
+    if (!taken.has(lower))
+        return base;
+    for (let n = 2; n < 10000; n++) {
+        const candidate = `${base} (${n})`;
+        if (!taken.has(candidate.toLowerCase()))
+            return candidate;
+    }
+    // 9999개 충돌 이라는 비현실 시나리오 — 마지막 fallback
+    return `${base} (${Date.now()})`;
+}
+//# sourceMappingURL=suggest-board-name.js.map

package/dist-server/service/import-session/suggest-board-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-board-name.js","sourceRoot":"","sources":["../../../server/service/import-session/suggest-board-name.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * suggestBoardName — ImportSession 으로부터 새 Board 의 후보 이름을 추천한다.\n *\n * 정책:\n *   1) base 후보 우선순위: input.hint → session.options.userPrompt → session.result.metadata.viewTypeReasoning\n *      → attachment.name stem → 'Imported board'\n *   2) base 정규화: 확장자 제거, _-. → 공백, 다중 공백 단일화, 50자 절단, trim\n *   3) 도메인 격리 + 단일 LIKE query: `WHERE domain_id = ? AND (name = base OR name LIKE 'base (%)')`\n *      한 번에 충돌 후보 다 가져오고 메모리에서 사용 가능한 가장 작은 (n) 결정\n *   4) 결과: base 가 충돌 없으면 base, 있으면 'base (2)' / 'base (3)' / ...\n *\n * materializeFromSession 과 동일한 *RepoLike 패턴 — typeorm 의존성 주입으로 단위테스트 가능.\n */\n\nconst FALLBACK = 'Imported board'\n\nexport interface SuggestBoardNameInput {\n  /** ImportSession id — 옵션. 있으면 거기서 hint / attachment 정보 추출. */\n  sessionId?: string\n  /**\n   * 명시 hint. session 정보보다 우선. 사용자가 wizard 에서 직접 메모를 쳐서 그것 기반 추천을\n   * 받고 싶을 때 사용.\n   */\n  hint?: string\n}\n\nexport interface SessionForSuggest {\n  id: string\n  attachmentId?: string\n  optionsJson?: string | null\n  resultJson?: string | null\n}\n\nexport interface AttachmentForSuggest {\n  id: string\n  name?: string\n}\n\nexport interface SuggestSessionRepoLike {\n  findOneBy(criteria: any): Promise<SessionForSuggest | null>\n}\n\nexport interface SuggestAttachmentRepoLike {\n  findOneBy(criteria: any): Promise<AttachmentForSuggest | null>\n}\n\nexport interface SuggestBoardRepoLike {\n  /**\n   * 도메인 격리된 LIKE 쿼리. find({ where: { name: Like('base%'), domain: { id } } }) 형태로\n   * 호출자가 wiring. typeorm Like operator 노출을 피하기 위해 단순 string 으로 받음.\n   */\n  findExistingNames(opts: { domainId: string; basePrefix: string }): Promise<string[]>\n}\n\nexport interface SuggestContext {\n  domain: { id: string; [k: string]: any }\n}\n\nexport interface SuggestDeps {\n  sessionRepo: SuggestSessionRepoLike\n  attachmentRepo: SuggestAttachmentRepoLike\n  boardRepo: SuggestBoardRepoLike\n}\n\nexport async function suggestBoardName(\n  input: SuggestBoardNameInput,\n  context: SuggestContext,\n  deps: SuggestDeps\n): Promise<string> {\n  const base = await resolveBaseName(input, context, deps)\n  const cleaned = sanitize(base) || FALLBACK\n\n  const existingNames = await deps.boardRepo.findExistingNames({\n    domainId: context.domain.id,\n    basePrefix: cleaned\n  })\n  return pickAvailableSuffix(cleaned, existingNames)\n}\n\n/**\n * Board 이름 + 설명을 함께 추천. 이름은 짧고 심플 (운영 카드/리스트 표시용),\n * 설명은 자세히 (사용자 hint + AI importStrategy + 통계 요약).\n *\n * 정책:\n *   - **name**: hint / userPrompt / VLM reasoning / attachment stem 에서 짧은 base 추출 후\n *     30자 이내로 자르고, 충돌 검사 + (n) suffix\n *   - **description**: userPrompt + AI importStrategy + (있으면) reasoning + 카테고리 분포\n *     를 자연어 단락으로 합성. 없으면 빈 문자열\n */\nexport interface SuggestBoardMetaResult {\n  name: string\n  description: string\n}\n\nexport async function suggestBoardMeta(\n  input: SuggestBoardNameInput,\n  context: SuggestContext,\n  deps: SuggestDeps\n): Promise<SuggestBoardMetaResult> {\n  // 보드 정체성 = AI 가 도면을 보고 식별한 subject. import 처리 메타 (importStrategy /\n  // categoryDist / userPrompt — AI 에게 한 지시) 와는 별 차원이라 영속 데이터에 섞지 않는다.\n  const { subjectName, subjectDescription } = await resolveSubject(input, context, deps)\n\n  // name: subjectName > input.hint > attachment.name stem > FALLBACK\n  // 사용자가 명시 hint 를 줬으면 그것이 우선 (직접 의도). VLM subjectName 은 그 다음.\n  const baseName =\n    (input.hint && input.hint.trim() && firstSentence(input.hint)) ||\n    subjectName ||\n    (await resolveAttachmentStem(input, context, deps)) ||\n    FALLBACK\n  const cleanedName = shortenName(sanitize(baseName) || FALLBACK)\n\n  const existingNames = await deps.boardRepo.findExistingNames({\n    domainId: context.domain.id,\n    basePrefix: cleanedName\n  })\n  const name = pickAvailableSuffix(cleanedName, existingNames)\n\n  // description: subjectDescription > input.hint (full) > 빈 문자열\n  // AI 가 도면을 본 자세한 묘사가 있으면 그것이 가장 가치 있음.\n  const description =\n    subjectDescription || (input.hint && input.hint.trim()) || ''\n\n  return { name, description }\n}\n\n/** AI 가 도면을 보고 식별한 subject (보드 정체성) — VLM 응답의 subjectName / subjectDescription. */\nasync function resolveSubject(\n  input: SuggestBoardNameInput,\n  context: SuggestContext,\n  deps: SuggestDeps\n): Promise<{ subjectName?: string; subjectDescription?: string }> {\n  if (!input.sessionId) return {}\n  const session = await deps.sessionRepo.findOneBy({\n    id: input.sessionId,\n    domain: { id: context.domain.id }\n  })\n  if (!session) return {}\n  const result = parseJsonSafe(session.resultJson)\n  const subjectName = typeof result?.metadata?.subjectName === 'string'\n    ? result.metadata.subjectName.trim()\n    : undefined\n  const subjectDescription = typeof result?.metadata?.subjectDescription === 'string'\n    ? result.metadata.subjectDescription.trim()\n    : undefined\n  return { subjectName, subjectDescription }\n}\n\n/** subject 미산출 시 fallback — attachment.name stem 만. */\nasync function resolveAttachmentStem(\n  input: SuggestBoardNameInput,\n  context: SuggestContext,\n  deps: SuggestDeps\n): Promise<string | undefined> {\n  if (!input.sessionId) return undefined\n  const session = await deps.sessionRepo.findOneBy({\n    id: input.sessionId,\n    domain: { id: context.domain.id }\n  })\n  if (!session?.attachmentId) return undefined\n  const att = await deps.attachmentRepo.findOneBy({\n    id: session.attachmentId,\n    domain: { id: context.domain.id }\n  })\n  return stemOf(att?.name) || undefined\n}\n\n/**\n * 짧은 이름 — 단순 30자 단위로 단어 경계에서 자르기. 너무 길면 그대로 자르되 단어 보존.\n */\nfunction shortenName(s: string): string {\n  if (s.length <= 30) return s\n  // 30자 이내 마지막 공백에서 자르기\n  const truncated = s.slice(0, 30)\n  const lastSpace = truncated.lastIndexOf(' ')\n  if (lastSpace > 10) return truncated.slice(0, lastSpace).trim()\n  return truncated.trim()\n}\n\n\n// ── helpers ──────────────────────────────────────────────────────────\n\nasync function resolveBaseName(\n  input: SuggestBoardNameInput,\n  context: SuggestContext,\n  deps: SuggestDeps\n): Promise<string> {\n  // 1) 명시 hint\n  if (input.hint && input.hint.trim()) return firstSentence(input.hint)\n\n  // 2) session 정보\n  if (input.sessionId) {\n    const session = await deps.sessionRepo.findOneBy({\n      id: input.sessionId,\n      domain: { id: context.domain.id }\n    })\n    if (session) {\n      // 2a) userPrompt 우선\n      const opts = parseJsonSafe(session.optionsJson)\n      const userPrompt = typeof opts?.userPrompt === 'string' ? opts.userPrompt.trim() : ''\n      if (userPrompt) return firstSentence(userPrompt)\n\n      // 2b) VLM reasoning\n      const result = parseJsonSafe(session.resultJson)\n      const reasoning =\n        typeof result?.boardModel?.importMeta?.viewTypeReasoning === 'string'\n          ? result.boardModel.importMeta.viewTypeReasoning.trim()\n          : typeof result?.metadata?.viewTypeReasoning === 'string'\n          ? result.metadata.viewTypeReasoning.trim()\n          : ''\n      if (reasoning) return firstSentence(reasoning)\n\n      // 2c) attachment name stem\n      if (session.attachmentId) {\n        const att = await deps.attachmentRepo.findOneBy({\n          id: session.attachmentId,\n          domain: { id: context.domain.id }\n        })\n        const stem = stemOf(att?.name)\n        if (stem) return stem\n      }\n    }\n  }\n\n  return FALLBACK\n}\n\nfunction parseJsonSafe(s: string | null | undefined): any {\n  if (!s) return undefined\n  try {\n    return JSON.parse(s)\n  } catch {\n    return undefined\n  }\n}\n\nfunction firstSentence(text: string): string {\n  // 첫 문장 종결 부호 또는 줄바꿈까지. 미발견 시 전체.\n  const m = text.match(/^([^.\\n!?]{1,120})[.\\n!?]?/)\n  return (m?.[1] ?? text).trim()\n}\n\nfunction stemOf(name: string | undefined | null): string {\n  if (!name) return ''\n  // 마지막 . 이후 (확장자) 제거. 점이 여러 번이면 가장 마지막만.\n  const lastDot = name.lastIndexOf('.')\n  if (lastDot > 0) return name.slice(0, lastDot)\n  return name\n}\n\n/**\n * 정규화: _-. → 공백, 다중 공백 단일화, trim, 50자 절단.\n * 결과가 빈 문자열이면 '' 반환 (호출자가 fallback).\n */\nfunction sanitize(s: string): string {\n  if (!s) return ''\n  let cleaned = s.replace(/[_\\-.]+/g, ' ').replace(/\\s+/g, ' ').trim()\n  if (cleaned.length > 50) cleaned = cleaned.slice(0, 50).trim()\n  return cleaned\n}\n\n/**\n * existingNames 안에서 base 가 그대로 비어있으면 base 반환, 아니면 'base (2)', '(3)', ...\n * case-insensitive 비교 (postgres ilike 호환).\n */\nexport function pickAvailableSuffix(base: string, existingNames: string[]): string {\n  const lower = base.toLowerCase()\n  const taken = new Set<string>()\n  for (const name of existingNames) {\n    if (typeof name === 'string') taken.add(name.toLowerCase())\n  }\n  if (!taken.has(lower)) return base\n  for (let n = 2; n < 10000; n++) {\n    const candidate = `${base} (${n})`\n    if (!taken.has(candidate.toLowerCase())) return candidate\n  }\n  // 9999개 충돌 이라는 비현실 시나리오 — 마지막 fallback\n  return `${base} (${Date.now()})`\n}\n"]}

package/dist-server/service/import-tools.d.ts

@@ -0,0 +1,10 @@
+import { type ToolCategory } from '@things-factory/ai-client-base';
+/**
+ * 명시적 register 함수 — 테스트나 lazy bootstrap 에서 import 만으로 발동되는 side-effect 가
+ * 부담스러울 때 import 후 명시 호출 가능.
+ */
+export declare function registerBoardImportTools(): void;
+/**
+ * 테스트용 — registerToolCategory 의 입력으로 사용된 카테고리 객체. 외부에서 inspect 가능.
+ */
+export declare const BOARD_IMPORT_TOOL_CATEGORY: ToolCategory;