codex-py

user2595/codex-py

Fork 0

Commit Graph

Author	SHA1	Message	Date
Tarik Moussa	5672358bbe	feat(graph): warn on low citing-paper coverage in graph report (R-D) Add graph.citing_coverage() (papers with >=1 out-edge / total) and a graph_min_citing_coverage setting (default 0.8). codex graph report now surfaces 'Citing coverage: N/M papers with out-edges (P%)' in text and JSON, and warns when the share is below threshold -- low citing coverage starves PageRank/coupling even when the paper count looks healthy (the DQ-1 sub-item). Separate from the existing total-count graph_min_corpus_size warning. Tests: citing_coverage unit tests + CLI tests (line shown, warning fires/suppressed, JSON field). Full suite green; ruff + mypy clean. Live: graph report shows 29/29 (100%), no warning. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 07:59:25 +02:00
Tarik Moussa	1f1e0e82b3	fix(F-15): address Opus review findings (CRITICAL + WARN) CRITICAL: - cli.py: invert cite-boost formula: divide distance by (1 + alphapr) instead of multiply — high-PageRank papers now correctly rank higher - cli.py: wire graph_min_corpus_size config into graph report; warning emitted to stderr so JSON stdout stays parseable WARN: - graph.py: document that damping is ignored in small-graph uniform branch - cli.py: sort dangling citations before slicing for stable output - cli.py: replace raise typer.Exit(0) with return in empty-graph path - tests: fix extra_args helper signatures; add cite-boost ordering test and small-corpus warning test Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-15 03:40:30 +02:00
Tarik Moussa	fd51b70000	feat(F-15): citation graph — PageRank, coupling, co-citation, CLI - codex/graph.py: build_citation_graph (DiGraph from DB), citation_pagerank (graceful uniform fallback < 5 nodes), find_related (bibliographic coupling), find_co_cited, dangling_citations - codex/config.py: graph_cite_boost_alpha=0.3, graph_min_corpus_size=15 - codex/cli.py: graph report [--top-n] [--json], graph related <paper-id> [--min-shared]; search paper --cite-boost (PageRank score weighting) - tests/graph/: 39 tests (graph functions + CLI) — 326 total green Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-15 03:31:36 +02:00

Author

SHA1

Message

Date

Tarik Moussa

5672358bbe

feat(graph): warn on low citing-paper coverage in graph report (R-D)

Add graph.citing_coverage() (papers with >=1 out-edge / total) and a graph_min_citing_coverage setting (default 0.8). codex graph report now surfaces 'Citing coverage: N/M papers with out-edges (P%)' in text and JSON, and warns when the share is below threshold -- low citing coverage starves PageRank/coupling even when the paper count looks healthy (the DQ-1 sub-item). Separate from the existing total-count graph_min_corpus_size warning.

Tests: citing_coverage unit tests + CLI tests (line shown, warning fires/suppressed, JSON field). Full suite green; ruff + mypy clean. Live: graph report shows 29/29 (100%), no warning.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-18 07:59:25 +02:00

Tarik Moussa

1f1e0e82b3

fix(F-15): address Opus review findings (CRITICAL + WARN)

CRITICAL:
- cli.py: invert cite-boost formula: divide distance by (1 + alpha*pr)
  instead of multiply — high-PageRank papers now correctly rank higher
- cli.py: wire graph_min_corpus_size config into graph report; warning
  emitted to stderr so JSON stdout stays parseable

WARN:
- graph.py: document that damping is ignored in small-graph uniform branch
- cli.py: sort dangling citations before slicing for stable output
- cli.py: replace raise typer.Exit(0) with return in empty-graph path
- tests: fix *extra_args helper signatures; add cite-boost ordering test
  and small-corpus warning test

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

2026-06-15 03:40:30 +02:00

Tarik Moussa

fd51b70000

feat(F-15): citation graph — PageRank, coupling, co-citation, CLI

- codex/graph.py: build_citation_graph (DiGraph from DB), citation_pagerank
  (graceful uniform fallback < 5 nodes), find_related (bibliographic coupling),
  find_co_cited, dangling_citations
- codex/config.py: graph_cite_boost_alpha=0.3, graph_min_corpus_size=15
- codex/cli.py: graph report [--top-n] [--json], graph related <paper-id>
  [--min-shared]; search paper --cite-boost (PageRank score weighting)
- tests/graph/: 39 tests (graph functions + CLI) — 326 total green

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

2026-06-15 03:31:36 +02:00

3 Commits