yusyus 7496c2b5e0 feat: unified document parser system with RST/Markdown/PDF support ...

Implements comprehensive unified parser architecture for extracting
structured content from multiple documentation formats with feature
parity and quality scoring.

Key Features:
- Unified Document structure for all formats (RST, Markdown, PDF)
- Enhanced RST parser: tables, cross-refs, directives, field lists
- Enhanced Markdown parser: tables, images, admonitions, quality scoring
- PDF parser wrapper: unified output while preserving all features
- Quality scoring system for code blocks and tables
- Format converters: to_markdown(), to_skill_format()
- Auto-detection of document formats

Architecture:
- BaseParser abstract class with format-specific implementations
- ContentBlock universal container with 12 block types
- 14 cross-reference types (including Godot-specific)
- Backward compatible with legacy parsers

Integration:
- doc_scraper.py: Enhanced MarkdownParser with graceful fallback
- codebase_scraper.py: RstParser for .rst file processing
- Maintains backward compatibility with existing workflows

Test Coverage:
- 75 tests passing (up from 42)
- 37 comprehensive parser tests (RST, Markdown, auto-detection, quality)
- Proper pytest fixtures and assertions
- Zero critical warnings

Documentation:
- Complete architecture guide (docs/architecture/UNIFIED_PARSERS.md)
- Class hierarchy diagrams and usage examples
- Integration guide and extension patterns

Impact:
- Godot documentation extraction: 20% → 90% content coverage (+70%)
- Tables: 0 → ~3,000+ extracted
- Cross-references: 0 → ~50,000+ extracted
- Directives: 0 → ~5,000+ extracted
- All with quality scoring and validation

Files Changed:
- New: src/skill_seekers/cli/parsers/extractors/ (7 files, ~100KB)
- New: tests/test_unified_parsers.py (37 tests)
- New: docs/architecture/UNIFIED_PARSERS.md (12KB)
- Modified: doc_scraper.py (enhanced Markdown extraction)
- Modified: codebase_scraper.py (RST file processing)

Breaking Changes: None (backward compatible)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-02-15 23:14:49 +03:00

..

fixtures

Add unified scraping tests and example conflict data

2025-10-29 23:19:32 +03:00

test_adaptors

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

__init__.py

Add comprehensive test system with 71 tests (100% pass rate)

2025-10-19 02:08:58 +03:00

conftest.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

docker-compose.test.yml

feat: Add integration testing with real vector databases (Phase 5)

2026-02-07 22:55:02 +03:00

mcp_integration_test.md

Add comprehensive MCP setup guide and integration test template

2025-10-19 17:01:37 +03:00

test_adaptor_benchmarks.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_analyze_command.py

feat: Unified create command + consolidated enhancement flags

2026-02-15 14:29:19 +03:00

test_analyze_e2e.py

fix: Resolve PDF processing (#267), How-To Guide (#242), Chinese README (#260) + code quality (#273)

2026-01-31 21:30:00 +03:00

test_api_reference_builder.py

change max lenght

2026-01-17 17:48:15 +00:00

test_architecture_scenarios.py

style: Run ruff format on 15 files (CI fix)

2026-01-18 00:01:30 +03:00

test_async_scraping.py

fix: Resolve deprecation warnings in Pydantic and asyncio

2026-02-08 13:34:48 +03:00

test_benchmark.py

test: Skip tests requiring optional dependencies

2026-02-08 14:49:45 +03:00

test_bootstrap_skill_e2e.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_bootstrap_skill.py

docs: Update all documentation to use new 'analyze' command

2026-01-29 22:56:33 +03:00

test_c3_integration.py

fix: Fix remaining 61 ruff linting errors (SIM102, SIM117)

2026-01-17 23:25:12 +03:00

test_chunking_integration.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_cli_parsers.py

feat: Unified create command + consolidated enhancement flags

2026-02-15 14:29:19 +03:00

test_cli_paths.py

test: Update version expectations from 2.9.0 to 3.0.0

2026-02-08 15:00:32 +03:00

test_cli_refactor_e2e.py

style: Auto-format 48 files with ruff format

2026-02-15 20:24:32 +03:00

test_cloud_storage.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_code_analyzer.py

run ruff

2026-01-17 17:29:21 +00:00

test_codebase_scraper.py

fix: Remove duplicate documentation directories to save disk space (fixes #279)

2026-02-05 21:27:41 +03:00

test_config_extractor.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_config_fetcher.py

fix: Resolve PDF processing (#267), How-To Guide (#242), Chinese README (#260) + code quality (#273)

2026-01-31 21:30:00 +03:00

test_config_validation.py

change max lenght

2026-01-17 17:48:15 +00:00

test_constants.py

change max lenght

2026-01-17 17:48:15 +00:00

test_create_arguments.py

style: Auto-format 48 files with ruff format

2026-02-15 20:24:32 +03:00

test_create_integration_basic.py

style: Auto-format 48 files with ruff format

2026-02-15 20:24:32 +03:00

test_dependency_analyzer.py

fix: Resolve 61 critical linting errors

2026-01-17 22:54:40 +03:00

test_e2e_three_stream_pipeline.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_embedding_pipeline.py

test: Skip tests requiring optional dependencies

2026-02-08 14:49:45 +03:00

test_embedding.py

test: Skip tests requiring optional dependencies

2026-02-08 14:49:45 +03:00

test_enhance_skill_local.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_estimate_pages.py

change max lenght

2026-01-17 17:48:15 +00:00

test_excluded_dirs_config.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_framework_detection.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_generate_router_github.py

change max lenght

2026-01-17 17:48:15 +00:00

test_git_repo.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_git_sources_e2e.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_github_fetcher.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_github_scraper.py

style: Run ruff format on 15 files (CI fix)

2026-01-18 00:01:30 +03:00

test_guide_enhancer.py

style: Run ruff format on 15 files (CI fix)

2026-01-18 00:01:30 +03:00

test_how_to_guide_builder.py

fix: Resolve PDF processing (#267), How-To Guide (#242), Chinese README (#260) + code quality (#273)

2026-01-31 21:30:00 +03:00

test_incremental_updates.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_install_agent.py

style: Run ruff format on 15 files (CI fix)

2026-01-18 00:01:30 +03:00

test_install_multiplatform.py

change max lenght

2026-01-17 17:48:15 +00:00

test_install_skill_e2e.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_install_skill.py

change max lenght

2026-01-17 17:48:15 +00:00

test_integration_adaptors.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_integration.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_issue_219_e2e.py

style: Auto-format 48 files with ruff format

2026-02-15 20:24:32 +03:00

test_issue_277_real_world.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_language_detector.py

run ruff

2026-01-17 17:29:21 +00:00

test_llms_txt_detector.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_llms_txt_downloader.py

style: Run ruff format on 15 files (CI fix)

2026-01-18 00:01:30 +03:00

test_llms_txt_parser.py

run ruff

2026-01-17 17:29:21 +00:00

test_markdown_parsing.py

fix: Fix list comprehension variable names (NameError in CI)

2026-01-17 23:33:34 +03:00

test_mcp_fastmcp.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_mcp_git_sources.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_mcp_server.py

fix: Update MCP tests for unified config format

2026-02-08 14:44:46 +03:00

test_mcp_vector_dbs.py

fix: Enforce min_chunk_size in RAG chunker

2026-02-07 20:59:03 +03:00

test_merge_sources_github.py

change max lenght

2026-01-17 17:48:15 +00:00

test_multi_source.py

change max lenght

2026-01-17 17:48:15 +00:00

test_multilang_support.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_package_skill.py

change max lenght

2026-01-17 17:48:15 +00:00

test_package_structure.py

test: Update version expectations from 2.9.0 to 3.0.0

2026-02-08 15:00:32 +03:00

test_parallel_scraping.py

change max lenght

2026-01-17 17:48:15 +00:00

test_parser_sync.py

style: Auto-format 48 files with ruff format

2026-02-15 20:24:32 +03:00

test_pattern_recognizer.py

fix: Add skipif for HTTP server tests & finalize test suite fixes

2026-02-08 13:33:15 +03:00

test_pdf_advanced_features.py

fix: Resolve 61 critical linting errors

2026-01-17 22:54:40 +03:00

test_pdf_extractor.py

Merge PR #275: Add Dart, Scala, SCSS, SASS, Elixir, Lua, Perl language detection

2026-02-04 21:00:49 +03:00

test_pdf_scraper.py

fix: Remove duplicate import os statements causing UnboundLocalError

2026-01-27 21:11:04 +03:00

test_pr144_concerns.py

run ruff

2026-01-17 17:29:21 +00:00

test_preset_system.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_quality_checker.py

change max lenght

2026-01-17 17:48:15 +00:00

test_quality_metrics.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_rag_chunker.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_rate_limit_handler.py

change max lenght

2026-01-17 17:48:15 +00:00

test_real_world_fastmcp.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_scraper_features.py

change max lenght

2026-01-17 17:48:15 +00:00

test_server_fastmcp_http.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_setup_scripts.py

style: Format test_setup_scripts.py with ruff

2026-01-18 13:48:37 +03:00

test_skip_llms_txt.py

style: Run ruff format on 15 files (CI fix)

2026-01-18 00:01:30 +03:00

test_smart_summarization.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_source_detector.py

style: Auto-format 48 files with ruff format

2026-02-15 20:24:32 +03:00

test_source_manager.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_streaming_ingestion.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_swift_detection.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_terminal_detection.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_test_example_extractor.py

test: Add GDScript test extraction test case

2026-02-02 23:08:25 +03:00

test_unified_analyzer.py

fix: Resolve remaining 188 linting errors (249 total fixed)

2026-01-17 23:02:11 +03:00

test_unified_mcp_integration.py

fix: Resolve 61 critical linting errors

2026-01-17 22:54:40 +03:00

test_unified_parsers.py

feat: unified document parser system with RST/Markdown/PDF support

2026-02-15 23:14:49 +03:00

test_unified.py

fix: Fix 3 test failures from legacy config removal (QA fixes)

2026-02-08 03:15:25 +03:00

test_upload_integration.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_upload_skill.py

change max lenght

2026-01-17 17:48:15 +00:00

test_url_conversion.py

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

test_utilities.py

run ruff

2026-01-17 17:29:21 +00:00