feat(wiki-research): add optional pluggable CLI retrieval backends - #109
Open
Ar9av wants to merge 1 commit into
Open
feat(wiki-research): add optional pluggable CLI retrieval backends#109Ar9av wants to merge 1 commit into
Ar9av wants to merge 1 commit into
Conversation
Introduces an optional vault file `references/research-backends.md` that registers extra CLI retrieval backends — name, binary, invoke template, when-to-use, cost tier, and env key. In Rounds 1–2 the skill checks active backends against each angle/URL and folds their output into the same claims/concepts/entities/contradictions extraction. Key guarantees: - No `research-backends.md` → zero change in behaviour - Missing binary / unset env key / non-zero exit → backend skipped, noted in run summary, research continues via WebSearch/WebFetch - Free-first ordering: free backends evaluated before paid ones per angle - A backend failure never aborts a run Ships a starter YAML registry template (defuddle, yt-dlp, perplexity-sonar) inline in the skill for users to copy into their vault. Closes #106
Aspyder1
approved these changes
Jul 13, 2026
Aspyder1
left a comment
There was a problem hiding this comment.
Reviewed: scoped, additive-only (opt-in via references/research-backends.md, zero regression when absent), graceful fallback on missing binaries/env keys, CI green (install-leaves-tree-clean passing), closes #106. Looks ready to merge.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
references/research-backends.mdthat registers extra CLI retrieval backends (name, binary, invoke template, when-to-use, cost tier, env key)Key guarantees
research-backends.md→ behaviour identical to todayWebSearch/WebFetch. A backend never aborts a run.freebackends evaluated beforepaidones per angledefuddlehook; no server wiring, no hard dependencyNet change
+78 lines in
.skills/wiki-research/SKILL.md, fully additive and optional.Test plan
research-backends.md→ skill runs identically to beforeresearch-backends.mdcontaining an unavailable binary → backend noted as skipped, research completes normallyenv_keyis unset → backend skipped, noted in summarydefuddle) → invoked for matching URLs, output folded into extractionCloses #106