Skip to content

v2.3.0 — Sci-Hub as peer source; relaxed install confirmation

Choose a tag to compare

@psypeal psypeal released this 23 Apr 12:59
· 10 commits to main since this release

What's new

Two user-facing fixes for the PDF enrichment flow, driven by feedback that v2.2.x was too rigid when using Sci-Hub.

1. Sci-Hub is now a peer source, not just a fallback

/knowledge-vault:enrich-references now works with either Unpaywall or Sci-Hub on its own — no need to configure Unpaywall if you only want to use Sci-Hub.

Configured sources Behavior
Unpaywall only Same as before — OA-only lookup
Sci-Hub only New — Sci-Hub handles every candidate directly
Both Unpaywall + Sci-Hub Unpaywall runs first per item; Sci-Hub picks up the misses
Neither Command stops with a helpful message listing how to enable at least one

2. Relaxed install confirmation for Sci-Hub

/knowledge-vault:setup-sources step 4a no longer requires a verbatim yes — any affirmative reply works (yes, y, ok, sure, proceed, go, continue — case-insensitive). Only a clearly negative reply (no, cancel, stop) cancels. The legal disclosure is still shown once so users know what they're opting into.

Migration

  • No user action required. Your existing .vault/.scihub-enabled marker files continue to work. If you had Unpaywall configured as the sole source, your workflow is unchanged.
  • If you want Sci-Hub standalone on a fresh project: skip the UNPAYWALL_EMAIL export and run /knowledge-vault:setup-sources → select Sci-Hub.

Other changes

  • README "Advanced: Sci-Hub fallback" renamed to "Advanced: Sci-Hub (opt-in, per-project)". Anchors updated.
  • Per-item status key no-oa-found + unpaywall-miss unified to no-pdf-found.
  • Flowchart and sample output reflect dual-source logic.
  • Stale reference to removed /knowledge-vault:setup-scihub command fixed.

Install / update

If you already have the marketplace configured:

/plugin update knowledge-vault

Otherwise: see the Install section in the README.


Full changelog: v2.2.1...v2.3.0