tuieval 0.2.0.dev56__tar.gz → 0.2.0.dev62__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/CHANGELOG.md +2 -1
  2. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/PKG-INFO +3 -3
  3. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/README.md +2 -2
  4. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/models.md +6 -4
  5. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/writing-packs.md +2 -2
  6. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/_version.py +2 -2
  7. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/cli.py +1 -1
  8. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/compare.py +20 -5
  9. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/pta.py +71 -36
  10. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/run_evals.py +4 -3
  11. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/tui.py +31 -114
  12. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/verdict.py +2 -1
  13. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/tests/test_tuieval.py +46 -15
  14. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/.gitignore +0 -0
  15. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/LICENSE +0 -0
  16. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/RELEASING.md +0 -0
  17. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/README.md +0 -0
  18. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/favicon.ico +0 -0
  19. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/readme-header.png +0 -0
  20. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/social-preview.png +0 -0
  21. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-1024.png +0 -0
  22. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-128.png +0 -0
  23. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-16.png +0 -0
  24. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-16.svg +0 -0
  25. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-256.png +0 -0
  26. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-32.png +0 -0
  27. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-48.png +0 -0
  28. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-512.png +0 -0
  29. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-64.png +0 -0
  30. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon-animated.svg +0 -0
  31. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/brand/tuieval-icon.svg +0 -0
  32. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/tui-answer-reasoning.png +0 -0
  33. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/tui-run-reasoning.png +0 -0
  34. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/docs/images/tui-setup.png +0 -0
  35. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/pyproject.toml +0 -0
  36. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/__init__.py +0 -0
  37. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/__main__.py +0 -0
  38. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/builtin.toml +0 -0
  39. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/client.py +0 -0
  40. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/doctor.py +0 -0
  41. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/engine.py +0 -0
  42. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/export.py +0 -0
  43. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/graders/__init__.py +0 -0
  44. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/graders/answer.py +0 -0
  45. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/graders/code.py +0 -0
  46. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/graders/rag.py +0 -0
  47. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/graders/reply.py +0 -0
  48. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/graders/tool_call.py +0 -0
  49. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/machines.py +0 -0
  50. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/onboard.py +0 -0
  51. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/packs.py +0 -0
  52. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/profiles.py +0 -0
  53. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/remove.py +0 -0
  54. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/scaffold.py +0 -0
  55. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/selftest.py +0 -0
  56. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/models.toml +0 -0
  57. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/answer/pack.toml +0 -0
  58. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/answer/system.txt +0 -0
  59. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/answer/tests.yaml +0 -0
  60. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/code/pack.toml +0 -0
  61. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/code/system.txt +0 -0
  62. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/code/tests.yaml +0 -0
  63. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/rag/pack.toml +0 -0
  64. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/rag/system.txt +0 -0
  65. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/rag/tests.yaml +0 -0
  66. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/reply/pack.toml +0 -0
  67. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/reply/system.txt +0 -0
  68. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/reply/tests.yaml +0 -0
  69. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/tool_call/pack.toml +0 -0
  70. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/tool_call/system.txt +0 -0
  71. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/tool_call/tests.yaml +0 -0
  72. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/templates/packs/tool_call/tools.yaml +0 -0
  73. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/tune.py +0 -0
  74. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/watch_proxy.py +0 -0
  75. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/workspace.py +0 -0
  76. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/src/tuieval/yamlout.py +0 -0
  77. {tuieval-0.2.0.dev56 → tuieval-0.2.0.dev62}/tests/mock_server.py +0 -0
@@ -2,10 +2,11 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ - Results has four tabs: PTA index, Production readiness, Per question and Failures. The PTA table adds tok/s, TTFT and memory; Per question can show only where models disagree; the settings warning is one line. Scorecard, pairwise, history and test quality stay in `tuieval compare`, `history` and `items`.
5
6
  - The run's ETA adds up each pack's answers left × that model's time per answer there (its history, then its own times once it has 5 answers), instead of extrapolating from the first few answers.
6
7
  - Faster start on Macs: the GPU core count comes from `ioreg` instead of `system_profiler`, which took seconds on some Macs.
7
8
  - A model a server won't serve (HTTP 401-404, e.g. OpenRouter's "No endpoints found") is never judged on it: those answers don't count, and the model stops at once instead of failing every question.
8
- - PTA index: parsimony (tokens used) and speed (time), each 100 for the best and 15 points less per doubling, and accuracy per model, as bars: the first Results tab (where `r` lands), `tuieval pta` and the report. Server errors aren't answers, and models with few answers are left out unless picked.
9
+ - PTA index: parsimony (tokens), time and accuracy per model as bars, with tokens and time shown as multiples of the best (2.4×): the first Results tab (where `r` lands), `tuieval pta` and the report. Server errors aren't answers, and models with few answers are left out unless picked.
9
10
  - Run several models at a time: `parallel_models` per machine, **Models at a time** in the TUI, or `tuieval run --parallel N` (default 1). Models wait for memory to fit, and answers note what ran alongside them.
10
11
  - More evals during a run: `n` opens Setup, and Start adds them to the run going (same tier) or queues them after it.
11
12
  - A new workspace's `models.toml` is 23 lines: the llama, local and OpenRouter servers and the defaults are built in (docs/models.md lists them in full; a server defined in `models.toml` replaces the built-in one with that name). Existing workspaces keep their settings; built-in servers they don't define become available, and adding a model still prefers the workspace's own servers.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: tuieval
3
- Version: 0.2.0.dev56
3
+ Version: 0.2.0.dev62
4
4
  Summary: Evaluate local and frontier LLMs on your own questions: accuracy, speed, tokens and PASS/FAIL verdicts, in the terminal.
5
5
  Project-URL: Homepage, https://github.com/ashe-wb/tuieval
6
6
  Project-URL: Issues, https://github.com/ashe-wb/tuieval/issues
@@ -144,7 +144,7 @@ See **[docs/models.md](docs/models.md)** for servers, OpenRouter endpoint pinnin
144
144
  1. **Pick packs and models** (space ticks; type to filter models by label or tag). Each model shows a short code per use case, e.g. `C✓ S?` (✓ pass, ✗ fail, ? inconclusive; grey = from earlier results). To run only some tests of a pack, highlight it and press `e`. Runs of different tests add up, and the pack can PASS once all its tests have run.
145
145
  2. **Pick a tier** (Smoke to check setup, Screen, Certify) and **press `s`**. The line above the buttons shows how many answers that is and roughly how long it will take. For each model, tuieval starts its server (or uses a running one), checks the right model is loaded, runs every selected pack, then stops it.
146
146
  3. **Watch the run:** progress with ETA, live score, tok/s, TTFT and memory, the current test with reasoning and answer side by side, recent results with the grader's reason. `k` skips a model, `c` cancels (finished work is kept and resumes next time). `n` sets up more evals while it runs: add them to this run (same tier) or queue them as the next run.
147
- 4. **Press `r` for results:** production readiness, verdict history, scorecard, speed & tokens (★ marks models nothing beats on both accuracy and time), per question, is the difference real?, tests that separate models, by difficulty, failures, and test quality.
147
+ 4. **Press `r` for results:** the PTA index (parsimony (tokens), time and accuracy as bars), production readiness, per question, and failures. `tuieval compare`, `tuieval history` and `tuieval items` have the rest: whether a difference is real, verdict history and test quality.
148
148
 
149
149
  Other keys: `t` tunes the ticked models' speed flags, `a` adds a model, `m` scans for GGUFs, `p` saves or loads a preset, `x` hides a model. `?` explains any screen.
150
150
 
@@ -176,7 +176,7 @@ tuieval help
176
176
 
177
177
  - **Start with Production readiness.** A single critical failure already means FAIL, whatever the accuracy: a model that breaks a hard rule once in 300 answers will do it in production. The Failures tab and `tuieval report` list exactly which answers failed.
178
178
  - **INCONCLUSIVE is not "nearly passed".** It says what's missing (usually a Certify run, or more trials).
179
- - **Trust "Is the difference real?" over raw percentages.** Differences of one or two tests are usually noise.
179
+ - **Trust `tuieval compare --pairwise` over raw percentages.** Differences of one or two tests are usually noise.
180
180
  - **Read `trunc` before accuracy.** A model that runs out of tokens isn't wrong; it's thinking too long for the budget.
181
181
  - **Watch TTFT for interactive use.** A model that is 5% more accurate but takes 3 s longer to start answering may be the worse choice.
182
182
 
@@ -118,7 +118,7 @@ See **[docs/models.md](docs/models.md)** for servers, OpenRouter endpoint pinnin
118
118
  1. **Pick packs and models** (space ticks; type to filter models by label or tag). Each model shows a short code per use case, e.g. `C✓ S?` (✓ pass, ✗ fail, ? inconclusive; grey = from earlier results). To run only some tests of a pack, highlight it and press `e`. Runs of different tests add up, and the pack can PASS once all its tests have run.
119
119
  2. **Pick a tier** (Smoke to check setup, Screen, Certify) and **press `s`**. The line above the buttons shows how many answers that is and roughly how long it will take. For each model, tuieval starts its server (or uses a running one), checks the right model is loaded, runs every selected pack, then stops it.
120
120
  3. **Watch the run:** progress with ETA, live score, tok/s, TTFT and memory, the current test with reasoning and answer side by side, recent results with the grader's reason. `k` skips a model, `c` cancels (finished work is kept and resumes next time). `n` sets up more evals while it runs: add them to this run (same tier) or queue them as the next run.
121
- 4. **Press `r` for results:** production readiness, verdict history, scorecard, speed & tokens (★ marks models nothing beats on both accuracy and time), per question, is the difference real?, tests that separate models, by difficulty, failures, and test quality.
121
+ 4. **Press `r` for results:** the PTA index (parsimony (tokens), time and accuracy as bars), production readiness, per question, and failures. `tuieval compare`, `tuieval history` and `tuieval items` have the rest: whether a difference is real, verdict history and test quality.
122
122
 
123
123
  Other keys: `t` tunes the ticked models' speed flags, `a` adds a model, `m` scans for GGUFs, `p` saves or loads a preset, `x` hides a model. `?` explains any screen.
124
124
 
@@ -150,7 +150,7 @@ tuieval help
150
150
 
151
151
  - **Start with Production readiness.** A single critical failure already means FAIL, whatever the accuracy: a model that breaks a hard rule once in 300 answers will do it in production. The Failures tab and `tuieval report` list exactly which answers failed.
152
152
  - **INCONCLUSIVE is not "nearly passed".** It says what's missing (usually a Certify run, or more trials).
153
- - **Trust "Is the difference real?" over raw percentages.** Differences of one or two tests are usually noise.
153
+ - **Trust `tuieval compare --pairwise` over raw percentages.** Differences of one or two tests are usually noise.
154
154
  - **Read `trunc` before accuracy.** A model that runs out of tokens isn't wrong; it's thinking too long for the budget.
155
155
  - **Watch TTFT for interactive use.** A model that is 5% more accurate but takes 3 s longer to start answering may be the worse choice.
156
156
 
@@ -86,11 +86,13 @@ By default a run serves one model at a time. On a machine with room for more, se
86
86
 
87
87
  ## PTA index
88
88
 
89
- The **PTA index** puts parsimony (tokens), speed (time) and accuracy side by side, 0-100 each and higher is better, as a bar per score for each model, with the numbers and a table underneath. It's the first tab in Results, where `r` opens, and it's also `tuieval pta` and a section in `tuieval report`. There's no combined number; verdicts and critical failures stay in Production readiness.
89
+ The **PTA index** puts parsimony (tokens), time and accuracy side by side, as a bar for each per model (longer is better), with a table underneath. It's the first tab in Results, where `r` opens, and it's also `tuieval pta` and a section in `tuieval report`. There's no combined number; verdicts and critical failures stay in Production readiness.
90
90
 
91
- - **P parsimony** (a score out of 100, not a percentage): from the tokens used, reasoning and answer, on every question compared (each question at its median over repeats). The fewest tokens score 100 (★ in the **tokens** column), and every doubling costs 15 points: `100 − 15 × log2(this model's tokens ÷ fewest)`, never below 0. Unlike speed it doesn't depend on your machine: it's how much a model says to get to an answer, which is what you pay for on an API and what fills its context.
92
- - **T speed** (a score out of 100, not a percentage): the same from the total time to answer those questions. The fastest model scores 100 (★ on its total time), and every doubling of the total time costs 15 points: `100 − 15 × log2(this model's total ÷ fastest total)`, never below 0 (about 100× slower). Twice as slow is 85, 10× slower is 50. Adding a faster model lowers the others. The table's **total time** column has the times themselves (lower is better).
93
- - **A accuracy** (a percentage): the share of answers to those questions that passed.
91
+ - **P parsimony (tokens)**: the tokens used, reasoning and answer, on every question compared (each question at its median over repeats). Beside the bar: how many times the leanest model's, e.g. `2.4×` (`1.0×` is the leanest, ★ in the table's **tokens/answer**). Unlike time it doesn't depend on your machine: it's how much a model says to get to an answer, which is what you pay for on an API and what fills its context.
92
+ - **T time**: the total time to answer those questions, as how many times the fastest model's, e.g. `28×` (★ in **time/answer**).
93
+ - **A accuracy**: the share of answers to those questions that passed.
94
+
95
+ The P and T bars use a log scale: full for the best, 15 points (of 100) shorter for every doubling, empty at about 100 times the best. So a model at 28× still shows a bar, and adding a better model shortens the others'.
94
96
 
95
97
  Models are compared on the questions all of them answered, so one that skipped some never looks faster. Server and connection errors aren't answers: a model with only those is listed as having none. A model with fewer than half as many answers as the most-answered one is left out (and listed), or it would shrink the shared questions for everyone. Pick the models and pack to compare in the TUI, or use `--only` and `--packs`: models you pick are always compared.
96
98
 
@@ -127,7 +127,7 @@ def ticket_route(answer, test, meta):
127
127
  - `critical=True` makes every test of this grader a critical trial (any of its failures *can* be critical). Otherwise only tests with `critical: true` or `expected: NOT_AVAILABLE` are.
128
128
  - `template` is the skeleton `tuieval capture` writes for a new test of this grader.
129
129
 
130
- A grader file can also add **Scorecard columns** (Results → Scorecard, and `tuieval compare`), for numbers your use case cares about that pass/fail doesn't show:
130
+ A grader file can also add **Scorecard columns** (`tuieval compare`), for numbers your use case cares about that pass/fail doesn't show:
131
131
 
132
132
  ```python
133
133
  import json
@@ -175,7 +175,7 @@ Graders mark failures that should disqualify a model whatever its accuracy:
175
175
 
176
176
  ## Difficulty labels
177
177
 
178
- Every test has a `difficulty` of easy, medium or hard. It's for you, not the model: requests are built only from `input`, `image`, the system prompt and tools, so the label never reaches the model. The TUI shows it in the pack list (e.g. `12E 20M 8H`), next to the current question, in Recent results and Failures, and in Results → By difficulty.
178
+ Every test has a `difficulty` of easy, medium or hard. It's for you, not the model: requests are built only from `input`, `image`, the system prompt and tools, so the label never reaches the model. The TUI shows it in the pack list (e.g. `12E 20M 8H`), next to the current question, in Recent results and Failures, and as a filter in Results → Per question.
179
179
 
180
180
  A useful convention: **easy** = one rule or a direct read; **medium** = arithmetic, one trap, or two conditions; **hard** = rules in conflict, multi-step reasoning, or misleading data. Once several models have run, `tuieval items` flags labels the results contradict ("easier than labelled": a hard test every model passes; "harder than labelled": an easy test most models fail). `tuieval selftest` warns about tests without a label.
181
181
 
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '0.2.0.dev56'
22
- __version_tuple__ = version_tuple = (0, 2, 0, 'dev56')
21
+ __version__ = version = '0.2.0.dev62'
22
+ __version_tuple__ = version_tuple = (0, 2, 0, 'dev62')
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -14,7 +14,7 @@ Start here
14
14
 
15
15
  Day to day
16
16
  tuieval compare [...] scorecards (--speed, --pairwise, --failures)
17
- tuieval pta the PTA index: parsimony, speed and accuracy per model, as bars
17
+ tuieval pta the PTA index: parsimony (tokens), time and accuracy per model, as bars
18
18
  tuieval report the verdicts with their evidence, as a markdown file
19
19
  tuieval history every verdict change, newest first
20
20
  tuieval items tests that don't separate models or look broken
@@ -121,6 +121,12 @@ def p90(values):
121
121
  return statistics.quantiles(values, n=10)[-1] if len(values) > 1 else (values[0] if values else None)
122
122
 
123
123
 
124
+ def pct(fraction):
125
+ """A share as a percentage: "100%" and "0%" only when exact, else one decimal ("99.6%"), so a model
126
+ with a wrong answer never shows as perfect."""
127
+ return "100%" if fraction >= 1 else "0%" if fraction <= 0 else f"{100 * fraction:.1f}%"
128
+
129
+
124
130
  def median(values):
125
131
  values = [v for v in values if v is not None]
126
132
  return statistics.median(values) if values else None
@@ -154,10 +160,19 @@ def settings_notes(infos):
154
160
  per_model.setdefault(i["label"], i["settings"])
155
161
  keys = sorted({k for s in per_model.values() for k in s})
156
162
  differing = [k for k in keys if len({json.dumps(s.get(k)) for s in per_model.values()}) > 1]
157
- if differing:
158
- detail = "; ".join(f"{k}: " + ", ".join(f"{m}={per_model[m].get(k)}" for m in sorted(per_model))
159
- for k in differing)
160
- notes.append(f"Settings differ between models ({detail}). Compare those models knowing that.")
163
+ parts = []
164
+ for k in differing: # only the models that differ from the most common value, named when few
165
+ groups = collections.defaultdict(list)
166
+ for m in sorted(per_model):
167
+ groups[json.dumps(per_model[m].get(k))].append(m)
168
+ common = max(groups, key=lambda v: len(groups[v]))
169
+ for value, ms in sorted(groups.items()):
170
+ if value != common:
171
+ who = ", ".join(ms) if len(ms) <= 3 else f"{len(ms)} models"
172
+ shown = "unset" if value == "null" else json.loads(value)
173
+ parts.append(f"{k} {shown} on {who}")
174
+ if parts:
175
+ notes.append("Settings differ: " + "; ".join(parts) + ".")
161
176
  fps = collections.defaultdict(set)
162
177
  for i in infos:
163
178
  if i.get("pack"):
@@ -412,7 +427,7 @@ def by_difficulty(rows):
412
427
  cells = []
413
428
  for lvl in LEVELS:
414
429
  x = [r["ok"] for r in sub if r.get("difficulty") == lvl]
415
- cells.append(f"{sum(x)}/{len(x)} ({100 * sum(x) / len(x):.0f}%)" if x else "-")
430
+ cells.append(f"{sum(x)}/{len(x)} ({pct(sum(x) / len(x))})" if x else "-")
416
431
  table.append([m, s] + cells)
417
432
  return header, table
418
433
 
@@ -1,13 +1,14 @@
1
- """PTA index: parsimony, speed (time) and accuracy per model, 0-100 each and higher is better, shown
2
- as a bar per score for each model.
1
+ """PTA index: parsimony (tokens), time and accuracy per model, a bar each (longer = better).
3
2
 
4
- P parsimony a score out of 100, from the tokens (reasoning and answer) used on every question
5
- compared (each question at its median over repeats): 100 for the model that used the
6
- fewest, POINTS_PER_DOUBLING points less for every doubling (0 at about 100 times more).
7
- Unlike T it doesn't depend on the machine: it's how much a model says to get there.
8
- T speed a score out of 100, the same from the total time to answer those questions: 100 for
9
- the fastest model. Log scales, so models that are all far behind the best still differ.
10
- A accuracy a percentage: the share of answers to those questions that passed.
3
+ P parsimony (tokens) the tokens (reasoning and answer) used on every question compared (each
4
+ question at its median over repeats), shown as how many times the leanest
5
+ model's ("2.4×"). Unlike T it doesn't depend on the machine.
6
+ T time the total time to answer those questions, as how many times the fastest
7
+ model's ("28×").
8
+ A accuracy the share of answers to those questions that passed (%).
9
+
10
+ Behind the P and T bars is a 0-100 score: 100 for the best, POINTS_PER_DOUBLING points less for every
11
+ doubling (0 at about 100 times more), so models far behind the best still get a visible bar.
11
12
 
12
13
  Models are compared on the questions all of them answered, so one that skipped some never looks
13
14
  faster. Server and connection errors aren't answers. By default a model with fewer than half as many
@@ -32,12 +33,23 @@ def score(total, best):
32
33
  return max(0.0, 100 - POINTS_PER_DOUBLING * math.log2(total / best))
33
34
 
34
35
 
35
- def index(rows, models=None):
36
+ def memory_gb(infos):
37
+ """{model: the most memory its server held in any run (GB)}, for models tuieval served (hosted: none).
38
+ On a discrete GPU that's its peak VRAM (vram_peak_gb), where the model lives; otherwise its resident memory."""
39
+ out = {}
40
+ for i in infos:
41
+ gb = i.get("vram_peak_gb") or (i["peak_rss_mb"] / 1024 if i.get("peak_rss_mb") else None)
42
+ if gb:
43
+ out[i["label"]] = max(out.get(i["label"], 0), gb)
44
+ return out
45
+
46
+
47
+ def index(rows, models=None, memory=None):
36
48
  """{"questions": n shared, "models": [{model, P, T, A, tokens, total_s, passed, answers, alongside,
37
- fewest, fastest}],
49
+ fewest, fastest, tps, ttft, memory_gb}],
38
50
  "left_out": [(model, questions answered)], "no_answers": [model], "most": questions answered by the
39
51
  most-answered model}, best accuracy first. models: the ones to compare (default: every model in rows
40
- with enough answers; models named here are compared whatever their count)."""
52
+ with enough answers; models named here are compared whatever their count). memory: memory_gb()."""
41
53
  no_answers = sorted({r["model"] for r in rows} - {r["model"] for r in rows if not r.get("error")})
42
54
  rows = [r for r in rows if not r.get("error")] # a server or connection error isn't an answer
43
55
  tests = compare.per_question(rows)
@@ -61,12 +73,19 @@ def index(rows, models=None):
61
73
  "total_s": sum(c["secs"] or 0 for c in cells),
62
74
  "passed": sum(c["passed"] for c in cells), "answers": answers,
63
75
  "A": 100 * sum(c["passed"] for c in cells) / answers if answers else None,
76
+ # generation speed and time to first token over the same answers (medians)
77
+ "tps": compare.median(r.get("gen_tps") for c in cells for r in c["rows"]),
78
+ "ttft": compare.median(r.get("ttft") for c in cells for r in c["rows"]),
79
+ "memory_gb": (memory or {}).get(m),
64
80
  # answers that ran while other models were served shared the machine's speed
65
81
  "alongside": any(r.get("alongside") for c in cells for r in c["rows"])})
66
82
  fastest = min((x["total_s"] for x in out if x["total_s"] > 0), default=None)
67
83
  fewest = min((x["tokens"] for x in out if x["tokens"] > 0), default=None)
68
84
  for x in out:
69
85
  x["P"], x["T"] = score(x["tokens"], fewest), score(x["total_s"], fastest)
86
+ # shown on the bars: how many times the leanest / fastest model's total (1.0 = the best)
87
+ x["tokens_x"] = x["tokens"] / fewest if fewest and x["tokens"] else None
88
+ x["time_x"] = x["total_s"] / fastest if fastest and x["total_s"] else None
70
89
  x["fewest"] = bool(fewest) and x["tokens"] == fewest
71
90
  x["fastest"] = bool(fastest) and x["total_s"] == fastest
72
91
  out.sort(key=lambda x: (-(x["A"] or 0), -(x["T"] or 0), x["model"]))
@@ -74,29 +93,40 @@ def index(rows, models=None):
74
93
  "most": most}
75
94
 
76
95
 
77
- LETTERS = (("P", "parsimony", "/100", "cyan"), ("T", "speed", "/100", "magenta"), ("A", "accuracy", "%", "green"))
96
+ # (letter, name, what the number beside the bar shows, colour); the bar itself is the 0-100 score
97
+ LETTERS = (("P", "parsimony (tokens)", "tokens_x", "cyan"), ("T", "time", "time_x", "magenta"),
98
+ ("A", "accuracy", "A", "green"))
99
+
100
+
101
+ def times(v):
102
+ """A multiple of the best: "1.0×", "2.4×", "28×"."""
103
+ return "-" if v is None else f"{v:.1f}×" if v < 9.95 else f"{v:.0f}×"
78
104
 
79
105
 
80
106
  def bars(result, width=20, markup=True):
81
- """Lines with a row per model and a bar per score (P, T, A), longer = better, each with its number:
82
- the at-a-glance view. markup=False gives plain text (the report)."""
107
+ """Lines with a row per model and a bar per score (P, T, A), longer = better: the at-a-glance view.
108
+ Beside P and T, how many times the leanest / fastest model's tokens / time; beside A, the percentage.
109
+ markup=False gives plain text (the report)."""
83
110
  if not result["models"]:
84
111
  return []
85
112
  name_w = max(len(x["model"]) for x in result["models"])
86
- cell_w = width + 6 # the bar, a space and "100%" or " 100"
113
+ # each column: the bar, a space, "100%" or "9.8×" (5), then a gap; at least as wide as its heading
114
+ cell_w = max(width + 9, *(len(f"{k} {name}") + 2 for k, name, _, _ in LETTERS))
87
115
  head = " " * (name_w + 2) + "".join(f"{f'{k} {name}':<{cell_w}}" for k, name, _, _ in LETTERS)
88
116
  lines = [f"[b]{head.rstrip()}[/b]" if markup else head.rstrip()]
89
117
  for x in result["models"]:
90
118
  cells = []
91
- for k, _, unit, color in LETTERS:
119
+ for k, _, shown, color in LETTERS:
92
120
  v = x[k]
93
121
  full = 0 if v is None else round(width * max(0, min(100, v)) / 100)
122
+ if v is not None and v < 100: # full only when perfect (accuracy) or the best (P, T)
123
+ full = min(full, width - 1)
94
124
  bar, rest = "█" * full, "░" * (width - full)
95
- num = "-" if v is None else f"{v:.0f}{'%' if unit == '%' else ''}"
125
+ num = (("-" if v is None else compare.pct(v / 100)) if shown == "A" else times(x.get(shown)))
96
126
  bar = f"[{color}]{bar}[/][grey37]{rest}[/]" if markup else bar + rest
97
- cells.append(f"{bar} {num:>4}")
127
+ cells.append(f"{bar} {num:>6}" + " " * (cell_w - width - 7))
98
128
  name = f"{x['model']:<{name_w}}"
99
- lines.append(f"{rich_escape(name) if markup else name} " + " ".join(cells))
129
+ lines.append((f"{rich_escape(name) if markup else name} " + "".join(cells)).rstrip())
100
130
  return lines
101
131
 
102
132
 
@@ -116,22 +146,28 @@ def left_out_lines(result):
116
146
  return out
117
147
 
118
148
 
119
- def _score(v, unit=""):
120
- """A is a percentage (%), P and T scores out of 100 (/100: on a log scale, not percentages)."""
121
- return "-" if v is None else f"{v:.0f}{unit}"
122
-
123
-
124
149
  def table(result):
125
150
  """(header, rows) for a plain table of the index."""
126
- header = ["model", "P parsimony /100", "T speed /100", "A accuracy %", "tokens", "total time",
127
- "answers right"]
128
- rows = [[x["model"], _score(x["P"]), _score(x["T"]), _score(x["A"], "%"),
129
- f"{round(x['tokens']):,}" + (" ★" if x.get("fewest") else ""),
130
- fmt_total(x["total_s"]) + (" ★" if x.get("fastest") else ""),
131
- f"{x['passed']}/{x['answers']}"] for x in result["models"]]
151
+ n = result["questions"] or 1
152
+ header = ["model", "tokens/answer", "time/answer", "answers right", "tok/s", "TTFT s", "memory GB"]
153
+ rows = [[x["model"], f"{round(x['tokens'] / n):,}" + (" ★" if x.get("fewest") else ""),
154
+ fmt_secs(x["total_s"] / n) + (" ★" if x.get("fastest") else ""),
155
+ f"{x['passed']}/{x['answers']}", _num(x.get("tps"), ".0f"), _num(x.get("ttft"), ".1f"),
156
+ _num(x.get("memory_gb"), ".1f")] for x in result["models"]]
132
157
  return header, rows
133
158
 
134
159
 
160
+ def fmt_secs(secs):
161
+ """Time per answer: "2.5s", "69s", "4m10s"."""
162
+ if not secs:
163
+ return "-"
164
+ return f"{secs:.1f}s" if secs < 10 else f"{secs:.0f}s" if secs < 60 else fmt_total(secs)
165
+
166
+
167
+ def _num(v, fmt):
168
+ return "-" if v is None else format(v, fmt)
169
+
170
+
135
171
  def fmt_total(secs):
136
172
  if not secs:
137
173
  return "-"
@@ -147,19 +183,18 @@ def scope_note(result, models):
147
183
  if not result["questions"]:
148
184
  return "These models have no question in common yet, so there's nothing to compare."
149
185
  return (f"Compared on the {result['questions']} questions all {len(result['models'])} model(s) answered. "
150
- f"A is a percentage. P parsimony and T speed are scores out of 100, not percentages: 100 = the fewest "
151
- f"tokens / the fastest total time (★), {POINTS_PER_DOUBLING} points less for each doubling; a better "
152
- "model added lowers the others.")
186
+ "Longer bars are better. P parsimony (tokens) and T time: how many times the leanest / fastest "
187
+ "model's (1.0×, ★ in the table). A accuracy: answers right.")
153
188
 
154
189
 
155
190
  def for_engine(e, labels=None, packs=None, results_dir=None):
156
191
  """(result, models) from a workspace's finished results (results on their way out excluded)."""
157
192
  paths = [p for p in compare.default_paths(results_dir or e.results_dir) if not e.superseded(p)]
158
- rows, _ = compare.load(paths) if paths else ([], [])
193
+ rows, infos = compare.load(paths) if paths else ([], [])
159
194
  if packs:
160
195
  rows = [r for r in rows if r["suite"] in packs]
161
196
  models = sorted({r["model"] for r in rows} & set(labels) if labels else {r["model"] for r in rows})
162
- return index(rows, models if labels else None), models
197
+ return index(rows, models if labels else None, memory_gb(infos)), models
163
198
 
164
199
 
165
200
  def markdown(result, models):
@@ -373,11 +373,12 @@ def report_markdown(e, labels=None):
373
373
  + f"; truncated {100 * ev['truncation']:.1f}%"
374
374
  + (f"; consistency {100 * ev['consistency']:.0f}% of {ev['groups']} groups" if ev.get("consistency") is not None else ""))
375
375
  recs = e.records(label, name)
376
+ from .compare import pct
376
377
  levels = []
377
378
  for lvl in ("easy", "medium", "hard"):
378
379
  x = [r["pass"] for r in recs if r.get("difficulty") == lvl]
379
380
  if x:
380
- levels.append(f"{lvl} {sum(x)}/{len(x)} ({100 * sum(x) / len(x):.0f}%)")
381
+ levels.append(f"{lvl} {sum(x)}/{len(x)} ({pct(sum(x) / len(x))})")
381
382
  if levels:
382
383
  lines.append(" - by difficulty: " + ", ".join(levels))
383
384
  for ex in ev.get("critical_examples", []):
@@ -389,7 +390,7 @@ def report_markdown(e, labels=None):
389
390
 
390
391
  def cmd_pta(argv):
391
392
  p = argparse.ArgumentParser(prog="tuieval pta",
392
- description="The PTA index: parsimony (tokens), speed and accuracy per model (0-100, higher is better), as a "
393
+ description="The PTA index: parsimony (tokens), time and accuracy per model, as a "
393
394
  "bar per score for each model and a table, over the questions all the models answered.")
394
395
  p.add_argument("--only", help="comma-separated model labels (default: every model with results)")
395
396
  p.add_argument("--packs", help="comma-separated packs (default: all)")
@@ -413,7 +414,7 @@ def cmd_pta(argv):
413
414
  return
414
415
  out.print()
415
416
  for line in pta.bars(result, a.width):
416
- out.print(line)
417
+ out.print(line, soft_wrap=True) # a bar row stays one line (the terminal wraps it if it must)
417
418
  header, rows = pta.table(result)
418
419
  widths = [max(len(h), *(len(r[i]) for r in rows)) for i, h in enumerate(header)]
419
420
  out.print()
@@ -10,7 +10,7 @@ Run screen: live reasoning and answer, per-test ✓/✗, TTFT and tokens/s, p
10
10
  k skips the current model, c cancels everything, f pauses auto-scroll.
11
11
  r shows results at any time (also mid-run); n starts a new run when it ends.
12
12
  Enter on a Recent results row shows that answer in full.
13
- Results: opens on the PTA index (parsimony, speed and accuracy per model, as bars). Per
13
+ Results: opens on the PTA index (parsimony, time and accuracy per model, as bars). Per
14
14
  question compares each model's tokens and seconds on the same question. ctrl+r
15
15
  reloads (it also reloads when a run's pack finishes). Enter on a Failures row or a
16
16
  Per question cell shows the answer: grading and checks, reasoning, answer, question.
@@ -19,6 +19,7 @@ Anywhere: esc/q go back (q quits only on Setup), ctrl+q quits, w lists this
19
19
  tunes. Leaving a live run or tune keeps it going; the header shows its progress.
20
20
  """
21
21
  import argparse
22
+ import collections
22
23
  import glob
23
24
  import json
24
25
  import os
@@ -331,16 +332,15 @@ with the model's reasoning and answer as they stream, then recent results with t
331
332
  v with several models at a time: stream the next one (k skips the one streaming)""",
332
333
  "ResultsScreen": """[b]Results[/b]
333
334
 
334
- Opens on the [b]PTA index[/b]: parsimony (tokens), speed and accuracy per model, a bar each (0-100,
335
- longer = better). [b]Production readiness[/b] gives one verdict per model and use case, and what's
336
- missing when it's INCONCLUSIVE. The other tabs are the evidence:
337
- Scorecard accuracy, critical failures and truncation per model and pack
338
- Speed & tokens time and tokens per answer (★ = nothing beats it on both accuracy and time)
339
- Per question every question, model by model
340
- Is the difference real? whether one model is really better than another, or it's noise
341
- Tests that separate the questions that tell models apart
335
+ PTA index parsimony (tokens), time and accuracy per model, a bar each (longer = better;
336
+ 2.4× = 2.4 times the best), with per-answer numbers, tok/s, TTFT and memory in
337
+ the table. Results open here.
338
+ Production readiness one verdict per model and use case; the table says why and what to run next
339
+ Per question every question, model by model (filters: pack, level, Models disagree)
342
340
  Failures every wrong answer with the grader's reason; enter opens it in full
343
- Test quality tests nobody fails, everybody fails, or that look broken
341
+
342
+ More in the terminal: tuieval compare (--pairwise: is a difference real), tuieval history,
343
+ tuieval items (test quality).
344
344
 
345
345
  [b]Keys[/b] esc back · ctrl+r refresh · w runs""",
346
346
  "TuneScreen": """[b]Tuning speed flags[/b]
@@ -2229,7 +2229,7 @@ class RunScreen(Screen):
2229
2229
  if self.running and self.total > done:
2230
2230
  left, rough = self.eta_seconds()
2231
2231
  eta = f" · ETA {'~' if rough else ''}{fmt_secs(left)}"
2232
- pct = f"{100 * passed / (passed + failed):.0f}%" if passed + failed else "-"
2232
+ pct = compare.pct(passed / (passed + failed)) if passed + failed else "-"
2233
2233
  recent = self.stats[-50:]
2234
2234
  tps = [r["gen_tps"] for r in recent if r.get("gen_tps")]
2235
2235
  ttfts = [r["ttft_s"] for r in recent if r.get("ttft_s") is not None and not r.get("cached_tokens")]
@@ -2347,8 +2347,8 @@ class RunScreen(Screen):
2347
2347
  class ResultsScreen(Screen):
2348
2348
  BINDINGS = [Binding("escape", "app.pop_screen", "Back"), Binding("q", "app.pop_screen", "Back", show=False),
2349
2349
  Binding("w", "runs", "Runs"), Binding("ctrl+r", "refresh", "Refresh")]
2350
- SORTS = [("Sort: token gap", "tokens"), ("Sort: time gap", "secs"),
2351
- ("Sort: most tokens", "most"), ("Sort: pack order", "order")]
2350
+ SORTS = [("By token gap", "tokens"), ("By time gap", "secs"),
2351
+ ("By most tokens", "most"), ("By pack order", "order")]
2352
2352
 
2353
2353
  def check_action(self, action, parameters):
2354
2354
  return bool(self.app.sessions) if action == "runs" else True
@@ -2378,9 +2378,9 @@ class ResultsScreen(Screen):
2378
2378
  with Horizontal(id="pta-controls"):
2379
2379
  yield Select([("All packs", "")], id="pta-pack", allow_blank=False, value="")
2380
2380
  yield Button("Models: all", id="pta-models")
2381
- yield Static("[dim]P parsimony: tokens used (reasoning and answer). T speed: total time. A accuracy: "
2382
- "answers right. Longer bars are better for all three. Verdicts and critical failures "
2383
- "are in Production readiness.[/dim]")
2381
+ yield Static("[dim]P parsimony (tokens): tokens used, reasoning and answer. T time: total time. "
2382
+ "A accuracy: answers right. Verdicts and critical failures are in Production "
2383
+ "readiness.[/dim]")
2384
2384
  yield Static(id="pta-note")
2385
2385
  yield Static(id="pta-bars")
2386
2386
  yield DataTable(id="pta", zebra_stripes=True, cursor_type="none")
@@ -2393,22 +2393,6 @@ class ResultsScreen(Screen):
2393
2393
  "measured there, or projected from token counts and that machine's tuned speeds.[/dim]")
2394
2394
  yield DataTable(id="latency", zebra_stripes=True)
2395
2395
  yield DataTable(id="readiness-detail", zebra_stripes=True, cursor_type="row")
2396
- with TabPane("Verdict history"):
2397
- yield Static("[dim]Every change in a model's verdict, newest first. Kept even after results are rerun "
2398
- "or questions change; the evidence behind older verdicts is in results/<model>/history/.[/dim]")
2399
- yield DataTable(id="history", zebra_stripes=True, cursor_type="row")
2400
- with TabPane("Scorecard"):
2401
- yield DataTable(id="scorecard", zebra_stripes=True)
2402
- with TabPane("Speed & tokens"):
2403
- yield Select([("As measured (all machines)", "")] +
2404
- [(f"{mc.id}{' (this machine)' if i == 0 else ''}", mc.id)
2405
- for i, mc in enumerate(self.app.engine.machines())],
2406
- id="speed-machine", allow_blank=False, value="")
2407
- yield Static("[dim]★ = no other model is both more accurate and faster per answer. "
2408
- "Memory is the server's resident size (includes GPU-mapped weights on Apple Silicon). "
2409
- "On another machine, times are measured there if the model ran there, otherwise "
2410
- "projected from each answer's token counts and that machine's tuned speeds.[/dim]")
2411
- yield DataTable(id="speed", zebra_stripes=True)
2412
2396
  with TabPane("Per question", id="tab-per-question"):
2413
2397
  with Horizontal(id="pq-controls"):
2414
2398
  yield Select([("All packs", "")], id="pq-pack", allow_blank=False, value="")
@@ -2416,28 +2400,16 @@ class ResultsScreen(Screen):
2416
2400
  id="pq-level", allow_blank=False, value="")
2417
2401
  yield Select(self.SORTS, id="pq-sort", allow_blank=False, value="tokens")
2418
2402
  yield Button("Models: all", id="pq-models")
2419
- yield Checkbox("Only questions all answered", False, id="pq-shared")
2420
- yield Checkbox("Include unfinished", True, id="pq-partial")
2403
+ yield Checkbox("Answered by all", False, id="pq-shared")
2404
+ yield Checkbox("Models disagree", False, id="pq-disagree")
2405
+ yield Checkbox("In progress", True, id="pq-partial")
2421
2406
  yield Static(id="pq-compare-title")
2422
2407
  yield DataTable(id="pq-summary", zebra_stripes=True, cursor_type="none")
2423
2408
  yield Static(id="pq-legend")
2424
2409
  yield DataTable(id="per-question", zebra_stripes=True, cursor_type="cell")
2425
- with TabPane("Is the difference real?"):
2426
- yield DataTable(id="pairwise", zebra_stripes=True)
2427
- with TabPane("Tests that separate models"):
2428
- yield DataTable(id="separating", zebra_stripes=True)
2429
- with TabPane("By difficulty"):
2430
- yield Static("[dim]Pass rate per difficulty level. The level is your label only; models never see it. "
2431
- "A strong model should hold up on HARD, not just EASY.[/dim]")
2432
- yield DataTable(id="difficulty", zebra_stripes=True)
2433
2410
  with TabPane("Failures"):
2434
2411
  yield Static("[dim]Enter on a row shows the whole answer, its reasoning and what was checked.[/dim]")
2435
2412
  yield DataTable(id="failures", zebra_stripes=True, cursor_type="row")
2436
- with TabPane("Test quality"):
2437
- yield Static("[dim]no signal: every model passed · suspicious: every model failed (check the test) · "
2438
- "inverted: the weakest model beat the strongest · flaky: same model, different results "
2439
- "across repeats[/dim]")
2440
- yield DataTable(id="quality", zebra_stripes=True)
2441
2413
  yield Footer()
2442
2414
 
2443
2415
  def on_mount(self):
@@ -2494,7 +2466,6 @@ class ResultsScreen(Screen):
2494
2466
 
2495
2467
  def fill(self):
2496
2468
  results_dir = self.results_dir or self.app.engine.results_dir
2497
- self.fill_history()
2498
2469
  paths = compare.default_paths(results_dir)
2499
2470
  self.partial_rows = compare.load_partials(results_dir)
2500
2471
  self.superseded = {p for p in compare.default_paths(results_dir) if self.app.engine.superseded(p)}
@@ -2511,40 +2482,13 @@ class ResultsScreen(Screen):
2511
2482
  smoke = os.path.abspath(results_dir) != os.path.abspath(self.app.engine.results_dir)
2512
2483
  info.update(f"{len(paths)} {'Smoke ' if smoke else ''}result files in {os.path.relpath(results_dir)}/" + banner
2513
2484
  + "".join(f"\n[yellow]⚠ {n}[/yellow]" for n in notes))
2514
- header, table = compare.scorecard(rows)
2515
- t = self.query_one("#scorecard", DataTable)
2516
- t.add_columns(*header)
2517
- t.add_rows(table)
2518
2485
  self.rows, self.infos = rows, infos
2519
- self.fill_speed(self.query_one("#speed-machine", Select).value or "")
2520
- p = self.query_one("#pairwise", DataTable)
2521
- p.add_columns("Model A", "Model B", "A − B", "95% CI", "Verdict", "Shared tests")
2522
- for a, b, diff, lo, hi, call, n in compare.pairwise(rows):
2523
- color = "green" if call == "clear" else "dim"
2524
- p.add_row(a, b, f"{100 * diff:+.1f} pts", f"[{100 * lo:+.1f}, {100 * hi:+.1f}]",
2525
- f"[{color}]{call}[/{color}]", str(n))
2526
- split, _ = compare.separating(rows)
2527
- sep = self.query_one("#separating", DataTable)
2528
- models = sorted({r["model"] for r in rows})
2529
- sep.add_columns("Test", *models)
2530
- for test, d in split:
2531
- sep.add_row(test, *[f"{sum(d[m])}/{len(d[m])}" if m in d else "-" for m in models])
2532
2486
  f = self.query_one("#failures", DataTable)
2533
2487
  f.add_columns("Model", "Level", "Test", "Reason")
2534
2488
  # compare.failures lists the failed rows in order, so they line up with fail_rows
2535
2489
  self.fail_rows = [r for r in rows if not r["ok"]]
2536
2490
  for model, test, reason, level in compare.failures(rows):
2537
2491
  f.add_row(model, diff_badge(level), test, rich_escape(reason[:130]))
2538
- dh, dt = compare.by_difficulty(rows)
2539
- dtab = self.query_one("#difficulty", DataTable)
2540
- dtab.add_columns("Model", "Pack", *[diff_badge(l) for l in compare.LEVELS])
2541
- for line in dt:
2542
- dtab.add_row(*line)
2543
- qt = self.query_one("#quality", DataTable)
2544
- qt.add_columns("Flags", "Test", *models)
2545
- if len(models) >= 2:
2546
- for test, flags, rates in compare.items(rows):
2547
- qt.add_row(", ".join(flags), test, *[f"{100 * rates[m]:.0f}%" if m in rates else "-" for m in models])
2548
2492
  self.fill_per_question()
2549
2493
  self.fill_pta()
2550
2494
  self.fill_readiness(results_dir)
@@ -2565,6 +2509,7 @@ class ResultsScreen(Screen):
2565
2509
  @on(Select.Changed, "#pq-sort")
2566
2510
  @on(Checkbox.Changed, "#pq-partial")
2567
2511
  @on(Checkbox.Changed, "#pq-shared")
2512
+ @on(Checkbox.Changed, "#pq-disagree")
2568
2513
  def per_question_changed(self):
2569
2514
  if getattr(self, "rows", None) is not None:
2570
2515
  self.fill_per_question()
@@ -2624,7 +2569,7 @@ class ResultsScreen(Screen):
2624
2569
  self.query_one("#pta-left-out", Static).update("")
2625
2570
  return
2626
2571
  # none picked: every model with enough answers (pta.index leaves out the rest, and says so)
2627
- result = pta.index(rows, sorted(chosen) or None)
2572
+ result = pta.index(rows, sorted(chosen) or None, pta.memory_gb(self.infos))
2628
2573
  self.query_one("#pta-note", Static).update(pta.scope_note(result, sorted(present)))
2629
2574
  self.query_one("#pta-bars", Static).update("\n".join(pta.bars(result)) if result["questions"] else "")
2630
2575
  self.query_one("#pta-left-out", Static).update(
@@ -2671,6 +2616,8 @@ class ResultsScreen(Screen):
2671
2616
  shown = sorted(chosen) if chosen else sorted({m for t in tests for m in t["cells"]})
2672
2617
  if self.query_one("#pq-shared", Checkbox).value:
2673
2618
  tests = [t for t in tests if all(m in t["cells"] for m in shown)]
2619
+ if self.query_one("#pq-disagree", Checkbox).value: # some models got it right, others didn't
2620
+ tests = [t for t in tests if len({c["passed"] == c["n"] for c in t["cells"].values()}) > 1]
2674
2621
  self.fill_pq_summary(tests, shown)
2675
2622
  order = {}
2676
2623
  for name, pk in self.app.engine.packs.items():
@@ -2801,38 +2748,6 @@ class ResultsScreen(Screen):
2801
2748
  return
2802
2749
  self.app.push_screen(AnswerScreen(entries, what="repeat"))
2803
2750
 
2804
- @on(Select.Changed, "#speed-machine")
2805
- def machine_changed(self, event):
2806
- if getattr(self, "rows", None) is not None:
2807
- self.fill_speed(event.value or "")
2808
-
2809
- def fill_speed(self, machine_id):
2810
- e = self.app.engine
2811
- speeds = {}
2812
- if machine_id:
2813
- mc = next(x for x in e.machines() if x.id == machine_id)
2814
- speeds = {m["label"]: (e.serving(m, mc).profile or {}).get("measured") for m in e.cfg["models"]}
2815
- header, table, _ = compare.speed(self.rows, self.infos, machine_id or None, speeds)
2816
- sp = self.query_one("#speed", DataTable)
2817
- sp.clear(columns=True)
2818
- sp.add_columns(*header)
2819
- for line in table:
2820
- sp.add_row(*([f"[yellow]{line[0]}[/yellow]"] + line[1:]))
2821
-
2822
- def fill_history(self):
2823
- e = self.app.engine
2824
- t = self.query_one("#history", DataTable)
2825
- t.add_columns("When", "Model", "Use case", "Change", "Questions", "Why")
2826
- rank = {"FAIL": 0, "INCONCLUSIVE": 1, "NO DATA": 1, "PASS": 2}
2827
- for h in reversed(verdict.load_history(e)):
2828
- prev, now = h.get("previous"), h["status"]
2829
- change = f"[{VERDICT_STYLE[now]}]{now}[/]" if not prev else \
2830
- f"{prev} → [{VERDICT_STYLE[now]}]{now}[/]"
2831
- if prev and rank.get(now, 1) < rank.get(prev, 1):
2832
- change += " [bold red]⚠ worse[/bold red]"
2833
- qs = "current" if verdict.is_current(h, e) else "[yellow]changed since[/yellow]"
2834
- t.add_row(h["time"].replace("T", " "), h["model"], h["use_case"], change, qs, "; ".join(h["reasons"])[:120])
2835
-
2836
2751
  def fill_readiness(self, results_dir):
2837
2752
  style = {"PASS": "bold green", "FAIL": "bold red", "INCONCLUSIVE": "yellow", "NO DATA": "dim"}
2838
2753
  matrix = self.query_one("#readiness", DataTable)
@@ -2844,17 +2759,18 @@ class ResultsScreen(Screen):
2844
2759
  return
2845
2760
  help_text.update(self.READINESS_HELP)
2846
2761
  table = verdict.readiness(self.app.engine)
2847
- short = ["[b]In short[/b]"]
2762
+ short = ["[b]In short[/b]"] # one line per model; what to run next is in the table below
2848
2763
  for label, sentence, todo in verdict.plain_summary(table):
2849
2764
  short.append(f" [b]{rich_escape(label)}[/b]: {rich_escape(sentence)}")
2850
- short += [f" → {rich_escape(g)}: {rich_escape(what)}" for g, what, _ in todo]
2851
2765
  if any("Certify" in what for _, _, todo in verdict.plain_summary(table) for _, what, _ in todo):
2852
2766
  short.append(" [dim]To run Certify: in Setup tick the model and pack, choose Certify, press s.[/dim]")
2853
2767
  self.query_one("#readiness-short", Static).update("\n".join(short) if table else
2854
2768
  "[dim]No verdicts yet: run something from Setup.[/dim]")
2855
2769
  groups = sorted({g for t in table.values() for g in t})
2856
2770
  matrix.add_columns("Model", *groups)
2857
- detail.add_columns("Model", "Use case", "Pack", "Verdict", "Why")
2771
+ detail.add_columns("Model", "Use case", "Pack", "Verdict", "Answers right", "Why")
2772
+ right = collections.Counter((r["model"], r["suite"]) for r in self.rows if r["ok"])
2773
+ answered = collections.Counter((r["model"], r["suite"]) for r in self.rows)
2858
2774
  lat = verdict.latency_table(self.app.engine, None, table)
2859
2775
  machine_ids = [mc.id for mc in self.app.engine.machines()]
2860
2776
  lt = self.query_one("#latency", DataTable)
@@ -2871,7 +2787,9 @@ class ResultsScreen(Screen):
2871
2787
  for g, (_, packs) in gs.items():
2872
2788
  for name, pv in packs.items():
2873
2789
  if pv.status != "NO DATA":
2874
- detail.add_row(label, g, name, f"[{style[pv.status]}]{pv.status}[/]", "; ".join(pv.reasons)[:160])
2790
+ n = answered[(label, name)]
2791
+ detail.add_row(label, g, name, f"[{style[pv.status]}]{pv.status}[/]",
2792
+ f"{right[(label, name)]}/{n}" if n else "-", "; ".join(pv.reasons)[:160])
2875
2793
 
2876
2794
 
2877
2795
  # ------------------------------------------------------------------ app
@@ -2932,7 +2850,6 @@ class EvalsApp(App):
2932
2850
  #machine { padding: 0 1; height: auto; }
2933
2851
  #tune-status { padding: 0 1; height: auto; min-height: 2; background: $boost; }
2934
2852
  #tune-log { height: 1fr; }
2935
- #speed-machine { width: 60; margin: 0 1; }
2936
2853
  #results-top { height: auto; }
2937
2854
  #results-info { width: 1fr; height: auto; }
2938
2855
  #toggle-smoke { width: auto; min-width: 32; }
@@ -2943,7 +2860,7 @@ class EvalsApp(App):
2943
2860
  #pta { width: 1fr; height: auto; margin-top: 1; }
2944
2861
  #pta-left-out { height: auto; padding: 1 0 0 0; }
2945
2862
  #pq-controls Checkbox { width: auto; }
2946
- #pq-controls Select { width: 28; margin-right: 1; }
2863
+ #pq-controls Select { width: 22; margin-right: 1; }
2947
2864
  #pq-models { margin-right: 1; min-width: 20; }
2948
2865
  #pq-compare-title { padding: 0 1; height: auto; }
2949
2866
  #pq-summary { height: auto; max-height: 10; }
@@ -259,7 +259,8 @@ def _plain_fail(v):
259
259
  if "cut off" in text:
260
260
  return "too many answers cut off by max_tokens"
261
261
  if "accuracy" in text and ev.get("trials"):
262
- return f"{100 * ev['accuracy']:.0f}% right, under the bar"
262
+ from .compare import pct # local: compare imports nothing from here, but keep verdict light
263
+ return f"{pct(ev['accuracy'])} right, under the bar"
263
264
  return text.split(" (")[0]
264
265
 
265
266
 
@@ -200,6 +200,15 @@ class WorkspaceGraders(unittest.TestCase):
200
200
 
201
201
 
202
202
  class Units(unittest.TestCase):
203
+ def test_settings_note_names_only_what_differs(self):
204
+ from tuieval import compare
205
+ infos = [{"label": m, "settings": {"temperature": 1.0, **extra}} for m, extra in
206
+ (("a", {}), ("b", {}), ("c", {"effort": "medium"}), ("d", {"effort": "medium"}),
207
+ ("e", {"effort": "medium"}), ("f", {"effort": "medium"}), ("g", {}), ("h", {}), ("i", {}),
208
+ ("j", {"penalty": 1.5}))]
209
+ self.assertEqual(compare.settings_notes(infos),
210
+ ["Settings differ: effort medium on 4 models; penalty 1.5 on j."])
211
+
203
212
  def test_eta_goes_pack_by_pack(self):
204
213
  from tuieval.tui import RunScreen
205
214
  job = lambda key, label, total, done=0, status="waiting": types.SimpleNamespace(
@@ -747,16 +756,28 @@ class PTAIndex(unittest.TestCase):
747
756
  self.assertEqual((by["slow"]["P"], by["fast"]["P"]), (100, 70)) # 4x the tokens: two doublings
748
757
  self.assertEqual((pta.score(2, 1), pta.score(1000, 1)), (85, 0))
749
758
  header, table = pta.table(res)
750
- self.assertEqual(header[1:4], ["P parsimony /100", "T speed /100", "A accuracy %"])
759
+ self.assertEqual(header[1:4], ["tokens/answer", "time/answer", "answers right"])
751
760
  cells = {r[0]: r for r in table}
752
- self.assertEqual(cells["fast"][1:4], ["70", "100", "50%"])
753
- self.assertEqual((cells["slow"][4], cells["fast"][5][-1]), ("20 ★", "★")) # fewest tokens, fastest
761
+ self.assertEqual((cells["slow"][1], cells["fast"][1:3]), ("10 ★", ["40", "2.0s ★"])) # per answer
754
762
  bars = pta.bars(res, 10, markup=False)
755
- self.assertEqual(bars[0].split(), ["P", "parsimony", "T", "speed", "A", "accuracy"])
756
- self.assertEqual(bars[2], "fast " + "███████░░░ 70 " + "██████████ 100 " + "█████░░░░░ 50%")
763
+ self.assertEqual(bars[0].split(), ["P", "parsimony", "(tokens)", "T", "time", "A", "accuracy"])
764
+ self.assertEqual((bars[0].index("P parsimony"), bars[0].index("T time")), # each bar starts under
765
+ (bars[2].index("███████░░░"), bars[2].index("██████████"))) # its heading
766
+ # the bar is the score (4x the tokens: 70); beside it, how many times the best
767
+ self.assertEqual(bars[2].split(), ["fast", "███████░░░", "4.0×", "██████████", "1.0×", "█████░░░░░", "50.0%"])
768
+ self.assertEqual((pta.times(1), pta.times(9.84), pta.times(27.9)), ("1.0×", "9.8×", "28×"))
757
769
  self.assertEqual((by["fast"]["A"], by["slow"]["A"]), (50, 100))
758
770
  self.assertEqual([x["model"] for x in res["models"]], ["slow", "fast"]) # best accuracy first
759
771
 
772
+ def test_accuracy_never_rounds_up_to_perfect(self):
773
+ from tuieval import compare, pta
774
+ self.assertEqual([compare.pct(f) for f in (467 / 469, 1, 0, 0.5)], ["99.6%", "100%", "0%", "50.0%"])
775
+ row = lambda model, a: {"model": model, "P": 100, "T": 100, "A": a, "tokens_x": 1, "time_x": 1}
776
+ bars = pta.bars({"models": [row("two-wrong", 100 * 467 / 469), row("perfect", 100.0)]}, 10, markup=False)
777
+ two_wrong, perfect = bars[1].split(), bars[2].split()
778
+ self.assertEqual((two_wrong[-2], two_wrong[-1]), ("█████████░", "99.6%")) # not a full bar
779
+ self.assertEqual((perfect[-2], perfect[-1]), ("██████████", "100%"))
780
+
760
781
  def test_server_errors_and_models_with_few_answers(self):
761
782
  from tuieval import pta
762
783
 
@@ -802,11 +823,10 @@ class PTAIndex(unittest.TestCase):
802
823
  wrong.stop()
803
824
  out = tuieval(ws, "pta").stdout
804
825
  self.assertIn("Compared on the 4 questions all 2 model(s) answered", out)
805
- table = {l.split()[0]: l.split()[1:4] for l in out.splitlines() if l.startswith(("good ", "hosted "))}
806
- self.assertEqual(table["good"], ["100", "100", "100%"])
807
- self.assertEqual(table["hosted"][0], "100") # the mock says as much either way
808
- self.assertLess(int(table["hosted"][1]), 100) # slower in total
809
- self.assertEqual(table["hosted"][2], "0%")
826
+ bars = {l.split()[0]: l for l in out.splitlines() if "█" in l}
827
+ self.assertEqual((bars["good"].count("1.0×"), "100%" in bars["good"]), (2, True))
828
+ self.assertEqual(bars["hosted"].count("1.0×"), 1) # as many tokens (the mock), but slower
829
+ self.assertIn(" 0%", bars["hosted"])
810
830
  self.assertIn("P parsimony", out)
811
831
  self.assertIn("4/4", tuieval(ws, "pta", "--only", "good").stdout)
812
832
  report = os.path.join(tmp, "r.md")
@@ -825,7 +845,15 @@ class PTAIndex(unittest.TestCase):
825
845
  t = app.screen.query_one("#pta", DataTable)
826
846
  rows = [[str(c) for c in t.get_row_at(i)] for i in range(t.row_count)]
827
847
  tri = str(app.screen.query_one("#pta-bars", Static).render())
828
- print(json.dumps({"rows": rows, "bars": "P parsimony" in tri,
848
+ app.screen.query_one("#pq-disagree").value = True # right vs wrong on all 4
849
+ await pilot.pause(0.3)
850
+ pq = app.screen.query_one("#per-question", DataTable)
851
+ both = pq.row_count
852
+ app.pq_models = {"good"} # one model never disagrees
853
+ app.screen.fill_per_question()
854
+ await pilot.pause(0.3)
855
+ alone = pq.row_count
856
+ print(json.dumps({"rows": rows, "bars": "P parsimony" in tri, "disagree": [both, alone],
829
857
  "tab": app.screen.query_one(TabbedContent).active}))
830
858
  asyncio.run(go())
831
859
  """)
@@ -834,8 +862,9 @@ class PTAIndex(unittest.TestCase):
834
862
  got = json.loads(p.stdout.strip().splitlines()[-1]) if p.stdout.strip() else p.stderr
835
863
  self.assertIsInstance(got, dict, got)
836
864
  self.assertTrue(got["bars"])
865
+ self.assertEqual(got["disagree"], [4, 0])
837
866
  self.assertEqual(got["tab"], "tab-pta") # Results opens on the PTA index
838
- self.assertEqual([r[:4] for r in got["rows"]][0], ["good", "100", "100", "100%"])
867
+ self.assertEqual([(r[0], r[3]) for r in got["rows"]][0], ("good", "4/4"))
839
868
 
840
869
 
841
870
  class Unavailable(unittest.TestCase):
@@ -935,19 +964,21 @@ class FirstRun(unittest.TestCase):
935
964
  code = textwrap.dedent("""
936
965
  import asyncio
937
966
  from tuieval.tui import EvalsApp
938
- from textual.widgets import TabbedContent
967
+ from textual.widgets import TabbedContent, TabPane
939
968
  async def go():
940
969
  app = EvalsApp({})
941
970
  async with app.run_test(size=(140, 40)) as pilot:
942
971
  await pilot.pause()
943
972
  await pilot.press("r")
944
973
  await pilot.pause()
945
- print(type(app.screen).__name__, app.screen.query_one(TabbedContent).active)
974
+ tc = app.screen.query_one(TabbedContent)
975
+ tabs = " | ".join(str(tc.get_tab(p.id).label) for p in tc.query(TabPane))
976
+ print(type(app.screen).__name__, tc.active, "|", tabs)
946
977
  asyncio.run(go())
947
978
  """)
948
979
  out = subprocess.run([sys.executable, "-c", code], capture_output=True, text=True,
949
980
  env=dict(os.environ, TUIEVAL_HOME=self.ws, TUIEVAL_DETECT_PORTS=""), timeout=60).stdout.strip()
950
- self.assertEqual(out, "ResultsScreen tab-pta")
981
+ self.assertEqual(out, "ResultsScreen tab-pta | PTA index | Production readiness | Per question | Failures")
951
982
 
952
983
  def test_stream_follows_only_at_the_bottom(self):
953
984
  code = textwrap.dedent("""
File without changes
File without changes