The definitive list of the best of (consumer facing) open source.
This report summarizes scanner evidence for mustbeperfect/definitive-opensource, a Python project with 3,660 GitHub stars. SynthScan examined 50,099 lines of code across 96 source files, recording 135 pattern matches distributed across 10 syntactic categories. The legacy adjusted pattern signal is 3.5 (Low pattern signal); it is not an authorship estimate.
Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.
Use each vector to guide manual verification of the underlying findings.
Payload schema: 1.0.0 · Engine: 2.0.0 · Scoring: heuristic-density-v1 · Scan date: 2026-10-31.
Can maintainers explain intent, assumptions, and trade-offs? 69 finding(s).
Are imports declared and package/API names verified? 36 finding(s).
Are wrappers, guards, and repeated structures necessary? 73 finding(s).
Which changes need focused human review? 135 finding(s).
This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.
Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.
This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.
The scanner identified 135 distinct pattern matches across 10 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.
Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/source/utils/github_utils.py | 143 | def build_graphql_repos_query(repo_pairs: list[tuple[str, str]]) -> str: | CODE |
| LOW | core/source/utils/github_utils.py | 192 | def fetch_repos_batch_graphql( | CODE |
| LOW | core/source/generation/backlog_generator.py | 31 | def generate_backlog_markdown( | CODE |
| LOW | core/source/generation/readme_generator.py | 19 | def generate_readme_for_platform(platform): | CODE |
| LOW | core/source/generation/tableofcontents_generator.py | 14 | def generate_table_of_contents(platform="all"): | CODE |
| LOW | core/tests/test_batch_github.py | 47 | def test_build_graphql_repos_query(self): | CODE |
| LOW | core/tests/test_batch_github.py | 58 | def test_normalize_graphql_repo(self): | CODE |
| LOW | core/tests/test_batch_github.py | 79 | def test_normalize_graphql_repo_null_license_and_language(self): | CODE |
| LOW | core/tests/test_batch_github.py | 99 | def test_fetch_repos_batch_graphql_success(self, mock_post): | CODE |
| LOW | core/tests/test_batch_github.py | 131 | def test_fetch_repos_batch_rest(self, mock_fetch_repo_data): | CODE |
| LOW | core/tests/test_batch_github.py | 145 | def test_fetch_repos_batch_with_token_and_partial_fallback( | CODE |
| LOW | core/tests/test_batch_github.py | 173 | def test_fetch_repos_batch_without_token_falls_back_to_rest( | CODE |
| LOW | core/tests/test_batch_github.py | 183 | def test_update_application_data_with_batch_result(self): | CODE |
| LOW | core/tests/test_batch_github.py | 207 | def test_update_application_data_respects_custom_flags(self): | CODE |
| LOW | core/tests/test_batch_github.py | 233 | def test_update_application_data_uses_fallback_cache_on_fetch_failure(self): | CODE |
| LOW | core/tests/test_batch_github.py | 264 | def test_update_application_data_preserves_zero_stars_from_fallback(self): | CODE |
| LOW | core/tests/test_batch_github.py | 294 | def test_update_application_data_populates_safe_defaults_when_no_fallback(self): | CODE |
| LOW | core/tests/test_batch_github.py | 315 | def test_update_application_data_preserves_custom_flags_on_fetch_failure(self): | CODE |
| LOW | core/tests/test_batch_github.py | 349 | def test_update_all_applications_flow(self, mock_batch): | CODE |
| LOW | core/tests/test_batch_github.py | 407 | def test_update_all_applications_preserves_fallback_cache_on_batch_failure( | CODE |
| LOW | core/tests/test_batch_github.py | 469 | def test_generate_backlog_preserves_fallback_cache_on_failure(self, mock_batch): | CODE |
| LOW | core/tests/test_batch_github.py | 516 | def test_update_application_data_persists_archived_and_github_full_name(self): | CODE |
| LOW | core/tests/test_batch_github.py | 536 | def test_update_application_data_fallback_persists_archived_and_github_full_name( | CODE |
| LOW | core/tests/test_batch_github.py | 562 | def test_update_application_data_defaults_when_no_repo_data_or_fallback(self): | CODE |
| LOW | core/tests/test_batch_github.py | 574 | def test_status_checker_offline(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 93 | def test_build_pr_content_archive(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 107 | def test_build_pr_content_deleted(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 121 | def test_build_pr_content_rebrand(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 136 | def test_apply_archive_change(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 175 | def test_apply_rebrand_change(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 233 | def test_get_open_pull_requests_gh(self, mock_run): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 254 | def test_get_repo_slug_from_env(self): | CODE |
| LOW | core/tests/test_status_pr_opener.py | 257 | def test_run_status_pr_opener_dry_run(self): | CODE |
| LOW | core/tests/test_json_formatter.py | 35 | def test_validate_categories_duplicates_and_parents(self): | CODE |
| LOW | core/tests/test_json_formatter.py | 108 | def test_validate_flags_and_tags_in_applications(self): | CODE |
| LOW | core/tests/test_json_formatter.py | 231 | def test_generate_report_clean_and_with_issues(self): | CODE |
| LOW | core/tests/test_json_formatter.py | 255 | def test_run_format_checks_integration(self): | CODE |
| LOW | core/tests/test_generation.py | 30 | def test_app_matches_platform(self): | CODE |
| LOW | core/tests/test_generation.py | 48 | def test_no_empty_tables_or_empty_parents(self): | CODE |
| LOW | core/tests/test_generation.py | 73 | def test_table_of_contents_synchronized_with_contents(self): | CODE |
| LOW | core/tests/test_generation.py | 102 | def test_specific_known_empty_categories_omitted(self): | CODE |
| LOW | core/tests/test_generation.py | 138 | def test_unified_header_contains_all_components(self): | CODE |
| LOW | core/tests/test_generation.py | 172 | def test_go_to_top_anchor_standardized(self): | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | README.md | 441 | | [Crush](https://github.com/charmbracelet/crush) `TUI` | Glamourous agentic coding for all 💘 | `Cross` | **28.9k** | | CODE |
| MEDIUM | README.md | 552 | | [Opik](https://github.com/comet-ml/opik) | Debug, evaluate, and monitor your LLM applications, RAG systems, and agenti | CODE |
| MEDIUM | README.md | 556 | ### RAG | COMMENT |
| MEDIUM | resources/backup/lastmanualreadme.md | 427 | ### RAG | COMMENT |
| MEDIUM | resources/backup/lastmanualreadme.md | 438 | | [DocsGPT](https://github.com/arc53/DocsGPT) | DocsGPT is an open-source genAI tool that helps users get reliable answe | CODE |
| MEDIUM | resources/readmes/selfhost.md | 407 | | [Opik](https://github.com/comet-ml/opik) | Debug, evaluate, and monitor your LLM applications, RAG systems, and agenti | CODE |
| MEDIUM | resources/readmes/selfhost.md | 410 | ### RAG | COMMENT |
| MEDIUM | resources/readmes/windows.md | 392 | | [Crush](https://github.com/charmbracelet/crush) `TUI` | Glamourous agentic coding for all 💘 | `Cross` | **28.9k** | | CODE |
| MEDIUM | resources/readmes/windows.md | 475 | ### RAG | COMMENT |
| MEDIUM | resources/readmes/linux.md | 394 | | [Crush](https://github.com/charmbracelet/crush) `TUI` | Glamourous agentic coding for all 💘 | `Cross` | **28.9k** | | CODE |
| MEDIUM | resources/readmes/linux.md | 469 | ### RAG | COMMENT |
| MEDIUM | resources/readmes/macos.md | 399 | | [Crush](https://github.com/charmbracelet/crush) `TUI` | Glamourous agentic coding for all 💘 | `Cross` | **28.9k** | | CODE |
| MEDIUM | resources/readmes/macos.md | 484 | ### RAG | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/source/utils/github_utils.py | 1 | CODE | |
| LOW | core/source/utils/__init__.py | 18 | CODE | |
| LOW | core/source/utils/__init__.py | 18 | CODE | |
| LOW | core/source/utils/__init__.py | 18 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 23 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/__init__.py | 2 | CODE | |
| LOW | core/source/utils/markdown_utils.py | 1 | CODE | |
| LOW | core/source/maintenance/json_formatter.py | 1 | CODE | |
| LOW | core/source/maintenance/status_pr_opener.py | 1 | CODE | |
| LOW | core/source/maintenance/backlog_updator.py | 1 | CODE | |
| LOW | core/source/maintenance/stats_updator.py | 1 | CODE | |
| LOW | core/source/maintenance/status_checker.py | 1 | CODE | |
| LOW | core/tests/test_batch_github.py | 1 | CODE | |
| LOW | core/tests/test_status_pr_opener.py | 1 | CODE | |
| LOW | core/tests/test_json_formatter.py | 1 | CODE | |
| LOW | core/tests/test_generation.py | 1 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/source/utils/github_utils.py | 27 | except Exception: | CODE |
| LOW | core/source/utils/github_utils.py | 67 | except Exception: | CODE |
| LOW | core/source/utils/github_utils.py | 77 | except Exception: | CODE |
| LOW | core/source/utils/github_utils.py | 125 | except Exception as e: | CODE |
| MEDIUM | core/source/utils/github_utils.py | 126 | print(f"Error fetching {repo_path}: {e}") | CODE |
| LOW | core/source/utils/github_utils.py | 262 | except Exception as e: | CODE |
| MEDIUM | core/source/utils/github_utils.py | 263 | print(f"Error executing GraphQL query for batch {batch_num}: {e}") | CODE |
| LOW | core/source/utils/github_utils.py | 316 | except Exception as e: | CODE |
| MEDIUM | core/source/utils/github_utils.py | 317 | print(f"Error fetching {repo_path} via REST: {e}") | CODE |
| LOW | core/source/utils/github_utils.py | 360 | except Exception as e: | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 53 | except Exception: | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 92 | except Exception: | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 111 | except Exception as e: | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 336 | except Exception as e: | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 360 | except Exception as e: | CODE |
| MEDIUM | core/source/maintenance/status_pr_opener.py | 361 | print(f"Error creating PR via API: {e}") | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 414 | except Exception: | CODE |
| MEDIUM | core/source/maintenance/status_pr_opener.py | 487 | print(f"Error pushing branch {branch_name}: {push_res.stderr.strip()}") | CODE |
| LOW | core/source/maintenance/status_pr_opener.py | 502 | except Exception as e: | CODE |
| MEDIUM | core/source/maintenance/status_pr_opener.py | 503 | print(f"Error processing {name}: {e}") | CODE |
| LOW | core/source/maintenance/backlog_updator.py | 67 | except Exception as e: | CODE |
| LOW | core/source/maintenance/backlog_updator.py | 148 | except Exception: | CODE |
| LOW | core/source/maintenance/stats_updator.py | 294 | except Exception as e: | CODE |
| LOW | core/source/maintenance/stats_updator.py | 358 | except Exception: | CODE |
| LOW | core/source/maintenance/status_checker.py | 110 | except Exception: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | core/source/utils/github_utils.py | 27 | except Exception: | CODE |
| HIGH | core/source/utils/__init__.py | 16 | except (ImportError, ModuleNotFoundError): | CODE |
| HIGH | core/source/maintenance/status_pr_opener.py | 53 | except Exception: | CODE |
| HIGH | core/source/maintenance/status_pr_opener.py | 92 | except Exception: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/source/utils/github_utils.py | 192 | CODE | |
| LOW | core/source/utils/github_utils.py | 271 | CODE | |
| LOW | core/source/maintenance/json_formatter.py | 175 | CODE | |
| LOW | core/source/maintenance/json_formatter.py | 371 | CODE | |
| LOW | core/source/maintenance/status_pr_opener.py | 32 | CODE | |
| LOW | core/source/maintenance/backlog_updator.py | 22 | CODE | |
| LOW | core/source/maintenance/stats_updator.py | 22 | CODE | |
| LOW | core/source/maintenance/stats_updator.py | 247 | CODE | |
| LOW | core/source/maintenance/status_checker.py | 16 | CODE | |
| LOW | core/source/generation/contents_generator.py | 27 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/source/maintenance/status_pr_opener.py | 381 | # Check if PR is already open | COMMENT |
| LOW | core/source/generation/contents_generator.py | 89 | # Check if this parent category has any subcategories with matching apps | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/source/utils/__init__.py | 35 | __all__ = [ | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | core/tests/test_batch_github.py | 121 | token="fake-token", | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | .github/FUNDING.yml | 1 | # These are supported funding model platforms | COMMENT |