From a49e3bba872e963615cc61de73ab933ce6787866 Mon Sep 17 00:00:00 2001
From: Ed_ <edwardgz@gmail.com>
Date: Wed, 17 Jun 2026 19:13:00 -0400
Subject: [PATCH] docs(track): result_migration_small_files decisions for
 src/vendor_capabilities.py (1 RAISE; keep as-is)

The audit reports src/vendor_capabilities.py:42 as INTERNAL_RETHROW
(suspicious) because the function raises KeyError when no
capabilities are registered for the requested vendor/model.

Decision: keep the raise pattern. This is a legitimate runtime
validation signal (caller asked for unregistered vendor/model).
8 callers in src/{app_controller,gui_2,ai_client}.py use the
returned caps object directly without checking; migrating to
Optional or Result would cascade into 8 caller updates.

The audit heuristic gap (raise KeyError after dict lookup miss
should be INTERNAL_PROGRAMMER_RAISE per the validation-raise
pattern) is noted as a follow-up improvement.