zara-knowledge: sourced knowledge and computational query bridge #18

New issue

Closed

opened 2026-08-31 18:44:44 +00:00 by lost-rob0t · 0 comments

lost-rob0t commented

2026-08-31 18:44:44 +00:00

(Migrated from github.com)

Plugin

zara-knowledge

Goal

Provide Zara with a sourced knowledge-query layer that can combine web/reference providers, computational engines and local knowledge adapters without pretending every answer came from the model itself.

Initial capabilities

provider-neutral search/query interface;
retrieve source metadata and bounded excerpts;
computational/factual query adapter support (for example Wolfram-style engines);
encyclopedia/reference adapter support;
local KB/search adapter support;
merge/rank results while retaining provenance;
expose citation-ready structured evidence to Zara.

Integration

zara-browser handles interactive browser sessions; this plugin handles knowledge retrieval/query semantics;
zara-memory may supply user/project knowledge sources but should not be silently treated as public factual evidence;
zara-expert can reason over normalized returned facts when appropriate.

Reliability

every external/local result retains provider/source/timestamp;
conflicting sources remain distinguishable;
bounded result counts and payload sizes;
provider failures degrade independently;
no credentials in returned evidence/logs.

Acceptance criteria

normalized sourced-result/evidence model exists
multiple fake providers can contribute results to one query
provenance survives ranking/merging
conflicting results are not silently collapsed
local and remote providers are distinguishable
tests are deterministic and network-free
README documents provider/plugin adapter contract and citation semantics
registry validation, plugin tests and nix flake check pass

## Plugin `zara-knowledge` ## Goal Provide Zara with a sourced knowledge-query layer that can combine web/reference providers, computational engines and local knowledge adapters without pretending every answer came from the model itself. ## Initial capabilities - provider-neutral search/query interface; - retrieve source metadata and bounded excerpts; - computational/factual query adapter support (for example Wolfram-style engines); - encyclopedia/reference adapter support; - local KB/search adapter support; - merge/rank results while retaining provenance; - expose citation-ready structured evidence to Zara. ## Integration - `zara-browser` handles interactive browser sessions; this plugin handles knowledge retrieval/query semantics; - `zara-memory` may supply user/project knowledge sources but should not be silently treated as public factual evidence; - `zara-expert` can reason over normalized returned facts when appropriate. ## Reliability - every external/local result retains provider/source/timestamp; - conflicting sources remain distinguishable; - bounded result counts and payload sizes; - provider failures degrade independently; - no credentials in returned evidence/logs. ## Acceptance criteria - [ ] normalized sourced-result/evidence model exists - [ ] multiple fake providers can contribute results to one query - [ ] provenance survives ranking/merging - [ ] conflicting results are not silently collapsed - [ ] local and remote providers are distinguishable - [ ] tests are deterministic and network-free - [ ] README documents provider/plugin adapter contract and citation semantics - [ ] registry validation, plugin tests and `nix flake check` pass