@things-factory/board-ai 10.1.6 → 10.1.8

package/client/index.ts

@@ -25,7 +25,19 @@ import { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/i
 import { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js'
 import { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js'
 
-registerChatDefaults({ catalogEntries: DEFAULT_CATALOG_ENTRIES, slashTemplates: DEFAULT_SLASH_TEMPLATES })
+/*
+ * `footerNoticeKey` — the promise at the bottom of the empty chat.
+ *
+ * It used to be a default inside the chat component: "AI responses are previewed on the board
+ * before they are applied." operato-figure showed that sentence with no board anywhere (2026-09-11).
+ * The promise is only true because board authoring **has** the machinery — a patch is staged and
+ * the user applies it. The package with the machinery says the sentence.
+ */
+registerChatDefaults({
+  catalogEntries: DEFAULT_CATALOG_ENTRIES,
+  slashTemplates: DEFAULT_SLASH_TEMPLATES,
+  footerNoticeKey: 'board-ai.text.preview-before-apply'
+})
 
 export * from '@things-factory/ai-assistant/dist-client/index.js'
 export * from './components/default-catalog-entries.js'

package/dist-client/client/index.js

@@ -24,7 +24,19 @@
 import { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/index.js';
 import { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js';
 import { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js';
-registerChatDefaults({ catalogEntries: DEFAULT_CATALOG_ENTRIES, slashTemplates: DEFAULT_SLASH_TEMPLATES });
+/*
+ * `footerNoticeKey` — the promise at the bottom of the empty chat.
+ *
+ * It used to be a default inside the chat component: "AI responses are previewed on the board
+ * before they are applied." operato-figure showed that sentence with no board anywhere (2026-09-11).
+ * The promise is only true because board authoring **has** the machinery — a patch is staged and
+ * the user applies it. The package with the machinery says the sentence.
+ */
+registerChatDefaults({
+    catalogEntries: DEFAULT_CATALOG_ENTRIES,
+    slashTemplates: DEFAULT_SLASH_TEMPLATES,
+    footerNoticeKey: 'board-ai.text.preview-before-apply'
+});
 export * from '@things-factory/ai-assistant/dist-client/index.js';
 export * from './components/default-catalog-entries.js';
 export * from './components/default-slash-templates.js';

package/dist-client/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AAEjF,oBAAoB,CAAC,EAAE,cAAc,EAAE,uBAAuB,EAAE,cAAc,EAAE,uBAAuB,EAAE,CAAC,CAAA;AAE1G,cAAc,mDAAmD,CAAA;AACjE,cAAc,yCAAyC,CAAA;AACvD,cAAc,yCAAyC,CAAA","sourcesContent":["/**\n * @things-factory/board-ai — client entries.\n *\n * 대화면 자체는 **`@things-factory/ai-assistant` 로 나갔다**(2026-09-10). 여기 남은 것은 보드\n * 저작의 기본 목록이고, 아래 한 줄이 그것을 대화면에 넣는다 — 등록하는 쪽이 주인이다.\n *\n * 이 패키지를 import 하는 소비처는 예전과 똑같이 동작한다: 엘리먼트가 등록되고, 보드 카탈로그와\n * 슬래시 목록이 채워진다.\n */\n/*\n * ⚠ **빌드된 경로를 명시한다** (2026-09-10).\n *\n * 처음에 `@things-factory/ai-assistant/client` 로 적었다. `exports` 맵이 없으니 그 서브패스가\n * **소스 디렉터리**로 떨어지고, webpack 이 `.ts` 원본을 번들에 실었다. 데코레이터 메타데이터가\n * 없는 채로 실려서 화면이 `Reflect.metadata is not a function` 으로 죽었다 — 빌드는 통과했고\n * 브라우저에서만 터진다.\n *\n * 이 저장소에 같은 부류가 이미 있다: 원본 `.ts` 를 싣는 패키지 때문에 앱마다 webpack stopgap 을\n * 두고 있다(barcode-base·print-base). 하나 더 만들지 않는다.\n *\n * `dist-client/index.js` 를 직접 가리키면 webpack 은 빌드된 JS 를, tsc 는 옆의 `index.d.ts` 를\n * 집는다. 오늘 `ingest` 를 `dist-shared` 로 가리킨 것과 같은 이유다.\n */\nimport { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/index.js'\nimport { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js'\nimport { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js'\n\nregisterChatDefaults({ catalogEntries: DEFAULT_CATALOG_ENTRIES, slashTemplates: DEFAULT_SLASH_TEMPLATES })\n\nexport * from '@things-factory/ai-assistant/dist-client/index.js'\nexport * from './components/default-catalog-entries.js'\nexport * from './components/default-slash-templates.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AAEjF;;;;;;;GAOG;AACH,oBAAoB,CAAC;IACnB,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,uBAAuB;IACvC,eAAe,EAAE,oCAAoC;CACtD,CAAC,CAAA;AAEF,cAAc,mDAAmD,CAAA;AACjE,cAAc,yCAAyC,CAAA;AACvD,cAAc,yCAAyC,CAAA","sourcesContent":["/**\n * @things-factory/board-ai — client entries.\n *\n * 대화면 자체는 **`@things-factory/ai-assistant` 로 나갔다**(2026-09-10). 여기 남은 것은 보드\n * 저작의 기본 목록이고, 아래 한 줄이 그것을 대화면에 넣는다 — 등록하는 쪽이 주인이다.\n *\n * 이 패키지를 import 하는 소비처는 예전과 똑같이 동작한다: 엘리먼트가 등록되고, 보드 카탈로그와\n * 슬래시 목록이 채워진다.\n */\n/*\n * ⚠ **빌드된 경로를 명시한다** (2026-09-10).\n *\n * 처음에 `@things-factory/ai-assistant/client` 로 적었다. `exports` 맵이 없으니 그 서브패스가\n * **소스 디렉터리**로 떨어지고, webpack 이 `.ts` 원본을 번들에 실었다. 데코레이터 메타데이터가\n * 없는 채로 실려서 화면이 `Reflect.metadata is not a function` 으로 죽었다 — 빌드는 통과했고\n * 브라우저에서만 터진다.\n *\n * 이 저장소에 같은 부류가 이미 있다: 원본 `.ts` 를 싣는 패키지 때문에 앱마다 webpack stopgap 을\n * 두고 있다(barcode-base·print-base). 하나 더 만들지 않는다.\n *\n * `dist-client/index.js` 를 직접 가리키면 webpack 은 빌드된 JS 를, tsc 는 옆의 `index.d.ts` 를\n * 집는다. 오늘 `ingest` 를 `dist-shared` 로 가리킨 것과 같은 이유다.\n */\nimport { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/index.js'\nimport { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js'\nimport { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js'\n\n/*\n * `footerNoticeKey` — the promise at the bottom of the empty chat.\n *\n * It used to be a default inside the chat component: \"AI responses are previewed on the board\n * before they are applied.\" operato-figure showed that sentence with no board anywhere (2026-09-11).\n * The promise is only true because board authoring **has** the machinery — a patch is staged and\n * the user applies it. The package with the machinery says the sentence.\n */\nregisterChatDefaults({\n  catalogEntries: DEFAULT_CATALOG_ENTRIES,\n  slashTemplates: DEFAULT_SLASH_TEMPLATES,\n  footerNoticeKey: 'board-ai.text.preview-before-apply'\n})\n\nexport * from '@things-factory/ai-assistant/dist-client/index.js'\nexport * from './components/default-catalog-entries.js'\nexport * from './components/default-slash-templates.js'\n"]}

package/dist-client/server/service/assistant.js

@@ -206,6 +206,21 @@ export class DefaultBoardAIAssistant {
             messages: messages.map(m => (typeof m.content === 'string' ? m.content : '')),
             toolResults: loopResult.groundedTexts
         });
+        const analysis = (toolUsages.length || patch || accumulatedActions.length || loopResult.proposals.length)
+            ? {
+                kind: 'board.analysis.v1',
+                scope: { boardId: currentBoard?.id },
+                window: { turn: messages.length },
+                confidence: { level: warnings.length ? 'low' : 'medium', 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', 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,
+                approval: { required: true, mode: 'confirm', 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,
@@ -214,7 +229,8 @@ export class DefaultBoardAIAssistant {
             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
         };
     }
     resolveTypesAndCategories(options) {