Skip to Content
Modules

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

LineWhat it says
A runWhen, 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 recordTaken (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 triageFor a bid: «Ours» or «Not ours», and why, by Tommo Bids
A model callThe 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).

TypeScriptPythonWrite 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.

On this page