refactor: _shared.py vira subpacote, um módulo por papel

Eram 882 linhas de seis papéis sem relação, sob um nome que só dizia
"compartilhado" — o depósito onde tudo que servia a mais de um handler
acabava caindo.

    media       316   transcrição em cache, corte por fala, relatório
    paths       206   sandbox, limites, caminho de saída
    project     116   abrir projeto, preparar modifier/generator
    captions    112   SRT, VTT, listas com timestamp
    detection    99   flash frames, buracos, duplicados
    formatting   86   tabelas e relatórios dos handlers

O __init__ reexporta os 46 nomes, então os treze pontos que importam daqui
não mudaram.

_transcript_cut_report saiu de formatting para media: ele precisa do hint de
instalação e do _text_result, ou seja, é relatório de transcrição e não
formatação genérica — mover foi mais honesto que cruzar imports entre os
dois módulos.

Quatro testes patchavam `server_tools._shared.transcribe`; o nome agora é
ligado por _shared/media.py, então o patch passou a apontar para lá — mesmo
padrão da experiência #23.

Lint zerado, 1454 testes passando.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

code/tests/test_diarize_media_tool.py

@@ -46,7 +46,7 @@ class TestDiarizeMediaHandler:
             await handle_diarize_media({"media_path": str(bad)})
 
     async def test_writes_diarization_json_and_reports(self, tmp_path, monkeypatch):
-        import server_tools._shared as _shared_mod
+        import server_tools._shared.media as _shared_mod
         import server_tools.voice as server_mod
         from server import handle_diarize_media
 
@@ -86,7 +86,7 @@ class TestDiarizeMediaHandler:
         assert data["words"][1]["speaker_id"] == "SPEAKER_01"
 
     async def test_reports_when_diarization_fails(self, tmp_path, monkeypatch):
-        import server_tools._shared as _shared_mod
+        import server_tools._shared.media as _shared_mod
         import server_tools.voice as server_mod
         from server import handle_diarize_media
 

code/tests/test_refine_voice_timeline_tool.py

@@ -32,7 +32,7 @@ def two_candidates(monkeypatch):
     than one candidate to cap.
     """
     import fcpxml.voice_timeline as vt
-    import server_tools._shared as _shared_mod
+    import server_tools._shared.media as _shared_mod
 
     transcript = {
         "language": "pt",

code/tests/test_voice_features_tool.py

@@ -43,7 +43,7 @@ def wav(tmp_path):
 @pytest.fixture
 def patched_analysis(monkeypatch):
     """Make the tool's transcription + librosa extractors deterministic."""
-    import server_tools._shared as _shared_mod
+    import server_tools._shared.media as _shared_mod
     import server_tools.voice as server_mod
 
     monkeypatch.setattr(_shared_mod, "transcribe", lambda *a, **k: _FAKE_TRANSCRIPT)
@@ -111,7 +111,7 @@ class TestAnalyzeVoiceFeaturesHandler:
         assert "emphasis_weights" in data["config"]
 
     async def test_empty_transcript_reports_instead_of_crashing(self, wav, monkeypatch):
-        import server_tools._shared as _shared_mod
+        import server_tools._shared.media as _shared_mod
         import server_tools.voice as server_mod
         from server import handle_analyze_voice_features
 
@@ -123,7 +123,7 @@ class TestAnalyzeVoiceFeaturesHandler:
         assert "no words" in result[0].text.lower()
 
     async def test_untranscribable_media_reports_install_hint(self, wav, monkeypatch):
-        import server_tools._shared as _shared_mod
+        import server_tools._shared.media as _shared_mod
         import server_tools.voice as server_mod
         from server import handle_analyze_voice_features
 
@@ -133,7 +133,7 @@ class TestAnalyzeVoiceFeaturesHandler:
         assert "faster-whisper" in result[0].text
 
     async def test_missing_pitch_track_degrades_without_crashing(self, wav, monkeypatch):
-        import server_tools._shared as _shared_mod
+        import server_tools._shared.media as _shared_mod
         import server_tools.voice as server_mod
         from server import handle_analyze_voice_features
 

code/tests/test_voice_timeline_tool.py

@@ -34,7 +34,7 @@ def wav(tmp_path):
 def patched(monkeypatch):
     """Deterministic transcription + acoustics, no optional extras needed."""
     import fcpxml.voice_timeline as vt
-    import server_tools._shared as _shared_mod
+    import server_tools._shared.media as _shared_mod
 
     monkeypatch.setattr(_shared_mod, "transcribe", lambda *a, **k: _TRANSCRIPT)
     monkeypatch.setattr(vt, "extract_pitch", lambda *a, **k: [(2.4, 260.0), (0.2, 120.0)])
@@ -71,7 +71,7 @@ class TestBuildVoiceTimelineHandler:
             await handle_build_voice_timeline({"media_path": str(bad)})
 
     async def test_untranscribable_media_reports_hint(self, wav, monkeypatch):
-        import server_tools._shared as _shared_mod
+        import server_tools._shared.media as _shared_mod
         from server import handle_build_voice_timeline
 
         monkeypatch.setattr(_shared_mod, "transcribe", lambda *a, **k: None)