anthropics/claude-agent-sdk-python

41.8

Adjusted Score

41.8

Raw Score

100%

Time Factor

2026-08-28

Last Push

8.0K

Stars

Python

Language

48.5K

Lines of Code

137

Files

1.6K

Pattern Hits

2026-08-29

Scan Date

0.11

HC Hit Rate

What These Metrics Mean

Adjusted Score: Primary synthetic code indicator. Raw score normalised per 1,000 lines of code and multiplied by the temporal discount factor. This is the definitive comparative metric — use it to rank repositories by AI authorship density.
Raw Score: The unmodified sum of all severity-weighted, context-multiplied pattern match scores before temporal discounting. Reflects the absolute signal strength independent of when the repository was last active.
Time Factor: The temporal discount multiplier (0–100%) applied to the raw score. Repositories last updated before ChatGPT's launch (Nov 2022) receive a 5% factor. Full signal is only assigned to repositories active in the post-adoption era (Jan 2024+).
Pattern Hits: Total count of individual pattern matches across all files and categories. A high hit count with a low score may indicate a very large codebase with isolated AI snippets; a low count with a high score indicates dense, concentrated AI signatures.
HC Hit Rate: High+Critical pattern hits per file, averaged across the repository. This orthogonal signal catches repositories where a few files are densely packed with high-severity AI tells — a strong indicator even when the normalised score appears moderate due to codebase size.
Lines of Code / Files: Total lines and files analysed. The scanner examines 94 file extensions. These denominators are used to normalise the score, enabling fair comparison between repositories of vastly different sizes.

Score History

This chart maps the temporal evolution of the adjusted synthetic code score across successive scan runs. An upward trajectory indicates ongoing incorporation of AI-generated code or expanding LLM-assisted scaffolding; a stable or declining trajectory may reflect active human refactoring, code removal, or the adoption of stricter authorship policies. The dashed secondary line (right axis) independently tracks total raw pattern hit count, which can diverge from the normalised score when codebase size changes significantly between scans.

Severity Breakdown

Classifies detected patterns by their diagnostic confidence and structural impact. CRITICAL patterns (coefficient 10) represent definitive synthetic signatures — hallucinated imports, explicit LLM attribution metadata — virtually never produced by human authors. HIGH (5) indicates strong structural tells such as cross-file repetition or cross-linguistic idioms. MEDIUM (2) covers recognisable conversational padding and AI-specific vocabulary. LOW (1) captures subtle indicators like tautological comments and generic boilerplate that require density to carry independent signal.

CRITICAL 0HIGH 15MEDIUM 263LOW 1286

Directory Score Breakdown

This horizontal bar chart decomposes the repository's raw synthetic code score by top-level directory, allowing you to pinpoint precisely which modules or components carry the highest AI authorship density. Directories with disproportionately high scores relative to their size warrant targeted manual review: concentrated AI signatures often trace back to mass-generated configuration layers, auto-ported test suites, LLM-scaffolded boilerplate classes, or entire subsystems authored under heavy copilot assistance. Use this view to prioritise your human code-review effort.

Pattern Findings

The scanner identified 1564 distinct pattern matches across 19 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a statistically significant AI authorship indicator. 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 diagnostic confidence level (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — comment-context matches receive a ×1.5 weight because LLMs systematically over-annotate. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier as dense clusters constitute far stronger evidence of synthetic authorship than isolated hits.

Decorative Section Separators224 hits · 820 pts

Severity	File	Line	Snippet	Context
MEDIUM⚡	tests/test_example_s3_session_store.py	131	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	133	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	236	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	238	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	338	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	340	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	375	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	377	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	446	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	448	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	481	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_example_s3_session_store.py	483	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	50	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	52	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	96	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	98	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	509	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	511	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	579	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_example_s3_session_store.py	581	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	68	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	70	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	114	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	116	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	267	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	269	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	465	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	467	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	599	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_mutations.py	601	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_session_mutations.py	25	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_session_mutations.py	27	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_session_mutations.py	534	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_session_mutations.py	536	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	126	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	128	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	247	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	249	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	1145	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	1147	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	1611	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_sessions.py	1613	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	38	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	40	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	640	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	642	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	675	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	677	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	1499	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	1501	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	1636	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	1638	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	1729	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_sessions.py	1731	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_store_conformance.py	27	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_store_conformance.py	29	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_store_conformance.py	138	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_session_store_conformance.py	140	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_mcp_large_output.py	96	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_mcp_large_output.py	98	# ---------------------------------------------------------------------------	COMMENT
164 more matches not shown…

Hyper-Verbose Identifiers955 hits · 775 pts

Severity	File	Line	Snippet	Context
LOW	tests/test_task_compat.py	10	def test_spawn_and_wait_asyncio(self):	CODE
LOW⚡	tests/test_task_compat.py	104	def test_cancelled_waiter_asyncio(self):	CODE
LOW⚡	tests/test_task_compat.py	107	def test_cancelled_waiter_trio(self):	CODE
LOW⚡	tests/test_task_compat.py	112	def test_done_callback_asyncio(self):	CODE
LOW	tests/test_task_compat.py	143	def test_exception_propagates_via_wait_asyncio(self):	CODE
LOW	tests/test_task_compat.py	154	def test_exception_propagates_via_wait_trio(self):	CODE
LOW	tests/test_task_compat.py	165	def test_unhandled_exception_logged_under_trio(self, caplog):	CODE
LOW⚡	tests/test_task_compat.py	223	def test_contextvar_propagates_asyncio(self):	CODE
LOW⚡	tests/test_task_compat.py	226	def test_contextvar_propagates_trio(self):	CODE
LOW⚡	tests/test_task_compat.py	231	def test_cancel_from_different_task_trio(self):	CODE
LOW	tests/test_changelog.py	12	def test_changelog_starts_with_header(self):	CODE
LOW	tests/test_changelog.py	18	def test_changelog_has_valid_version_format(self):	CODE
LOW	tests/test_changelog.py	34	def test_changelog_has_bullet_points(self):	CODE
LOW	tests/test_changelog.py	63	def test_changelog_versions_in_descending_order(self):	CODE
LOW	tests/test_changelog.py	79	def test_changelog_no_empty_bullet_points(self):	CODE
LOW	tests/test_streaming_client.py	48	async def control_protocol_generator():	CODE
LOW	tests/test_streaming_client.py	110	def _create_mock_transport_with_control_responses():	CODE
LOW	tests/test_streaming_client.py	130	async def control_protocol_generator():	CODE
LOW	tests/test_streaming_client.py	162	async def test_auto_connect_with_context_manager(self):	CODE
LOW	tests/test_streaming_client.py	180	async def test_manual_connect_disconnect(self):	CODE
LOW	tests/test_streaming_client.py	202	async def test_connect_with_string_prompt(self):	CODE
LOW	tests/test_streaming_client.py	227	async def test_forward_subagent_text_sent_in_initialize(self):	CODE
LOW	tests/test_streaming_client.py	256	async def test_connect_with_async_iterable(self):	CODE
LOW	tests/test_streaming_client.py	314	async def test_send_message_with_session_id(self):	CODE
LOW	tests/test_streaming_client.py	341	async def test_send_message_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	522	async def test_interrupt_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	530	async def test_reconnect_mcp_server(self):	CODE
LOW	tests/test_streaming_client.py	562	async def test_reconnect_mcp_server_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	603	async def test_toggle_mcp_server_enabled_true(self):	CODE
LOW	tests/test_streaming_client.py	634	async def test_toggle_mcp_server_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	673	async def test_stop_task_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	742	async def control_protocol_generator():	CODE
LOW	tests/test_streaming_client.py	815	async def test_get_mcp_status_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	870	async def control_protocol_generator():	CODE
LOW	tests/test_streaming_client.py	921	async def test_get_context_usage_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	952	async def test_concurrent_send_receive(self):	CODE
LOW	tests/test_streaming_client.py	1032	async def test_query_with_async_iterable(self):	CODE
LOW	tests/test_streaming_client.py	1134	async def test_receive_messages_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	1143	async def test_receive_response_not_connected(self):	CODE
LOW	tests/test_streaming_client.py	1173	async def test_disconnect_without_connect(self):	CODE
LOW	tests/test_streaming_client.py	1181	async def test_context_manager_with_exception(self):	CODE
LOW	tests/test_streaming_client.py	1198	async def test_receive_response_list_comprehension(self):	CODE
LOW⚡	tests/test_example_s3_session_store.py	137	async def test_append_part_name_format_and_sortable() -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	242	async def test_load_null_when_empty(s3_client: Any) -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	248	async def test_load_sorts_and_concatenates() -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	328	async def test_load_skips_malformed_lines() -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	344	async def test_list_sessions_extracts_mtime() -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	381	async def test_delete_batch_deletes_parts() -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	452	async def test_list_subkeys_extracts_unique_subpaths() -> None:	CODE
LOW⚡	tests/test_example_s3_session_store.py	488	async def test_prefix_normalization(raw_prefix: str) -> None:	CODE
LOW	tests/test_example_s3_session_store.py	115	async def test_conformance_with_options_dataclass(s3_client: Any) -> None:	CODE
LOW	tests/test_example_s3_session_store.py	163	async def test_append_two_instances_distinct_part_names() -> None:	CODE
LOW	tests/test_example_s3_session_store.py	178	async def test_append_jsonl_serialization() -> None:	CODE
LOW	tests/test_example_s3_session_store.py	190	async def test_append_same_ms_preserves_order(monkeypatch: pytest.MonkeyPatch) -> None:	CODE
LOW	tests/test_example_s3_session_store.py	213	async def test_append_empty_is_noop() -> None:	CODE
LOW	tests/test_example_s3_session_store.py	223	async def test_append_includes_subpath() -> None:	CODE
LOW	tests/test_example_s3_session_store.py	294	async def test_load_excludes_subpath_parts() -> None:	CODE
LOW	tests/test_example_s3_session_store.py	361	async def test_list_sessions_ignores_subagent_parts() -> None:	CODE
LOW	tests/test_example_s3_session_store.py	399	async def test_delete_subpath_direct_only(s3_client: Any) -> None:	CODE
LOW	tests/test_example_s3_session_store.py	415	async def test_delete_cascades_without_subpath(s3_client: Any) -> None:	CODE
895 more matches not shown…

Unused Imports174 hits · 109 pts

Severity	File	Line	Context
LOW	tests/test_example_redis_session_store_live.py	14	CODE
LOW	tests/test_example_s3_session_store.py	9	CODE
LOW	tests/test_session_mutations.py	3	CODE
LOW	tests/test_sessions.py	3	CODE
LOW	tests/test_session_store_conformance.py	8	CODE
LOW	tests/test_example_redis_session_store.py	12	CODE
LOW	tests/test_session_store_anyio.py	8	CODE
LOW	tests/test_session_summary.py	8	CODE
LOW	tests/test_session_resume.py	3	CODE
LOW	tests/test_session_helpers_store.py	8	CODE
LOW	tests/test_example_s3_session_store_live.py	12	CODE
LOW	tests/test_example_postgres_session_store.py	14	CODE
LOW	tests/test_session_import.py	3	CODE
LOW	tests/test_transcript_mirror.py	6	CODE
LOW	tests/test_types.py	441	CODE
LOW	tests/test_types.py	441	CODE
LOW	tests/test_types.py	441	CODE
LOW	tests/test_types.py	441	CODE
LOW	tests/test_types.py	441	CODE
LOW	examples/hooks.py	16	CODE
LOW	examples/include_partial_messages.py	18	CODE
LOW	examples/include_partial_messages.py	18	CODE
LOW	examples/include_partial_messages.py	18	CODE
LOW	examples/include_partial_messages.py	18	CODE
LOW	examples/include_partial_messages.py	18	CODE
LOW	examples/session_stores/postgres_session_store.py	65	CODE
LOW	examples/session_stores/redis_session_store.py	50	CODE
LOW	examples/session_stores/s3_session_store.py	45	CODE
LOW	scripts/check_pypi_quota.py	10	CODE
LOW	scripts/build_wheel.py	35	CODE
LOW	src/claude_agent_sdk/__init__.py	32	CODE
LOW	src/claude_agent_sdk/__init__.py	32	CODE
LOW	src/claude_agent_sdk/__init__.py	32	CODE
LOW	src/claude_agent_sdk/__init__.py	32	CODE
LOW	src/claude_agent_sdk/__init__.py	32	CODE
LOW	src/claude_agent_sdk/__init__.py	32	CODE
LOW	src/claude_agent_sdk/__init__.py	41	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	42	CODE
LOW	src/claude_agent_sdk/__init__.py	53	CODE
LOW	src/claude_agent_sdk/__init__.py	53	CODE
LOW	src/claude_agent_sdk/__init__.py	54	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	55	CODE
LOW	src/claude_agent_sdk/__init__.py	67	CODE
114 more matches not shown…

Excessive Try-Catch Wrapping55 hits · 65 pts

Severity	File	Line	Snippet	Context
LOW	tests/test_task_compat.py	249	except Exception as e: # pragma: no cover - failure path	CODE
MEDIUM	tests/test_task_compat.py	245	def cancel_in_other_task():	CODE
LOW	tests/test_sdk_mcp_integration.py	578	except Exception as e:	CODE
LOW	tests/test_sdk_mcp_integration.py	1734	except Exception as e:	CODE
LOW	tests/test_transport.py	1969	except Exception as e:	CODE
LOW	tests/test_transport.py	2037	except Exception as e:	CODE
MEDIUM	tests/test_query.py	1259	def close_in_other_task():	CODE
LOW	tests/test_query.py	1168	except Exception as e:	CODE
LOW	tests/test_query.py	1262	except Exception as e:	CODE
LOW	e2e-tests/test_dynamic_control.py	91	except Exception as e:	CODE
LOW⚡	examples/streaming_mode_ipython.py	163	except Exception as e:	CODE
MEDIUM⚡	examples/streaming_mode_ipython.py	164	print(f"Error: {e}")	CODE
MEDIUM	examples/setting_sources.py	193	print(f"Error: Unknown example '{example_name}'")	CODE
MEDIUM	examples/hooks.py	339	print(f"Error: Unknown example '{example_name}'")	CODE
MEDIUM	examples/stderr_callback_example.py	19	print(f"Error detected: {message}")	CODE
LOW	examples/streaming_mode.py	407	except Exception as e:	CODE
LOW	examples/streaming_mode.py	465	except Exception as e:	CODE
MEDIUM	examples/streaming_mode.py	510	print(f"Error: Unknown example '{example_name}'")	CODE
MEDIUM	scripts/update_cli_version.py	70	print(f"Error: {exc}", file=sys.stderr)	CODE
MEDIUM	scripts/download_cli.py	181	print(f"Error: could not run the install command: {e}", file=sys.stderr)	CODE
MEDIUM	scripts/download_cli.py	316	print("Error: Could not find installed Claude CLI binary", file=sys.stderr)	CODE
MEDIUM	scripts/download_cli.py	366	print(f"Error: {exc}", file=sys.stderr)	CODE
MEDIUM	scripts/build_wheel.py	60	print(f"Error: {description} failed", file=sys.stderr)	CODE
LOW	scripts/build_wheel.py	305	except Exception as e:	CODE
LOW	.github/workflows/build-and-publish.yml	118	except Exception as exc:	CODE
LOW	src/claude_agent_sdk/__init__.py	614	except Exception as e:	CODE
LOW	src/claude_agent_sdk/_internal/session_resume.py	311	except Exception as e: # noqa: BLE001 - surface adapter failures with context	CODE
LOW	src/claude_agent_sdk/_internal/session_resume.py	506	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/session_resume.py	524	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	591	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	795	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	868	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	1169	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	1642	except Exception as e: # noqa: BLE001 - adapter is user code	CODE
LOW	src/claude_agent_sdk/_internal/query.py	228	except Exception as e: # pragma: no cover - buffer-full edge case	CODE
LOW	src/claude_agent_sdk/_internal/query.py	405	except Exception as e:	CODE
LOW	src/claude_agent_sdk/_internal/query.py	586	except Exception as e:	CODE
LOW	src/claude_agent_sdk/_internal/query.py	669	except Exception as e:	CODE
LOW	src/claude_agent_sdk/_internal/query.py	877	except Exception as e:	CODE
LOW	src/claude_agent_sdk/_internal/query.py	891	except Exception as e:	CODE
LOW	src/claude_agent_sdk/_internal/sdk_mcp_bridge.py	163	except Exception as e:	CODE
MEDIUM	src/claude_agent_sdk/_internal/sdk_mcp_bridge.py	139	def _run(self) -> None:	CODE
LOW	…laude_agent_sdk/_internal/transcript_mirror_batcher.py	110	except Exception as e: # pragma: no cover - defensive	CODE
LOW	…laude_agent_sdk/_internal/transcript_mirror_batcher.py	131	except Exception as e: # pragma: no cover - defensive	CODE
LOW	…laude_agent_sdk/_internal/transcript_mirror_batcher.py	143	except Exception as cb_err: # pragma: no cover - defensive	CODE
LOW	…laude_agent_sdk/_internal/transcript_mirror_batcher.py	203	except Exception as e: # noqa: BLE001 - adapter is user code	CODE
LOW	src/claude_agent_sdk/_internal/session_mutations.py	535	except Exception:	CODE
LOW	src/claude_agent_sdk/_internal/session_mutations.py	649	except Exception:	CODE
LOW⚡	…claude_agent_sdk/_internal/transport/subprocess_cli.py	914	except Exception:	CODE
LOW⚡	…claude_agent_sdk/_internal/transport/subprocess_cli.py	931	except Exception:	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	840	except Exception: # noqa: BLE001 - best-effort tracing must never break connect()	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	892	except Exception as e:	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	1062	except Exception as e:	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	1132	except Exception:	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	1178	except Exception:	CODE

Self-Referential Comments16 hits · 50 pts

Severity	File	Line	Snippet	Context
MEDIUM	tests/test_streaming_client.py	1039	# Create a simple test script that validates stdin and outputs a result	COMMENT
MEDIUM	tests/test_streaming_client.py	1158	# Create a new mock transport for each call	COMMENT
MEDIUM⚡	tests/test_sessions.py	447	# Create a non-UUID .jsonl file	COMMENT
MEDIUM	tests/test_sessions.py	526	# Create a real directory so realpath works	COMMENT
MEDIUM	tests/test_transport.py	1943	# Create a real subprocess that consumes stdin (cross-platform)	COMMENT
MEDIUM	tests/test_transport.py	1997	# Create a real subprocess that consumes stdin (cross-platform)	COMMENT
MEDIUM	tests/test_transport.py	2265	# Create a large agent definition (50KB prompt)	COMMENT
MEDIUM	e2e-tests/test_structured_output.py	72	# Define a schema with nested structure	COMMENT
MEDIUM	e2e-tests/test_agents_and_settings.py	158	# Create a temporary project with a filesystem agent	COMMENT
MEDIUM	e2e-tests/test_agents_and_settings.py	163	# Create a test agent file	COMMENT
MEDIUM	e2e-tests/test_agents_and_settings.py	218	# Create a temporary project with local settings	COMMENT
MEDIUM	e2e-tests/test_agents_and_settings.py	254	# Create a temporary project with a slash command	COMMENT
MEDIUM	e2e-tests/test_agents_and_settings.py	296	# Create a temporary project with local settings	COMMENT
MEDIUM	examples/streaming_mode_ipython.py	101	# Create a background task to consume messages	COMMENT
MEDIUM	examples/mcp_calculator.py	142	# Create the calculator server with all tools	COMMENT
MEDIUM	examples/streaming_mode.py	145	# Create a background task to consume messages	COMMENT

Deep Nesting63 hits · 44 pts

Severity	File	Line	Context
LOW	tests/test_changelog.py	34	CODE
LOW	tests/test_streaming_client.py	26	CODE
LOW	tests/test_streaming_client.py	110	CODE
LOW	tests/test_streaming_client.py	48	CODE
LOW	tests/test_streaming_client.py	130	CODE
LOW	tests/test_streaming_client.py	282	CODE
LOW	tests/test_streaming_client.py	314	CODE
LOW	tests/test_streaming_client.py	349	CODE
LOW	tests/test_streaming_client.py	415	CODE
LOW	tests/test_streaming_client.py	492	CODE
LOW	tests/test_streaming_client.py	530	CODE
LOW	tests/test_streaming_client.py	570	CODE
LOW	tests/test_streaming_client.py	603	CODE
LOW	tests/test_streaming_client.py	642	CODE
LOW	tests/test_streaming_client.py	681	CODE
LOW	tests/test_streaming_client.py	823	CODE
LOW	tests/test_streaming_client.py	952	CODE
LOW	tests/test_streaming_client.py	1198	CODE
LOW	tests/test_streaming_client.py	742	CODE
LOW	tests/test_streaming_client.py	870	CODE
LOW	tests/test_streaming_client.py	962	CODE
LOW	tests/test_streaming_client.py	1208	CODE
LOW	tests/test_sdk_mcp_integration.py	1463	CODE
LOW	tests/test_option_warnings.py	303	CODE
LOW	tests/test_option_warnings.py	318	CODE
LOW	e2e-tests/test_forward_subagent_text.py	43	CODE
LOW	examples/mcp_calculator.py	100	CODE
LOW	examples/filesystem_agents.py	28	CODE
LOW	examples/filesystem_agents.py	43	CODE
LOW	examples/tools_option.py	16	CODE
LOW	examples/tools_option.py	45	CODE
LOW	examples/tools_option.py	74	CODE
LOW	examples/streaming_mode_trio.py	23	CODE
LOW	examples/streaming_mode.py	36	CODE
LOW	examples/streaming_mode.py	176	CODE
LOW	examples/streaming_mode.py	301	CODE
LOW	examples/streaming_mode.py	347	CODE
LOW	examples/streaming_mode.py	427	CODE
LOW	examples/session_stores/s3_session_store.py	344	CODE
LOW	scripts/build_wheel.py	153	CODE
LOW	scripts/build_wheel.py	238	CODE
LOW	src/claude_agent_sdk/__init__.py	451	CODE
LOW	src/claude_agent_sdk/types.py	142	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	229	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	259	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	739	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	844	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	1139	CODE
LOW	src/claude_agent_sdk/_internal/sessions.py	1672	CODE
LOW	src/claude_agent_sdk/_internal/session_summary.py	51	CODE
LOW	src/claude_agent_sdk/_internal/query.py	231	CODE
LOW	src/claude_agent_sdk/_internal/query.py	308	CODE
LOW	src/claude_agent_sdk/_internal/query.py	469	CODE
LOW	src/claude_agent_sdk/_internal/query.py	762	CODE
LOW	src/claude_agent_sdk/_internal/message_parser.py	50	CODE
LOW	src/claude_agent_sdk/_internal/sdk_mcp_bridge.py	289	CODE
LOW	…laude_agent_sdk/_internal/transcript_mirror_batcher.py	149	CODE
LOW	src/claude_agent_sdk/_internal/session_mutations.py	504	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	465	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	562	CODE
3 more matches not shown…

Docstring Block Structure7 hits · 35 pts

Severity	File	Line	Snippet	Context
HIGH	src/claude_agent_sdk/__init__.py	257	Decorator for defining MCP tools with type safety. Creates a tool that can be used with SDK MCP servers. The tool r	STRING
HIGH	src/claude_agent_sdk/__init__.py	494	Create an in-process MCP server that runs within your Python application. Unlike external MCP servers that run as s	STRING
HIGH	src/claude_agent_sdk/_internal/sessions.py	1678	List sessions from a :class:`SessionStore`. Async, store-backed counterpart to :func:`list_sessions`. Loads each	STRING
HIGH	src/claude_agent_sdk/_internal/sessions.py	1901	List subagent IDs for a session from a :class:`SessionStore`. Async, store-backed counterpart to :func:`list_subage	STRING
HIGH	src/claude_agent_sdk/_internal/message_parser.py	51	Parse message from CLI output into typed Message objects. Args: data: Raw message dictionary from CLI	STRING
HIGH	src/claude_agent_sdk/_internal/session_mutations.py	246	Fork a session into a new branch with fresh UUIDs. Copies transcript messages from the source session into a new se	STRING
HIGH	src/claude_agent_sdk/_internal/session_mutations.py	892	Fork a session into a new branch with fresh UUIDs via a :class:`SessionStore`. Async, store-backed counterpart to :	STRING

Modern Structural Boilerplate24 hits · 24 pts

Severity	File	Line	Snippet	Context
LOW	examples/hooks.py	32	logger = logging.getLogger(__name__)	CODE
LOW	scripts/update_version.py	9	def update_version(new_version: str) -> None:	CODE
LOW	scripts/update_cli_version.py	22	def update_cli_version(new_version: str, version_path: Path \| None = None) -> None:	CODE
LOW	scripts/build_wheel.py	65	def update_version(version: str) -> None:	CODE
LOW	src/claude_agent_sdk/client.py	284	async def set_permission_mode(self, mode: PermissionMode) -> None:	CODE
LOW	src/claude_agent_sdk/client.py	311	async def set_model(self, model: str \| None = None) -> None:	CODE
LOW	src/claude_agent_sdk/__init__.py	172	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/__init__.py	622	__all__ = [	CODE
LOW	src/claude_agent_sdk/_internal/session_resume.py	51	logger = logging.getLogger(__name__)	CODE
LOW⚡	src/claude_agent_sdk/_internal/sessions.py	26	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/_internal/session_summary.py	25	__all__ = ["fold_session_summary", "summary_entry_to_sdk_info"]	CODE
LOW	src/claude_agent_sdk/_internal/query.py	36	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/_internal/query.py	201	def set_transcript_mirror_batcher(self, batcher: "TranscriptMirrorBatcher") -> None:	CODE
LOW	src/claude_agent_sdk/_internal/query.py	688	async def set_permission_mode(self, mode: PermissionMode) -> None:	CODE
LOW	src/claude_agent_sdk/_internal/query.py	697	async def set_model(self, model: str \| None) -> None:	CODE
LOW	src/claude_agent_sdk/_internal/session_import.py	26	__all__ = ["import_session_to_store"]	CODE
LOW	src/claude_agent_sdk/_internal/_task_compat.py	29	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/_internal/message_parser.py	34	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/_internal/sdk_mcp_bridge.py	41	logger = logging.getLogger(__name__)	CODE
LOW	…laude_agent_sdk/_internal/transcript_mirror_batcher.py	25	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/_internal/session_store.py	20	__all__ = [	CODE
LOW	src/claude_agent_sdk/_internal/transport/__init__.py	87	__all__ = ["Transport"]	CODE
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	33	logger = logging.getLogger(__name__)	CODE
LOW	src/claude_agent_sdk/testing/__init__.py	9	__all__ = ["run_session_store_conformance"]	CODE

Cross-Language Confusion3 hits · 18 pts

Severity	File	Line	Snippet	Context
HIGH	tests/test_download_cli.py	86	("1.0.0 && id", None),	CODE
HIGH⚡	…claude_agent_sdk/_internal/transport/subprocess_cli.py	923	for line in framer.push(chunk):	CODE
HIGH	…claude_agent_sdk/_internal/transport/subprocess_cli.py	1102	for line in framer.push(chunk):	CODE

AI Slop Vocabulary5 hits · 17 pts

Severity	File	Line	Snippet	Context
MEDIUM	tests/test_example_redis_session_store_live.py	102	# The harness calls make_store() once per contract for isolation. Give	COMMENT
LOW	tests/test_streaming_client.py	1109	# On Unix, just use the script directly	STRING
MEDIUM⚡	tests/test_example_redis_session_store.py	81	# Conformance harness	COMMENT
MEDIUM⚡	tests/test_example_postgres_session_store.py	119	# Conformance harness	COMMENT
MEDIUM⚡	tests/test_example_postgres_session_store.py	126	# The harness calls make_store() once per contract for isolation. Give	COMMENT

Cross-File Repetition3 hits · 15 pts

Severity	File	Snippet	Context
HIGH	examples/setting_sources.py	run all examples or a specific example based on command line argument.	STRING
HIGH	examples/hooks.py	run all examples or a specific example based on command line argument.	STRING
HIGH	examples/streaming_mode.py	run all examples or a specific example based on command line argument.	STRING

Redundant / Tautological Comments9 hits · 13 pts

Severity	File	Line	Snippet	Context
LOW	tests/test_streaming_client.py	54	# Check if initialization was requested	COMMENT
LOW	tests/test_sessions.py	1390	# Set mtime to Feb 2026 (well after the Jan timestamp)	COMMENT
LOW	e2e-tests/test_sdk_mcp_tools.py	48	# Check if the actual Python function was called	COMMENT
LOW	examples/streaming_mode_ipython.py	113	# Check if we got a result after interrupt	COMMENT
LOW	examples/max_budget_usd.py	71	# Check if budget was exceeded	COMMENT
LOW	scripts/build_wheel.py	245	# Check if we have a bundled CLI - if so, retag the wheel as platform-specific	COMMENT
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	489	# Check if settings is a JSON string or a file path	COMMENT
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	499	# Read the file	COMMENT
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	882	# Check if the error comes from the working directory or the CLI	COMMENT

Over-Commented Block12 hits · 12 pts

Severity	File	Line	Snippet	Context
LOW	e2e-tests/test_stderr_callback.py	21	# and since CLI 2.1.193 the CLI refuses to honor project-scoped grants from	COMMENT
LOW	scripts/test-docker.sh	1	#!/bin/bash	COMMENT
LOW	.github/workflows/claude-code-review.yml	61	# - For test files: Coverage, edge cases, and test quality	COMMENT
LOW	src/claude_agent_sdk/types.py	1061	"fromSession": str,	COMMENT
LOW	src/claude_agent_sdk/_internal/query.py	41	# This mirrors the set the CLI itself holds a result back for, which is	COMMENT
LOW	src/claude_agent_sdk/_internal/query.py	181	# in flight) so the stdin-closing waiter can wake; see #1088 and	COMMENT
LOW	src/claude_agent_sdk/_internal/query.py	361		COMMENT
LOW	src/claude_agent_sdk/_internal/query.py	441	# exception rides along so receive_messages() re-raises it as-is	COMMENT
LOW	src/claude_agent_sdk/_internal/message_parser.py	261	uuid=data["uuid"],	COMMENT
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	261	# spawn) or an extensionless wrapper script from a git-bash /	COMMENT
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	361		COMMENT
LOW	…claude_agent_sdk/_internal/transport/subprocess_cli.py	381	# simulation lands on some other name. Refusing whenever ANY	COMMENT

Dead Code5 hits · 10 pts

Severity	File	Line	Context
MEDIUM	tests/test_query.py	1107	CODE
MEDIUM	tests/test_query.py	1114	CODE
MEDIUM	tests/test_session_resume.py	919	CODE
MEDIUM	tests/test_client.py	353	CODE
MEDIUM	src/claude_agent_sdk/client.py	95	CODE

Synthetic Comment Markers1 hit · 8 pts

Severity	File	Line	Snippet	Context
HIGH	src/claude_agent_sdk/_internal/sessions.py	441	# User-set title (customTitle) wins over AI-generated title (aiTitle).	COMMENT

Slop Phrases2 hits · 5 pts

Severity	File	Line	Snippet	Context
LOW⚡	examples/streaming_mode_ipython.py	82	# Don't forget to disconnect when done	COMMENT
MEDIUM	examples/plugin_example.py	28	# In production, you can use any path to your plugin directory	COMMENT

Magic Placeholder Names1 hit · 5 pts

Severity	File	Line	Snippet	Context
HIGH	e2e-tests/README.md	14	export ANTHROPIC_API_KEY="your-api-key-here"	CODE

Example Usage Blocks2 hits · 3 pts

Severity	File	Line	Snippet	Context
LOW	scripts/test-docker.sh	5	# Usage:	COMMENT
LOW	scripts/gh.sh	7	# Usage:	COMMENT

AI Structural Patterns3 hits · 2 pts

Severity	File	Line	Context
LOW	tests/test_sessions.py	53	CODE
LOW	src/claude_agent_sdk/__init__.py	210	CODE
LOW	src/claude_agent_sdk/_internal/query.py	113	CODE

Analysis Overview

What These Metrics Mean

Score History

Severity Breakdown

Directory Score Breakdown

Pattern Findings