AI Slop Code RIsk Monitor

Ontos-AI/knowhere

Knowhere extracts, parses, and outputs structured chunks ready for AI Agents and RAG.

19.9 Elevated pattern signal View on GitHub

Maintenance and Governance Review

This report summarizes scanner evidence for Ontos-AI/knowhere, a Python project with 3,705 GitHub stars. SynthScan examined 233,564 lines of code across 1182 source files, recording 3984 pattern matches distributed across 22 syntactic categories. The legacy adjusted pattern signal is 19.9 (Elevated 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.

19.9
Adjusted Signal
19.9
Raw Pattern Score
100%
Time Factor
2026-10-10
Last Push
3.7K
Stars
Python
Language
233.6K
Lines of Code
1.2K
Files
4.0K
Pattern Hits
2026-10-12
Scan Date
0.05
HC Hit Rate

Risk Review · v3

Use each vector to guide manual verification of the underlying findings.

Cognitive Ownership Risk 40.0/100 · MEDIUM

Can maintainers explain intent, assumptions, and trade-offs? 2275 finding(s).

Hallucinated Dependency & Supply Chain Risk 18.4/100 · LOW

Are imports declared and package/API names verified? 923 finding(s).

Agent Over-Engineering Ratio 50.9/100 · HIGH

Are wrappers, guards, and repeated structures necessary? 2771 finding(s).

PR Review Velocity Impact 63.0/100 · HIGH

Which changes need focused human review? 3984 finding(s).

What These Metrics Mean

Adjusted Signal
Legacy pattern score normalized per 1,000 scanned lines and multiplied by the repository-level time factor. It is not an estimate of AI authorship.
Raw Pattern Score
Sum of severity- and context-weighted pattern findings before applying the time factor.
Time Factor
A coarse multiplier based on repository last-push metadata. It does not identify when individual code was written.
Pattern Hits
Count of configured pattern findings. Review each location and surrounding code before acting.
HC Hit Rate
High- and critical-severity findings per scanned file. Severity is a configured detector weight, not proof of a vulnerability or authorship.
Lines / Files
Scan coverage denominators used by the legacy normalized score.

Pattern-Signal History

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.

Severity Breakdown

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.

CRITICAL 0HIGH 60MEDIUM 178LOW 3746

Directory Score Breakdown

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.

Pattern Findings

The scanner identified 3984 distinct pattern matches across 22 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.

Hyper-Verbose Identifiers1961 hits · 1984 pts
SeverityFileLineSnippetContext
LOWdeploy/ecs/test_manage_staging_workflow.py15def test_workflow_exposes_only_manual_status_start_and_stop() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py26def test_mutations_require_an_ontos_ai_github_approval_url() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py35def test_workflow_uses_named_profile_and_approved_account() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py46def test_start_restores_healthy_workers_before_api() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py70def test_worker_health_gate_polls_through_container_start_period() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py85def test_public_api_health_gate_retries_transient_alb_errors() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py102def test_stop_closes_api_then_drains_before_workers() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py117def test_status_uses_the_jobs_ledger_for_backlog() -> None:CODE
LOWdeploy/ecs/test_manage_staging_workflow.py130def test_start_reports_readiness_time() -> None:CODE
LOWdeploy/ecs/test_render_task_definitions.py114def test_staging_templates_preserve_expected_staging_configuration(CODE
LOWdeploy/ecs/test_render_task_definitions.py143def test_staging_worker_preserves_evidence_selected_capacity(tmp_path: Path) -> None:CODE
LOWdeploy/ecs/test_render_task_definitions.py159def test_staging_api_preserves_selected_capacity(tmp_path: Path) -> None:CODE
LOWdeploy/ecs/test_render_task_definitions.py185def test_renderer_rejects_unresolved_placeholders() -> None:CODE
LOWdeploy/ecs/render_task_definitions.py72def validate_rendered_definition(definition: object) -> None:CODE
LOWscripts/publication_benchmark/admit_telemetry.py81def evaluate_telemetry_admission(CODE
LOWscripts/publication_benchmark/admit_telemetry.py561def _evaluate_terminal_traces(CODE
LOWscripts/publication_benchmark/admit_telemetry.py660def _evaluate_sql_write_parity(CODE
LOWscripts/publication_benchmark/admit_telemetry.py705def _evaluate_duration_overhead(CODE
LOWscripts/publication_benchmark/publication_execution.py58def build_publication_environment(CODE
LOWscripts/publication_benchmark/publication_execution.py89def apply_publication_environment(CODE
LOWscripts/publication_benchmark/publication_execution.py375def capture_background_activity(db: Session) -> dict[str, Any]:CODE
LOWscripts/publication_benchmark/publication_execution.py414def _cache_invalidation_effects(CODE
LOWscripts/publication_benchmark/capacity_execution.py140def _monitor_peak_connections(database_url: str, stop_event: Event) -> int:CODE
LOWscripts/publication_benchmark/aggregate.py178def _background_activity_note(raw_records: Sequence[Mapping[str, Any]]) -> str:CODE
LOWscripts/publication_benchmark/aggregate.py239def _load_terminal_trace_accounting(CODE
LOWscripts/publication_benchmark/aggregate.py263def _build_trace_mode_statistics(CODE
LOWscripts/publication_benchmark/trace_accounting.py38def terminal_trace_accounting_contract() -> dict[str, object]:CODE
LOWscripts/publication_benchmark/trace_accounting.py118def assert_terminal_trace_accounting(accounting: TerminalTraceAccounting) -> None:CODE
LOWscripts/publication_benchmark/guards.py40def assert_writable_database_url(database_url: str, *, purpose: str) -> None:CODE
LOWscripts/publication_benchmark/guards.py64def assert_not_source_database(CODE
LOWscripts/publication_benchmark/guards.py84def assert_clone_record_is_usable(CODE
LOWscripts/publication_benchmark/guards.py108def assert_clone_target_is_distinct_from_source(CODE
LOWscripts/publication_benchmark/guards.py128def assert_frozen_input_digest(manifest: "FrozenInputManifest | None") -> None:CODE
LOWscripts/publication_benchmark/guards.py141def assert_strategy_matches_environment(CODE
LOWscripts/publication_benchmark/run_capacity.py58def build_two_stage_sampling_plan() -> dict[str, Any]:CODE
LOWscripts/publication_benchmark/run_capacity.py165def summarize_arrival_latency(samples: Sequence[CapacitySample]) -> float:CODE
LOWscripts/publication_benchmark/check_memory_growth.py132def verify_live_test_database(database_url: str, record: CloneRecord) -> int:CODE
LOWscripts/publication_benchmark/run_record.py165def find_comparability_conflicts(CODE
LOWscripts/publication_benchmark/run_record.py184def find_comparability_exceptions(CODE
LOWscripts/publication_benchmark/run_record.py200def assert_runs_are_comparable(CODE
LOWscripts/publication_benchmark/run_record.py224def resolve_source_content_digest(repository_root: Path) -> str:CODE
LOWscripts/publication_benchmark/state_snapshot.py188def canonical_semantic_digest(value: object) -> str:CODE
LOWscripts/publication_benchmark/state_snapshot.py199def normalize_serving_payload(CODE
LOWscripts/publication_benchmark/state_snapshot.py265def capture_semantic_fingerprints(CODE
LOWscripts/publication_benchmark/state_snapshot.py572def _normalize_namespace_snapshot(CODE
LOWscripts/publication_benchmark/cases.py260def _verify_replacement_state(CODE
LOWscripts/publication_benchmark/cases.py332def _replacement_transition_mismatches(pair: ReplacementCaseEvidence) -> tuple[str, ...]:CODE
LOWscripts/publication_benchmark/cases.py505def _verify_new_document_state(CODE
LOWscripts/publication_benchmark/cases.py584def _new_document_before_mismatches(snapshot: Mapping[str, Any]) -> tuple[str, ...]:CODE
LOWscripts/publication_benchmark/cases.py609def _new_document_after_mismatches(snapshot: Mapping[str, Any]) -> tuple[str, ...]:CODE
LOWscripts/publication_benchmark/compare_state.py107def state_parity_artifact_path(CODE
LOWscripts/publication_benchmark/clone_db.py421 def _template_database_url_path(self, template_id: str) -> Path:CODE
LOWscripts/publication_benchmark/clone_db.py838 def _settle_restored_database(self, clone_container: str) -> float:CODE
LOWscripts/publication_benchmark/clone_db.py1180 def _assert_managed_clone_target(CODE
LOWscripts/publication_benchmark/clone_db.py1194 def _assert_not_template_volume(self, volume_name: str) -> None:CODE
LOWscripts/publication_benchmark/state_parity.py66def compare_publication_state(CODE
LOWscripts/publication_benchmark/state_parity.py147def write_state_parity_artifact(CODE
LOWscripts/publication_benchmark/cli_support.py18def bootstrap_repository_path() -> Path:CODE
LOWscripts/publication_benchmark/cli_support.py87def resolve_dependency_lock_digest(CODE
LOWscripts/publication_benchmark/frozen_input.py202def get_prohibited_payload_values(CODE
1901 more matches not shown…
Unused Imports906 hits · 884 pts
SeverityFileLineSnippetContext
LOWdeploy/ecs/render_task_definitions.py3CODE
LOWscripts/backup-demo-originals.py3CODE
LOWscripts/retire_legacy_token_lookup.py3CODE
LOWscripts/restore-demo-originals.py3CODE
LOWscripts/publication_benchmark/admit_telemetry.py8CODE
LOWscripts/publication_benchmark/publication_execution.py13CODE
LOWscripts/publication_benchmark/run_correctness.py13CODE
LOWscripts/publication_benchmark/capacity_execution.py3CODE
LOWscripts/publication_benchmark/aggregate.py7CODE
LOWscripts/publication_benchmark/trace_accounting.py9CODE
LOWscripts/publication_benchmark/guards.py8CODE
LOWscripts/publication_benchmark/guards.py17CODE
LOWscripts/publication_benchmark/guards.py17CODE
LOWscripts/publication_benchmark/guards.py21CODE
LOWscripts/publication_benchmark/run_capacity.py10CODE
LOWscripts/publication_benchmark/check_memory_growth.py8CODE
LOWscripts/publication_benchmark/layout.py8CODE
LOWscripts/publication_benchmark/run_record.py8CODE
LOWscripts/publication_benchmark/check_pool_reuse.py8CODE
LOWscripts/publication_benchmark/freeze_input.py13CODE
LOWscripts/publication_benchmark/state_snapshot.py8CODE
LOWscripts/publication_benchmark/cases.py7CODE
LOWscripts/publication_benchmark/compare_state.py3CODE
LOWscripts/publication_benchmark/clone_db.py14CODE
LOWscripts/publication_benchmark/run_retrieval_probe.py8CODE
LOWscripts/publication_benchmark/state_parity.py8CODE
LOWscripts/publication_benchmark/cli_support.py3CODE
LOWscripts/publication_benchmark/frozen_input.py13CODE
LOWscripts/publication_benchmark/capacity_campaign.py3CODE
LOWscripts/publication_benchmark/retrieval_interference.py3CODE
LOWscripts/publication_benchmark/run_publication.py11CODE
LOWscripts/publication_benchmark/report.py9CODE
LOWscripts/publication_benchmark/clone_state.py8CODE
LOWscripts/publication_benchmark/formal_campaign_report.py10CODE
LOWpackages/shared-python/shared/core/logging.py12CODE
LOWpackages/shared-python/shared/core/response/__init__.py3CODE
LOWpackages/shared-python/shared/core/response/__init__.py4CODE
LOWpackages/shared-python/shared/core/response/__init__.py4CODE
LOWpackages/shared-python/shared/core/response/__init__.py4CODE
LOWpackages/shared-python/shared/core/response/__init__.py4CODE
LOWpackages/shared-python/shared/core/config/__init__.py5CODE
LOWpackages/shared-python/shared/core/config/__init__.py8CODE
LOWpackages/shared-python/shared/core/config/__init__.py8CODE
LOWpackages/shared-python/shared/core/config/__init__.py8CODE
LOWpackages/shared-python/shared/core/config/__init__.py8CODE
LOWpackages/shared-python/shared/core/config/__init__.py8CODE
LOWpackages/shared-python/shared/core/config/__init__.py15CODE
LOWpackages/shared-python/shared/core/config/__init__.py16CODE
LOWpackages/shared-python/shared/core/config/__init__.py17CODE
LOWpackages/shared-python/shared/core/config/__init__.py18CODE
LOWpackages/shared-python/shared/core/config/__init__.py19CODE
LOWpackages/shared-python/shared/core/config/__init__.py20CODE
LOWpackages/shared-python/shared/core/config/__init__.py20CODE
LOWpackages/shared-python/shared/core/config/__init__.py24CODE
LOWpackages/shared-python/shared/core/config/__init__.py25CODE
LOWpackages/shared-python/shared/core/config/__init__.py25CODE
LOWpackages/shared-python/shared/core/config/__init__.py25CODE
LOWpackages/shared-python/shared/core/config/__init__.py26CODE
LOWpackages/shared-python/shared/core/config/__init__.py27CODE
LOW…ython/shared/core/state_machine/transition_payloads.py1CODE
846 more matches not shown…
Excessive Try-Catch Wrapping516 hits · 548 pts
SeverityFileLineSnippetContext
LOWscripts/backup-demo-originals.py106 except Exception as error:CODE
LOWscripts/retire_legacy_token_lookup.py64 except Exception as error:CODE
LOWscripts/restore-demo-originals.py251 except Exception as error:CODE
LOWscripts/publication_benchmark/publication_execution.py579 except Exception as error: # noqa: BLE001 - recorded as the sampleCODE
LOWscripts/publication_benchmark/publication_execution.py782 except Exception as error: # noqa: BLE001 - recorded as the sampleCODE
LOWscripts/publication_benchmark/capacity_execution.py313 except Exception as error: # noqa: BLE001 - failures are evidenceCODE
LOWscripts/publication_benchmark/check_memory_growth.py298 except Exception:CODE
LOWscripts/publication_benchmark/check_memory_growth.py536 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py391 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py398 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py743 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py746 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py1108 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py1120 except Exception:CODE
LOWscripts/publication_benchmark/clone_db.py1146 except Exception:CODE
LOWscripts/publication_benchmark/retrieval_interference.py318 except Exception as exception:CODE
LOWpackages/shared-python/shared/core/database.py114 except Exception:CODE
LOW⚡packages/shared-python/shared/core/database.py129 except Exception as commit_error:CODE
LOW⚡packages/shared-python/shared/core/database.py134 except Exception as rollback_error:CODE
LOW⚡packages/shared-python/shared/core/database.py138 except Exception:CODE
LOW⚡packages/shared-python/shared/core/database.py144 except Exception as rollback_error:CODE
LOW⚡packages/shared-python/shared/core/database.py155 except Exception as close_error:CODE
LOWpackages/shared-python/shared/core/database.py229 except Exception as e:CODE
LOWpackages/shared-python/shared/core/database.py332 except Exception as e:CODE
LOWpackages/shared-python/shared/core/database.py341 except Exception as e:CODE
LOWpackages/shared-python/shared/core/database.py355 except Exception as e:CODE
LOWpackages/shared-python/shared/core/celery_router.py166 except Exception as e:CODE
LOWpackages/shared-python/shared/core/celery_router.py207 except Exception as e:CODE
LOWpackages/shared-python/shared/core/celery_router.py249 except Exception as e:CODE
LOWpackages/shared-python/shared/core/celery_router.py305 except Exception as e:CODE
LOWpackages/shared-python/shared/core/database_sync.py92 except Exception:CODE
LOWpackages/shared-python/shared/core/config/database.py138 except Exception as e:CODE
LOWpackages/shared-python/shared/core/config/redis.py115 except Exception as e:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py168 except Exception as e:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py173 except Exception as rollback_err:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py253 except Exception as e:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py296 except Exception as e:CODE
LOW⚡…hared-python/shared/core/state_machine/service_sync.py339 except Exception as e:CODE
LOW⚡…hared-python/shared/core/state_machine/service_sync.py344 except Exception as rollback_err:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py440 except Exception as e:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py472 except Exception as e:CODE
LOW…hared-python/shared/core/state_machine/service_sync.py480 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py181 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py186 except Exception as rollback_err:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py271 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py319 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py363 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py368 except Exception as rollback_err:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py385 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py496 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py500 except Exception as rollback_err:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py534 except Exception as e:CODE
LOW…ges/shared-python/shared/core/state_machine/service.py542 except Exception as e:CODE
LOW⚡…ython/shared/core/state_machine/transition_payloads.py23 except Exception:CODE
LOW…ed-python/shared/core/exceptions/knowhere_exception.py250 except Exception as e:STRING
LOWpackages/shared-python/shared/utils/json_utils.py71 except Exception: # pragma: no coverCODE
LOWpackages/shared-python/shared/utils/json_utils.py88 except Exception: # pragma: no coverCODE
LOW⚡packages/shared-python/shared/utils/token_estimate.py21 except Exception:CODE
LOW⚡packages/shared-python/shared/utils/token_estimate.py27 except Exception:CODE
LOW⚡packages/shared-python/shared/utils/token_estimate.py33 except Exception:CODE
456 more matches not shown…
Decorative Section Separators134 hits · 434 pts
SeverityFileLineSnippetContext
MEDIUM…hared-python/shared/core/state_machine/service_sync.py52 # ── Public API ──────────────────────────────────────────────────────COMMENT
MEDIUM⚡…hared-python/shared/core/state_machine/service_sync.py348 # ── Private helpers ─────────────────────────────────────────────────COMMENT
MEDIUM…ges/shared-python/shared/core/state_machine/service.py50 # ── Public API ──────────────────────────────────────────────────────COMMENT
MEDIUM…ges/shared-python/shared/core/state_machine/service.py389 # ── Private helpers ─────────────────────────────────────────────────COMMENT
MEDIUM…red-python/shared/core/exceptions/domain_exceptions.py50# ============================================================================COMMENT
MEDIUM…red-python/shared/core/exceptions/domain_exceptions.py52# ============================================================================COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py69# ============================================================================COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py71# ----------------------------------------------------------------------------COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py74# ============================================================================COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py339# ============================================================================COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py341# ----------------------------------------------------------------------------COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py345# ============================================================================COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py457# ============================================================================COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py459# ----------------------------------------------------------------------------COMMENT
MEDIUM⚡…red-python/shared/core/exceptions/domain_exceptions.py462# ============================================================================COMMENT
MEDIUM…ed-python/shared/core/exceptions/knowhere_exception.py148 # =======================================================================COMMENT
MEDIUM…ed-python/shared/core/exceptions/knowhere_exception.py150 # =======================================================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py56 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py58 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py82 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py84 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py126 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py128 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py162 # =============================================COMMENT
MEDIUM…ages/shared-python/shared/core/billing/micro_dollar.py164 # =============================================COMMENT
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py43# --------------------------------------------------------------------------COMMENT
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py45# --------------------------------------------------------------------------COMMENT
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py64# --------------------------------------------------------------------------COMMENT
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py66# --------------------------------------------------------------------------COMMENT
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py270# --------------------------------------------------------------------------COMMENT
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py272# --------------------------------------------------------------------------COMMENT
MEDIUM…hared-python/shared/services/redis/distributed_lock.py81 # ------------------------------------------------------------------STRING
MEDIUM…hared-python/shared/services/redis/distributed_lock.py83 # ------------------------------------------------------------------STRING
MEDIUM⚡…hared-python/shared/services/redis/distributed_lock.py123 # ------------------------------------------------------------------COMMENT
MEDIUM⚡…hared-python/shared/services/redis/distributed_lock.py125 # ------------------------------------------------------------------COMMENT
MEDIUM…hared-python/shared/services/redis/distributed_lock.py141 # ------------------------------------------------------------------COMMENT
MEDIUM…hared-python/shared/services/redis/distributed_lock.py143 # ------------------------------------------------------------------COMMENT
MEDIUM⚡…ython/shared/services/retrieval/publication_service.py56 # ── Public API ──────────────────────────────────────────────────────COMMENT
MEDIUM⚡…on/shared/services/ai/openai_compatible_client_sync.py178 # ------------------------------------------------------------------COMMENT
MEDIUM⚡…on/shared/services/ai/openai_compatible_client_sync.py180 # ------------------------------------------------------------------COMMENT
MEDIUM…on/shared/services/ai/openai_compatible_client_sync.py299 # ------------------------------------------------------------------COMMENT
MEDIUM…ed-python/shared/services/ai/iloveapi_quota_manager.py147 # ------------------------------------------------------------------COMMENT
MEDIUM…ed-python/shared/services/ai/iloveapi_quota_manager.py149 # ------------------------------------------------------------------COMMENT
MEDIUM…ges/shared-python/shared/services/ai/prompt_service.py17# ──────────────────────────────────────────────────────────────────────────────COMMENT
MEDIUM…ges/shared-python/shared/services/ai/prompt_service.py19# ──────────────────────────────────────────────────────────────────────────────COMMENT
MEDIUM…ges/shared-python/shared/services/ai/prompt_service.py66# ──────────────────────────────────────────────────────────────────────────────COMMENT
MEDIUM…ges/shared-python/shared/services/ai/prompt_service.py68# ──────────────────────────────────────────────────────────────────────────────COMMENT
MEDIUM…ages/shared-python/shared/services/quota/token_pool.py133 # ------------------------------------------------------------------STRING
MEDIUM…ages/shared-python/shared/services/quota/token_pool.py135 # ------------------------------------------------------------------STRING
MEDIUM…ages/shared-python/shared/services/quota/token_pool.py205 # ------------------------------------------------------------------COMMENT
MEDIUM…ages/shared-python/shared/services/quota/token_pool.py207 # ------------------------------------------------------------------COMMENT
MEDIUM…ages/shared-python/shared/services/quota/token_pool.py275 # ------------------------------------------------------------------COMMENT
MEDIUM…ages/shared-python/shared/services/quota/token_pool.py277 # ------------------------------------------------------------------COMMENT
MEDIUM…hared-python/shared/services/jobs/lifecycle/service.py52 # ── Public API ──────────────────────────────────────────────────────COMMENT
MEDIUMapps/api/app/services/rate_limit/config.py16# ---------------------------------------------------------------------------COMMENT
MEDIUMapps/api/app/services/rate_limit/config.py18# ---------------------------------------------------------------------------COMMENT
MEDIUMapps/api/app/services/rate_limit/config.py76 # ------------------------------------------------------------------COMMENT
MEDIUMapps/api/app/services/rate_limit/config.py78 # ------------------------------------------------------------------COMMENT
MEDIUMapps/api/app/services/rate_limit/config.py99 # ------------------------------------------------------------------COMMENT
MEDIUMapps/api/app/services/rate_limit/config.py101 # ------------------------------------------------------------------COMMENT
74 more matches not shown…
Deep Nesting181 hits · 178 pts
SeverityFileLineSnippetContext
LOWscripts/backup-demo-originals.py53CODE
LOWscripts/retire_legacy_token_lookup.py19CODE
LOWscripts/restore-demo-originals.py87CODE
LOWscripts/publication_benchmark/admit_telemetry.py291CODE
LOWscripts/publication_benchmark/publication_execution.py506CODE
LOWscripts/publication_benchmark/publication_execution.py654CODE
LOWscripts/publication_benchmark/run_correctness.py101CODE
LOWscripts/publication_benchmark/capacity_execution.py140CODE
LOWscripts/publication_benchmark/run_record.py224CODE
LOWscripts/publication_benchmark/clone_db.py1347CODE
LOWscripts/publication_benchmark/capacity_campaign.py104CODE
LOWscripts/publication_benchmark/capacity_campaign.py241CODE
LOWscripts/publication_benchmark/report.py349CODE
LOWpackages/shared-python/shared/core/logging.py143CODE
LOWpackages/shared-python/shared/core/database.py120CODE
LOWpackages/shared-python/shared/core/celery_router.py216CODE
LOWpackages/shared-python/shared/core/config/database.py81CODE
LOW…hared-python/shared/core/state_machine/service_sync.py75CODE
LOW…ges/shared-python/shared/core/state_machine/service.py76CODE
LOW…hared-python/shared/tests/test_agent_tools_contract.py61CODE
LOW…on/shared/tests/test_publication_trace_sql_contract.py253CODE
LOWpackages/shared-python/shared/utils/text_utils.py140CODE
LOWpackages/shared-python/shared/utils/text_utils.py223CODE
LOWpackages/shared-python/shared/utils/zip_download.py11CODE
LOW…ed-python/shared/services/encryption/fernet_service.py116CODE
LOW…red-python/shared/services/redis/redis_sync_service.py152CODE
LOW…s/shared-python/shared/services/redis/redis_service.py469CODE
LOW…s/shared-python/shared/services/redis/redis_monitor.py92CODE
LOW…s/shared-python/shared/services/redis/redis_monitor.py185CODE
LOW…s/shared-python/shared/services/redis/redis_monitor.py278CODE
LOW…red-python/shared/services/storage/zip_chunk_schema.py17CODE
LOW…red-python/shared/services/storage/zip_chunk_schema.py46CODE
LOW…d-python/shared/services/storage/zip_doc_navigation.py37CODE
LOW…d-python/shared/services/storage/zip_doc_navigation.py128CODE
LOW…-python/shared/services/storage/adapters/s3_adapter.py152CODE
LOW…on/shared/services/chunks/dataframe_chunk_converter.py291CODE
LOW…red-python/shared/services/chunks/chunk_connections.py112CODE
LOW…red-python/shared/services/chunks/chunk_connections.py169CODE
LOW…on/shared/services/retrieval/publication_token_copy.py91CODE
LOW…on/shared/services/retrieval/publication_token_copy.py127CODE
LOW…red-python/shared/services/retrieval/map_unit_index.py52CODE
LOW…ared-python/shared/services/retrieval/demo_examples.py18CODE
LOW…thon/shared/services/retrieval/hydration/table_grid.py79CODE
LOW…d-python/shared/services/retrieval/hydration/assets.py223CODE
LOW…ared/services/retrieval/agent_explore/evidence_pool.py173CODE
LOW…ices/retrieval/agent_explore/harness/openai_harness.py174CODE
LOW…shared/services/retrieval/agent_tools/explore_mount.py52CODE
LOW…ed/services/retrieval/agent_tools/tools/node_filter.py117CODE
LOW…/shared/services/retrieval/agent_tools/tools/assets.py186CODE
LOW…on/shared/services/retrieval/agent_tools/tools/read.py372CODE
LOW…shared/services/retrieval/search/map_unit_discovery.py224CODE
LOW…red-python/shared/services/retrieval/search/ranking.py25CODE
LOW…shared/services/retrieval/scoring/knowhere_provider.py171CODE
LOW…/shared-python/shared/services/http/pinned_outbound.py236CODE
LOW…ed-python/shared/services/ai/iloveapi_quota_manager.py96CODE
LOW…ges/shared-python/shared/services/ai/token_tracking.py147CODE
LOW…ges/shared-python/shared/services/ai/prompt_service.py119CODE
LOW…ges/shared-python/shared/services/ai/summary/engine.py74CODE
LOW…ges/shared-python/shared/services/ai/summary/engine.py99CODE
LOW…shared-python/shared/services/telemetry/api_metrics.py37CODE
121 more matches not shown…
Empty Error Handlers33 hits · 165 pts
SeverityFileLineSnippetContext
HIGHscripts/publication_benchmark/clone_db.py398except Exception:CODE
HIGHscripts/publication_benchmark/clone_db.py746except Exception:CODE
HIGH…ckages/shared-python/shared/core/otel_gevent_compat.py23except ValueError:CODE
HIGHpackages/shared-python/shared/utils/token_estimate.py27except Exception:CODE
HIGHpackages/shared-python/shared/utils/token_estimate.py63except Exception:CODE
HIGH…on/shared/services/chunks/dataframe_chunk_converter.py201except json.JSONDecodeError:CODE
HIGH…-python/shared/services/ai/response_process_service.py31except Exception:CODE
HIGH…ges/shared-python/shared/services/ai/token_tracking.py64except ImportError:CODE
HIGHapps/api/main.py200except ImportError:CODE
HIGH…pi/app/services/auth/api_key_authentication_service.py206except Exception:CODE
HIGH…app/services/document_parser/support/stage_profiler.py49except ImportError:CODE
HIGH…pp/services/document_parser/structure/layout_parser.py402except (TypeError, ValueError):CODE
HIGH…ices/document_parser/structure/heading_llm_executor.py317except (TypeError, ValueError):CODE
HIGHapps/worker/app/services/common/file_utils.py36except Exception:CODE
HIGHapps/worker/app/services/document_agent/trace.py122except Exception:CODE
HIGHapps/worker/app/services/document_agent/trace.py276except Exception:CODE
HIGHapps/worker/app/services/document_agent/visual.py92except Exception:CODE
HIGH…services/document_agent/tools/find_toc_anchor_pages.py253except Exception:CODE
HIGH…p/services/document_agent/tools/probe_page_features.py389except Exception:CODE
HIGH…es/document_agent/tools/extract_toc_with_boundaries.py98except Exception:CODE
HIGH…ker/scripts/page_memory/debug_pm_stage2_calibration.py142except FileNotFoundError:CODE
HIGHapps/worker/scripts/page_memory/_debug_pm_shared.py612except FileNotFoundError:CODE
HIGHapps/worker/scripts/page_memory/_debug_pm_shared.py1480except (ValueError, json.JSONDecodeError, OSError):CODE
HIGHdeprecated/mapnav/nav/nav_agent.py247except Exception:CODE
HIGHdeprecated/mapnav/nav/nav_assets.py401except (ValueError, json.JSONDecodeError):CODE
HIGHdeprecated/mapnav/nav/nav_assets.py410except (ValueError, json.JSONDecodeError):CODE
HIGHdeprecated/mapnav/nav/nav_assets.py419except (ValueError, json.JSONDecodeError):CODE
HIGHdeprecated/mapnav/nav/nav_assets.py468except (ValueError, json.JSONDecodeError):CODE
HIGHdeprecated/mapnav/nav/nav_projection.py29except Exception:CODE
HIGHdeprecated/mapnav/nav/nav_control.py54except Exception:CODE
HIGHdeprecated/mapnav/nav/nav_control.py106except Exception:CODE
HIGHdeprecated/mapnav/nav/nav_policy.py16except Exception:CODE
HIGHdeprecated/mapnav/nav/nav_plan.py132except Exception:CODE
Modern Structural Boilerplate81 hits · 82 pts
SeverityFileLineSnippetContext
LOWpackages/shared-python/shared/core/database.py20logger = logging.getLogger(__name__)CODE
LOWpackages/shared-python/shared/core/response/__init__.py11__all__ = [CODE
LOWpackages/shared-python/shared/core/config/__init__.py29__all__ = [CODE
LOW…es/shared-python/shared/core/state_machine/__init__.py19__all__ = [CODE
LOW…ckages/shared-python/shared/core/constants/__init__.py8__all__ = [CODE
LOW…kages/shared-python/shared/core/exceptions/__init__.py25__all__ = [CODE
LOWpackages/shared-python/shared/core/billing/__init__.py26__all__ = [CODE
LOWpackages/shared-python/shared/repositories/__init__.py8__all__ = ["CreditsRepository", "SyncCreditsRepository"]CODE
LOWpackages/shared-python/shared/models/__init__.py10__all__ = [CODE
LOW…kages/shared-python/shared/models/database/__init__.py50__all__ = [CODE
LOW…es/shared-python/shared/models/schemas/job_metadata.py129 def set_file_source(metadata: Dict[str, Any], *, source_file_name: str) -> None:CODE
LOW…ages/shared-python/shared/services/webhook/__init__.py5__all__ = ["WebhookDispatcher", "get_webhook_dispatcher"]CODE
LOW…s/shared-python/shared/services/encryption/__init__.py8__all__ = ["FernetService", "get_fernet_service"]CODE
LOW…ckages/shared-python/shared/services/redis/__init__.py24__all__ = [CODE
LOWpackages/shared-python/shared/services/auth/__init__.py5__all__ = ["ensure_better_auth_user_table"]CODE
LOW…ed-python/shared/services/storage/adapters/__init__.py8__all__ = ["FileSystemStorageAdapter", "S3StorageAdapter"]CODE
LOW…shared-python/shared/services/retrieval/app_service.py13__all__ = ["run_retrieval_query"]CODE
LOW…red-python/shared/services/retrieval/map_unit_index.py45__all__ = ["MAP_UNIT_INDEX_FORMAT_VERSION", "replace_document_map_units"]CODE
LOW…red-python/shared/services/retrieval/trace/__init__.py6__all__ = [CODE
LOW…ared-python/shared/services/retrieval/graph/service.py32logger = logging.getLogger(__name__)CODE
LOW…on/shared/services/retrieval/agent_explore/__init__.py17__all__ = [CODE
LOW…d/services/retrieval/agent_explore/harness/__init__.py14__all__ = ["Harness", "resolve_harness"]CODE
LOW…thon/shared/services/retrieval/agent_tools/registry.py33logger = logging.getLogger(__name__)CODE
LOW…thon/shared/services/retrieval/agent_tools/__init__.py42__all__ = [CODE
LOW…hared/services/retrieval/agent_tools/tools/__init__.py21__all__ = [CODE
LOWpackages/shared-python/shared/services/http/__init__.py46__all__ = [CODE
LOWpackages/shared-python/shared/services/ai/__init__.py9__all__ = [CODE
LOW…ckages/shared-python/shared/services/quota/__init__.py5__all__ = ["BaseQuotaManager", "TokenConfig", "TokenLease"]CODE
LOW…es/shared-python/shared/services/telemetry/__init__.py15__all__ = [CODE
LOW…hared/services/jobs/lifecycle/publication_trace_sql.py391__all__ = [CODE
LOW…ages/shared-python/shared/services/billing/__init__.py12__all__ = [CODE
LOWapps/api/app/core/__init__.py25__all__ = [CODE
LOWapps/api/app/core/middleware/__init__.py6__all__ = ["setup_cors", "LoggingMiddleware"]CODE
LOWapps/api/app/repositories/__init__.py9__all__ = [CODE
LOWapps/api/app/mcp/__init__.py3__all__ = ["create_retrieval_mcp_server"]CODE
LOWapps/api/app/api/api_router.py15__all__ = ["api_router"]CODE
LOWapps/api/app/api/v1/api_v1.py68__all__ = ["api_router"]CODE
LOWapps/api/app/api/v2/api_v2.py14__all__ = ["api_router"]CODE
LOWapps/api/app/api/v2/routes/documents.py42__all__ = ["router"]CODE
LOWapps/api/app/services/document_ingestion/__init__.py3__all__ = ["DocumentIngestionService"]CODE
LOWapps/api/app/services/rate_limit/__init__.py20__all__ = [CODE
LOWapps/api/app/services/jobs/__init__.py7__all__ = [CODE
LOWapps/api/app/services/jobs/read_service.py12__all__ = [CODE
LOW…s/api/app/services/billing/billing_workflow_service.py17__all__ = ["BillingWorkflowService", "ParseUsageResponse"]CODE
LOWapps/api/scripts/add_credits.py106async def _set_user_tier(session: AsyncSession, user_id: str, tier_name: str) -> None:CODE
LOW…ions/4a5b6c7d8e9f_add_retrieval_serving_generations.py16__all__ = [CODE
LOW…/6c7d8e9f0a1b_add_retrieval_namespace_map_snapshots.py16__all__ = [CODE
LOW…ns/9f0a1b2c3d4e_drop_retrieval_namespace_statistics.py22__all__ = [CODE
LOW…versions/e4f5a6b7c8d9_drop_chunk_search_tsv_columns.py20__all__ = [CODE
LOW…ersions/2b3c4d5e6f7a_drop_map_unit_term_search_text.py21__all__ = [CODE
LOW…mbic/versions/5b6c7d8e9f0a_add_term_trigram_indexes.py15__all__ = [CODE
LOWapps/worker/app/services/__init__.py3__all__ = []CODE
LOW…ices/document_parser/formats/markdown/deferred_task.py35__all__ = [CODE
LOW…ker/app/services/document_parser/profiling/taxonomy.py24__all__ = ["PdfRoutingCategory"]CODE
LOW⚡…app/services/document_parser/profiling/doc_profiler.py256__all__ = ["profile_document"]CODE
LOW…pp/services/document_parser/profiling/profile_model.py81__all__ = ["ParserDocumentProfile", "ParserTocProfile", "TocEvidence"]CODE
LOW…ent_parser/orchestration/office_container_validator.py96__all__ = ["validate_office_container"]CODE
LOW…nt_parser/orchestration/office_container_inspection.py56__all__ = [CODE
LOWapps/worker/app/services/document_ingestion/service.py5__all__ = ["parse_uploaded_file_job"]CODE
LOWapps/worker/app/services/common/__init__.py13__all__ = [CODE
21 more matches not shown…
Cross-File Repetition14 hits · 70 pts
SeverityFileLineSnippetContext
HIGH…ges/shared-python/shared/services/ai/token_tracking.py0walk up the greenlet parent chain to find a registered root id.STRING
HIGH…ages/shared-python/shared/services/ai/llm_overrides.py0walk up the greenlet parent chain to find a registered root id.STRING
HIGH…app/services/document_parser/support/stage_profiler.py0walk up the greenlet parent chain to find a registered root id.STRING
HIGHapps/api/tests/contract/test_documents_contract.py0insert into documents ( document_id, user_id, namespace, status, current_job_result_id, source_file_name, parse_track, cSTRING
HIGHapps/api/tests/contract/test_job_creation_contract.py0insert into documents ( document_id, user_id, namespace, status, current_job_result_id, source_file_name, parse_track, cSTRING
HIGHapps/api/tests/support/contract_database.py0insert into documents ( document_id, user_id, namespace, status, current_job_result_id, source_file_name, parse_track, cSTRING
HIGHapps/api/tests/contract/test_documents_contract.py0update documents set current_job_result_id = :job_result_id where document_id = :document_idSTRING
HIGHapps/api/tests/contract/test_retrieval_contract.py0update documents set current_job_result_id = :job_result_id where document_id = :document_idSTRING
HIGHapps/api/tests/contract/test_job_creation_contract.py0update documents set current_job_result_id = :job_result_id where document_id = :document_idSTRING
HIGH…s/contract/test_retrieval_classic_map_unit_contract.py0update documents set current_job_result_id = :job_result_id where document_id = :document_idSTRING
HIGH…api-contract/test_retrieval_map_unit_index_contract.py0update documents set current_job_result_id = :job_result_id where document_id = :document_idSTRING
HIGHapps/api/tests/support/sync_contract_database.py0insert into "user" (id, name, email) values (:user_id, :name, :email)STRING
HIGHapps/api/tests/support/contract_database.py0insert into "user" (id, name, email) values (:user_id, :name, :email)STRING
HIGHapps/worker/tests/support/contract_database.py0insert into "user" (id, name, email) values (:user_id, :name, :email)STRING
Cross-Language Confusion10 hits · 58 pts
SeverityFileLineSnippetContext
HIGHscripts/publication_benchmark/clone_db.py278 "/from/global/pg_control 2>/dev/null || true",CODE
HIGH⚡packages/shared-python/shared/services/ai/llm_mock.py131 "detect-toc-range": '{"toc_start": null, "toc_end": null, "confidence": "low"}',CODE
HIGH⚡packages/shared-python/shared/services/ai/llm_mock.py136 '"entities": [], "chart": null}'CODE
HIGH⚡packages/shared-python/shared/services/ai/llm_mock.py144 '"entities": [], "chart": null}'CODE
HIGH…ges/shared-python/shared/services/ai/prompt_service.py940 "toc_start": null,CODE
HIGH…ges/shared-python/shared/services/ai/prompt_service.py941 "toc_end": null,CODE
HIGHapps/api/scripts/ensure_test_environment.py53 "Ubuntu: sudo apt-get update && sudo apt-get install -y "CODE
HIGH…ker/app/services/document_agent/calibration/prompts.py13 "found_page": "number|null, the physical page number where it starts",CODE
HIGH…/app/services/document_agent/coarse_profile/prompts.py15 "you observe (largest y) when any header is present, otherwise null; "CODE
HIGHdeprecated/mapnav/nav/nav_plan.py677 '"cardinality": null},\n'CODE
Over-Commented Block37 hits · 34 pts
SeverityFileLineSnippetContext
LOW…thon/shared/services/retrieval/agent_tools/registry.py121 budget: ToolBudget = field(default_factory=ToolBudget)COMMENT
LOWapps/api/alembic.ini1# A generic, single database configuration.COMMENT
LOWapps/api/alembic.ini21COMMENT
LOWapps/api/alembic.ini41COMMENT
LOWapps/api/alembic.ini61# behavior of splitting on spaces and/or commas.COMMENT
LOWapps/api/alembic.ini81# are written from script.py.makoCOMMENT
LOWapps/api/alembic.ini101COMMENT
LOWapps/api/app/api/v1/routes/webhook.py181 raiseCOMMENT
LOWapps/api/app/api/v1/routes/webhook.py201# logger.info(f"Headers: {dict(request.headers)}")COMMENT
LOWapps/worker/requirements.txt1# This file was autogenerated by uv via the following command:COMMENT
LOWapps/worker/requirements.txt21annotated-doc==0.0.4COMMENT
LOWapps/worker/requirements.txt41 # via aiohttpCOMMENT
LOWapps/worker/requirements.txt61 # viaCOMMENT
LOWapps/worker/requirements.txt81charset-normalizer==3.4.7COMMENT
LOWapps/worker/requirements.txt101crcmod==1.7COMMENT
LOWapps/worker/requirements.txt121et-xmlfile==2.0.0COMMENT
LOWapps/worker/requirements.txt141 # knowhere-sharedCOMMENT
LOWapps/worker/requirements.txt161 # viaCOMMENT
LOWapps/worker/requirements.txt181 # botocoreCOMMENT
LOWapps/worker/requirements.txt201markdownify==1.2.2COMMENT
LOWapps/worker/requirements.txt221 # rank-bm25COMMENT
LOWapps/worker/requirements.txt241 # opentelemetry-instrumentation-asgiCOMMENT
LOWapps/worker/requirements.txt261 # via opentelemetry-instrumentation-fastapiCOMMENT
LOWapps/worker/requirements.txt281 # opentelemetry-instrumentation-asgiCOMMENT
LOWapps/worker/requirements.txt301pandas==2.3.1COMMENT
LOWapps/worker/requirements.txt321 # aiohttpCOMMENT
LOWapps/worker/requirements.txt341pycparser==3.0 ; implementation_name != 'PyPy'COMMENT
LOWapps/worker/requirements.txt361 # fastapi-usersCOMMENT
LOWapps/worker/requirements.txt381 # pytest-mockCOMMENT
LOWapps/worker/requirements.txt401 # via knowhere-worker-appCOMMENT
LOWapps/worker/requirements.txt421regex==2026.4.4COMMENT
LOWapps/worker/requirements.txt441sniffio==1.3.1COMMENT
LOWapps/worker/requirements.txt461tenacity==9.1.4COMMENT
LOWapps/worker/requirements.txt481 # opentelemetry-semantic-conventionsCOMMENT
LOWapps/worker/requirements.txt501 # viaCOMMENT
LOWdeprecated/mapnav/nav/nav_types.py41 # Display budget for the one-shot planning map; executor still uses map_char_limit.COMMENT
LOWdeprecated/mapnav/nav/nav_types.py261 subgoal_widen_gaps: Dict[str, str] = field(default_factory=dict)COMMENT
Self-Referential Comments9 hits · 33 pts
SeverityFileLineSnippetContext
MEDIUMdeploy/local-dev/localstack/init/setup-aws-resources.sh19# Create the buckets used by local development.COMMENT
MEDIUMdeploy/local-dev/localstack/init/setup-aws-resources.sh55# Create the SNS topic used for upload notifications.COMMENT
MEDIUMpackages/shared-python/shared/core/database.py72# Create the async session factory.COMMENT
MEDIUM⚡packages/shared-python/shared/core/database.py160# Create an app-level context manager for operations without an injected DB session.COMMENT
MEDIUM⚡packages/shared-python/shared/core/config/app.py75# Create the shared application config instance.COMMENT
MEDIUM⚡packages/shared-python/shared/core/config/app.py81# Create the Redis connection-pool manager.COMMENT
MEDIUM⚡packages/shared-python/shared/core/config/app.py84# Create the Redis config manager.COMMENT
MEDIUMapps/api/scripts/reset_alembic.py21 # Create the SQLAlchemy engine.COMMENT
MEDIUM…pp/services/document_parser/formats/markdown/parser.py375 # Create a placeholder chunk so the previous heading's pathCOMMENT
Structural Annotation Overuse18 hits · 32 pts
SeverityFileLineSnippetContext
LOWREADME.md81### Step 1: Parse and Build MemoryCOMMENT
LOWREADME.md88### Step 2: Agentic RetrievalCOMMENT
LOW…ared-python/shared/services/billing/credits_service.py164 # Step 1: Insert transaction record (ledger entry)COMMENT
LOW⚡…ared-python/shared/services/billing/credits_service.py175 # Step 2: Recalculate balance from ledger (source of truth)COMMENT
LOW⚡…ared-python/shared/services/billing/credits_service.py180 # Step 3: Update materialized viewCOMMENT
LOWapps/api/app/services/rate_limit/tier_service.py98 # Step 1: sum lifetime successful payments in micro-dollarsCOMMENT
LOWapps/api/app/services/rate_limit/tier_service.py120 # Step 4: persist the tier on user_balancesCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py141 # Step 1: Start taskCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py170 # Step 2: Upload from memory (BytesIO, no disk write)COMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py193 # Step 3: ProcessCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py220 # Step 4: Download PDF to memoryCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py434 # Step 1: PPTX → PDF (in memory)COMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py117 # Step 1: find all TOC keywordsCOMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py123 # Step 2: if no TOC keywords found, use the first line as the candidate areaCOMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py132 # Step 3: build candidate areas for each start indexCOMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py288 # Step 1: detect candidate areas (may be multiple)COMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py296 # Step 2: evaluate each candidate area with LLM (parallel when multiple)COMMENT
LOW…r/app/services/document_parser/structure/toc_parser.py516 # Step 3: Remove TOC lines from md_lines (process in reverse order to correct indices)COMMENT
Verbosity Indicators16 hits · 29 pts
SeverityFileLineSnippetContext
LOW…ared-python/shared/services/billing/credits_service.py164 # Step 1: Insert transaction record (ledger entry)COMMENT
LOW⚡…ared-python/shared/services/billing/credits_service.py175 # Step 2: Recalculate balance from ledger (source of truth)COMMENT
LOW⚡…ared-python/shared/services/billing/credits_service.py180 # Step 3: Update materialized viewCOMMENT
LOWapps/api/app/services/rate_limit/tier_service.py98 # Step 1: sum lifetime successful payments in micro-dollarsCOMMENT
LOWapps/api/app/services/rate_limit/tier_service.py120 # Step 4: persist the tier on user_balancesCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py141 # Step 1: Start taskCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py170 # Step 2: Upload from memory (BytesIO, no disk write)COMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py193 # Step 3: ProcessCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py220 # Step 4: Download PDF to memoryCOMMENT
LOW…er/app/services/document_parser/formats/pptx/parser.py434 # Step 1: PPTX → PDF (in memory)COMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py117 # Step 1: find all TOC keywordsCOMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py123 # Step 2: if no TOC keywords found, use the first line as the candidate areaCOMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py132 # Step 3: build candidate areas for each start indexCOMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py288 # Step 1: detect candidate areas (may be multiple)COMMENT
LOW⚡…r/app/services/document_parser/structure/toc_parser.py296 # Step 2: evaluate each candidate area with LLM (parallel when multiple)COMMENT
LOW…r/app/services/document_parser/structure/toc_parser.py516 # Step 3: Remove TOC lines from md_lines (process in reverse order to correct indices)COMMENT
Modern AI Meta-Vocabulary9 hits · 24 pts
SeverityFileLineSnippetContext
MEDIUMAGENTS.md243│ ├── doc_nav.json # Hierarchical navigation tree for agentic retrievalCODE
MEDIUM…sign/retrieval-heart-vessel-trace-optimization-plan.md548### Deferred: LLM orchestration improvementsCOMMENT
MEDIUM…thon/shared/services/retrieval/agent_explore/config.py31# episode.py; this is completion budget, not context window).COMMENT
MEDIUM…/demo_documents/stem-transformers-tutorial/chunks.json5676 "content": "►\nLibrary system\n►\nImagine you're looking for information on a specific topic (query)\n►\nEach book CODE
MEDIUM…/demo_documents/stem-transformers-tutorial/chunks.json5676 "content": "►\nLibrary system\n►\nImagine you're looking for information on a specific topic (query)\n►\nEach book CODE
MEDIUM…/versions/e5f6a7b8c9d0_add_agentic_retrieval_tables.py21 # ── retrieval_runs: one row per agentic retrieval query ──COMMENT
MEDIUMapps/worker/scripts/debug_retrieval.py473 # --query mode should exercise the production agentic path; omittingCOMMENT
MEDIUMdeprecated/mapnav/nav/nav_agent.py414 # Checklist: wave orchestration. Every episode runs plan + harvest + control.COMMENT
MEDIUMdeprecated/mapnav/nav/nav_types.py66 # WHERE node filter (pre-harvest). Off until orchestrate enables a subgoal.COMMENT
AI Structural Patterns24 hits · 24 pts
SeverityFileLineSnippetContext
LOWscripts/publication_benchmark/run_correctness.py101CODE
LOW…ges/shared-python/shared/services/redis/key_builder.py221CODE
LOW…shared-python/shared/services/retrieval/app_service.py16CODE
LOW…ared-python/shared/services/retrieval/cache_service.py65CODE
LOW…red-python/shared/services/retrieval/trace/recorder.py33CODE
LOW…ython/shared/services/retrieval/agent_tools/snippet.py78CODE
LOW…red-python/shared/services/retrieval/execution/plan.py37CODE
LOW…n/shared/services/retrieval/execution/query_request.py41CODE
LOW…ges/shared-python/shared/services/ai/summary/engine.py187CODE
LOW…ges/shared-python/shared/services/ai/summary/engine.py204CODE
LOW…ges/shared-python/shared/services/ai/summary/engine.py220CODE
LOWapps/api/app/api/v1/routes/documents.py60CODE
LOWapps/api/app/api/v1/routes/jobs.py58CODE
LOWapps/api/app/api/v2/routes/jobs.py51CODE
LOW…tract/test_publication_telemetry_admission_contract.py53CODE
LOWapps/api/tests/support/contract_database.py358CODE
LOWapps/api/tests/support/contract_database.py741CODE
LOW…s/worker/app/services/document_parser/parse_service.py10CODE
LOW…pp/services/document_parser/formats/markdown/parser.py230CODE
LOW…pp/services/document_parser/structure/layout_parser.py477CODE
LOWapps/worker/tests/support/contract_database.py37CODE
LOWdeprecated/mapnav/nav/nav_agent.py278CODE
LOWdeprecated/mapnav/nav/nav_agent.py318CODE
LOWdeprecated/mapnav/nav/nav_llm.py162CODE
AI Slop Vocabulary7 hits · 20 pts
SeverityFileLineSnippetContext
MEDIUM⚡…ared-python/shared/tests/test_agent_explore_harness.py271# harness/resolve.py: AGENT_EXPLORE_HARNESS switchCOMMENT
MEDIUM…s/shared-python/shared/services/redis/redis_monitor.py261 """Get a comprehensive monitoring report."""STRING
MEDIUM…es/shared-python/shared/services/retrieval/settings.py7# agent tool-loop harness caps (``ToolBudget.max_chars``).COMMENT
MEDIUM…thon/shared/services/retrieval/agent_explore/config.py13# Model for AGENT_EXPLORE_HARNESS=cursor_sdk (harness/cursor_harness.py) —COMMENT
MEDIUM…thon/shared/services/retrieval/agent_explore/config.py14# a separate constant from AGENT_EXPLORE_MODEL because that harness'sCOMMENT
MEDIUM…thon/shared/services/retrieval/agent_tools/registry.py37# ``scoring/map_lighting.py`` and each harness's ``tool_message_content`` call.COMMENT
MEDIUMdeprecated/mapnav/nav/nav_types.py60 # Default 1 so shared-checklist probe/harness match without silent overrides.COMMENT
Dead Code8 hits · 16 pts
SeverityFileLineSnippetContext
MEDIUM…ared-python/shared/tests/test_agent_tools_map_scope.py86CODE
MEDIUM…hared-python/shared/tests/test_agent_tools_contract.py25CODE
MEDIUM…es/shared-python/shared/tests/test_agent_tools_grep.py129CODE
MEDIUM…n/shared/tests/test_agent_tools_explore_table_image.py72CODE
MEDIUM…ared/tests/test_agent_tools_discovery_read_contract.py89CODE
MEDIUM…es/shared-python/shared/tests/test_agent_tools_read.py73CODE
MEDIUM…red-python/shared/tests/test_agent_tools_read_trace.py48CODE
MEDIUM…sts/contract/test_agent_evidence_retention_contract.py138CODE
Docstring Block Structure3 hits · 15 pts
SeverityFileLineSnippetContext
HIGH…es/shared-python/shared/services/redis/retry_policy.py28 Execute a Redis operation with retry support. Args: operation: Operation callback to execuSTRING
HIGH…ared-python/shared/services/billing/credits_service.py312 Deduct credits using ledger pattern. Raises InsufficientCreditsException if balance too low. ASTRING
HIGH…ices/document_parser/formats/pdf/pymupdf_subprocess.py338Run PyMuPDF work through a bounded gevent threadpool slot. Args: worker_fn: Top-level function with signatuSTRING
Redundant / Tautological Comments8 hits · 12 pts
SeverityFileLineSnippetContext
LOW…ges/shared-python/shared/services/ai/token_tracking.py50 # Check if this greenlet was registered as a childCOMMENT
LOW…ared-python/shared/services/billing/credits_service.py384 # Check if already refundedCOMMENT
LOWapps/api/app/api/v1/routes/webhook_secrets.py146 # Check if secret already exists for this endpointCOMMENT
LOWapps/api/app/services/rate_limit/config.py154 # Check if there are actual changesCOMMENT
LOW…er/app/services/document_parser/formats/html/parser.py263 # Check if purely numericCOMMENT
LOW…rvices/document_parser/structure/metadata_extractor.py113 # Check if this is a # headingCOMMENT
LOW…rvices/document_parser/structure/metadata_extractor.py198 # Check if span contains table htmlCOMMENT
LOW…rvices/document_parser/structure/metadata_extractor.py409 # Check if this is a tracked headingCOMMENT
Fake / Example Data7 hits · 7 pts
SeverityFileLineSnippetContext
LOW…ckages/shared-python/shared/tests/test_asset_inline.py124 ("asset_type", "file_path", "placeholder", "display_marker"),CODE
LOW⚡…/tests/contract/test_self_hosted_telemetry_contract.py92 "email": "user@example.com",CODE
LOW…/tests/contract/test_self_hosted_telemetry_contract.py150 "email": "user@example.com",CODE
LOW…/tests/contract/test_self_hosted_telemetry_contract.py161 "email": "user@example.com",CODE
LOW…/tests/contract/test_self_hosted_telemetry_contract.py170 "email": "user@example.com",CODE
LOW…/tests/contract/test_self_hosted_telemetry_contract.py317 "email": "user@example.com",CODE
LOW…/tests/contract/test_self_hosted_telemetry_contract.py381 "email": "user@example.com",CODE
Slop Phrases1 hit · 2 pts
SeverityFileLineSnippetContext
MEDIUM…documents/financial-micron-report-9c0becf5/chunks.json1724 "content": "March 18, 2026\n30\nOutlook\n• We expect higher price, lower cost and favorable mix to \nall contributCODE
Example Usage Blocks1 hit · 2 pts
SeverityFileLineSnippetContext
LOWscripts/smoke_byok.sh3# Usage:COMMENT