diff --git a/AGENTS.md b/AGENTS.md index fcfdd9f..05694f4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 - `/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 `/../_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. diff --git a/docs/SORTING.md b/docs/SORTING.md index 2876701..72e2b70 100644 --- a/docs/SORTING.md +++ b/docs/SORTING.md @@ -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 `/../_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