@things-factory/board-ai 10.1.7 → 10.1.13

package/logs/.5e5d741d8b7784a2fbad65eedc0fd46946aaf6f2-audit.json

@@ -0,0 +1,15 @@
+{
+    "keep": {
+        "days": true,
+        "amount": 14
+    },
+    "auditLog": "logs/.5e5d741d8b7784a2fbad65eedc0fd46946aaf6f2-audit.json",
+    "files": [
+        {
+            "date": 1789195002942,
+            "name": "logs/connections-2026-09-12-15.log",
+            "hash": "cf643fb0881a2a037b9657d9f0cab3f858825cbc597ef955ba6335a9305911c5"
+        }
+    ],
+    "hashType": "sha256"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/board-ai",
-  "version": "10.1.7",
+  "version": "10.1.13",
   "main": "dist-server/index.js",
   "browser": "dist-client/client/index.js",
   "things-factory": true,
@@ -31,10 +31,10 @@
     "@operato/graphql": "^10.0.0",
     "@operato/i18n": "^10.0.0",
     "@operato/styles": "^10.0.0",
-    "@things-factory/ai-assistant": "^10.1.7",
-    "@things-factory/ai-client-base": "^10.1.7",
+    "@things-factory/ai-assistant": "^10.1.13",
+    "@things-factory/ai-client-base": "^10.1.8",
     "@things-factory/auth-base": "^10.1.7",
-    "@things-factory/board-import": "^10.1.7",
+    "@things-factory/board-import": "^10.1.8",
     "@things-factory/env": "^10.1.3",
     "@things-factory/shell": "^10.1.7",
     "dompurify": "^3.0.0",
@@ -46,5 +46,5 @@
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.0"
   },
-  "gitHead": "9a036f83f5751f9e4af9180e9a0018f716a4ba27"
+  "gitHead": "f2cd3d27e32e71cca1d3af5499ef54249b1cc111"
 }

package/server/service/assistant.test.ts

@@ -19,6 +19,7 @@ import {
   buildBoardEditTools,
   DefaultBoardAIAssistant
 } from './assistant'
+import { isGroundedAnalysisContract } from '@things-factory/ai-client-base'
 
 describe('toolCallToBoardEditOp', () => {
   test('addComponent: 정상 인자', () => {
@@ -1845,6 +1846,10 @@ describe('agentic loop (chatViaTools) — mock provider', () => {
     // result 는 summarized 객체
     expect(u.result.count).toBe(1)
     expect(u.result.selected[0].name).toBe('AGV-1')
+    expect(isGroundedAnalysisContract(r.analysis)).toBe(true)
+    expect(r.analysis?.kind).toBe('board.analysis.v1')
+    expect(r.analysis?.approvalRequired).toBe(true)
+    expect(r.analysis?.approval.mode).toBe('confirm')
   })
 
   test('toolUsages 수집 — write tool 은 queued 마커', async () => {

package/server/service/assistant.ts

@@ -310,6 +310,22 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
       toolResults: loopResult.groundedTexts
     })
 
+    const analysis = (toolUsages.length || patch || accumulatedActions.length || loopResult.proposals.length)
+      ? {
+          kind: 'board.analysis.v1' as const,
+          scope: { boardId: (currentBoard as any)?.id },
+          window: { turn: messages.length },
+          confidence: { level: warnings.length ? 'low' as const : 'medium' as const, reasons: warnings.length ? ['grounding-warning'] : ['tool-or-board-context'] },
+          limitations: warnings.map(code => ({ code })),
+          claims: [{ code: patch ? 'board.patch-proposed' : 'board.context-reviewed', severity: 'info' as const, evidence: { toolCalls: toolUsages.length, componentCount: components.length }, method: 'board-agentic-loop', assumptions: ['Board context is current for this turn.'] }],
+          facts: { board: boardContext, toolUsages },
+          ...(patch ? { proposal: patch } : accumulatedActions.length ? { proposal: accumulatedActions } : {}),
+          approvalRequired: true as const,
+          approval: { required: true as const, mode: 'confirm' as const, reason: patch || accumulatedActions.length ? 'Board or scene change requires user confirmation.' : 'Analysis is advisory.' },
+          trace: { source: 'board-ai', generatedAt: new Date().toISOString(), version: '1' }
+        }
+      : undefined
+
     return {
       reply,
       patch,
@@ -318,7 +334,8 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
       actions: accumulatedActions.length > 0 ? accumulatedActions : undefined,
       /* 제안은 실행 전 상태다 — 대화면이 확인 버튼을 그린다. 서버는 실행하지 않는다. */
       proposals: loopResult.proposals.length > 0 ? loopResult.proposals : undefined,
-      groundingWarnings: warnings.length > 0 ? warnings : undefined
+      groundingWarnings: warnings.length > 0 ? warnings : undefined,
+      analysis
     }
   }
 

package/server/service/board-ai-resolver.ts

@@ -245,6 +245,13 @@ class BoardAIChatOutput {
       'Ungrounded identifiers mentioned by the reply — present in the answer but absent from everything the model received (prompt, board context, history, tool results). Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.'
   })
   groundingWarnings?: any
+
+  @Field(() => GraphQLJSON, {
+    nullable: true,
+    description:
+      'Grounded analysis contract for this turn: scope, evidence-backed claims, limitations, proposal and explicit approval boundary. Null when the turn did not perform an analysis.'
+  })
+  analysis?: any
 }
 
 @Resolver()
@@ -513,7 +520,8 @@ export class BoardAIChatResolver {
       actions: r.actions && r.actions.length > 0 ? r.actions : null,
       proposals: r.proposals && r.proposals.length > 0 ? r.proposals : null,
       historyFolded: historyFolded ?? null,
-      groundingWarnings: r.groundingWarnings && r.groundingWarnings.length > 0 ? r.groundingWarnings : null
+      groundingWarnings: r.groundingWarnings && r.groundingWarnings.length > 0 ? r.groundingWarnings : null,
+      analysis: r.analysis ?? null
     }
   }
 

package/server/service/types.ts

@@ -117,8 +117,14 @@ export interface ComponentSchema {
  * import 를 그대로 두기 위해서다 — 뜻의 정본은 저쪽 한 곳이다.
  */
 import type { ToolUsage } from '@things-factory/ai-client-base'
+import type { AIAnalysisClaim, GroundedAnalysisContract } from '@things-factory/ai-client-base'
 export type { ToolUsage }
 
+/** Board-specific extension of the shared evidence/approval analysis boundary. */
+export interface BoardGroundedAnalysis extends GroundedAnalysisContract<any, AIAnalysisClaim, BoardEditPatch | BoardActionOp[]> {
+  kind: 'board.analysis.v1'
+}
+
 
 export interface ChatResponse {
   /** 사용자에게 보여줄 텍스트 응답 */
@@ -148,6 +154,8 @@ export interface ChatResponse {
    * 판정 규칙·사정거리는 ./grounding 참조. 비면(undefined) 접지 정상.
    */
   groundingWarnings?: string[]
+  /** Present when the turn inspected state or proposed a board/action change. */
+  analysis?: BoardGroundedAnalysis
 }
 
 export interface BoardEditPatch {