feat(resolve): --max-files knob to trade CLAP cost vs kit per-index detail

Opaque folders send every file through a batched HTSAT forward; --max-files N
caps that. Defaults to CLF.MAX_FILES (12). Use 6 for fast dominant-family
grounding when full per-index kit detail isn't needed.

armada/tide-table/sample_resolve.py

@@ -150,7 +150,9 @@ def main():
         CLF.METHOD = args[args.index("--method") + 1]
     else:
         CLF.METHOD = "ensemble"            # best on the scoreboard (73%)
-    print(f"   (audio method={CLF.METHOD}, mode={CLF.MODE})")
+    if "--max-files" in args:              # speed/detail knob: fewer opaque files →
+        CLF.MAX_FILES = int(args[args.index("--max-files") + 1])  # fewer CLAP forwards
+    print(f"   (audio method={CLF.METHOD}, mode={CLF.MODE}, max_files={CLF.MAX_FILES})")
     if args and args[0] == "one" and len(args) > 1:
         cmd_one(args[1])
     elif args and args[0] == "run":