Skip to content

v0.2.0 — reference scholar + synthesis_doc_builder

Latest

Choose a tag to compare

@drknowhow drknowhow released this 02 Jun 11:03
485dfc1

What's new in v0.2.0

This release ships the deferred reference implementation that the v0.1.0 protocol bundle pointed at. v0.1.x consumers see no breaking changes — the SKILL protocol surface is unchanged. The new lib/ code is pluggable reference for orchestrators wiring deep_research into their own runtime.

Added

  • lib/scholar.py — stdlib-urllib adapter over OpenAlex, Semantic Scholar, PubMed, arXiv, Europe PMC, Crossref, Unpaywall. Actions: search, multi_search, get, find_doi, resolve_oa. Uniform normalized-hit schema across sources.
  • lib/synthesis_doc_builder.pypython-docx + matplotlib helper that renders the synthesis doc (forest plot, PRISMA flow, stance heat-table) with a pluggable upload callback.
  • pyproject.toml — installable package. Core stdlib-only; [viz] extra adds python-docx, matplotlib, numpy.
  • tests/test_scholar_smoke.py, tests/test_synthesis_doc_builder_smoke.py — stdlib unittest, network-free, soft-dep-aware skips.

Changed

  • lib/scholar.py exposes configure(contact_email, app_name) and honors SCHOLAR_CONTACT_EMAIL env. Without it, polite-pool mailto= is omitted and a generic UA is sent. Embedding dedup pluggable via set_embedding_deduper(fn).
  • lib/synthesis_doc_builder.py decouples upload via Uploader = Callable[[Path, str, str], dict]. No uploader → returns local .docx path, uploaded=False.
  • manifests/deep-research.v0.4.json bumps tool.version to 0.2.0.
  • SKILL.md drops the v0.1 hedge.
  • README.md updated for v0.2.0; quickstart shows pip install "deep-research[viz]".

Install

pip install "deep-research[viz]"   # full reference impl
pip install deep-research          # protocol + stdlib core only

Full diff: v0.1.1...v0.2.0