@things-factory/ai-assistant 10.1.87 → 10.1.90

package/test/entry-proposal.test.ts

@@ -0,0 +1,67 @@
+/*
+ * The data entry card on the screen (design/ai/data-entry.md §5) - what it counts, which card is current,
+ * and what it leaves in the conversation. The chat's wiring is read as text: importing it pulls the shell.
+ */
+import { readFileSync } from 'fs'
+import { join } from 'path'
+
+import { runProposal, setEntryProposalHandler } from '../client/utils/assistant-proposals'
+import {
+  entryOutcomeNote,
+  entryProposalHandler,
+  entryReadyCount,
+  latestEntryKeys,
+  type EntryApplyAnswer
+} from '../client/utils/entry-proposal'
+
+const t = (key: string, options: any = {}) =>
+  String(options.defaultValue ?? key).replace(/\{(\w+)\}/g, (_, name) => String(options[name] ?? ''))
+
+const card = (key: string, target = 'office.expense-line', rows: any[] = []) => ({ key, kind: 'entry', target, rows })
+
+describe('the entry card', () => {
+  it('★ counts only the rows that will go in', () => {
+    const p = card('k', undefined, [
+      { index: 0, values: {}, sources: [], issues: [] },
+      { index: 1, values: {}, sources: [], issues: [{ code: 'required', field: 'amount', blocking: true }] },
+      { index: 2, values: {}, sources: [], issues: [{ code: 'no-source', blocking: false }] }
+    ])
+    expect(entryReadyCount(p)).toBe(2)
+  })
+
+  it('★ the newest card per record is the current one - an older one is replaced', () => {
+    const latest = latestEntryKeys([[card('k1')], [{ key: 'x', tool: 'proposeAction' }], [card('k2'), card('k3', 'office.leave')]])
+    expect(latest.get('office.expense-line')).toBe('k2')
+    expect(latest.get('office.leave')).toBe('k3')
+  })
+
+  it('leaves in the conversation what went in and each row that did not, by its place', () => {
+    const answer: EntryApplyAnswer = {
+      verdict: 'accepted',
+      applied: 2,
+      missed: 1,
+      rows: [{ index: 0, ok: true }, { index: 1, ok: false, error: 'closed period' }, { index: 2, ok: true }]
+    }
+    expect(entryOutcomeNote(answer, t)).toBe('entered 2 rows.\nrow 2: closed period')
+  })
+
+  it('★ every entry card runs the one framework handler, whatever record it enters - no app registers one', async () => {
+    const asked: string[] = []
+    setEntryProposalHandler(
+      entryProposalHandler(async (sessionId, key) => {
+        asked.push(`${sessionId}/${key}`)
+        return { verdict: 'accepted', applied: 1, missed: 0, rows: [{ index: 0, ok: true }] }
+      }, t)
+    )
+    const outcome = await runProposal({ ...card('k9'), tool: 'proposeOfficeExpenseLineEntries' }, { sessionId: 's1', confirm: async () => true, notify: () => {} })
+    expect(asked).toEqual(['s1/k9'])
+    expect(outcome).toMatchObject({ verdict: 'accepted', applied: 1, missed: 0 })
+  })
+
+  it('the chat draws the review and names the button by the rows it enters', () => {
+    const chat = readFileSync(join(__dirname, '..', 'client', 'components', 'assistant-chat.ts'), 'utf8')
+    expect(chat).toContain('<ox-assistant-entry-review .proposal=${p}>')
+    expect(chat).toContain("'ai-assistant.entry.enter'")
+    expect(chat).toContain("'ai-assistant.entry.replaced'")
+  })
+})

package/test/open-doors.test.ts

@@ -142,11 +142,12 @@ describe('what the walk itself has to be true for', () => {
      * 2026-09-24: 27 root fields, 25 declared, 2 open — both streams.
      * 2026-09-25: 28 — attachToConversation (a conversation's files, shared dock §9), declared.
      * 2026-09-28: 29 — requestProposal (a proposal is requested once, ADR-0097 Q-D4), declared.
+     * 2026-09-30: 30 — applyEntryProposal (enter the rows the person pressed, design/ai/data-entry.md), declared.
      */
     const all = fieldsOf('Query').length + fieldsOf('Mutation').length + fieldsOf('Subscription').length
     const open = openFields('Query').length + openFields('Mutation').length + openFields('Subscription').length
 
-    expect(all).toBe(29)
+    expect(all).toBe(30)
     expect(open).toBe(2)
   })
 })

package/translations/en.json

@@ -197,5 +197,40 @@
   "ai-assistant.session.filter-private": "Private",
   "ai-assistant.session.filter-unread": "Unread",
   "ai-assistant.dock.ask-needs-conversation": "the question was not sent.",
-  "ai-assistant.dock.audience-open-band": "Public conversation - everyone in this domain can read and write here."
+  "ai-assistant.dock.audience-open-band": "Public conversation - everyone in this domain can read and write here.",
+  "ai-assistant.entry.rows": "{count} rows",
+  "ai-assistant.entry.ready": "{count} ready",
+  "ai-assistant.entry.blocked": "{count} will not be entered",
+  "ai-assistant.entry.cut": "{count} left out over the limit",
+  "ai-assistant.entry.source": "from",
+  "ai-assistant.entry.missing": "missing",
+  "ai-assistant.entry.more-rows": "{count} more rows are not shown - they are entered too.",
+  "ai-assistant.entry.check-failed": "the application could not check these rows; they are checked again when entered.",
+  "ai-assistant.entry.replaced": "replaced by a newer card",
+  "ai-assistant.entry.enter": "enter {count} rows",
+  "ai-assistant.entry.nothing-to-enter": "nothing to enter",
+  "ai-assistant.entry.entered": "entered {count} rows.",
+  "ai-assistant.entry.entered-none": "no row was entered.",
+  "ai-assistant.entry.row-refused": "row {n}: {reason}",
+  "ai-assistant.entry.more-refused": "{count} more rows were not entered.",
+  "ai-assistant.entry.issue.required": "no value",
+  "ai-assistant.entry.issue.not-a-number": "not a number",
+  "ai-assistant.entry.issue.not-an-integer": "not a whole number",
+  "ai-assistant.entry.issue.not-a-date": "not a date",
+  "ai-assistant.entry.issue.not-a-boolean": "not yes or no",
+  "ai-assistant.entry.issue.not-in-list": "not one of {values}",
+  "ai-assistant.entry.issue.unknown-field": "not a field of this record - left out",
+  "ai-assistant.entry.issue.no-source": "no source given",
+  "ai-assistant.entry.verified": "{count} found in their file",
+  "ai-assistant.entry.unmatched": "{count} with a value their file does not have",
+  "ai-assistant.entry.evidence": "found on line {line} of the file",
+  "ai-assistant.entry.total": "{field} total {sum}",
+  "ai-assistant.entry.total-ready": "entered {sum}",
+  "ai-assistant.entry.total-declared": "the material says {sum}",
+  "ai-assistant.entry.total-not-found": "not found in the file",
+  "ai-assistant.entry.total-differs": "differs by {sum}",
+  "ai-assistant.entry.total-matches": "matches",
+  "ai-assistant.entry.issue.not-in-source": "the file does not have this value",
+  "ai-assistant.entry.issue.source-scattered": "the values are not on one line of the file",
+  "ai-assistant.entry.issue.source-not-checked": "a photo cannot be checked here"
 }

package/translations/ja.json

@@ -197,5 +197,40 @@
   "ai-assistant.session.filter-private": "非公開",
   "ai-assistant.session.filter-unread": "未読",
   "ai-assistant.dock.ask-needs-conversation": "質問は送信されませんでした。",
-  "ai-assistant.dock.audience-open-band": "公開会話 — この事業所の誰でも読み書きできます。"
+  "ai-assistant.dock.audience-open-band": "公開会話 — この事業所の誰でも読み書きできます。",
+  "ai-assistant.entry.rows": "{count}行",
+  "ai-assistant.entry.ready": "入力可能 {count}",
+  "ai-assistant.entry.blocked": "{count}行は入力しません",
+  "ai-assistant.entry.cut": "上限を超えた{count}行は除外されました",
+  "ai-assistant.entry.source": "出典",
+  "ai-assistant.entry.missing": "なし",
+  "ai-assistant.entry.more-rows": "残り{count}行は表示されませんが、一緒に入力します。",
+  "ai-assistant.entry.check-failed": "アプリケーションがこれらの行を検査できませんでした。入力時に再検査します。",
+  "ai-assistant.entry.replaced": "新しいカードに置き換え",
+  "ai-assistant.entry.enter": "{count}行を入力",
+  "ai-assistant.entry.nothing-to-enter": "入力できる行なし",
+  "ai-assistant.entry.entered": "{count}行を入力しました。",
+  "ai-assistant.entry.entered-none": "入力された行はありません。",
+  "ai-assistant.entry.row-refused": "{n}行目: {reason}",
+  "ai-assistant.entry.more-refused": "さらに{count}行が入力されませんでした。",
+  "ai-assistant.entry.issue.required": "値がありません",
+  "ai-assistant.entry.issue.not-a-number": "数値ではありません",
+  "ai-assistant.entry.issue.not-an-integer": "整数ではありません",
+  "ai-assistant.entry.issue.not-a-date": "日付ではありません",
+  "ai-assistant.entry.issue.not-a-boolean": "はい/いいえではありません",
+  "ai-assistant.entry.issue.not-in-list": "許可された値ではありません ({values})",
+  "ai-assistant.entry.issue.unknown-field": "この記録にない項目のため除外しました",
+  "ai-assistant.entry.issue.no-source": "出典がありません",
+  "ai-assistant.entry.verified": "{count}行を資料と照合済み",
+  "ai-assistant.entry.unmatched": "{count}行に資料にない値",
+  "ai-assistant.entry.evidence": "資料の{line}行目で確認",
+  "ai-assistant.entry.total": "{field} 合計 {sum}",
+  "ai-assistant.entry.total-ready": "入力分 {sum}",
+  "ai-assistant.entry.total-declared": "資料の合計 {sum}",
+  "ai-assistant.entry.total-not-found": "資料で見つかりません",
+  "ai-assistant.entry.total-differs": "差 {sum}",
+  "ai-assistant.entry.total-matches": "一致",
+  "ai-assistant.entry.issue.not-in-source": "資料にない値です",
+  "ai-assistant.entry.issue.source-scattered": "値が資料の同じ行にありません",
+  "ai-assistant.entry.issue.source-not-checked": "写真の資料は照合できませんでした"
 }

package/translations/ko.json

@@ -197,5 +197,40 @@
   "ai-assistant.session.filter-private": "비공개",
   "ai-assistant.session.filter-unread": "안 읽음",
   "ai-assistant.dock.ask-needs-conversation": "질문을 보내지 않았습니다.",
-  "ai-assistant.dock.audience-open-band": "공개 대화 — 이 사업장의 누구나 읽고 쓸 수 있습니다."
+  "ai-assistant.dock.audience-open-band": "공개 대화 — 이 사업장의 누구나 읽고 쓸 수 있습니다.",
+  "ai-assistant.entry.rows": "{count}행",
+  "ai-assistant.entry.ready": "입력 가능 {count}",
+  "ai-assistant.entry.blocked": "{count}행은 입력하지 않습니다",
+  "ai-assistant.entry.cut": "한도를 넘어 {count}행이 빠졌습니다",
+  "ai-assistant.entry.source": "출처",
+  "ai-assistant.entry.missing": "없음",
+  "ai-assistant.entry.more-rows": "나머지 {count}행은 표에 보이지 않지만 함께 입력합니다.",
+  "ai-assistant.entry.check-failed": "애플리케이션이 이 행들을 검사하지 못했습니다. 입력할 때 다시 검사합니다.",
+  "ai-assistant.entry.replaced": "새 카드로 바뀜",
+  "ai-assistant.entry.enter": "{count}행 입력",
+  "ai-assistant.entry.nothing-to-enter": "입력할 행 없음",
+  "ai-assistant.entry.entered": "{count}행을 입력했습니다.",
+  "ai-assistant.entry.entered-none": "입력한 행이 없습니다.",
+  "ai-assistant.entry.row-refused": "{n}행: {reason}",
+  "ai-assistant.entry.more-refused": "{count}행이 더 입력되지 않았습니다.",
+  "ai-assistant.entry.issue.required": "값이 없습니다",
+  "ai-assistant.entry.issue.not-a-number": "숫자가 아닙니다",
+  "ai-assistant.entry.issue.not-an-integer": "정수가 아닙니다",
+  "ai-assistant.entry.issue.not-a-date": "날짜가 아닙니다",
+  "ai-assistant.entry.issue.not-a-boolean": "예/아니오가 아닙니다",
+  "ai-assistant.entry.issue.not-in-list": "허용된 값이 아닙니다 ({values})",
+  "ai-assistant.entry.issue.unknown-field": "이 기록에 없는 칸이라 뺐습니다",
+  "ai-assistant.entry.issue.no-source": "출처가 없습니다",
+  "ai-assistant.entry.verified": "{count}행 자료와 대조됨",
+  "ai-assistant.entry.unmatched": "{count}행에 자료에 없는 값",
+  "ai-assistant.entry.evidence": "자료 {line}번째 줄에서 확인",
+  "ai-assistant.entry.total": "{field} 합계 {sum}",
+  "ai-assistant.entry.total-ready": "입력분 {sum}",
+  "ai-assistant.entry.total-declared": "자료의 합계 {sum}",
+  "ai-assistant.entry.total-not-found": "자료에서 찾지 못함",
+  "ai-assistant.entry.total-differs": "차이 {sum}",
+  "ai-assistant.entry.total-matches": "일치",
+  "ai-assistant.entry.issue.not-in-source": "자료에 없는 값입니다",
+  "ai-assistant.entry.issue.source-scattered": "값이 자료의 한 줄에 함께 있지 않습니다",
+  "ai-assistant.entry.issue.source-not-checked": "사진 자료는 대조하지 못했습니다"
 }

package/translations/ms.json

@@ -197,5 +197,40 @@
   "ai-assistant.session.filter-private": "Peribadi",
   "ai-assistant.session.filter-unread": "Belum dibaca",
   "ai-assistant.dock.ask-needs-conversation": "soalan tidak dihantar.",
-  "ai-assistant.dock.audience-open-band": "Perbualan awam - sesiapa dalam domain ini boleh membaca dan menulis di sini."
+  "ai-assistant.dock.audience-open-band": "Perbualan awam - sesiapa dalam domain ini boleh membaca dan menulis di sini.",
+  "ai-assistant.entry.rows": "{count} baris",
+  "ai-assistant.entry.ready": "{count} sedia",
+  "ai-assistant.entry.blocked": "{count} tidak akan dimasukkan",
+  "ai-assistant.entry.cut": "{count} ditinggalkan kerana melebihi had",
+  "ai-assistant.entry.source": "sumber",
+  "ai-assistant.entry.missing": "tiada",
+  "ai-assistant.entry.more-rows": "{count} baris lagi tidak dipaparkan - ia turut dimasukkan.",
+  "ai-assistant.entry.check-failed": "aplikasi tidak dapat menyemak baris ini; ia disemak semula semasa dimasukkan.",
+  "ai-assistant.entry.replaced": "diganti kad yang lebih baharu",
+  "ai-assistant.entry.enter": "masukkan {count} baris",
+  "ai-assistant.entry.nothing-to-enter": "tiada untuk dimasukkan",
+  "ai-assistant.entry.entered": "{count} baris dimasukkan.",
+  "ai-assistant.entry.entered-none": "tiada baris dimasukkan.",
+  "ai-assistant.entry.row-refused": "baris {n}: {reason}",
+  "ai-assistant.entry.more-refused": "{count} baris lagi tidak dimasukkan.",
+  "ai-assistant.entry.issue.required": "tiada nilai",
+  "ai-assistant.entry.issue.not-a-number": "bukan nombor",
+  "ai-assistant.entry.issue.not-an-integer": "bukan nombor bulat",
+  "ai-assistant.entry.issue.not-a-date": "bukan tarikh",
+  "ai-assistant.entry.issue.not-a-boolean": "bukan ya atau tidak",
+  "ai-assistant.entry.issue.not-in-list": "bukan salah satu daripada {values}",
+  "ai-assistant.entry.issue.unknown-field": "bukan medan rekod ini - ditinggalkan",
+  "ai-assistant.entry.issue.no-source": "tiada sumber",
+  "ai-assistant.entry.verified": "{count} ditemui dalam fail",
+  "ai-assistant.entry.unmatched": "{count} dengan nilai yang tiada dalam fail",
+  "ai-assistant.entry.evidence": "ditemui pada baris {line} fail",
+  "ai-assistant.entry.total": "jumlah {field} {sum}",
+  "ai-assistant.entry.total-ready": "dimasukkan {sum}",
+  "ai-assistant.entry.total-declared": "bahan menyatakan {sum}",
+  "ai-assistant.entry.total-not-found": "tidak ditemui dalam fail",
+  "ai-assistant.entry.total-differs": "berbeza {sum}",
+  "ai-assistant.entry.total-matches": "sepadan",
+  "ai-assistant.entry.issue.not-in-source": "fail tiada nilai ini",
+  "ai-assistant.entry.issue.source-scattered": "nilai tidak berada pada satu baris fail",
+  "ai-assistant.entry.issue.source-not-checked": "foto tidak dapat disemak di sini"
 }

package/translations/zh.json

@@ -197,5 +197,40 @@
   "ai-assistant.session.filter-private": "私密",
   "ai-assistant.session.filter-unread": "未读",
   "ai-assistant.dock.ask-needs-conversation": "问题未发送。",
-  "ai-assistant.dock.audience-open-band": "公开对话 — 本工作区的任何人都可以阅读和发言。"
+  "ai-assistant.dock.audience-open-band": "公开对话 — 本工作区的任何人都可以阅读和发言。",
+  "ai-assistant.entry.rows": "{count}行",
+  "ai-assistant.entry.ready": "可录入 {count}",
+  "ai-assistant.entry.blocked": "{count}行不会录入",
+  "ai-assistant.entry.cut": "超出上限，{count}行未包含",
+  "ai-assistant.entry.source": "来源",
+  "ai-assistant.entry.missing": "缺少",
+  "ai-assistant.entry.more-rows": "其余{count}行未显示，但会一并录入。",
+  "ai-assistant.entry.check-failed": "应用无法检查这些行；录入时会再次检查。",
+  "ai-assistant.entry.replaced": "已被新卡片取代",
+  "ai-assistant.entry.enter": "录入{count}行",
+  "ai-assistant.entry.nothing-to-enter": "没有可录入的行",
+  "ai-assistant.entry.entered": "已录入{count}行。",
+  "ai-assistant.entry.entered-none": "未录入任何行。",
+  "ai-assistant.entry.row-refused": "第{n}行：{reason}",
+  "ai-assistant.entry.more-refused": "另有{count}行未录入。",
+  "ai-assistant.entry.issue.required": "缺少值",
+  "ai-assistant.entry.issue.not-a-number": "不是数字",
+  "ai-assistant.entry.issue.not-an-integer": "不是整数",
+  "ai-assistant.entry.issue.not-a-date": "不是日期",
+  "ai-assistant.entry.issue.not-a-boolean": "不是是/否",
+  "ai-assistant.entry.issue.not-in-list": "不是允许的值（{values}）",
+  "ai-assistant.entry.issue.unknown-field": "不是此记录的字段，已忽略",
+  "ai-assistant.entry.issue.no-source": "未注明来源",
+  "ai-assistant.entry.verified": "{count}行已与资料核对",
+  "ai-assistant.entry.unmatched": "{count}行含资料中没有的值",
+  "ai-assistant.entry.evidence": "在资料第{line}行找到",
+  "ai-assistant.entry.total": "{field}合计 {sum}",
+  "ai-assistant.entry.total-ready": "录入部分 {sum}",
+  "ai-assistant.entry.total-declared": "资料合计 {sum}",
+  "ai-assistant.entry.total-not-found": "资料中未找到",
+  "ai-assistant.entry.total-differs": "相差 {sum}",
+  "ai-assistant.entry.total-matches": "一致",
+  "ai-assistant.entry.issue.not-in-source": "资料中没有此值",
+  "ai-assistant.entry.issue.source-scattered": "这些值不在资料的同一行",
+  "ai-assistant.entry.issue.source-not-checked": "照片资料无法核对"
 }