docs(tests): create tests/README.md with full suite inventory, coverage matrix, and execution guide

graphify-out/2026-08-21/GRAPH_REPORT.md

@@ -1,7 +1,7 @@
 # Graph Report - TextNLPClassifierApp  (2026-08-21)
 
 ## Corpus Check
-- 203 files · ~114,894 words
+- 203 files · ~114,931 words
 - Verdict: corpus is large enough that graph structure adds value.
 
 ## Summary
@@ -10,7 +10,7 @@
 - Token cost: 0 input · 0 output
 
 ## Graph Freshness
-- Built from commit: `a874b98d`
+- Built from commit: `2cdd3547`
 - Run `git rev-parse HEAD` and compare to check if the graph is stale.
 - Run `graphify update .` after code changes (no API cost).
 
@@ -157,7 +157,7 @@
 - Specification Quality Checklist: Convert Article JSON to Markdown
 - CLI Contract: `convert_article_to_markdown.py`
 - 9. Interface CLI
-- get_hl_gl_ceid
+- sample_rss_xml
 - 13. Estratégia de testes
 - 6. Contrato de entrada
 - ECPSnapshot
@@ -196,7 +196,7 @@
   classify.py → src/models.py
 - `main()` --uses--> `ErrorCode`  [INFERRED]
   classify.py → src/models.py
-- `test_e2e_extract_google_news_live_pipeline()` --uses--> `ExtractionResult`  [INFERRED]
+- `test_extract_google_news_orchestration_mocked()` --uses--> `ExtractionResult`  [INFERRED]
   tests/test_extract_google_news.py → scripts/extract_google_news.py
 - `test_llm_adapter_interface()` --calls--> `LLMFallbackAdapter`  [EXTRACTED]
   tests/test_adapters.py → src/adapters/llm.py
@@ -373,16 +373,16 @@ Cohesion: 0.08
 Nodes (24): 1. Visão geral (arquitetura), 2.1 DTO de entrada (`googlenews_etl/application/dtos/extract_news_dto.py`), 2.2 Value Object de validação (`googlenews_etl/domain/entities/search_query.py`), 2. Entrada, 3.1 O caso de uso (`googlenews_etl/application/use_cases/extract_news_use_case.py`), 3.2 A porta (`googlenews_etl/domain/ports/news_extractor_port.py`), 3.3.1 Inicialização: sessão HTTP com impersonação de browser, 3.3.2 Mapeamento idioma → parâmetros `hl`/`gl` (`_get_hl_gl`) (+16 more)
 
 ### Community 82 - "extract_google_news.py"
-Cohesion: 0.20
-Nodes (14): extract_google_news(), _fetch_rss_content(), NewsArticle, _normalize_text_for_comparison(), parse_google_news_rss(), Remove pontuação e espaços extras para comparação de redundância., Parseia o XML do RSS do Google News e extrai os itens estruturados., Resolve em paralelo as URLs intermediárias do Google News para os links finais… (+6 more)
+Cohesion: 0.15
+Nodes (18): extract_google_news(), _fetch_rss_content(), get_hl_gl_ceid(), NewsArticle, _normalize_text_for_comparison(), parse_google_news_rss(), Mapeia idioma e locale para os parâmetros hl, gl e ceid do Google News., Remove pontuação e espaços extras para comparação de redundância. (+10 more)
 
 ### Community 83 - "ExtractionResult"
 Cohesion: 0.29
-Nodes (5): ExtractionResult, Any, Resultado consolidado da extração., Valida a consolidação do ExtractionResult a partir da busca mockada com URLs…, test_extract_google_news_orchestration_mocked()
+Nodes (5): ExtractionResult, Any, Resultado consolidado da extração., Valida E2E o fluxo completo de busca, parsing e resolução de URLs reais ao vivo., test_e2e_extract_google_news_live_pipeline()
 
 ### Community 84 - "test_extract_google_news.py"
-Cohesion: 0.16
-Nodes (14): Resolve a URL intermediária do Google News para a URL real do veículo., resolve_article_url(), fixture, Testes unitários e de integração para o Extrator de Manchetes do Google News.…, Valida o parsing do feed RSS, higienização de tags HTML e deduplicação., Valida fallback gracioso de URL quando não é link do Google News ou em erro., Valida resolução bem-sucedida de URL do Google News para o portal destino., Valida E2E que o decodificador resolve uma URL real do Google News para o… (+6 more)
+Cohesion: 0.15
+Nodes (15): Resolve a URL intermediária do Google News para a URL real do veículo., resolve_article_url(), Testes unitários e de integração para o Extrator de Manchetes do Google News.…, Valida fallback gracioso de URL quando não é link do Google News ou em erro., Valida resolução bem-sucedida de URL do Google News para o portal destino., Valida E2E que o decodificador resolve uma URL real do Google News para o…, Valida o mapeamento padrão de idiomas para pares (hl, gl, ceid)., Valida a sobrescrita geográfica quando o argumento locale é especificado. (+7 more)
 
 ### Community 85 - "Implementation Tasks: Google News Headlines Extractor"
 Cohesion: 0.14
@@ -402,7 +402,7 @@ Nodes (7): Architecture & Pipeline, Documentation (this feature), Implementation
 
 ### Community 90 - "SearchQuery"
 Cohesion: 0.20
-Nodes (6): Value Object com parâmetros de busca validados., SearchQuery, Valida E2E o fluxo completo de busca, parsing e resolução de URLs reais ao vivo., Valida as regras de negócio e limites de SearchQuery., test_e2e_extract_google_news_live_pipeline(), test_search_query_validation()
+Nodes (6): Value Object com parâmetros de busca validados., SearchQuery, Valida a consolidação do ExtractionResult a partir da busca mockada com URLs…, Valida as regras de negócio e limites de SearchQuery., test_extract_google_news_orchestration_mocked(), test_search_query_validation()
 
 ### Community 91 - "1. Technical Decisions & Tradeoffs"
 Cohesion: 0.25
@@ -624,9 +624,9 @@ Nodes (5): 1. Script Signature, 2. Command-Line Arguments, 3. Exit Codes, 4. Sta
 Cohesion: 0.40
 Nodes (5): 9.1 Script, 9.2 Argumentos, 9.3 Exemplos, 9.4 Saída do processo, 9. Interface CLI
 
-### Community 149 - "get_hl_gl_ceid"
-Cohesion: 0.25
-Nodes (8): get_hl_gl_ceid(), Mapeia idioma e locale para os parâmetros hl, gl e ceid do Google News., Valida o mapeamento padrão de idiomas para pares (hl, gl, ceid)., Valida a sobrescrita geográfica quando o argumento locale é especificado., Valida fallback dinâmico para idiomas regionais não listados explicitamente., test_get_hl_gl_ceid_default_mappings(), test_get_hl_gl_ceid_dynamic_fallback(), test_get_hl_gl_ceid_with_custom_locale()
+### Community 149 - "sample_rss_xml"
+Cohesion: 0.67
+Nodes (3): fixture, Fixture que fornece o conteúdo do XML de exemplo para testes offline., sample_rss_xml()
 
 ### Community 150 - "13. Estratégia de testes"
 Cohesion: 0.50