@things-factory/ai-assistant 10.1.141 → 10.1.142

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/ai-assistant",
-  "version": "10.1.141",
+  "version": "10.1.142",
   "main": "dist-server/index.js",
   "things-factory": true,
   "author": "heartyoh",
@@ -34,11 +34,11 @@
     "@operato/shell": "^10.0.0",
     "@operato/styles": "^10.0.0",
     "@things-factory/ai-client-base": "^10.1.129",
-    "@things-factory/apptool-base": "^10.1.141",
-    "@things-factory/attachment-base": "^10.1.141",
-    "@things-factory/auth-base": "^10.1.141",
+    "@things-factory/apptool-base": "^10.1.142",
+    "@things-factory/attachment-base": "^10.1.142",
+    "@things-factory/auth-base": "^10.1.142",
     "@things-factory/env": "^10.1.20",
-    "@things-factory/shell": "^10.1.141",
+    "@things-factory/shell": "^10.1.142",
     "dompurify": "^3.0.0",
     "exceljs": "4.2.0",
     "graphql-scalars": "^1.22.0",
@@ -52,5 +52,5 @@
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.0"
   },
-  "gitHead": "931866a13b9149be42a294f207e245aba11e57f8"
+  "gitHead": "73522201151b0156168b0eeea15f2962cda0bd8f"
 }

package/server/service/data-read/data-read.test.ts

@@ -221,6 +221,18 @@ describe('a list declared in one line', () => {
     expect(plain.screen!.params({ year: 2026 })).toEqual({})
   })
 
+  it('★ a fixed filter is on every read, out of the model\'s reach - a condition narrows the list, never widens it', async () => {
+    const made: ReadTarget = listReadTarget({ ...line, key: 'office.spending', listQuery: 'cashTransactions', fixedFilters: [{ name: 'type', operator: 'eq', value: 'EXPENSE' }] })
+    declareReadTarget(made)
+    expect(made.criteria.map(one => one.name)).not.toContain('type')
+    const all: any = await queryRecords(made, {}, {}, run)
+    expect(all.total).toBe(4)
+    expect(calls[0].filters).toEqual([{ name: 'type', operator: 'eq', value: 'EXPENSE' }])
+    expect(((await queryRecords(made, { flow: 'INCOME' }, {}, run)) as any).total).toBe(0)
+    expect(((await queryRecords(made, { id: 't3' }, {}, run)) as any).total).toBe(0)
+    expect(listReadTarget(line).fixedFilters).toBeUndefined()
+  })
+
   it('a minimum or maximum amount means the amount column, else the first summed one', () => {
     const made: ReadTarget = listReadTarget({ ...line, key: 'office.claims', columns: [{ name: 'totalAmount', type: 'number', total: true }] })
     expect(made.criteria.find(one => one.name === 'minAmount')!.filter(5)).toEqual({ name: 'totalAmount', operator: 'gte', value: 5 })

package/server/service/data-read/list-read.ts

@@ -3,7 +3,7 @@
  * a ListParam query, the fields it reads, a date to range over, a status, an amount, search words, and a screen.
  * Each application writes its lists as these lines; this turns one into a read target with the conditions it takes.
  */
-import type { ReadColumn, ReadCriterion, ReadTarget } from './read-target.js'
+import type { ReadColumn, ReadCriterion, ReadFilter, ReadTarget } from './read-target.js'
 
 export interface ListRead {
   /** `<app>.<record>`. */
@@ -12,8 +12,10 @@ export interface ListRead {
   title: string
   /** The screen's name as the person knows it - the model picks the list by it. */
   name: string
-  /** The ListParam query (`cashTransactions`). */
+  /** The ListParam query (`transactions`). */
   listQuery: string
+  /** Filters every read applies, out of the model's reach - the records the list is of (`category` CONFIRMED). */
+  fixedFilters?: ReadFilter[]
   /** The fields of each item it reads - the screen's own selection where there is one. */
   selection: string
   columns: ReadColumn[]
@@ -75,6 +77,7 @@ export function listReadTarget(list: ListRead): ReadTarget {
       `query ($filters: [Filter!], $pagination: Pagination, $sortings: [Sorting!]${search ? ', $search: String' : ''}) ` +
       `{ ${list.listQuery}(filters: $filters, pagination: $pagination, sortings: $sortings${search ? ', search: $search' : ''}) { items { ${list.selection} } total } }`,
     criteria,
+    ...(list.fixedFilters?.length ? { fixedFilters: list.fixedFilters } : {}),
     columns: list.columns,
     rowsOf: data => ({ rows: data?.[list.listQuery]?.items ?? [], total: data?.[list.listQuery]?.total ?? 0 }),
     ...(search ? { search: { description: `the ${list.search}` } } : {}),

package/server/service/data-read/read-target.ts

@@ -62,6 +62,11 @@ export interface ReadTarget {
    */
   search?: { description: string }
   criteria: ReadCriterion[]
+  /**
+   * Filters every read of this list applies - the records it is of (a book's confirmed lines, not its forecasts). Not
+   * a condition: the model neither sees nor sets them, so a read can narrow the list but never widen it.
+   */
+  fixedFilters?: ReadFilter[]
   columns: ReadColumn[]
   rowsOf: (data: any) => { rows: any[]; total: number }
   /** Orders the rows; the query's own order when left out. */
@@ -167,7 +172,7 @@ export async function readRows(target: ReadTarget, filters: ReadFilter[], run: G
   let total = 0
   for (let page = 1; rows.length < MAX_READ_ROWS; page++) {
     const answer = await run(target.query, {
-      filters,
+      filters: [...filters, ...(target.fixedFilters ?? [])],
       ...(search ? { search } : {}),
       pagination: { page, limit: READ_PAGE },
       ...(target.sortings ? { sortings: target.sortings } : {})