docs: probe votes on full inner paths; Iron Hands mega-bucket fix documented

AGENTS.md

@@ -247,6 +247,13 @@ never re-fetch them again):
      `{Middle-Earth}`) - catalog entries filtered at load, keyword hits
      count as unclassified; files stay in `_unsorted`. `--drop-system`/
      `--keep-system` adjust. The catalog snapshot keeps all systems.
+   - **Probe votes on full inner paths** (2026-10-07, after run 5): pack
+     probes clean the whole relative path, so inner dir names vote
+     ("Catachan/Jungle Fighters/" resolves Astra Militarum). No
+     single-token containment boost for inner votes (a root file named
+     "lieutenant" once claimed ~7000 files into one Iron Hands unit);
+     full-catalog and different-faction adoptions need token
+     containment (`_contained_somewhere`).
 
    The catalog deliberately covers all GW systems (needed for
    catalog-agnostic use) - wrong-system placement is prevented by matching

docs/SORTING.md

@@ -148,6 +148,16 @@ already-present duplicates, 0 copied):
   those sections - the files stay in `_unsorted`. `--drop-system NAME`
   drops more, `--keep-system NAME` re-enables one. The committed catalog
   snapshot itself is untouched.
+- **Probe votes on full inner paths** (2026-10-07): the pack probe's
+  inner-name votes clean the whole relative path (dir names included),
+  not just the file stem - hash-named 0807 packs resolve their faction
+  from folders like `Catachan/Jungle Fighters/` instead of from one
+  root file named `lieutenant`. The token-containment boost is disabled
+  for single-token inner votes (one generic-ish word must not claim a
+  pack), and full-catalog/different-faction adoptions additionally
+  require token containment (`_contained_somewhere`). A matched catalog
+  unit's class layer always wins (no keyword class survives next to a
+  precise unit match).
 
 ## Catalog file (`data/library_catalog.json`)