docs: audit + low-confidence doc live in <library>/../_logs/ now

This commit is contained in:
2026-10-08 14:22:40 +02:00
parent 8f3a91bcd4
commit 8f4cc55bb4
2 changed files with 15 additions and 1 deletions
+6 -1
View File
@@ -238,7 +238,7 @@ never re-fetch them again):
- **Weak tier**: when nothing reaches the threshold, a hit >= `WEAK_MIN`
(0.50) is accepted but flagged low confidence - `[w]` in the plan,
`confidence: low` in the audit, listed in
`<library>/sorter_low_confidence.txt`. Weak and tokenless adoptions
`sorter_low_confidence.txt` in the log dir (see below). Weak and tokenless adoptions
require a shared non-generic token; tokenless normal adoption needs
+0.08 (`TOKENLESS_BONUS`); cross-system adoption additionally needs
token containment (`_token_contained`), because char-ratio lies
@@ -255,6 +255,11 @@ never re-fetch them again):
full-catalog and different-faction adoptions need token
containment (`_contained_somewhere`).
- **Bookkeeping location (fixed 2026-10-08)**: the audit and the
low-confidence doc are written to `<library>/../_logs/` by default
(`--audit` overrides) - never inside the library itself, because the
library may be a seeded torrent whose file set is frozen.
The catalog deliberately covers all GW systems (needed for
catalog-agnostic use) - wrong-system placement is prevented by matching
discipline and the drop filter, not by shrinking the catalog.
+9
View File
@@ -81,6 +81,15 @@ graph LR
applied action is appended to `sorter_applied.jsonl` and re-runs skip
targets that already exist.
## Bookkeeping location
The audit (`sorter_applied.jsonl`) and the low-confidence review doc
(`sorter_low_confidence.txt`) are written to `<library>/../_logs/` by
default — **never inside the library itself**, because the library may be
a seeded torrent whose file set is frozen (a rewritten audit file would
fail the client's recheck). `--audit FILE` overrides this; the low-
confidence doc always lands next to the audit file.
## Why hardlinks, and the unzip question
- Hardlinks make "same file, two positions" free (0 extra bytes) — the