@things-factory/ai-assistant 10.1.27 → 10.1.29

package/client/components/assistant-chat.ts

@@ -59,7 +59,8 @@ import {
  * 뜨지 않는 것이 맞다.
  */
 import { chatDefaults } from './chat-defaults.js'
-import { isDifferentConversation, resolveConversation, type AssistantMode } from './assistant-mode.js'
+import { isDifferentConversation, resolveConversation, type AssistantMode, type AssistantModeView, pickInitialMode } from './assistant-mode.js'
+import { parseProposalOutcomeLine, type ParsedProposalOutcome } from './proposal-outcome-line.js'
 import { availableTriggers, type TriggerChip } from './chat-triggers.js'
 
 interface ChatLine {
@@ -80,6 +81,13 @@ interface ChatLine {
   followUp?: string
   patchId?: string
   pending?: boolean
+  /**
+   * 서버가 이 사람에게 값을 안 내준 줄 — ADR-0073 판정 1.
+   *
+   * `content` 에 온 것은 「이 답은 <문> 권한이 필요합니다」 한 줄이다. 줄을 지우지 않는 이유는, 방에
+   * 무슨 일이 있었는지는 알 수 있어야 하기 때문이다. 값만 안 보인다.
+   */
+  redacted?: boolean
   /** AI 가 응답을 만드는 동안 호출한 도구 trace — fold-able 박스에서 노출. */
   toolUsages?: Array<{
     name: string
@@ -172,10 +180,82 @@ const ASSISTANT_CHAT_MUTATION = gql`
       offeredTools
       proposals
       groundingWarnings
+      historyFolded
     }
   }
 `
 
+/*
+ * What this conversation offers on screen, in this person's language.
+ *
+ * The `/` sentences, the `@` catalog and the two notices are declared with the mode on the server
+ * (ADR-0061 decision 7) and translated there, so the panel and the door cannot describe different
+ * conversations, and a host does not carry a second copy of the words.
+ */
+/*
+ * 이 화면에 설 수 있는 대화들 — ADR-0072 A17 ①.
+ *
+ * 화면은 자기가 무엇을 보여 주는지만 말하고, 그 위에 어느 대화가 서는지는 앱 서버가 답한다.
+ */
+const ASSISTANT_MODES_QUERY = gql`
+  query AssistantModes($subject: String!) {
+    assistantModes(subject: $subject) {
+      kind
+      label
+      isDefault
+    }
+  }
+`
+
+const ASSISTANT_MODE_QUERY = gql`
+  query AssistantMode($kind: String!) {
+    assistantMode(kind: $kind) {
+      kind
+      slashTemplates {
+        name
+        description
+        template
+      }
+      catalogEntries
+      proposalChoices
+      placeholder
+      intro
+      examples
+      footerNotice
+      stagedNotice
+    }
+  }
+`
+
+/*
+ * 방에 말하는 문 — 사람에게 하는 말이고 모델을 부르지 않는다(ADR-0070 A15).
+ *
+ * 이 문이 서기 전에는 화면에서 나가는 모든 말이 어시스턴트를 향했다. 옆 사람에게 한마디 하려면
+ * 어시스턴트가 반드시 대답했고, 그 대답이 다시 대화에 남았다.
+ */
+/*
+ * `@` 가 고를 수 있는 사람들 — 이 도메인의 사용자.
+ *
+ * 호스트가 `userProvider` 를 주지 않으면 여기서 직접 묻는다. 주지 않는 것이 기본이었고, 그래서 앱 셋
+ * 어디에서도 `@이름` 을 **고를 수가 없었다** — 멘션이 사람을 불러들이는 기전(ADR-0071 결정 1)을 세워
+ * 놓고 부르는 자리가 없는 상태였다. 이 문은 `ai-assistant` 의 것이고 대화창이 그 문의 화면이다.
+ */
+const DOMAIN_USERS_FOR_MENTION_QUERY = gql`
+  query DomainUsersForMention($query: String) {
+    domainUsersForMention(query: $query) {
+      id
+      name
+      email
+    }
+  }
+`
+
+const SAY_TO_ROOM_MUTATION = gql`
+  mutation SayToRoom($sessionId: String!, $content: String!) {
+    sayToRoom(sessionId: $sessionId, content: $content)
+  }
+`
+
 const CHAT_MESSAGES_QUERY = gql`
   query ChatMessages($sessionId: String!, $limit: Int, $offset: Int) {
     chatMessages(sessionId: $sessionId, limit: $limit, offset: $offset) {
@@ -186,6 +266,7 @@ const CHAT_MESSAGES_QUERY = gql`
       toolUsagesJson
       groundingWarningsJson
       createdAt
+      redacted
       creator {
         name
         email
@@ -206,6 +287,7 @@ const CHAT_MESSAGE_SUBSCRIPTION = gql`
       toolUsagesJson
       groundingWarningsJson
       createdAt
+      redacted
       creator {
         name
         email
@@ -305,8 +387,10 @@ export class OxAssistantChat extends LitElement {
    * `@` mention 도메인 사용자 공급자 (선택). 호스트가 `domainUsersForMention` query 로 wrap.
    *
    * 호스트는 query 문자열을 받아 도메인 사용자 후보 (id/name/email) 배열을 돌려준다.
-   * 미설정 시 `@` popup 은 빈 결과 (사용자가 멘션 못 함). 멀티유저 환경 활성화 정책에 따라
-   * 호스트가 set 해야 활성화. async 가 자연스러우므로 Promise 반환 가능.
+   *
+   * **미설정이면 대화창이 이 패키지의 문(`domainUsersForMention`)에 직접 묻는다.** 예전에는 빈
+   * 결과였고, 그래서 앱 셋에서는 `@이름` 을 고를 수 없었다 — 멘션이 사람을 불러들이는 길을 세워도
+   * 부르는 자리가 없었다. 자기 목록을 따로 쓰는 호스트만 이것을 준다.
    */
   @property({ attribute: false })
   userProvider?: (
@@ -352,34 +436,38 @@ export class OxAssistantChat extends LitElement {
    *                  returns patches and scene actions
    *   assistantChat  a surface with no document of its own — lives here, runs registered tools only
    *
-   * Default stays `boardAIChat`: every existing consumer is a board surface, and a default that
-   * changed under them would move their conversation to a door with no board tools behind it.
-   *
-   * A host that has no board must pass `assistantChat` **and** `systemPrompt`. Until it does, the
-   * chat calls a mutation that lives in a package it may not even load — which is how
-   * operato-figure got `Cannot query field "boardAIChat" on type "Mutation"` (2026-09-11).
+   * **There is no default** (ADR-0061 decision 7). It was `boardAIChat`, which meant a surface that
+   * said nothing talked to a package it may not even load — operato-figure got
+   * `Cannot query field "boardAIChat" on type "Mutation"` that way (2026-09-11). A surface that
+   * declares a mode talks to `assistantChat`; one that declares no mode names this itself.
    */
   @property({ type: String, attribute: 'chat-endpoint' })
-  chatEndpoint: 'boardAIChat' | 'assistantChat' = 'boardAIChat'
+  chatEndpoint?: 'boardAIChat' | 'assistantChat'
 
-  /**
-   * Who the assistant is on this surface, in the host's words. Required by `assistantChat`; the
-   * board conversation carries its own persona on the server and ignores this.
-   */
   /**
    * What this conversation is — see `AssistantMode`.
    *
-   * A host that sets this does not set `systemPrompt`, `toolCategories`, `hostContext` or
-   * `chatEndpoint` separately, and does not rely on `registerChatDefaults` for its `@` and `/`
-   * lists: the mode carries all of them together, so they cannot disagree with each other.
+   * A host that sets this sets nothing else about the conversation: the persona, the tool
+   * categories, the model and the limits belong to the mode its app server registered, and what
+   * `@` and `/` offer comes from that same declaration, translated. They cannot disagree because
+   * there is one of them.
    *
-   * When `mode.id` changes the conversation on screen is closed and a new one begins.
+   * When `kind` or `target` changes the conversation on screen is closed and a new one begins.
    */
   @property({ attribute: false })
   mode?: AssistantMode
 
-  @property({ type: String, attribute: 'system-prompt' })
-  systemPrompt?: string
+  /**
+   * 이 화면이 보여 주는 것의 **종류** — `'board'`, `'space'`, `'station'`, `'figure'` (ADR-0072 A17 ①).
+   *
+   * `mode` 가 「지금 어느 대화인가」라면 이것은 「그 자리에 어떤 대화들이 설 수 있나」이다. 서버가
+   * `assistantModes(subject)` 로 답하고, 둘 이상이면 고르개가 뜬다. 하나면 고르개를 내지 않는다 —
+   * 고를 것이 없는 고르개는 자리만 차지한다.
+   *
+   * 화면이 이것을 안 주면 고르개는 없고 host 가 정한 대화 하나만 산다. 그것이 오늘까지의 모양이다.
+   */
+  @property({ type: String })
+  subject?: string
 
   /**
    * 라이브 상태를 다루는 대화면인가 — true 면 **첫 턴에 도구 호출을 강제**한다.
@@ -408,8 +496,10 @@ export class OxAssistantChat extends LitElement {
   @property({ type: Array, attribute: false })
   componentSchemas?: Array<{ type: string; description?: string; group?: string; properties?: Record<string, any> }>
 
+  /* No default here — the render falls back to `ai-assistant.text.input-placeholder`, which every locale has.
+   * A literal default is one language for every reader, and it hid the key that already existed. */
   @property({ type: String })
-  placeholder = '자연어로 명령하세요 (Shift+Enter 줄바꿈, Enter 전송)'
+  placeholder?: string
 
   @state()
   private lines: ChatLine[] = []
@@ -475,6 +565,22 @@ export class OxAssistantChat extends LitElement {
   @state()
   private dragOver = false
 
+  /*
+   * ── 왜 이미지만 받나 ──────────────────────────────────────────────────────
+   * `.json` · `.txt` · `.csv` 도 받고 있었다. 그 파일들은 `hostContext.attachments` 로 실려 갔고
+   * **그것을 읽어 모델에 붙이는 코드가 없었다.** 사람이 CSV 를 붙이고 「이 표 좀 봐줘」라고 하면 화면에
+   * 파일 칩이 뜨고 답도 왔다. 그 답은 파일을 본 적이 없고, 오류도 안 났다(2026-09-18 표면 조사).
+   *
+   * 이미지는 길이 있다 — `assistant-chat-resolver.ts` 가 `hostContext.image` 를 마지막 사람 턴에
+   * 붙인다. 그래서 되는 것만 남기고 좁혔다. 못 하는 일을 화면이 권하지 않는다.
+   *
+   * ── 글 파일을 청하는 제품이 설 때의 모양 (수석 아키텍트, ADR-0071 보탬) ───
+   * 이미지와 **같은 자리**(사람 턴)에 붙인다. 크기 상한은 모드가 선언하고, 넘으면 보내기 전에 사실 한
+   * 줄로 거절한다 — 조용히 자르지 않는다. 비용은 사용량의 축이다(ADR-0061 결정 6).
+   *
+   * `attachments` 짐 자체는 그대로 둔다: figure 의 도구가 거기서 이미지를 찾는다
+   * (`figure-tools.ts` — `ctx.host.image` 가 없을 때의 갈래).
+   */
   private async onAttachFiles(files: FileList | File[] | null | undefined) {
     if (!files || files.length === 0) return
     const list = Array.from(files)
@@ -607,11 +713,12 @@ export class OxAssistantChat extends LitElement {
       The screen still shows nothing either way. There is no sentence to show, and inventing one is
       what this whole correction removed.
     */
-    if (!this.conversation.stagedNoticeKey && !OxAssistantChat.warnedMissingStagedNotice) {
+    if (!this.conversation.stagedNotice && !OxAssistantChat.warnedMissingStagedNotice) {
       OxAssistantChat.warnedMissingStagedNotice = true
       console.warn(
-        '[assistant-chat] a host reported a proposal staged but registered no `stagedNoticeKey`, ' +
-          'so the card can say nothing. Pass one to `registerChatDefaults` from the host.'
+        '[assistant-chat] a host reported a proposal staged but declared no staged notice, so the card can ' +
+          'say nothing. Declare `stagedNoticeKey` on the mode (the server translates it), or pass one to ' +
+          '`registerChatDefaults` from a host with no mode.'
       )
     }
 
@@ -663,6 +770,10 @@ export class OxAssistantChat extends LitElement {
     return (auth.credential as any)?.email
   }
 
+  private get _myUserId(): string | undefined {
+    return (auth.credential as any)?.id
+  }
+
   /** Mention popup — `#` (컴포넌트) / `@` (카탈로그) / `/` (slash) 트리거 시 활성.
    *  단일 popup 재사용 — mentionTrigger 로 활성 trigger 추적. */
   @state()
@@ -716,15 +827,130 @@ export class OxAssistantChat extends LitElement {
     return resolveConversation(
       this.mode,
       {
-        systemPrompt: this.systemPrompt,
-        toolCategories: this.toolCategories,
         hostContext: this.hostContext,
-        chatEndpoint: this.chatEndpoint
-      },
-      chatDefaults
+        chatEndpoint: this.chatEndpoint,
+        /* A host with no mode still registers its wording as keys; it is translated here. */
+        footerNotice: chatDefaults.footerNoticeKey ? i18next.t(chatDefaults.footerNoticeKey) : undefined,
+        stagedNotice: chatDefaults.stagedNoticeKey ? i18next.t(chatDefaults.stagedNoticeKey) : undefined
+      } as any,
+      chatDefaults as any,
+      this.modeView
     )
   }
 
+  /**
+   * What the server said this mode offers, in this person's language.
+   *
+   * Fetched when the mode changes and kept until the next one answers. Until it arrives the panel
+   * offers nothing rather than the list some other package registered globally.
+   */
+  @state() private modeView?: AssistantModeView
+
+  private modeViewToken = 0
+
+  /** 이 subject 에 설 수 있는 대화들 — 기본이 먼저. 하나뿐이면 고르개를 그리지 않는다. */
+  @state() private modeChoices: { kind: string; label: string; isDefault: boolean }[] = []
+
+  private modeChoicesToken = 0
+
+  /**
+   * 이 화면에 설 수 있는 대화를 서버에 묻는다.
+   *
+   * 화면이 종류 목록을 손에 들고 있으면, 대화를 하나 더 세운 날 그 화면만 모른 채로 남는다. 목록은
+   * 앱 서버의 선언에서 나온다(ADR-0072 A17 ①).
+   */
+  private async loadModeChoices() {
+    const subject = this.subject
+    if (!subject) {
+      this.modeChoices = []
+      return
+    }
+    const token = ++this.modeChoicesToken
+    try {
+      const result = await client.query({
+        query: ASSISTANT_MODES_QUERY,
+        variables: { subject },
+        fetchPolicy: 'cache-first'
+      })
+      if (token !== this.modeChoicesToken) return
+      this.modeChoices = result.data?.assistantModes ?? []
+    } catch {
+      /*
+       * 못 물어봤다고 화면을 막지 않는다 — host 가 준 대화는 그대로 산다. 고르개만 안 나온다.
+       * 여기서 오류 문구를 띄우면 고를 것이 하나뿐인 화면에서도 빨간 줄이 뜬다.
+       */
+      if (token !== this.modeChoicesToken) return
+      this.modeChoices = []
+    }
+  }
+
+  /**
+   * 사람이 다른 대화를 골랐다.
+   *
+   * 고른 것은 **이 subject 종류에 대해** 기억한다 — 보드를 열 때마다 저작 대화로 돌아가면, 현장을
+   * 물으려던 사람은 화면을 열 때마다 같은 손질을 다시 해야 한다. 기억은 이 브라우저에만 남는다
+   * (서버에 칸을 만들지 않는다 — A17 ①). 세션 자체는 자기가 어느 대화였는지 이미 안다.
+   */
+  private onModePick(kind: string) {
+    if (!this.mode || kind === this.mode.kind) return
+    try {
+      if (this.subject) localStorage.setItem(`assistant-mode:${this.subject}`, kind)
+    } catch {
+      /* 저장이 막힌 브라우저에서도 고르기 자체는 된다 — 다음에 다시 고르면 될 뿐이다. */
+    }
+    this.askHostForMode(kind)
+  }
+
+  /**
+   * **고르는 것은 청하는 일이다** — `mode` 를 여기서 바꾸지 않는다.
+   *
+   * host 는 렌더마다 `mode` 를 다시 내려 준다. 패널이 자기 손으로 고쳐 두면 다음 렌더가 그것을 덮고,
+   * 더 나쁜 것은 host 가 **자기가 무엇을 열었는지 모르는 채로 남는다**는 것이다. host 는 대화의 세션을
+   * 대상별로 들고 있으므로, 대화가 바뀐 것을 모르면 앞 대화의 세션을 그대로 넘긴다 — 그러면 새 말이 앞
+   * 대화에 붙는다(2026-09-18 Figure 레인이 :3300 에서 본 것이 이것이다).
+   *
+   * 그래서 주인은 하나다: host 가 `mode` 를 갖고, 패널은 「이것으로 바꿔 달라」고 말한다. 기억은 패널이
+   * 진다(브라우저마다 다른 값이라 host 가 질 것이 아니다) — 기억한 것을 되살릴 때도 같은 청으로 나간다.
+   */
+  private askHostForMode(kind: string) {
+    this.dispatchEvent(
+      new CustomEvent('assistant-mode-change', { detail: { kind, subject: this.subject }, bubbles: true, composed: true })
+    )
+  }
+
+  /** 이 subject 에서 지난번에 고른 대화 — 없으면 undefined. */
+  private rememberedMode(subject: string): string | undefined {
+    try {
+      return localStorage.getItem(`assistant-mode:${subject}`) ?? undefined
+    } catch {
+      return undefined
+    }
+  }
+
+  private async loadModeView() {
+    const mode = this.mode
+    if (!mode?.kind) {
+      this.modeView = undefined
+      return
+    }
+    const token = ++this.modeViewToken
+    try {
+      const result = await client.query({ query: ASSISTANT_MODE_QUERY, variables: { kind: mode.kind }, fetchPolicy: 'cache-first' })
+      /* A late answer for a conversation the person has already left is dropped. */
+      if (token !== this.modeViewToken) return
+      this.modeView = result.data?.assistantMode
+      this.rebuildMentionCaches()
+    } catch (error) {
+      if (token !== this.modeViewToken) return
+      this.modeView = undefined
+      /*
+       * A kind this server does not have is a mismatched deployment, and the person should read it
+       * rather than watch an empty `/` list.
+       */
+      this.errorMessage = error instanceof Error ? error.message : String(error)
+    }
+  }
+
   /*
    * The `@` and `/` candidates, built once per mode.
    *
@@ -775,6 +1001,52 @@ export class OxAssistantChat extends LitElement {
     }
 
     /* ── C4 Roster (participants + presence) ───────────── */
+    /* 이 대화의 주어 — 같은 화면 위에 두 대화가 설 때만 나온다(ADR-0072 A17 ①).
+       지금 대화가 제목 굵기로 서고, 바꿀 자리가 그 옆에 붙는다. 세션 탭과 같은 무게로 그리지 않는다
+       (UX 레인, 2026-09-18) — 한쪽은 화제를 바꾸고 한쪽은 실타래를 바꾼다. */
+    .mode-subject {
+      display: flex;
+      align-items: baseline;
+      gap: 8px;
+      padding: 6px 12px;
+      border-bottom: 1px solid var(--md-sys-color-outline-variant, #e2e8f0);
+    }
+    .mode-now {
+      /* 고른 상태의 색은 세션 탭과 같은 계열이다 — 한 패널 안에서 「골랐다」가 두 색으로 나오면 읽는
+         사람은 두 색이 서로 다른 뜻인 줄 안다.
+
+         12px 이었다가 한 단 내렸다. 도크 제목(figure 의 .scope-title 이 12.5px / 650)과 0.5px ·
+         굵기 50 차이는 눈에 닿지 않아서, 거의 같은 제목 줄이 둘 포개졌다. 도크 제목은 그 도크 전체를
+         거느리고 이 줄은 그 안 대화 하나의 성질이다 — 11px 이면 이 패널의 다른 조작부와 같은 단이고,
+         「이것이 주어다」는 색이 계속 진다(UX 레인, 2026-09-18). */
+      color: var(--primary-color, #007f87);
+      font-size: 11px;
+      font-weight: 600;
+    }
+    .mode-switch,
+    .mode-select {
+      appearance: none;
+      background: transparent;
+      border: 1px solid var(--md-sys-color-outline-variant, #cbd5e1);
+      border-radius: 999px;
+      color: var(--md-sys-color-on-surface-variant, #475569);
+      cursor: pointer;
+      font: inherit;
+      font-size: 11px;
+      padding: 2px 10px;
+      white-space: nowrap;
+    }
+    .mode-switch:hover:not([disabled]) {
+      background: color-mix(in srgb, var(--primary-color, #007f87) 7%, transparent);
+      color: var(--primary-color, #007f87);
+    }
+    /* 답하는 동안에도 「내가 지금 무엇에 대해 말하고 있나」는 또렷해야 한다 — 흐려지는 것은 바꿀
+       자리뿐이다. 지금 대화까지 흐리면 그 한 줄이 가장 안 보인다. */
+    .mode-subject [disabled] {
+      cursor: default;
+      opacity: 0.5;
+    }
+
     .roster {
       display: flex;
       align-items: center;
@@ -1325,6 +1597,29 @@ export class OxAssistantChat extends LitElement {
       overflow: visible;
     }
 
+    /* 값이 안 온 줄 — ADR-0073 판정 1.
+       말풍선의 자리와 「AI」 딱지는 지킨다 — 그 줄은 어시스턴트의 답이 맞고, 읽는 사람이 못 지나간
+       것이다. 점선 테두리와 흐린 색이 「이것은 그가 쓴 문장이 아니다」를 말한다.
+
+       기울임은 쓰지 않는다. 이 앱의 글꼴 묶음에 한글 이탤릭 자소가 없어 브라우저가 합성으로 기울이고,
+       획 균형이 무너져 작은 글자가 먼저 안 읽힌다. UX 레인이 :4000 에서 재 보았다 — 「권한」의 진행
+       폭이 normal·italic 둘 다 27.6875px 로 같다(2026-09-18). */
+    .msg.redacted {
+      background: transparent;
+      border: 1px dashed var(--md-sys-color-outline-variant, #cbd5e1);
+      color: var(--md-sys-color-outline, #94a3b8);
+    }
+    .redacted-body {
+      align-items: center;
+      display: flex;
+      gap: 6px;
+    }
+    .redacted-body md-icon {
+      /* md-icon 은 자기 크기를 이 변수로 잡는다 — width/height 만 주면 아무 일도 안 일어난다. */
+      --md-icon-size: 14px;
+      font-size: 14px;
+    }
+
     .msg.pending {
       opacity: 0.5;
     }
@@ -2185,6 +2480,20 @@ export class OxAssistantChat extends LitElement {
       cursor: not-allowed;
     }
 
+    /* 보내기 전에 보이는 초대 안내 — 누르기 전에 알아야 하는 사실이다. */
+    .invite-notice {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      margin: 0 2px 4px;
+      color: var(--md-sys-color-on-surface-variant, #475569);
+      font-size: 11.5px;
+    }
+
+    .invite-notice md-icon {
+      --md-icon-size: 15px;
+    }
+
     /* ── Send button — ChatGPT 스타일 원형 ↑ (.input-row 안의 button 만) ─── */
     .input-row > button {
       width: 32px;
@@ -2206,6 +2515,15 @@ export class OxAssistantChat extends LitElement {
       align-self: flex-end;
       margin-bottom: 2px;
     }
+    /*
+      방에 말하는 자리는 **두 번째 행동**이다 — 이 화면의 첫 행동은 어시스턴트에게 묻는 것이다.
+      같은 무게로 두면 무엇이 기본인지 화면이 말하지 않게 된다(ADR-0070 A15 의 자리 둘).
+    */
+    .input-row > button.say-to-room {
+      background: var(--md-sys-color-surface-container-highest, #e2e8f0);
+      color: var(--md-sys-color-on-surface-variant, #475569);
+    }
+
     .input-row > button:disabled {
       background: var(--md-sys-color-surface-container-highest, #e2e8f0);
       color: var(--md-sys-color-outline, #94a3b8);
@@ -2241,6 +2559,23 @@ export class OxAssistantChat extends LitElement {
     // 첫 마운트 시 sessionId 가 이미 set 돼있어도 loadHistory 는 첫 render 후 updated()
     // 가 처리 — 단일 진입점으로 일관 (이전엔 connectedCallback 과 updated 양쪽이 호출 →
     // 동시 fetch race 발생).
+    /* 모드가 이미 붙어 있으면 무엇을 주는지 먼저 묻는다 — 바뀔 때는 updated 가 다시 묻는다. */
+    if (this.mode?.kind) this.loadModeView()
+    if (this.subject) this.onSubjectChanged()
+  }
+
+  /**
+   * 화면이 보여 주는 것의 종류가 바뀌었다 — 설 수 있는 대화를 다시 묻고, 지난번 고른 것을 되살린다.
+   *
+   * 되살리는 것은 **고른 대화**이지 세션이 아니다. 세션은 자기가 어느 대화였는지 이미 알고, 다른
+   * 대화로 가면 그때 새로 난다(ADR-0072 A17 ①).
+   */
+  private async onSubjectChanged() {
+    await this.loadModeChoices()
+    if (this.modeChoices.length < 2 || !this.subject || !this.mode) return
+
+    const kind = pickInitialMode(this.mode.kind, this.modeChoices, this.rememberedMode(this.subject))
+    if (kind && kind !== this.mode.kind) this.askHostForMode(kind)
   }
 
   updated(changed: Map<string, any>) {
@@ -2268,8 +2603,14 @@ export class OxAssistantChat extends LitElement {
      * The host still owns `sessionId`; it hears `assistant-mode-changed` and decides whether
      * this subject gets a stored session of its own.
      */
+    /* 보는 것의 종류가 바뀌면 설 수 있는 대화도 달라진다 — 보드에서 현장으로 넘어간 자리. */
+    if (changed.has('subject')) this.onSubjectChanged()
+
     if (changed.has('mode') && isDifferentConversation(changed.get('mode'), this.mode)) {
+      /* What this conversation offers is the new mode's; ask before drawing the panel again. */
+      this.modeView = undefined
       this.rebuildMentionCaches()
+      this.loadModeView()
       this.lines = []
       this.pickedMentions.clear()
       this.pickedUserMentions.clear()
@@ -2319,6 +2660,10 @@ export class OxAssistantChat extends LitElement {
   disconnectedCallback() {
     this._stopPresence()
     this._stopMessageSubscription()
+    if (this.elapsedTimer) {
+      clearInterval(this.elapsedTimer)
+      this.elapsedTimer = undefined
+    }
     super.disconnectedCallback()
   }
 
@@ -2455,6 +2800,7 @@ export class OxAssistantChat extends LitElement {
       ${this.toastMessage
         ? html`<div class="toast show">${this.toastMessage}</div>`
         : nothing}
+      ${this.renderModeSubject()}
       ${this.renderSessionTabs()}
       ${this.renderRoster()}
       <div class="messages" @click=${this.onBubbleClick}>
@@ -2472,8 +2818,12 @@ export class OxAssistantChat extends LitElement {
           const prevSameSender = !!prev && prev.role === 'user' && prev.senderEmail === line.senderEmail
           const showSenderLabel = isOther && !prevSameSender
           const content = (line.content ?? '').trim()
-          const isMarkdown = line.role !== 'system' && content.length > 0
-          const showActions = line.role !== 'system' && !line.pending && content.length > 0
+          /*
+           * 가려진 줄은 어시스턴트의 말이 아니다 — 마크다운으로 그리지 않고, 복사·재실행 같은 손잡이도
+           * 달지 않는다(ADR-0073 판정 1). 그 손잡이들은 있지도 않은 답을 다룬다.
+           */
+          const isMarkdown = line.role !== 'system' && content.length > 0 && !line.redacted
+          const showActions = line.role !== 'system' && !line.pending && content.length > 0 && !line.redacted
           return html`
             ${showLabel
               ? html`<div class="msg-label">${i18next.t('ai-assistant.label.ai')}</div>`
@@ -2484,9 +2834,11 @@ export class OxAssistantChat extends LitElement {
               <div
                 class="msg ${line.role} ${isOther ? 'other' : ''} ${line.pending ? 'pending' : ''} ${line.systemOpen
                   ? 'open'
-                  : ''}">
+                  : ''} ${line.redacted ? 'redacted' : ''}">
                 ${line.pending
                   ? html`<span class="typing-dots"><span></span><span></span><span></span></span>`
+                  : line.redacted
+                    ? html`<div class="redacted-body"><md-icon>lock</md-icon><span>${content}</span></div>`
                   : isMarkdown
                     ? html`<div class="md-body">${unsafeHTML(renderMarkdown(content))}</div>`
                     : line.role === 'system'
@@ -2587,7 +2939,7 @@ export class OxAssistantChat extends LitElement {
             id="chat-file-input"
             type="file"
             multiple
-            accept="image/*,.json,.txt,.csv"
+            accept="image/*"
             style="display: none"
             @change=${(e: Event) => {
               const input = e.target as HTMLInputElement
@@ -2601,7 +2953,7 @@ export class OxAssistantChat extends LitElement {
             type="button"
             class="action"
             @click=${() => this.renderRoot.querySelector<HTMLInputElement>('#chat-file-input')?.click()}
-            title=${i18next.t('ai-assistant.tooltip.attach-file', { defaultValue: 'Attach images or files (drag & drop or paste supported)' })}>
+            title=${i18next.t('ai-assistant.tooltip.attach-file', { defaultValue: 'attach an image (drag & drop or paste supported)' })}>
             <md-icon>attach_file</md-icon>
             ${i18next.t('ai-assistant.button.attach', { defaultValue: 'Attach' })}
           </button>
@@ -2647,6 +2999,7 @@ export class OxAssistantChat extends LitElement {
               </div>
             `
           : nothing}
+        ${this.renderInviteNotice()}
         <div class="input-row">
           <div class="textarea-wrap">
             <textarea
@@ -2660,7 +3013,9 @@ export class OxAssistantChat extends LitElement {
               }}
               ?disabled=${this.busy}
               rows="1"
-              placeholder=${this.placeholder ?? i18next.t('ai-assistant.text.input-placeholder')}></textarea>
+              placeholder=${this.conversation.placeholder ??
+                this.placeholder ??
+                i18next.t('ai-assistant.text.input-placeholder')}></textarea>
             ${this.mentionOpen
               ? html`
                   <ox-mention-popup
@@ -2681,6 +3036,27 @@ export class OxAssistantChat extends LitElement {
                 `
               : nothing}
           </div>
+          ${/*
+              두 자리다 — 어시스턴트에게 묻는 자리와 **방에 말하는 자리**. 누른 자리가 그 말의 대상을
+              정하고, 서버는 어느 문이 불렸는지로 그 사실을 저장한다(ADR-0070 A15 결정 ①).
+
+              **방에 사람이 있을 때만 보인다.** 혼자 쓰는 대화에서 「방에 말하기」는 아무에게도 하지 않는
+              말이고, 누를 일이 없는 단추는 무엇이 기본인지 흐린다. 조건은 참여자 목록과 같다(둘 이상) —
+              둘째 사람은 멘션으로 들어오고, 그 순간 이 자리도 함께 선다.
+            */ ''}
+          ${this.sessionId && this.participants.length >= 2
+            ? html`
+                <button
+                  class="say-to-room"
+                  ?disabled=${this.busy || !this.input.trim()}
+                  @click=${() => this.sayToRoom()}
+                  title=${i18next.t('ai-assistant.text.say-to-room-tooltip', {
+                    defaultValue: 'say this to the people here — the assistant does not answer'
+                  })}>
+                  <md-icon>forum</md-icon>
+                </button>
+              `
+            : nothing}
           <button
             ?disabled=${this.busy || (!this.input.trim() && this.attachments.length === 0)}
             @click=${this.send}
@@ -2694,6 +3070,83 @@ export class OxAssistantChat extends LitElement {
     `
   }
 
+  /**
+   * 방에 말한다 — 어시스턴트는 답하지 않는다.
+   *
+   * 저장되는 대화가 있을 때만 할 수 있다. 세션이 없는 즉석 질문에는 「방」이 없다 — 그 자리에서
+   * 한 말은 누구에게도 남지 않는다.
+   */
+  private async sayToRoom() {
+    const body = this.input.trim()
+    if (!body || this.busy) return
+    if (!this.sessionId) {
+      /* 말할 방이 없다는 사실을 말한다 — 조용히 버리면 사람은 말했다고 믿는다. */
+      this.errorMessage = i18next.t('ai-assistant.text.no-room-yet', {
+        defaultValue: 'this conversation is not saved yet, so there is nobody else in it to talk to'
+      })
+      return
+    }
+
+    const localId = `local-${++this._localSeq}-r`
+    this.lines = [...this.lines, { role: 'user', content: body, _localId: localId, senderEmail: this._myEmail }]
+    this.input = ''
+    this.busy = true
+    try {
+      const result = await client.mutate({
+        mutation: SAY_TO_ROOM_MUTATION,
+        variables: { sessionId: this.sessionId, content: body }
+      })
+      /* 방송 에코와 겹치지 않게 서버 id 로 맞춘다 — 보낸 말이 두 줄로 보이지 않게. */
+      this._reconcileSentLine(localId, result.data?.sayToRoom ?? undefined, {})
+    } catch (error) {
+      this.lines = this.lines.filter(line => line._localId !== localId)
+      this.input = body
+      this.errorMessage = error instanceof Error ? error.message : String(error)
+    } finally {
+      this.busy = false
+    }
+  }
+
+  /**
+   * 보내기 전에 말한다 — 「이 사람은 이 대화에 들어옵니다」(ADR-0071 결정 1 ④).
+   *
+   * 멘션은 사람을 불러들인다. 누른 뒤에 알면 이미 들어와 있고, 협의의 공개 범위는 되돌리기 어려운
+   * 종류의 일이다. 그래서 **아직 보내지 않은 상태에서** 누가 들어오게 되는지 보인다.
+   *
+   * 초대할 수 없는 자리(보기 권한 · 아직 참여자가 아님)라면 그 사실을 말한다 — 눌렀는데 아무 일도
+   * 일어나지 않는 것이 가장 나쁘다.
+   */
+  private renderInviteNotice() {
+    if (!this.sessionId) return nothing
+
+    const here = new Set(this.participants.map(p => p.user?.id).filter(Boolean) as string[])
+    const incoming = [...this.pickedUserMentions.entries()]
+      .filter(([token, userId]) => this.input.includes(`@${token}`) && !here.has(userId))
+      .map(([token]) => token)
+    if (incoming.length === 0) return nothing
+
+    const myRole = this.participants.find(p => p.user?.id && p.user.id === this._myUserId)?.role
+    const mayInvite = myRole === 'owner' || myRole === 'member'
+    const names = incoming.map(token => `@${token}`).join(', ')
+
+    return html`
+      <div class="invite-notice">
+        <md-icon>person_add</md-icon>
+        <span>
+          ${mayInvite
+            ? i18next.t('ai-assistant.text.will-be-invited', {
+                names,
+                defaultValue: '{names} will join this conversation when you send'
+              })
+            : i18next.t('ai-assistant.text.cannot-invite', {
+                names,
+                defaultValue: '{names} will not join — only the people already in this conversation can bring someone in'
+              })}
+        </span>
+      </div>
+    `
+  }
+
   private onKeyDown(e: KeyboardEvent) {
     // Mention popup 활성 시 — 화살표/Enter/Tab/Esc 가로채서 popup 네비게이션
     if (this.mentionOpen) {
@@ -2815,13 +3268,32 @@ export class OxAssistantChat extends LitElement {
     this.highlightMatchedCandidates()
   }
 
+  /**
+   * 호스트가 목록을 주지 않을 때 이 도메인의 사용자를 직접 묻는다.
+   *
+   * 실패는 빈 목록이다 — 멘션을 못 고르는 것이지 대화가 막힐 일은 아니다.
+   */
+  private async fetchDomainUsers(query: string): Promise<Array<{ id: string; name?: string | null; email?: string | null }>> {
+    try {
+      const result = await client.query({
+        query: DOMAIN_USERS_FOR_MENTION_QUERY,
+        variables: { query },
+        fetchPolicy: 'network-only'
+      })
+      return result.data?.domainUsersForMention ?? []
+    } catch {
+      return []
+    }
+  }
+
   /** `@` query 에 대한 userProvider 비동기 호출 — 응답 도착 시 popup 결과 갱신.
    *  race 방지: token 으로 최신 호출 식별 (늦게 도착한 응답 무시). */
   private async refreshUserCandidatesAsync(query: string, hashPos: number) {
-    if (!this.userProvider) return
     const token = ++this.userFetchToken
     try {
-      const users = await Promise.resolve(this.userProvider(query))
+      const users = this.userProvider
+        ? await Promise.resolve(this.userProvider(query))
+        : await this.fetchDomainUsers(query)
       if (token !== this.userFetchToken) return // 더 최신 호출이 있음
       // popup 이 닫혔거나 trigger / hashPos 가 바뀌면 무시
       if (!this.mentionOpen || this.mentionTrigger !== '@' || this.mentionHashPos !== hashPos) {
@@ -3006,6 +3478,11 @@ export class OxAssistantChat extends LitElement {
    * 읽었고, 그러면 호스트 값을 한쪽만 반영하는 상태가 만들어질 수 있었다.
    */
   private get exampleGroups(): Array<{ label: string; items: string[] }> {
+    /*
+     * 대화가 자기 예시를 가지면 그것이 먼저다 — 자리표·`/` 와 같은 차례(ADR-0061 결정 7). host 속성은
+     * 대화를 모르므로, 한 화면에 대화가 둘 서면 한쪽에 맞는 글이 다른 쪽에도 뜬다.
+     */
+    if (this.modeView?.examples?.length) return this.modeView.examples
     if (this.examples?.length) return this.examples
     return OxAssistantChat.EXAMPLE_GROUPS.map(group => ({
       label: i18next.t(group.labelKey),
@@ -3051,6 +3528,63 @@ export class OxAssistantChat extends LitElement {
 
   /** 보드의 세션 탭 — 다중 세션 활성화 시 패널 상단. host 가 sessions 비워두면 표시 X.
    *  레이블은 session.name 우선, 없으면 fallback "세션 N". */
+  /**
+   * 이 대화의 **주어** — 같은 화면 위에 두 대화가 설 때만 나온다(ADR-0072 A17 ①).
+   *
+   * 하나뿐이면 아무것도 그리지 않는다. 고를 것이 없는 고르개는 자리만 차지하고, 사람에게 「무언가
+   * 고를 것이 있다」는 잘못된 신호를 준다.
+   *
+   * ── 왜 탭 줄이 아닌가 (UX 레인, 2026-09-18) ───────────────────────────────
+   * 처음에는 칩 줄에 `role="tablist"` 를 달았다. 바로 아래가 세션 탭이고 그쪽도 tablist 라서, 화면
+   * 낭독기로 들으면 「탭 목록, 대화」 다음에 「탭 목록, Conversation history」 가 이어졌다 — 고르는
+   * 축이 둘인데 둘 다 「탭」이라고 말한다. 게다가 ARIA 탭은 좌우 화살표 이동과 `tabpanel` 이 함께
+   * 있어야 성립하고, 둘 다 없으면 낭독기는 「2 중 1번째 탭」이라 말하고 화살표는 아무 일도 안 한다.
+   *
+   * 무게도 다르다. 세션은 「어느 지난 대화냐」이고 모드는 「이 대화가 무엇에 대한 것이냐」이다. 같은
+   * 무게로 그리면 어느 쪽이 화제를 바꾸고 어느 쪽이 실타래를 바꾸는지 구별되지 않는다. 그래서 지금
+   * 대화가 제목 굵기로 서고, 바꿀 자리는 그 옆에 붙는다.
+   *
+   * ── 왜 도크 제목 줄로 안 올리나 (UX 레인 판정, 2026-09-18) ────────────────
+   * 도크 제목은 「지금 어디에 있나」(이 도형 · 이 현장 · 이 스테이션 화면)이고 이 줄은 「이 대화가
+   * 무엇에 대한 것이냐」이다. 대화의 주어는 대화 안에 있다. 그리고 세 도크가 각자 그리면 세 벌이 되고
+   * 그 세 벌은 갈린다 — `modeChoices` 를 아는 것도 여기다. 올리면 목록과 고른 것이 세 자리로 나갔다
+   * 돌아온다.
+   */
+  private renderModeSubject() {
+    if (this.modeChoices.length < 2) return nothing
+
+    const current = this.modeChoices.find(choice => choice.kind === this.mode?.kind)
+    const others = this.modeChoices.filter(choice => choice.kind !== this.mode?.kind)
+
+    return html`
+      <div class="mode-subject">
+        <span class="mode-now">${current?.label ?? this.mode?.kind ?? ''}</span>
+        ${others.length === 1
+          ? html`
+              <button
+                class="mode-switch"
+                title=${i18next.t('ai-assistant.text.switch-conversation', { name: others[0].label })}
+                aria-label=${i18next.t('ai-assistant.text.switch-conversation', { name: others[0].label })}
+                ?disabled=${this.busy}
+                @click=${() => this.onModePick(others[0].kind)}>
+                ${others[0].label}
+              </button>
+            `
+          : html`
+              <select
+                class="mode-select"
+                aria-label=${i18next.t('ai-assistant.label.conversation')}
+                ?disabled=${this.busy}
+                @change=${(event: Event) => this.onModePick((event.target as HTMLSelectElement).value)}>
+                ${this.modeChoices.map(
+                  choice => html`<option value=${choice.kind} ?selected=${choice.kind === this.mode?.kind}>${choice.label}</option>`
+                )}
+              </select>
+            `}
+      </div>
+    `
+  }
+
   private renderSessionTabs() {
     if (!this.sessions || this.sessions.length === 0) return nothing
     return html`
@@ -3110,8 +3644,13 @@ export class OxAssistantChat extends LitElement {
       <div class="empty">
         <div class="header">
           <md-icon class="icon">auto_awesome</md-icon>
-          <div class="title">${this.intro?.title ?? i18next.t('ai-assistant.text.empty-title')}</div>
-          <div class="subtitle">${this.intro?.subtitle ?? i18next.t('ai-assistant.text.empty-subtitle')}</div>
+          <!-- 대화가 자기 글을 가지면 그것이 먼저다 — host 속성은 대화를 모른다. -->
+          <div class="title">
+            ${this.modeView?.intro?.title ?? this.intro?.title ?? i18next.t('ai-assistant.text.empty-title')}
+          </div>
+          <div class="subtitle">
+            ${this.modeView?.intro?.subtitle ?? this.intro?.subtitle ?? i18next.t('ai-assistant.text.empty-subtitle')}
+          </div>
         </div>
 
         ${this.triggerChips.length > 0
@@ -3154,8 +3693,8 @@ export class OxAssistantChat extends LitElement {
           <span class="badge">${i18next.t('ai-assistant.label.korean-supported')}</span>
           <span class="badge">${i18next.t('ai-assistant.label.multi-command')}</span>
           <span class="badge">${i18next.t('ai-assistant.label.review-able')}</span>
-          ${this.conversation.footerNoticeKey
-            ? html`<br />${i18next.t(this.conversation.footerNoticeKey)}`
+          ${this.conversation.footerNotice
+            ? html`<br />${this.conversation.footerNotice}`
             : ''}
         </div>
       </div>
@@ -3334,8 +3873,9 @@ export class OxAssistantChat extends LitElement {
                 class="run"
                 ?disabled=${sent}
                 @click=${() => this.executeProposal(p, key)}>
-                ${sent ? i18next.t('ai-assistant.text.proposal-sent', { defaultValue: 'execution requested' })
-                       : i18next.t('ai-assistant.button.run-proposal', { defaultValue: 'run' })}
+                ${sent
+                  ? this.proposalStateText(key)
+                  : i18next.t('ai-assistant.button.run-proposal', { defaultValue: 'run' })}
               </button>
               ${/*
                   Drawn only where the host has said it staged this candidate, in the host's own
@@ -3343,15 +3883,15 @@ export class OxAssistantChat extends LitElement {
                   This badge used to read "there are chips" as "the model is in the 3D viewer" and
                   say so, in a component that plant and twin also use.
                 */ ''}
-              ${this.stagedProposals.has(key) && this.conversation.stagedNoticeKey ? html`
+              ${this.stagedProposals.has(key) && this.conversation.stagedNotice ? html`
                 <span class="staged-badge">
                   <md-icon>check_circle</md-icon>
-                  <span>${i18next.t(this.conversation.stagedNoticeKey!)}</span>
+                  <span>${this.conversation.stagedNotice}</span>
                 </span>
               ` : nothing}
             </div>
             ${rawChoices.length ? html`
-              <div class="proposal-choices" role="group" aria-label="대화 선택지">
+              <div class="proposal-choices" role="group" aria-label=${i18next.t('ai-assistant.text.proposal-choices', { defaultValue: 'follow-up choices' })}>
                 ${rawChoices.map((c: any) => html`
                   <button
                     class="choice-chip ${c.primary ? 'primary' : ''}"
@@ -3369,6 +3909,51 @@ export class OxAssistantChat extends LitElement {
     `
   }
 
+  /**
+   * 눌린 카드가 말하는 것 — **호스트가 한 일**이고, 아직 모르면 모른다고 말한다.
+   *
+   * 예전에는 누른 순간 「실행됨」이었다. 09-18 트윈에서 아무 일도 일어나지 않은 채 「✓ 반영했습니다」가
+   * 떴다(ADR-0070 A12-a).
+   */
+  private proposalStateText(key: string): string {
+    const outcome = this.proposalOutcomes.get(key)
+
+    if (!outcome) {
+      /* 답이 오기 전 — 아는 사실은 「보냈고 아직 답이 없다」뿐이다. 경과 시간을 함께 보인다. */
+      const since = this.proposalSentAt.get(key)
+      const seconds = since ? Math.max(0, Math.round((Date.now() - since) / 1000)) : 0
+      return i18next.t('ai-assistant.text.proposal-waiting', {
+        seconds,
+        defaultValue: 'sending — {seconds}s, no answer yet'
+      })
+    }
+
+    const counted =
+      typeof outcome.applied === 'number' && typeof outcome.total === 'number' && outcome.total > 0
+        ? i18next.t('ai-assistant.text.proposal-applied-count', {
+            applied: outcome.applied,
+            total: outcome.total,
+            defaultValue: ' {applied} of {total}'
+          })
+        : ''
+
+    /* 사유는 호스트가 준 코드 그대로다 — 문장으로 바꾸지 않는다(ADR-0042). */
+    const reason = outcome.errorCode ? ` (${outcome.errorCode})` : ''
+
+    const verdict = i18next.t(`ai-assistant.verdict.${outcome.verdict}`, {
+      defaultValue:
+        outcome.verdict === 'accepted'
+          ? 'done'
+          : outcome.verdict === 'refused'
+            ? 'refused'
+            : outcome.verdict === 'declined'
+              ? 'cancelled'
+              : 'could not run'
+    })
+
+    return `${verdict}${counted}${reason}`
+  }
+
   private onChoiceClick(choice: any, proposal: any, key: string) {
     if (choice.action === 'save') {
       this.dispatchEvent(
@@ -3420,10 +4005,17 @@ export class OxAssistantChat extends LitElement {
         .map(k => `${JSON.stringify(k)}:${stable(v[k])}`)
         .join(',')}}`
     }
+    /*
+     * 서버가 실어 보낸 키가 정본이다 — 무엇이 같은 조치인가는 제안을 만든 쪽이 안다(ADR-0061 결정
+     * 7 뒤 정리). 예전에는 여기서 `command|instanceId|args` 로 다시 셌는데, 명령이 없는 제안(선언 ·
+     * 새 트윈 초안)은 그 셋이 모두 비어 **서로 다른 제안이 한 카드로 접혔고**, 하나를 누르면 나머지가
+     * 함께 「요청됨」이 됐다.
+     */
+    if (typeof p?.key === 'string' && p.key) return p.key
     try {
-      return `${p?.command ?? ''}|${p?.instanceId ?? ''}|${stable(p?.args)}`
+      return `${p?.tool ?? ''}|${p?.command ?? ''}|${p?.instanceId ?? ''}|${stable(p?.args)}|${stable(p?.ops)}`
     } catch {
-      return `${p?.command ?? ''}|${p?.instanceId ?? ''}`
+      return `${p?.tool ?? ''}|${p?.command ?? ''}|${p?.instanceId ?? ''}`
     }
   }
 
@@ -3431,17 +4023,64 @@ export class OxAssistantChat extends LitElement {
    * 실행은 호스트가 한다 — 이 컴포넌트는 도메인(트윈 명령 채널)을 모른다.
    * 확인 대화·명령 전송·결과 기록은 호스트의 몫이고, 여기서는 중복 클릭만 막는다.
    */
+  /**
+   * 누른 시각 — 「보내는 중」 옆의 경과 시간용.
+   *
+   * 시간으로 실패를 판정하지 않는다(ADR-0070 A12-a 결정 ②). 아는 사실은 「아직 답을 받지 못했다」
+   * 하나이고, 시간이 지났다고 실패로 바꾸면 그것이 지어낸 원인이다.
+   */
+  private proposalSentAt = new Map<string, number>()
+
+  private elapsedTimer?: ReturnType<typeof setInterval>
+
   private executeProposal(p: any, key: string) {
     this.sentProposals = new Set(this.sentProposals).add(key)
+    this.proposalSentAt.set(key, Date.now())
+    this._startElapsedTicker()
     this.dispatchEvent(
       new CustomEvent('assistant-proposal-execute', {
-        detail: { proposal: p, sessionId: this.sessionId },
+        /*
+         * `proposalKey` 를 함께 준다 — 호스트가 `reportProposalOutcome` 으로 답할 때 쓰는 이름이다.
+         * 호스트가 자기 규칙으로 키를 다시 만들면 카드가 못 찾는 답이 생긴다(원본은 하나).
+         */
+        detail: { proposal: p, sessionId: this.sessionId, proposalKey: key },
         bubbles: true,
         composed: true
       })
     )
   }
 
+  /**
+   * 호스트가 무엇을 했는지 — 대화에 남은 `system` 행에서 읽는다(ADR-0070 A12-a 결정 ①).
+   *
+   * 카드가 자기 기억으로 상태를 들고 있으면 새로 고치는 순간 사라지고, 다른 창에서 실행한 것은
+   * 애초에 보이지 않는다. 그래서 상태의 자리는 이력이다.
+   */
+  private get proposalOutcomes(): Map<string, ParsedProposalOutcome> {
+    const outcomes = new Map<string, ParsedProposalOutcome>()
+    for (const line of this.lines) {
+      if (line.role !== 'system') continue
+      const parsed = parseProposalOutcomeLine(line.content ?? '')
+      if (parsed) outcomes.set(parsed.key, parsed)
+    }
+    return outcomes
+  }
+
+  /** 경과 시간을 보이는 동안에만 돈다 — 답이 오면 멈춘다. */
+  private _startElapsedTicker() {
+    if (this.elapsedTimer) return
+    this.elapsedTimer = setInterval(() => {
+      const outcomes = this.proposalOutcomes
+      const waiting = [...this.proposalSentAt.keys()].some(key => !outcomes.has(key))
+      if (!waiting) {
+        clearInterval(this.elapsedTimer)
+        this.elapsedTimer = undefined
+        return
+      }
+      this.requestUpdate()
+    }, 1000)
+  }
+
   /**
    * 접지 경고 — 답이 언급했지만 **근거에 없던** 대상을 알린다.
    *
@@ -3569,12 +4208,12 @@ export class OxAssistantChat extends LitElement {
   /** 배지 문구 — 코드가 아니라 사람 말로. */
   private outcomeLabel(outcome: string): string {
     const map: Record<string, [string, string]> = {
-      ok: ['ai-assistant.text.outcome-ok', '조회'],
-      rejected: ['ai-assistant.text.outcome-rejected', '거절'],
-      queued: ['ai-assistant.text.outcome-queued', '적용 예정'],
-      proposed: ['ai-assistant.text.outcome-proposed', '제안'],
-      folded: ['ai-assistant.text.outcome-folded', '중복 접힘'],
-      error: ['ai-assistant.text.outcome-error', '오류']
+      ok: ['ai-assistant.text.outcome-ok', 'read'],
+      rejected: ['ai-assistant.text.outcome-rejected', 'rejected'],
+      queued: ['ai-assistant.text.outcome-queued', 'to apply'],
+      proposed: ['ai-assistant.text.outcome-proposed', 'proposed'],
+      folded: ['ai-assistant.text.outcome-folded', 'duplicate'],
+      error: ['ai-assistant.text.outcome-error', 'error']
     }
     const [key, fallback] = map[outcome] ?? map.ok
     return i18next.t(key, { defaultValue: fallback })
@@ -3719,8 +4358,8 @@ export class OxAssistantChat extends LitElement {
 
     const promptText = text || (attachmentsToSend.length > 0
       ? (attachmentsToSend[0].type.startsWith('image/')
-          ? '첨부된 이미지를 참고하여 제안해 주세요.'
-          : '첨부된 파일을 확인해 주세요.')
+          ? i18next.t('ai-assistant.text.attached-image-ask', { defaultValue: 'here is an image — go by it.' })
+          : i18next.t('ai-assistant.text.attached-file-ask', { defaultValue: 'here is a file — take a look.' }))
       : '')
     if (!this.sessionId && this.prepareSession) {
       this.busy = true
@@ -3740,7 +4379,7 @@ export class OxAssistantChat extends LitElement {
     let requestBase: any
     try {
       const provided = this.contextProvider?.() || {}
-      requestContext = structuredClone({ systemPrompt: this.conversation.systemPrompt, hostContext: this.conversation.hostContext, ...provided })
+      requestContext = structuredClone({ hostContext: this.conversation.hostContext, ...provided })
       liveBoard = structuredClone(this.boardProvider ? this.boardProvider() : this.currentBoard)
       requestBase = { version: 1, sessionId: this.sessionId, hostContext: requestContext.hostContext,
         modelFingerprint: assistantModelFingerprint(liveBoard) }
@@ -3825,11 +4464,9 @@ export class OxAssistantChat extends LitElement {
             ? buildAssistantChatInput({
                 sessionId: this.sessionId,
                 history,
-                systemPrompt: requestContext.systemPrompt!,
+                mode: { kind: this.conversation.kind!, target: this.conversation.target },
                 truncateAfterMessageId: this._truncateAfterId,
-                hostContext: requestContext.hostContext,
-                toolCategories: this.conversation.toolCategories,
-                requireGroundingTools: this.requireGroundingTools
+                hostContext: requestContext.hostContext
               })
             : buildChatMutationInput({
                 sessionId: this.sessionId,
@@ -3838,7 +4475,8 @@ export class OxAssistantChat extends LitElement {
                 scopes: this.scopes,
                 truncateAfterMessageId: this._truncateAfterId,
                 hostContext: requestContext.hostContext,
-                toolCategories: this.conversation.toolCategories,
+                /* The board door still takes its categories from the element — it declares no mode. */
+                toolCategories: this.toolCategories,
                 boardTools: this.boardTools,
                 requireGroundingTools: this.requireGroundingTools,
                 knownTypes: this.knownTypes,