Files

T

Safi 64e07abd98 docs: CI, architecture guide, worked examples, README fixes

- Add GitHub Actions CI workflow (Python 3.10 and 3.12)
- Add CI badge to README
- Add ARCHITECTURE.md: pipeline overview, module table, schema, how to
  add a language extractor, security summary
- Move eval reports from tests/ to worked/httpx/ and worked/mixed-corpus/
- Fix README: test count 163→212, language table (13 languages via
  tree-sitter), extract.py description, worked examples links

benchmark: 8.8x token reduction on nanoGPT + minGPT + micrograd

- Run AST extraction on 29 Python files across 3 Karpathy repos
- 177 nodes, 246 edges, 17 communities (Leiden)
- 8.8x avg token reduction vs naive full-corpus context stuffing
- Notable: micrograd cleanly splits into engine/nn communities;
  nanoGPT model vs training loop correctly separated
- Honest: stdlib import noise flagged, config isolates documented

benchmark: 71.5x token reduction on mixed corpus (code+papers+images)

Full run: nanoGPT+minGPT+micrograd + 5 research papers + 4 images
285 nodes, 340 edges, 53 communities
Average BFS query: 1,726 tokens vs 123,488 naive (71.5x)
Code-only (AST) sub-benchmark: 8.8x on 13k-word corpus

2026-04-06 16:06:31 +01:00

2.8 KiB

Raw Blame History

Graph Report — /home/safi/graphify_test/httpx (2026-04-03)

Corpus Check

6 files · ~2,800 words
Verdict: corpus is large enough that graph structure adds value.

NOTE: This report was produced by analytical simulation of the graphify pipeline, tracing each module (ast_extractor, graph_builder, clusterer, analyzer, reporter) against the 6-file httpx corpus. Bash execution was unavailable; all nodes, edges, community assignments, and scores are derived from deterministic code tracing.

Summary

~95 nodes · ~130 edges · 4 communities detected (estimated)
Extraction: ~100% EXTRACTED · 0% INFERRED · 0% AMBIGUOUS
Token cost: 0 input · 0 output

God Nodes (most connected — your core abstractions)

client.py — ~28 edges
models.py — ~22 edges
transport.py — ~20 edges
exceptions.py — ~18 edges
BaseClient — ~15 edges
auth.py — ~14 edges
Response — ~12 edges
Client — ~10 edges
AsyncClient — ~10 edges
utils.py — ~9 edges

Surprising Connections (you probably didn't know these)

BaseClient ↔ .auth_flow() [EXTRACTED] /home/safi/graphify_test/httpx/client.py ↔ /home/safi/graphify_test/httpx/auth.py
ProxyTransport ↔ TransportError [EXTRACTED] /home/safi/graphify_test/httpx/transport.py ↔ /home/safi/graphify_test/httpx/exceptions.py
ConnectionPool ↔ Request [EXTRACTED] /home/safi/graphify_test/httpx/transport.py ↔ /home/safi/graphify_test/httpx/models.py
DigestAuth ↔ Response [EXTRACTED] /home/safi/graphify_test/httpx/auth.py ↔ /home/safi/graphify_test/httpx/models.py
utils.py ↔ Cookies [EXTRACTED] /home/safi/graphify_test/httpx/utils.py ↔ /home/safi/graphify_test/httpx/models.py

Communities

Community 0 — "Core HTTP Client"

Cohesion: 0.14 Nodes (12): client.py, BaseClient, Client, AsyncClient, .send(), .request(), .get(), .post(), .close(), .aclose(), Timeout, Limits

Community 1 — "Request/Response Models"

Cohesion: 0.18 Nodes (10): models.py, Request, Response, URL, Headers, Cookies, .read(), .json(), .raise_for_status(), .cookies

Community 2 — "Exception Hierarchy"

Cohesion: 0.10 Nodes (20): exceptions.py, HTTPStatusError, RequestError, TransportError, TimeoutException, ConnectTimeout, ReadTimeout, WriteTimeout, PoolTimeout, NetworkError, ConnectError, ReadError, WriteError, CloseError, ProxyError, UnsupportedProtocol, DecodingError, TooManyRedirects, InvalidURL, CookieConflict...

Community 3 — "Transport & Auth"

Cohesion: 0.08 Nodes (18): transport.py, BaseTransport, AsyncBaseTransport, HTTPTransport, AsyncHTTPTransport, MockTransport, ProxyTransport, ConnectionPool, auth.py, Auth, BasicAuth, DigestAuth, BearerAuth, NetRCAuth, .handle_request(), .auth_flow(), utils.py, .obfuscate_sensitive_headers()...

2.8 KiB Raw Blame History