PaperGraph MCP v0.11.0

PaperGraph MCP v0.11.0 adds Reading Report Export: a deterministic Markdown artifact for saving and sharing a paper's evidence-backed reading state.

Highlights

• Export paper-level reading reports as Markdown.
• Include Paper Map context, main-result candidates, recommended reading route, local logic-chain evidence, external reading risks, and evidence-quality warnings in one report.
• Add workspace_export_paper_reading_report MCP tool.
• Add export-paper-reading-report CLI command with stdout Markdown output and --output report.md file export.
• Preserve explicit evidence boundaries: no proof verification, no hidden prerequisite inference, no semantic theorem matching.

Verification

• GitHub CI passed on PR #21.
• Local release-commit verification: 445 passed, 1 skipped.

PaperGraph MCP v0.10.0

PaperGraph MCP v0.10.0

v0.10.0 adds Paper Map, an evidence-first first-load overview for a stored paper.

Paper Map helps a researcher or agent quickly see the shape of a paper before choosing where to read next. It highlights likely main-result candidates, local result structure, proof-path evidence, external reading risks, and evidence-quality warnings while preserving PaperGraph's core rule: show evidence, do not guess mathematical dependencies.

Highlights

• Added workspace_get_paper_map
• Added Workspace.get_paper_map(...)
• Added CLI command get-paper-map
• Surfaces main-result candidates with explicit heuristic reasons
• Builds a bounded reading route from existing proof-path evidence
• Embeds external import risks from the existing import planner
• Reports evidence-quality warnings for missing proofs, unresolved references, and external dependencies
• Updated README, onboarding instructions, diagnostics, CI smoke checks, and version pins to v0.10.0

Evidence Boundaries

Paper Map does not verify proofs, perform semantic theorem matching, infer hidden prerequisites, or automatically import external papers. Empty dependencies still mean “no supported extraction evidence found,” not “there are no mathematical dependencies.”

Testing

434 passed, 1 skipped

PaperGraph MCP v0.9.2

Highlights

• Added conservative proof-roadmap extraction for phrases such as It remains to prove Lemmas 1 and 2.
• Resolved grouped singular/plural local result mentions into existing proof dependency evidence.
• Preserved unresolved roadmap mentions for review instead of dropping them.
• Added conservative TeX visible numbering for local result resolution without changing result IDs.
• Carried roadmap dependencies into reading paths and updated release pins for v0.9.2.

Verification

• Local: uv run pytest -> 421 passed, 1 skipped in 36.48s
• PR CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34202665175 -> success
• Main CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34203217594 -> success
• Pinned install: uvx --from git+https://github.com/lotchuazzz-crypto/papergraph-mcp.git@v0.9.2 papergraph-mcp --version -> papergraph-mcp 0.9.2

Pull Request

• #17

PaperGraph MCP v0.9.1

Highlights

• Added conservative TeX proof environment extraction for LaTeX project imports.
• Associated adjacent TeX proof blocks with the immediately preceding unassociated result.
• Resolved proof-local LaTeX label refs (\ref, \eqref, \autoref, \cref, \Cref) to stored result labels.
• Exposed proof-local external result stops from TeX proofs instead of losing them.
• Updated README, onboarding, diagnostics, and release pins for v0.9.1.

Verification

• Local: uv run pytest -> 416 passed, 1 skipped in 35.15s
• PR CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34199910024 -> success
• Main CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34200472671 -> success
• Pinned install: uvx --from git+https://github.com/lotchuazzz-crypto/papergraph-mcp.git@v0.9.1 papergraph-mcp --version -> papergraph-mcp 0.9.1

Pull Request

• #16

PaperGraph MCP v0.9.0

Highlights

• Added a read-only External Import Planner for result, reading queue, and paper scopes.
• Groups stored external result mentions, citation mentions, and bibliography entries into deterministic arXiv import candidates.
• Marks already-imported arXiv papers to prevent duplicate imports.
• Preserves unresolved or non-actionable stops as blocked evidence.
• Exposes planner APIs through MCP tools and JSON CLI commands.
• Updates README, onboarding, diagnostics, and release pins for v0.9.0.

Verification

• Local: uv run pytest -> 411 passed, 1 skipped in 34.97s
• PR CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34194729169 -> success
• Main CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34195249195 -> success
• Pinned install: uvx --from git+https://github.com/lotchuazzz-crypto/papergraph-mcp.git@v0.9.0 papergraph-mcp --version -> papergraph-mcp 0.9.0

Pull Request

• #15

PaperGraph MCP v0.8.0

Highlights

• Adds the persistent Reading Queue Planner on workspace schema v5.
• Creates deterministic queue items from reading-path evidence: required selected targets, recommended local proof dependencies, and caution items for external or unresolved stops.
• Applies queue items directly to Reading Session State as queued checkpoints with queue provenance.
• Exposes queue create/list/get/apply through MCP tools and JSON CLI commands.
• Updates README, onboarding recipes, CI smoke checks, and diagnostics pins to v0.8.0.

Verification

• Local: uv run pytest with TMP/TEMP set to the worktree .tmp -> 399 passed, 1 skipped in 37.60s.
• Pull request CI: run #27 on PR #14 -> success.
• Main CI: run #28 on 474740b6f13dd845074e28df0c8f578d43804597 -> success.
• Pinned install: uvx --from git+https://github.com/lotchuazzz-crypto/papergraph-mcp.git@v0.8.0 papergraph-mcp --version -> papergraph-mcp 0.8.0.

Links

• PR: #14
• CI: https://github.com/lotchuazzz-crypto/papergraph-mcp/actions/runs/34046324906

PaperGraph MCP v0.7.0

PaperGraph MCP v0.7.0 adds persistent Reading Session State for resumable evidence-grounded paper reading.

Highlights:

• Add schema v4 workspace tables for reading sessions, checkpoints, and notes.
• Add workspace APIs and MCP tools to create/list/get sessions, record checkpoints, add notes/questions, and export recovery summaries.
• Add matching JSON CLI commands for existing workspaces.
• Document the Reading Session workflow and update onboarding pins to v0.7.0.

Verification:

• Local full suite: 386 passed, 1 skipped.
• GitHub Actions main CI run #26: success across Ubuntu/Windows Python 3.10/3.12 plus wheel install smoke.
• Pinned install verified: uvx --from git+https://github.com/lotchuazzz-crypto/papergraph-mcp.git@v0.7.0 papergraph-mcp --version prints papergraph-mcp 0.7.0.

PaperGraph MCP v0.6.1

PaperGraph MCP v0.6.1 adds command-line Reading Bridge exports for existing SQLite workspaces.

Highlights:

• Add CLI JSON export commands for Reading Bridge payloads: export-reading-bundle, export-result-reading-context, get-source-slice, and get-result-reading-path.
• Reuse the existing v0.6 Reading Bridge workspace APIs without changing MCP tool signatures or payload shapes.
• Document terminal workflows for exporting paper bundles, focused result contexts, bounded source slices, and reading paths.
• Update release surfaces and onboarding pins to v0.6.1.

Verification:

• Local full suite: 371 passed, 1 skipped.
• GitHub Actions main CI run 33879089884: Ubuntu and Windows tests on Python 3.10 and 3.12 passed.
• Wheel build and install smoke passed.
• Pinned install verified: uvx --from git+https://github.com/lotchuazzz-crypto/papergraph-mcp.git@v0.6.1 papergraph-mcp --version prints papergraph-mcp 0.6.1.

v0.4.4

Summary

• Adds high-level raw request handling with validate_arxiv_request(input) and load_arxiv_request(input, main_file=None, refresh=False).
• Accepts bare arXiv IDs, arXiv URLs, Markdown links, and prose while preserving candidate provenance.
• Stops ambiguous requests such as [math/0307200](https://arxiv.org/abs/2609.01574) before any download or active graph replacement.
• Updates CLI and onboarding docs so first-use agents prefer the high-level request tools.

Verification

• python -m pytest -q -p no:cacheprovider -> 294 passed, 1 skipped
• papergraph-mcp --version -> papergraph-mcp 0.4.4
• papergraph-mcp validate-arxiv-request "[math/0307200](https://arxiv.org/abs/2609.01574)" -> status: conflict, action: ask_user_to_choose
• papergraph-mcp load-arxiv-request "[math/0307200](https://arxiv.org/abs/2609.01574)" -> exits 1 with the same conflict JSON

PaperGraph MCP v0.4.3

PaperGraph MCP v0.4.3

This release hardens the real first-use path so agents verify both the running PaperGraph version and the intended arXiv paper before loading source.

Added

• papergraph-mcp doctor prints environment diagnostics as JSON, including package version, release tag, recommended pinned source, dependency extraction basis, and optional local Git context.
• papergraph-mcp validate-arxiv validates a text arXiv ID and/or arXiv URL before loading.
• MCP tools get_environment_diagnostics and validate_arxiv_input expose the same checks to agents.

Hardened

• Conflicting arXiv text IDs and URLs now return status: conflict, action: ask_user_to_choose, and no selected ID.
• README and onboarding now require existing clones to run git fetch --tags origin before being treated as current.
• First-use guidance now requires validation before load_arxiv_paper when both an arXiv ID and URL appear.

Verified

• Full test suite: 280 passed, 1 skipped.
• GitHub CI passed on Ubuntu and Windows for Python 3.10 and 3.12, plus wheel build/install smoke.