diff --git a/TRY-IT.md b/TRY-IT.md index 73e154f..e3976c1 100644 --- a/TRY-IT.md +++ b/TRY-IT.md @@ -111,6 +111,8 @@ qqq table count person --join pet # many-side join: count an qqq table get person 1 --join pet qqq table variants person # none in the sample; --variant on table commands and process run qqq table stats person annualSalary --local -l 3 # column statistics; the sample has no columnStats process, --local computes them +qqq saved-view list person ; qqq saved-view open person ; qqq table query person --view -w … # saved views (none in the sample) +qqq saved-view save person --name Mine -w "lastName = Sample" -o -id --fields id,firstName -l 50 ; saved-view rename|delete person Mine … qqq process list ; qqq process describe sleepInteractive qqq process run sleepInteractive -v sleepMillis=1500 # async job, polled, progress on stderr qqq process run clonePeople -r 1,2 # records by primary key @@ -166,7 +168,7 @@ Filter values can be expressions: `now()`, `now(-7d)`, `thisPeriod(month)`, `las `startOf(quarter,-1)`, `me()`, `${variable.x}`; quote values with commas: `city IN "St. Louis, MO",Chicago`. Where M1 stands: `docs/parity/feature-matrix.md` has the CLI status of every Next UI acceptance row. Not yet in -the CLI: bulk load (the sample server cannot accept uploads, see `docs/server-findings.md` #10), saved views, +the CLI: bulk load (the sample server cannot accept uploads, see `docs/server-findings.md` #10), saved views on a server that has them, server-side column statistics (no columnStats process in the sample), audits, a variant-backed table to verify variants against (the sample has none), jobs on a durable-jobs server, TABLE_BASED sign-in, DATE_TIME local-to-UTC conversion. diff --git a/docs/parity/feature-matrix.md b/docs/parity/feature-matrix.md index e572129..45f6647 100644 --- a/docs/parity/feature-matrix.md +++ b/docs/parity/feature-matrix.md @@ -14,13 +14,13 @@ The TUI column fills in during M3. | NAV | 40 | 9 | 3 | 1 | 27 | | PRC | 60 | 24 | 24 | 0 | 12 | | PRF | 5 | 4 | 1 | 0 | 0 | -| QRY | 70 | 29 | 12 | 6 | 23 | +| QRY | 70 | 29 | 7 | 13 | 21 | | REC | 65 | 28 | 23 | 2 | 12 | | REL | 9 | 4 | 5 | 0 | 0 | | RPT | 20 | 1 | 19 | 0 | 0 | | SEC | 43 | 17 | 14 | 0 | 12 | | WID | 69 | 29 | 27 | 0 | 13 | -| **all** | 401 | 151 | 128 | 13 | 109 | +| **all** | 401 | 151 | 123 | 20 | 107 | ## Rows @@ -134,10 +134,10 @@ The TUI column fills in during M3. | QRY-090 | Column menu sorts, pins, opens a field filter and hides a column | n/a | todo | saved views and column UI | | QRY-091 | Column menu copies page or full query values in backend sort order | n/a | todo | saved views and column UI | | QRY-092 | Column chooser searches, groups, counts and marks changed layouts | n/a | todo | saved views and column UI | -| QRY-093 | Last saved view and unsaved edits survive reopening and reload | n/a | todo | saved views and column UI | -| QRY-094 | Counted quick views render and open their saved-view route | n/a | todo | saved views and column UI | +| QRY-093 | Last saved view and unsaved edits survive reopening and reload | n/a | todo | no screen state to keep: views are opened by name | +| QRY-094 | Counted quick views render and open their saved-view route | partial | todo | saved-view list counts quick views with doCount (--counts counts all) | | QRY-095 | A new query defaults to fifty rows per page | n/a | todo | saved views and column UI | -| QRY-096 | A saved view reconciles removed fields and warns the user | n/a | todo | saved views and column UI | +| QRY-096 | A saved view reconciles removed fields and warns the user | partial | todo | opening a view drops removed fields with Material's warnings on stderr | | QRY-001 | Record list renders metadata labels and all records in the default primary-key-descending order | pass | todo | default order by primary key | | QRY-002 | Pagination with Material page sizes and URL state | pass | todo | --limit, --skip, --all | | QRY-003 | Column header sort cycles ascending, descending and default; sort kept in the URL | pass | todo | --order, -field for descending | @@ -169,11 +169,11 @@ The TUI column fills in during M3. | QRY-041 | XLSX and JSON exports carry the same rows | pass | todo | csv, xlsx, json, tsv; format from --out extension; --no-header; bad format or field exit 2 before the request | | QRY-042 | Nothing to export disables the formats | n/a | todo | nothing to disable | | QRY-043 | Backend refuses exports of unreadable tables | pass | todo | server refuses | -| QRY-050 | Your saved views are listed and open on their own route | todo | todo | saved views | -| QRY-051 | Saving a new view stores filter, sort, columns and page size | todo | todo | | -| QRY-052 | Update, rename and delete your view | todo | todo | | -| QRY-053 | Duplicate names and unknown views are reported without changes | todo | todo | | -| QRY-054 | A view shared with you opens read-only and the backend refuses changes | todo | todo | | +| QRY-050 | Your saved views are listed and open on their own route | partial | todo | qqq saved-view list , open , table query --view; the sample has no saved views; verified with node tests and a local stub server | +| QRY-051 | Saving a new view stores filter, sort, columns and page size | partial | todo | saved-view save --name: filter, sort, columns and page size as the Material RecordQueryView | +| QRY-052 | Update, rename and delete your view | partial | todo | saved-view save --replace, rename, delete (asks; --yes) | +| QRY-053 | Duplicate names and unknown views are reported without changes | partial | todo | a name in use is refused before any change; an unknown view exits 2 with the list | +| QRY-054 | A view shared with you opens read-only and the backend refuses changes | partial | todo | views shared with you are listed as shared by their owner; changes to them are the server's to refuse, its message shown | | QRY-060 | Variant table asks for a variant, queries with it and remembers it | partial | todo | table variants; --variant on query, count, get, copy, export, writes and process run; a terminal asks; not remembered between commands; no variant table in the sample | | QRY-061 | Dismissing the variant prompt queries nothing; backend requires a variant | partial | todo | no --variant and no terminal (or no answer): exit 2, nothing queried; no variant table in the sample | | QRY-062 | A table without count, export or write capabilities offers none of them | pass | todo | describe shows capabilities; server refuses | diff --git a/scripts/parity-matrix.py b/scripts/parity-matrix.py index 766f87e..de93322 100644 --- a/scripts/parity-matrix.py +++ b/scripts/parity-matrix.py @@ -50,7 +50,7 @@ STATUS = { 'QRY-016': (P, '--group with parentheses'), 'QRY-017': (P, '--print-filter gives the JSON the web links accept'), 'QRY-018': (P, 'any operator in --where'), 'QRY-019': (P, '--search on query, count and export: CONTAINS over the shown text fields, ORed, ANDed with the filter'), 'QRY-020': (N, '--join and table.field in --fields/--where/--order, labelled "Join: Field"; the sample exposes no joins, verified through an association join (person to pet)'), 'QRY-021': (P, 'a many-side join repeats rows; count and --count add the distinct count (person --join pet: 21 rows, 16 distinct)'), 'QRY-022': (N, 'qqq table stats [-w …] through the columnStats process; the sample has neither QUERY_STATS nor the process, so --local (same figures from the matching rows) is what was verified'), 'QRY-023': (P, 'without QUERY_STATS (or the process) table stats exits 2 with the reason; --local is an explicit opt-in'), 'QRY-030': (P, '-r ids, --filter-json, --limit'), 'QRY-031': (T, 'bulk edit'), 'QRY-032': (T, 'bulk delete'), 'QRY-033': (P, 'process run --filter-json with limit'), 'QRY-034': (T, 'process list --table'), 'QRY-035': (P, 'server refuses; exit 3'), 'QRY-040': (P, 'table export: filtered (--where, --group, --search), sorted (--order), --fields in column order, --limit, --out -'), 'QRY-041': (P, 'csv, xlsx, json, tsv; format from --out extension; --no-header; bad format or field exit 2 before the request'), - 'QRY-042': (X, 'nothing to disable'), 'QRY-043': (P, 'server refuses'), 'QRY-050': (T, 'saved views'), 'QRY-051': (T, ''), 'QRY-052': (T, ''), 'QRY-053': (T, ''), 'QRY-054': (T, ''), + 'QRY-042': (X, 'nothing to disable'), 'QRY-043': (P, 'server refuses'), 'QRY-050': (N, 'qqq saved-view list , open , table query --view; the sample has no saved views; verified with node tests and a local stub server'), 'QRY-051': (N, 'saved-view save --name: filter, sort, columns and page size as the Material RecordQueryView'), 'QRY-052': (N, 'saved-view save --replace, rename, delete (asks; --yes)'), 'QRY-053': (N, 'a name in use is refused before any change; an unknown view exits 2 with the list'), 'QRY-054': (N, 'views shared with you are listed as shared by their owner; changes to them are the server\'s to refuse, its message shown'), 'QRY-060': (N, 'table variants; --variant on query, count, get, copy, export, writes and process run; a terminal asks; not remembered between commands; no variant table in the sample'), 'QRY-061': (N, 'no --variant and no terminal (or no answer): exit 2, nothing queried; no variant table in the sample'), 'QRY-062': (P, 'describe shows capabilities; server refuses'), 'QRY-063': (P, 'server refuses writes'), 'QRY-064': (P, ''), 'QRY-065': (P, 'POST /table/{t}/export'), 'QRY-066': (N, 'GET /table/{t}/variants (called live; the sample lists none)'), 'QRY-067': (P, 'table get --key; the primary key and Material gotoFieldNames are the declared keys, other fields looked up with a note'), 'QRY-068': (P, 'default columns follow sections by tier'), 'QRY-069': (X, 'locale formatting'), 'QRY-070': (X, 'shortcuts'), 'QRY-071': (N, 'process run --variant: tableVariant on init, every step and status; sent live, no variant table to observe'), 'QRY-080': (X, 'quick filters UI'), 'QRY-081': (X, ''), 'QRY-082': (X, ''), 'QRY-083': (X, ''), 'QRY-084': (X, ''), 'QRY-085': (T, 'weekday criteria'), 'QRY-086': (P, 'expressions'), 'QRY-087': (P, 'IN lists; quoted values'), 'QRY-088': (X, ''), 'QRY-089': (P, 'behaviors'), @@ -82,7 +82,8 @@ STATUS = { 'RPT-001': (T, 'report run exists; no sample report to verify'), 'RPT-002': (T, ''), 'RPT-003': (T, ''), 'RPT-004': (T, ''), 'RPT-005': (T, ''), 'RPT-006': (T, 'report inputs'), 'RPT-007': (P, 'server'), 'RPT-008': (T, 'report list'), **{f'RPT-{i:03d}': (T, 'saved reports, schedules, sharing') for i in (9,10,11,12,13,14,15,16,17,18,19)}, 'RPT-020': (T, ''), # HLP - 'HLP-001': (N, 'qqq help show app|widget|instance; the sample carries no help content'), 'HLP-002': (N, 'qqq help show table [field]: table, section and field help; no sample content'), 'HLP-003': (N, 'field help is the column help; table action help slots print with their slot name; no sample content'), 'HLP-004': (N, 'qqq help show process

: process, step, HELP_TEXT and step field help; no sample content'), 'HLP-005': (P, 'qqq help-search'), 'HLP-006': (X, 'author affordance'), + 'HLP-001': (N, 'qqq help show app|widget|instance; the sample carries no help content'), 'HLP-002': (N, 'qqq help show table [field]: table, section and field help; no sample content'), 'HLP-003': (N, 'field help is the column help; table action help slots print with their slot name; no sample content'), 'HLP-004': (N, 'qqq help show process

: process, step, HELP_TEXT and step field help; no sample content'), 'HLP-005': (P, 'qqq help-search'), + 'QRY-093': (X, 'no screen state to keep: views are opened by name'), 'QRY-094': (N, 'saved-view list counts quick views with doCount (--counts counts all)'), 'QRY-096': (N, 'opening a view drops removed fields with Material\'s warnings on stderr'), 'HLP-006': (X, 'author affordance'), } rows = []