localagentbrowser 1.53__tar.gz → 1.61__tar.gz

{localagentbrowser-1.53 → localagentbrowser-1.61}/CHANGELOG.md

@@ -1,9 +1,105 @@
 # Changelog
 
-Every version of `agent_browser.py`, newest first. Each version is also a tagged commit (`v1.11` … `v1.53`).
+Every version of `agent_browser.py`, newest first. Each released version is also a tagged commit (`v1.11` … `v1.61`); 1.54 to 1.56 and 1.58 to 1.60 were internal steps
+measured on the regression suite and released as part of 1.57 and 1.61 (see
+[docs/regression-history.md](docs/regression-history.md)).
 Timings are from live runs on the development machine (Intel i5-9500, 6 cores, no GPU, Qwen2.5-7B-Instruct
 Q4_K_M in LM Studio), where reading the prompt takes about 90% of every model call.
 
+## [1.61] - 2026-10-21
+Released together with the internal steps 1.58, 1.59 and 1.60, each measured on the regression suite
+([docs/regression-history.md](docs/regression-history.md) has every step's results, task by task).
+### Added
+- An outline pointer for long pages. On a page long enough to have an outline, the read-on check looks for an unread
+  part whose label names a word of an item with nothing recorded yet ("Administration" for "setup and
+  administration"), and a plain READ_MORE then reads that part instead of the next one. Told only to use the
+  outline, the model went on to the next part 6 times out of 6 on a 10-part comparison page; with the code making
+  the jump, it reaches the part every time. Words that say what the whole page is about are ignored (the page title's
+  words, words every item shares), as are item verbs and parts that start inside code; hyphenated words stay whole.
+  On 1.61 the comparison finished for the first time since 1.56, from that page's Administration part.
+- "Every item has the discoveries it asks for: choose FINISH now" in the note after a discovery, when each item has
+  at least what it asks for. When that holds, the read-on check also asks for FINISH instead of offering to read on
+  (replayed: read on 6 of 6 before, FINISH 9 of 9 after).
+### Changed
+- The agent is sent back before finishing only for gaps the code verifies: an item nothing was copied for, fewer
+  things than the item asks for, or nothing recorded. The model's other verdicts are logged "(not sent back)" and
+  only shape the final result. About half of the send-backs for those verdicts had been wrong, costing finishes.
+- Every item that asks for a number is counted, not only items with a condition: an owl task finished with two
+  tribes for "at least three cultures". Amounts of time or measure ("the first two weeks") are not counts.
+- A thing not shown to meet a condition stays in the result, marked where it is first named ("**OnlyOffice** (not
+  shown in the pages read to be free and open-source)"), instead of being left out: leaving such things out dropped
+  correct answers along with wrong ones.
+- A description named by the coverage check as one of a list's things is ignored (it had made two office suites
+  count as three).
+- Smaller fresh prompts: refusal reasons in the journal are cut to 120 characters, pages list 8 links instead of 15
+  (those with a few words of text first; in four suites the agent opened 39 pages, none from page links), and links
+  whose text is HTML are skipped. Fresh prompts are about 2,500 tokens instead of 3,500-4,900.
+- Regression suite: the scorer accepts a forbidden item when the result marks it with the caveat.
+### Fixed
+- When several things shared a caveat, only the first was marked: the identical note next to it counted for all.
+
+Regression runs, finished out of 7 (model minutes): 1.58 5 (214), 1.59 5 (209.5), 1.60 6 (170.6), 1.61 6 (222.1).
+What is still open: a fresh prompt (when a conversation reaches its token budget) does not carry the advice to
+finish, and on 1.61 the documentation task read on after one with all four items found; nothing checks that a
+recipe's steps reach their end (on 1.60 cold brew stopped after step 2). Measured and not used: checking a
+discovery's link to its item by shared words (most links without a shared word are right), and a 16,384-token
+context, which would halve the fresh prompts but needs more memory than the default aims for.
+
+## [1.57] - 2026-10-19
+Released together with the internal steps 1.54, 1.55 and 1.56, each of which was measured on the regression suite
+but not released on its own. [docs/regression-history.md](docs/regression-history.md) has every step's results,
+task by task, and what each one showed.
+### Added
+- Coverage check before finishing. The 1.53 suite left two problems open: an explanation finished from one overview
+  paragraph that the model said covered every item (no oxygen or water), and a list named WPS Office as
+  "free, open-source". Before a FINISH goes through, each checklist item is now checked against the full findings
+  in a short call of its own, with the item last so the instructions are read once (about 1-3 minutes for a
+  checklist). The code checks the verdict rather than taking it on trust: an item nothing was copied for counts as
+  unanswered; an item asking for a number of things gets "only 1 of 3 found" when fewer are named; for such items,
+  each thing named must be shown to meet the item's conditions in words copied from a finding about that thing; and
+  a claim that something is missing is dropped when every word of it is already in the findings. With gaps, the
+  FINISH is sent back once, naming the next step for a condition ("SEARCH for 'OnlyOffice free and open-source' to
+  check it, or replace it"), and the next turn starts from a fresh prompt. Finishing with nothing recorded is sent
+  back too.
+- What no finding answers is reported by the code. Checked once more just before the final result, checklist items
+  nothing answers and things not shown to meet a condition are left out of what the final result is asked to write
+  and added after it ("Not found in the pages read", "Left out, not shown to meet the conditions in the pages read").
+  The final result had filled a gap from the model's own knowledge (a care routine for repotted plants).
+- The first turn asks for one short search for the whole objective, keeping its conditions: with the checklist, the
+  first search had gone after the first item only, and the documentation task had dropped "official". Two system
+  prompt rules say the same for later searches.
+### Changed
+- A DISCOVER refused as not on the page now quotes the page sentence closest to it (chosen by the refused text and
+  the objective), to record instead, or names what the parts shown never mention ("Japan, Navajo"); it is no longer
+  wrapped in "Do NOT choose DISCOVER again ... choose a different action", which outweighed the quoted sentence.
+  Replayed on the saved runs: the page's real aftercare line was recorded 6 times out of 6 (0 of 3 before), a refusal
+  where the real steps came on the next part still led to READ_MORE 6 of 6, and an owl case read on 5 of 6.
+- The final result gives as many items as asked for without ever repeating one, and says how many were not found:
+  a list run had listed LibreOffice three times.
+- Opinion items are shown in the checklist as "written by you at FINISH, not found on a page": shown as having no
+  discoveries yet, an owl task kept collecting cultures after it had the three asked for.
+- Fundraising banners and other site notices are hidden like cookie banners: Wikipedia's filled the whole first part
+  of an article.
+- Regression suite: the core how-to is now "make cold brew coffee at home" (`howto-coldbrew`), since the repotting
+  task went to the same guide in three runs and that guide has no section on care in the first two weeks; repotting
+  stays as an extra task under its old id. The summary flags a task that fails again on the same site as before. The
+  documentation task has 45 minutes, like the others.
+### Fixed
+- The not-on-page check refused the real Kilimanjaro answer as unseen because the banner hid the article (above).
+- Numbered headings ("#### 1. Setup") were flagged as numbers missing from the findings (1.53).
+
+Regression runs, finished out of 7 (model minutes): 1.53 5 (200), 1.54 4 (239), 1.54 with fixes 5 (225), 1.55 5
+(233), 1.56 4 (272), 1.57 4 (270). Across these runs the result quality rose where the checks fired: the
+explanation went from thin to complete and cited, the comparison stopped inventing features, the list stopped naming
+WPS Office as open source, and every documentation finding since 1.55 is from python.org. What is not better: about
+half of the coverage check's send-backs were for gaps that were not real, and each costs 8-10 minutes on this
+hardware (a fresh prompt reads 3,000-4,000 tokens), so finishes were lost: on 1.57, a list of three correct
+open-source suites sent back because no words showed them to be "free", and a comparison sent back for "official
+documentation" it was not asked for. The next step is to send the agent back only for gaps the code verifies.
+Also still open: on the documentation task the Windows line repeats the create command instead of the activate
+one (1.56 and 1.57), and on 1.57 the opinion task ran out of time on a page that covered two of the three
+cultures asked for.
+
 ## [1.53] - 2026-10-17
 ### Added
 - Regression suite (`tools/regression.py`): seven objectives, one of each kind of task tested so far, run one

{localagentbrowser-1.53/localagentbrowser.egg-info → localagentbrowser-1.61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: localagentbrowser
-Version: 1.53
+Version: 1.61
 Summary: An autonomous web agent driven by a local LLM (LM Studio) and Playwright. Runs entirely on your own machine.
 Author: SnowFX
 License-Expression: MIT
@@ -56,7 +56,7 @@ and tuned to work well with a **small 7B model on a CPU, no GPU required**.
 - ⚡ **Built for slow hardware.** It reuses LM Studio's prompt cache, so most turns process only what changed.
 - 📝 **A readable report every time.** `research_report.md` holds the final result and every finding with its
   source, written however the run ends; `research_log.txt` keeps every action and reason.
-- ✅ **Tested.** 136 tests on Linux and Windows, Python 3.10–3.13, run in about a second with no model or browser,
+- ✅ **Tested.** 165 tests on Linux and Windows, Python 3.10–3.13, run in a few seconds with no model or browser,
   plus a [regression suite](#regression-suite) of live runs on seven different kinds of task.
 
 📖 **The story behind it:** [Teaching a 7B model on a CPU to finish what it starts](https://dev.to/snowfxxx/teaching-a-7b-model-on-a-cpu-to-finish-what-it-starts-1amc),
@@ -199,17 +199,19 @@ does not generalise; the [changelog](https://github.com/SnowFXXX/LocalAgentBrows
 
 Since 1.53, every change is measured on the same seven objectives, one of each kind above, run one after the other
 with a time limit each (`tools/regression.py`, see [Testing](#testing)). Single runs vary with the pages a search
-turns up, so the suite compares versions on all seven at once:
-
-| Task | 1.52 | 1.53 (objective checklist) |
-|---|---|---|
-| Factual question | Finished, 12 min | Finished, 14 min |
-| List of three office suites | Time limit (45 min) | Finished, 30 min; but one of the three (WPS Office) is not open source |
-| Comparison and recommendation | Time limit (45 min) | Finished, 39 min, every part covered |
-| How-to (repotting) | Time limit (45 min) | Time limit (45 min); materials and steps found, aftercare not |
-| Explanation (photosynthesis) | Time limit (60 min) | Finished, 13 min, but thin: one finding, no oxygen or water |
-| Opinion (owls) | Time limit (45 min) | Finished, 38 min, four cultures and an opinion |
-| Documentation (venv, official docs) | Finished, 15 min, from a tutorial site | Time limit (30 min); create and activate found, from python.org |
+turns up, so the suite compares versions on all seven at once. 1.54 to 1.56 and 1.58 to 1.60 were internal steps
+measured this way and released with 1.57 and 1.61; [docs/regression-history.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/docs/regression-history.md)
+has every step's results and what each one showed.
+
+| Task | 1.52 | 1.53 (objective checklist) | 1.57 (coverage check) | 1.61 (verified send-backs, outline pointer) |
+|---|---|---|---|---|
+| Factual question | Finished, 12 min | Finished, 14 min | Finished, 13 min | Finished, 17 min |
+| List of three office suites | Time limit | Finished, 30 min; but WPS Office is not open source | Time limit: three correct open-source suites by turn 7, sent back because no words showed them to be "free" | Finished, 21 min: LibreOffice, WPS Office and OnlyOffice, each marked "not shown in the pages read to be free and open-source" |
+| Comparison and recommendation | Time limit | Finished, 39 min | Time limit, after a send-back for "official documentation", which the objective does not ask for | Finished, 26 min, setup and administration from the part of a long page the outline pointer chose |
+| How-to (cold brew from 1.55; repotting before) | Time limit | Time limit | Finished, 36 min; but "how long it keeps" answered with the steeping time | Finished, 33 min: every step, the 16-hour steep and the shelf life, cited |
+| Explanation (photosynthesis) | Time limit | Finished, 13 min, but thin: no oxygen or water | Finished, 59 min: inputs, outputs and both stages, cited | Finished, 39 min |
+| Opinion (owls) | Time limit | Finished, 38 min | Time limit: its first page covered two of the three cultures asked for | Finished, 42 min: four cultures, cited, with a view |
+| Documentation (venv, official docs) | Finished, 15 min, from a tutorial site | Time limit (30 min) | Finished, 37 min, all from python.org; but the Windows line repeats the create command instead of the activate one | Time limit: all four items found from python.org, then it read on |
 
 ## How it works
 
@@ -248,12 +250,22 @@ flowchart LR
 - **Findings must match the page.** A finding that shares too few word pairs with the page text shown so far
   (or has a sentence that does) is sent back once, asking for only what the page says in its own words, and
   one far from anything on the page is refused outright. A small model will otherwise "complete" a list from
-  its own knowledge when a page says "follow these 6 steps" and the steps come later.
+  its own knowledge when a page says "follow these 6 steps" and the steps come later. The refusal points the way:
+  it quotes the one page sentence closest to what the model wrote, to record instead, or names what the parts
+  shown never mention ("Japan, Navajo"), so the model reads on.
 - **An objective checklist.** At the start, one short model call splits the objective into a fixed checklist of
   what the result must contain, keeping conditions like "free, open-source" or "three". Each finding names the
   items it serves, the checklist with its findings is in every prompt, and every check goes through these items
   instead of asking the model to split the objective again from memory, which drifted: it once blocked its own
-  finish over "migration strategies", which the objective never asked for.
+  finish over "migration strategies", which the objective never asked for. Opinion items are shown as written
+  at FINISH, not as gaps to fill, and the first search covers the whole objective in one short query, keeping
+  its conditions ("official python documentation venv").
+- **A coverage check before finishing.** Each checklist item is checked against the findings in a short call of
+  its own, and the code checks the verdict instead of taking it on trust: an item nothing was copied for, fewer
+  things than asked for ("only 1 of 3 found"), and things not shown, in words copied from a finding about them,
+  to meet a condition such as "open-source". A claim that something is missing is dropped when every word of it is
+  already in the findings. With gaps, the FINISH is sent back once, with the next step named ("SEARCH for
+  'OnlyOffice free and open-source' to check it, or replace it"), and the next turn starts from a fresh prompt.
 - **Numbered findings.** Findings are numbered in the prompt and listed with every check, and the model names
   the finding that covers each part of the objective ("covered by [2]") instead of just saying "covered".
 - **Knowing when it's done.** After every new finding the model is asked whether the objective is now fully
@@ -265,12 +277,16 @@ flowchart LR
   A part that cannot be found after several tries can be reported as missing instead of blocking for good.
 - **Writing is a separate step.** When the agent finishes, one more model call writes the final result from
   only the objective and the recorded findings, under a short list of rules: no guessing or outside knowledge,
-  cite findings by number, give exactly as many items as asked for, and add a "My view:" paragraph only when
-  the objective asks for an opinion. A small model writes far better when that is its only job, and every
-  claim stays traceable to a recorded finding. The report flags any number in the final result that appears
-  in none of the findings, the most harmful kind of slip in a how-to.
+  cite findings by number, give as many items as asked for (never repeating one, and saying how many were not
+  found), and add a "My view:" paragraph only when the objective asks for an opinion. A small model writes far
+  better when that is its only job, and every claim stays traceable to a recorded finding. What no finding
+  answers is not left to the model: those checklist items, and things not shown to meet a condition, are left out
+  of what it is asked to write, and the code adds them after the result as "Not found in the pages read" and
+  "Left out, not shown to meet the conditions". The report flags any number in the final result that appears in
+  none of the findings, the most harmful kind of slip in a how-to.
 - **Error pages are recognised.** A page answering 404, 403 and so on counts as a failed visit, not content.
-- **Readable pages.** Navigation menus, footers and cookie banners are hidden; code blocks and tables are
+- **Readable pages.** Navigation menus, footers, cookie banners and site notices such as fundraising banners are
+  hidden; code blocks and tables are
   never split between parts; links already shown are not repeated. Long pages come with an outline of the
   headings in each part, marking the parts already read, so the agent can jump to the part it needs instead of
   reading in order.
@@ -303,12 +319,13 @@ Measured on an Intel i5-9500 (6 cores, no GPU) with Qwen2.5-7B-Instruct Q4_K_M a
 | Follow-up on the same page (finding recorded, cheap retry) | 35–60 s |
 | Next part of a page, or a new page appended | 100–280 s |
 | First turn of a run | 45–110 s |
-| Fresh prompt after the context budget is reached | 160–380 s (longest with long pages) |
+| Fresh prompt (context budget reached, or after a coverage send-back) | 160–540 s (longest with long pages) |
+| Coverage check before finishing (all checklist items) | about 1–3 min |
 | Writing the final result (once, at the end) | 50–190 s, depending on how much was found |
 
-Whole runs vary with the pages a search turns up. In the results table, a factual question takes about 12
-minutes of model time, a list of three items 16 to 49, a comparison 25 to 38 and an explanation 45 or more. A
-GPU or a smaller model will be much faster.
+Whole runs vary with the pages a search turns up. In the regression runs since 1.53, a factual question took 9 to
+19 minutes of model time; the list, comparison, how-to, opinion and documentation tasks 17 to 44 when they finished;
+and the explanation 13 to 59. A whole suite of seven tasks took 171 to 272 minutes. A GPU or a smaller model will be much faster.
 
 ## FAQ
 
@@ -343,18 +360,21 @@ turn that brings in a new page takes a few minutes. See [Performance](#performan
   research, an opinion from several sources, a factual question, a comparison, a how-to, a list and an
   explanation of a topic. Each one
   exposed something that did not generalise and was fixed; other kinds of tasks may expose more.
-- **Reading long pages and knowing when it has enough.** The model used to read long pages part by part
-  without recording the relevant parts; since 1.42 it must say what a part contains before reading on. On 1.52
-  the explanation task still lost about 20 minutes reading unrelated sections of a long article and did not
-  finish. On 1.53, with the objective checklist, it finished in 13 minutes, but from a single overview paragraph
-  that left out oxygen and water: the model can now claim one finding covers every item. Judging whether a
-  finding really covers an item is the weakest area.
+- **Judging whether a finding covers an item is the weakest area.** The model's verdict is unreliable both ways:
+  on 1.53 the explanation finished from one overview paragraph without oxygen or water, and in the regression runs
+  since 1.54 about half of the coverage check's send-backs were for gaps that were not real ("missing official
+  documentation" on a comparison that did not ask for it, "H2O, O2" already recorded). Since 1.58 the agent is sent
+  back only for what the code verifies (an item nothing answers, fewer things than asked for); the model's other
+  verdicts only shape the final result, so a thin answer can still pass (on 1.61 the comparison's "many
+  simultaneous users" part is short).
 - **Conditions in the objective.** A small model tends to drop conditions such as "open source" or "using the
   official documentation": a list of open-source office suites once included FreeOffice (free but not open
   source), and a task that asked for the official Python documentation used a tutorial site. The objective
-  checklist keeps the conditions in view (the documentation task went to python.org on 1.53), but on the same
-  run the list task still named WPS Office, which is not open source. Check the result against any conditions
-  you set.
+  checklist keeps the conditions in view (the documentation task uses python.org since 1.55), and a thing not
+  shown in the findings to meet a condition is marked where it is named ("not shown in the pages read to be free
+  and open-source"). The mark says what the pages read did not show, not that the thing fails the condition: on
+  1.61 it marked LibreOffice and OnlyOffice, which are open source, as well as WPS Office, which is not. Check the
+  result against any conditions you set.
 - **A small model's judgement is the ceiling.** It sometimes drifts to loosely related pages, prefers
   secondary sources or stays with one source too long, and results vary with the first pages a search turns
   up; every finding is in `research_report.md` regardless.
@@ -363,8 +383,9 @@ turn that brings in a new page takes a few minutes. See [Performance](#performan
   minutes, but with thin findings and without naming what it could not find, so check the result against the
   objective.
 - **Check the citations.** The final result is told to use only recorded findings, but a 7B model sometimes
-  puts the wrong number on a citation, adds a line no finding supports or leaves out a step, so verify a
-  claim against the listed findings before relying on it.
+  puts the wrong number on a citation, adds a line no finding supports, leaves out a step or misreads a part of
+  the question (on 1.57 it answered "how long it keeps in the fridge" with the steeping time), so verify a claim
+  against the listed findings before relying on it.
 - **Some sites refuse automated browsers** (HTTP 403). The agent respects that and does not try to disguise
   itself; it moves on to other sources.
 - **Reading only.** The agent searches, opens pages and reads them. It does not click, fill in forms or sign in.
@@ -381,7 +402,15 @@ turn that brings in a new page takes a few minutes. See [Performance](#performan
 - [ ] Let very strict objectives end with the gaps named instead of searching indefinitely (they finish since 1.50; naming the gaps is still open)
 - [x] Measure every change on a regression suite of seven kinds of task (1.53)
 - [x] Keep a fixed checklist of the objective's parts instead of re-splitting it at every check (1.53)
-- [ ] Check that a finding really covers its checklist item, including conditions like "open source"
+- [ ] Check that a finding really covers its checklist item, including conditions like "open source" (partly, since
+  1.57: a coverage check before finishing, with what the code can verify)
+- [x] Send the agent back only for gaps the code verifies, and let the model's other verdicts only shape the final
+  result (1.58, released in 1.61)
+- [x] Point the agent to the part of a long page whose outline names an item it still needs (1.61)
+- [ ] Keep the advice to finish when a conversation starts over from a fresh prompt (the next step after 1.61)
+- [ ] Rewind dead ends: save the conversation before an expensive step such as reading a long page, and if it
+  leads nowhere, return to that point with a short note instead of carrying the unused page text in every later
+  prompt (LM Studio reuses its cache up to the saved point)
 - [ ] Try more kinds of objectives (seven so far) and adjust the rules that don't generalise
 - [ ] Make fresh prompts (the slowest kind of turn) cheaper still (31% cheaper since 1.34)
 - [ ] Interacting with pages (clicking, forms) for tasks beyond reading
@@ -390,7 +419,7 @@ Ideas and requests are welcome in [issues](https://github.com/SnowFXXX/LocalAgen
 
 ## Testing
 
-The test suite runs in about a second and needs neither LM Studio nor a browser: the model and the website
+The test suite runs in a few seconds and needs neither LM Studio nor a browser: the model and the website
 are replaced by scripted fakes, including an end-to-end run of the main loop.
 
 ```bash
@@ -416,8 +445,12 @@ Each run gets a folder in `regression_runs/` with every task's report, journal,
 trace, and a `summary.md` that is updated after each task: whether it finished, turns, model time, how many
 checklist items got findings, which checks fired, and problems found by simple word checks (missing answers,
 missed conditions such as a non-open-source item, uncited paragraphs, numbers missing from the findings, a
-missing opinion). `--suite all` adds five more tasks, `--only` runs some of them, and `--rescore` scores an
-earlier run again without the model.
+missing opinion). It also flags a task that fails again on the same site as in the earlier run: one site that
+cannot answer part of an objective can decide a task whatever the agent does (the repotting how-to went to the same
+guide in three runs, which is why the core how-to is now the cold brew one). `--suite all` adds six more tasks,
+including the earlier how-to, `--only` runs some of them, and `--rescore` scores an earlier run again without the
+model. Every step since 1.53 and its results are in
+[docs/regression-history.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/docs/regression-history.md).
 
 ## Contributing
 
@@ -426,8 +459,10 @@ the [Code of Conduct](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/CO
 
 ## Project history
 
-Every version is a tagged commit, and [CHANGELOG.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/CHANGELOG.md) describes what changed in each one and
-why, with the measurements behind the decisions.
+Every released version is a tagged commit, and [CHANGELOG.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/CHANGELOG.md) describes what changed in each one and
+why, with the measurements behind the decisions. Versions 1.54 to 1.56 and 1.58 to 1.60 were internal steps, each
+measured on the regression suite and released with 1.57 and 1.61; their results are in
+[docs/regression-history.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/docs/regression-history.md).
 
 ## Acknowledgements
 

{localagentbrowser-1.53 → localagentbrowser-1.61}/README.md

@@ -24,7 +24,7 @@ and tuned to work well with a **small 7B model on a CPU, no GPU required**.
 - ⚡ **Built for slow hardware.** It reuses LM Studio's prompt cache, so most turns process only what changed.
 - 📝 **A readable report every time.** `research_report.md` holds the final result and every finding with its
   source, written however the run ends; `research_log.txt` keeps every action and reason.
-- ✅ **Tested.** 136 tests on Linux and Windows, Python 3.10–3.13, run in about a second with no model or browser,
+- ✅ **Tested.** 165 tests on Linux and Windows, Python 3.10–3.13, run in a few seconds with no model or browser,
   plus a [regression suite](#regression-suite) of live runs on seven different kinds of task.
 
 📖 **The story behind it:** [Teaching a 7B model on a CPU to finish what it starts](https://dev.to/snowfxxx/teaching-a-7b-model-on-a-cpu-to-finish-what-it-starts-1amc),
@@ -167,17 +167,19 @@ does not generalise; the [changelog](https://github.com/SnowFXXX/LocalAgentBrows
 
 Since 1.53, every change is measured on the same seven objectives, one of each kind above, run one after the other
 with a time limit each (`tools/regression.py`, see [Testing](#testing)). Single runs vary with the pages a search
-turns up, so the suite compares versions on all seven at once:
-
-| Task | 1.52 | 1.53 (objective checklist) |
-|---|---|---|
-| Factual question | Finished, 12 min | Finished, 14 min |
-| List of three office suites | Time limit (45 min) | Finished, 30 min; but one of the three (WPS Office) is not open source |
-| Comparison and recommendation | Time limit (45 min) | Finished, 39 min, every part covered |
-| How-to (repotting) | Time limit (45 min) | Time limit (45 min); materials and steps found, aftercare not |
-| Explanation (photosynthesis) | Time limit (60 min) | Finished, 13 min, but thin: one finding, no oxygen or water |
-| Opinion (owls) | Time limit (45 min) | Finished, 38 min, four cultures and an opinion |
-| Documentation (venv, official docs) | Finished, 15 min, from a tutorial site | Time limit (30 min); create and activate found, from python.org |
+turns up, so the suite compares versions on all seven at once. 1.54 to 1.56 and 1.58 to 1.60 were internal steps
+measured this way and released with 1.57 and 1.61; [docs/regression-history.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/docs/regression-history.md)
+has every step's results and what each one showed.
+
+| Task | 1.52 | 1.53 (objective checklist) | 1.57 (coverage check) | 1.61 (verified send-backs, outline pointer) |
+|---|---|---|---|---|
+| Factual question | Finished, 12 min | Finished, 14 min | Finished, 13 min | Finished, 17 min |
+| List of three office suites | Time limit | Finished, 30 min; but WPS Office is not open source | Time limit: three correct open-source suites by turn 7, sent back because no words showed them to be "free" | Finished, 21 min: LibreOffice, WPS Office and OnlyOffice, each marked "not shown in the pages read to be free and open-source" |
+| Comparison and recommendation | Time limit | Finished, 39 min | Time limit, after a send-back for "official documentation", which the objective does not ask for | Finished, 26 min, setup and administration from the part of a long page the outline pointer chose |
+| How-to (cold brew from 1.55; repotting before) | Time limit | Time limit | Finished, 36 min; but "how long it keeps" answered with the steeping time | Finished, 33 min: every step, the 16-hour steep and the shelf life, cited |
+| Explanation (photosynthesis) | Time limit | Finished, 13 min, but thin: no oxygen or water | Finished, 59 min: inputs, outputs and both stages, cited | Finished, 39 min |
+| Opinion (owls) | Time limit | Finished, 38 min | Time limit: its first page covered two of the three cultures asked for | Finished, 42 min: four cultures, cited, with a view |
+| Documentation (venv, official docs) | Finished, 15 min, from a tutorial site | Time limit (30 min) | Finished, 37 min, all from python.org; but the Windows line repeats the create command instead of the activate one | Time limit: all four items found from python.org, then it read on |
 
 ## How it works
 
@@ -216,12 +218,22 @@ flowchart LR
 - **Findings must match the page.** A finding that shares too few word pairs with the page text shown so far
   (or has a sentence that does) is sent back once, asking for only what the page says in its own words, and
   one far from anything on the page is refused outright. A small model will otherwise "complete" a list from
-  its own knowledge when a page says "follow these 6 steps" and the steps come later.
+  its own knowledge when a page says "follow these 6 steps" and the steps come later. The refusal points the way:
+  it quotes the one page sentence closest to what the model wrote, to record instead, or names what the parts
+  shown never mention ("Japan, Navajo"), so the model reads on.
 - **An objective checklist.** At the start, one short model call splits the objective into a fixed checklist of
   what the result must contain, keeping conditions like "free, open-source" or "three". Each finding names the
   items it serves, the checklist with its findings is in every prompt, and every check goes through these items
   instead of asking the model to split the objective again from memory, which drifted: it once blocked its own
-  finish over "migration strategies", which the objective never asked for.
+  finish over "migration strategies", which the objective never asked for. Opinion items are shown as written
+  at FINISH, not as gaps to fill, and the first search covers the whole objective in one short query, keeping
+  its conditions ("official python documentation venv").
+- **A coverage check before finishing.** Each checklist item is checked against the findings in a short call of
+  its own, and the code checks the verdict instead of taking it on trust: an item nothing was copied for, fewer
+  things than asked for ("only 1 of 3 found"), and things not shown, in words copied from a finding about them,
+  to meet a condition such as "open-source". A claim that something is missing is dropped when every word of it is
+  already in the findings. With gaps, the FINISH is sent back once, with the next step named ("SEARCH for
+  'OnlyOffice free and open-source' to check it, or replace it"), and the next turn starts from a fresh prompt.
 - **Numbered findings.** Findings are numbered in the prompt and listed with every check, and the model names
   the finding that covers each part of the objective ("covered by [2]") instead of just saying "covered".
 - **Knowing when it's done.** After every new finding the model is asked whether the objective is now fully
@@ -233,12 +245,16 @@ flowchart LR
   A part that cannot be found after several tries can be reported as missing instead of blocking for good.
 - **Writing is a separate step.** When the agent finishes, one more model call writes the final result from
   only the objective and the recorded findings, under a short list of rules: no guessing or outside knowledge,
-  cite findings by number, give exactly as many items as asked for, and add a "My view:" paragraph only when
-  the objective asks for an opinion. A small model writes far better when that is its only job, and every
-  claim stays traceable to a recorded finding. The report flags any number in the final result that appears
-  in none of the findings, the most harmful kind of slip in a how-to.
+  cite findings by number, give as many items as asked for (never repeating one, and saying how many were not
+  found), and add a "My view:" paragraph only when the objective asks for an opinion. A small model writes far
+  better when that is its only job, and every claim stays traceable to a recorded finding. What no finding
+  answers is not left to the model: those checklist items, and things not shown to meet a condition, are left out
+  of what it is asked to write, and the code adds them after the result as "Not found in the pages read" and
+  "Left out, not shown to meet the conditions". The report flags any number in the final result that appears in
+  none of the findings, the most harmful kind of slip in a how-to.
 - **Error pages are recognised.** A page answering 404, 403 and so on counts as a failed visit, not content.
-- **Readable pages.** Navigation menus, footers and cookie banners are hidden; code blocks and tables are
+- **Readable pages.** Navigation menus, footers, cookie banners and site notices such as fundraising banners are
+  hidden; code blocks and tables are
   never split between parts; links already shown are not repeated. Long pages come with an outline of the
   headings in each part, marking the parts already read, so the agent can jump to the part it needs instead of
   reading in order.
@@ -271,12 +287,13 @@ Measured on an Intel i5-9500 (6 cores, no GPU) with Qwen2.5-7B-Instruct Q4_K_M a
 | Follow-up on the same page (finding recorded, cheap retry) | 35–60 s |
 | Next part of a page, or a new page appended | 100–280 s |
 | First turn of a run | 45–110 s |
-| Fresh prompt after the context budget is reached | 160–380 s (longest with long pages) |
+| Fresh prompt (context budget reached, or after a coverage send-back) | 160–540 s (longest with long pages) |
+| Coverage check before finishing (all checklist items) | about 1–3 min |
 | Writing the final result (once, at the end) | 50–190 s, depending on how much was found |
 
-Whole runs vary with the pages a search turns up. In the results table, a factual question takes about 12
-minutes of model time, a list of three items 16 to 49, a comparison 25 to 38 and an explanation 45 or more. A
-GPU or a smaller model will be much faster.
+Whole runs vary with the pages a search turns up. In the regression runs since 1.53, a factual question took 9 to
+19 minutes of model time; the list, comparison, how-to, opinion and documentation tasks 17 to 44 when they finished;
+and the explanation 13 to 59. A whole suite of seven tasks took 171 to 272 minutes. A GPU or a smaller model will be much faster.
 
 ## FAQ
 
@@ -311,18 +328,21 @@ turn that brings in a new page takes a few minutes. See [Performance](#performan
   research, an opinion from several sources, a factual question, a comparison, a how-to, a list and an
   explanation of a topic. Each one
   exposed something that did not generalise and was fixed; other kinds of tasks may expose more.
-- **Reading long pages and knowing when it has enough.** The model used to read long pages part by part
-  without recording the relevant parts; since 1.42 it must say what a part contains before reading on. On 1.52
-  the explanation task still lost about 20 minutes reading unrelated sections of a long article and did not
-  finish. On 1.53, with the objective checklist, it finished in 13 minutes, but from a single overview paragraph
-  that left out oxygen and water: the model can now claim one finding covers every item. Judging whether a
-  finding really covers an item is the weakest area.
+- **Judging whether a finding covers an item is the weakest area.** The model's verdict is unreliable both ways:
+  on 1.53 the explanation finished from one overview paragraph without oxygen or water, and in the regression runs
+  since 1.54 about half of the coverage check's send-backs were for gaps that were not real ("missing official
+  documentation" on a comparison that did not ask for it, "H2O, O2" already recorded). Since 1.58 the agent is sent
+  back only for what the code verifies (an item nothing answers, fewer things than asked for); the model's other
+  verdicts only shape the final result, so a thin answer can still pass (on 1.61 the comparison's "many
+  simultaneous users" part is short).
 - **Conditions in the objective.** A small model tends to drop conditions such as "open source" or "using the
   official documentation": a list of open-source office suites once included FreeOffice (free but not open
   source), and a task that asked for the official Python documentation used a tutorial site. The objective
-  checklist keeps the conditions in view (the documentation task went to python.org on 1.53), but on the same
-  run the list task still named WPS Office, which is not open source. Check the result against any conditions
-  you set.
+  checklist keeps the conditions in view (the documentation task uses python.org since 1.55), and a thing not
+  shown in the findings to meet a condition is marked where it is named ("not shown in the pages read to be free
+  and open-source"). The mark says what the pages read did not show, not that the thing fails the condition: on
+  1.61 it marked LibreOffice and OnlyOffice, which are open source, as well as WPS Office, which is not. Check the
+  result against any conditions you set.
 - **A small model's judgement is the ceiling.** It sometimes drifts to loosely related pages, prefers
   secondary sources or stays with one source too long, and results vary with the first pages a search turns
   up; every finding is in `research_report.md` regardless.
@@ -331,8 +351,9 @@ turn that brings in a new page takes a few minutes. See [Performance](#performan
   minutes, but with thin findings and without naming what it could not find, so check the result against the
   objective.
 - **Check the citations.** The final result is told to use only recorded findings, but a 7B model sometimes
-  puts the wrong number on a citation, adds a line no finding supports or leaves out a step, so verify a
-  claim against the listed findings before relying on it.
+  puts the wrong number on a citation, adds a line no finding supports, leaves out a step or misreads a part of
+  the question (on 1.57 it answered "how long it keeps in the fridge" with the steeping time), so verify a claim
+  against the listed findings before relying on it.
 - **Some sites refuse automated browsers** (HTTP 403). The agent respects that and does not try to disguise
   itself; it moves on to other sources.
 - **Reading only.** The agent searches, opens pages and reads them. It does not click, fill in forms or sign in.
@@ -349,7 +370,15 @@ turn that brings in a new page takes a few minutes. See [Performance](#performan
 - [ ] Let very strict objectives end with the gaps named instead of searching indefinitely (they finish since 1.50; naming the gaps is still open)
 - [x] Measure every change on a regression suite of seven kinds of task (1.53)
 - [x] Keep a fixed checklist of the objective's parts instead of re-splitting it at every check (1.53)
-- [ ] Check that a finding really covers its checklist item, including conditions like "open source"
+- [ ] Check that a finding really covers its checklist item, including conditions like "open source" (partly, since
+  1.57: a coverage check before finishing, with what the code can verify)
+- [x] Send the agent back only for gaps the code verifies, and let the model's other verdicts only shape the final
+  result (1.58, released in 1.61)
+- [x] Point the agent to the part of a long page whose outline names an item it still needs (1.61)
+- [ ] Keep the advice to finish when a conversation starts over from a fresh prompt (the next step after 1.61)
+- [ ] Rewind dead ends: save the conversation before an expensive step such as reading a long page, and if it
+  leads nowhere, return to that point with a short note instead of carrying the unused page text in every later
+  prompt (LM Studio reuses its cache up to the saved point)
 - [ ] Try more kinds of objectives (seven so far) and adjust the rules that don't generalise
 - [ ] Make fresh prompts (the slowest kind of turn) cheaper still (31% cheaper since 1.34)
 - [ ] Interacting with pages (clicking, forms) for tasks beyond reading
@@ -358,7 +387,7 @@ Ideas and requests are welcome in [issues](https://github.com/SnowFXXX/LocalAgen
 
 ## Testing
 
-The test suite runs in about a second and needs neither LM Studio nor a browser: the model and the website
+The test suite runs in a few seconds and needs neither LM Studio nor a browser: the model and the website
 are replaced by scripted fakes, including an end-to-end run of the main loop.
 
 ```bash
@@ -384,8 +413,12 @@ Each run gets a folder in `regression_runs/` with every task's report, journal,
 trace, and a `summary.md` that is updated after each task: whether it finished, turns, model time, how many
 checklist items got findings, which checks fired, and problems found by simple word checks (missing answers,
 missed conditions such as a non-open-source item, uncited paragraphs, numbers missing from the findings, a
-missing opinion). `--suite all` adds five more tasks, `--only` runs some of them, and `--rescore` scores an
-earlier run again without the model.
+missing opinion). It also flags a task that fails again on the same site as in the earlier run: one site that
+cannot answer part of an objective can decide a task whatever the agent does (the repotting how-to went to the same
+guide in three runs, which is why the core how-to is now the cold brew one). `--suite all` adds six more tasks,
+including the earlier how-to, `--only` runs some of them, and `--rescore` scores an earlier run again without the
+model. Every step since 1.53 and its results are in
+[docs/regression-history.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/docs/regression-history.md).
 
 ## Contributing
 
@@ -394,8 +427,10 @@ the [Code of Conduct](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/CO
 
 ## Project history
 
-Every version is a tagged commit, and [CHANGELOG.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/CHANGELOG.md) describes what changed in each one and
-why, with the measurements behind the decisions.
+Every released version is a tagged commit, and [CHANGELOG.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/CHANGELOG.md) describes what changed in each one and
+why, with the measurements behind the decisions. Versions 1.54 to 1.56 and 1.58 to 1.60 were internal steps, each
+measured on the regression suite and released with 1.57 and 1.61; their results are in
+[docs/regression-history.md](https://github.com/SnowFXXX/LocalAgentBrowser/blob/main/docs/regression-history.md).
 
 ## Acknowledgements