The log
Each scout has a log in Settings, Scouts. Tommos writes a line of each run and each record; the module writes its own lines, of three kinds.
Each source has its log, in the shape of the log of Tommo Bids: by day, newest first; a line of each run, and under it the module's lines and a line of each record.
The lines Tommos writes
| Line | What it says |
|---|---|
| A run | When, how long, how it ended (done, failed with the reason, out of time), found, taken, the same again, refused. The versions of the module and of the tools stand behind Technical details |
| A record | Taken (with the link to its deal or card), waiting for the triage, sorted out by the triage, the same again, refused (with the reason of the contract or of the door), or in the trial lane; with the record's matched |
| The triage | For a bid: «Ours» or «Not ours», and why, by Tommo Bids |
| A model call | The model, the tokens and the cost, or why the call was refused |
The lines your module writes
Three kinds only. Any other kind is not kept, and the check refuses it (check e).
| TypeScript | Python | Write it for |
|---|---|---|
log.read(where, count) | log.read(where, count) | Each page or feed you read, and how many items it held |
log.skipped(key, reason) | log.skipped(key, reason) | Each item you dropped, and why |
log.warning(text) | log.warning(text) | Something a person should know |
How a warning shows
A warning does not fail the run. A run that ends with a warning is Done, and it is not red: only a run that failed or ran out of time is red. Each warning is its own line under the run, once; the same words again add a count, such as Warning ×3. The line shows the first part of your text, to its first «.» or «;», at most 120 characters. The whole text stands behind Technical details on the run's line. So put the fact first: «page 3 answered 503; the run took pages 1 and 2».
log.read("the fictional register", 6);
log.skipped("FN-0004", "its due date 2026-11-05 has passed");
log.warning("page 3 answered 503; the run took pages 1 and 2");A module that writes no log.read line is refused: a run that says nothing of what it read cannot be judged.
A good reason to skip
Say the fact that dropped the item, in the source's own terms, short:
- «its due date 2026-04-06 has passed»
- «github.com is not a company's own website»
- «the tender is cancelled, not open»
Not «not relevant», not «filtered»: a person must see the rule.
matched
Each record carries matched: the rule of your module that took it, as a fact. «an open notice of the fictional register»,
«CPV 72254, software testing», «a Show HN launch with its own website». It stands on the record's line of the log and
on the record in Tommos.
country
A bid carries its buyer's country, GB or US. The log of Tommo Bids shows its flag. A bid with no country shows none.
What never stands in the log
The tools take the value of each secret and the query of each address out of every line and every error before it is
kept, and Tommos takes them out again. https://api.example.gov/x?token=abc stands as
https://api.example.gov/x?[query]. A run keeps at most 500 lines of the module, each at most 500 characters.
The tools
The tools of Tommos for a module, in TypeScript and in Python: fetch, the cursor, the builders of a bid and a prospect, the domain, the date and the key, the log, and ask.
The check
The checks a module must pass before Tommos adds it, each with what it means and how to fix it. The same check runs on your computer, in your GitHub workflow and in Tommos.