IMPORT-EVALS.md markdown
30 lines 2.2 KB
Raw
sha256:87f84653ce4706be8c65b0c4494ed6fb891213cca82db2b1824772cddc41a752 feat(auth): durable MCP OAuth refresh via shared strong sto… Agent minor 56 days ago

Import evals vs retrieval evals vs proposal evaluation

Keep these separate so work does not backtrack.

1. Import / ingest QA (eval v1) — now

  • Question: Did this importer produce notes with the expected frontmatter (source, source_id, date, title where applicable) and body?
  • How: Golden fixtures under test/fixtures/import/ plus test/import-importers-golden.test.mjs and test/import-source-types.test.mjs.
  • Scope: Deterministic importers in lib/importers/. Notion (live API), audio/video (Whisper), and hosted multipart are exercised manually or in integration environments; see IMPORT-MANUAL-CHECKLIST.md.
  • Optional fields (causal_chain_id, episode_id, entity, follows): assert in goldens only when an importer is defined to set them; otherwise treat as a product extension, not a regression in the base import phase.

2. Retrieval / RAG evals (eval v2) — later

  • Question: For a query, do we retrieve the right notes (and optionally the right order for causal chains)?
  • Spec reserve: INTENTION-AND-TEMPORAL.md §7 and SPEC.md (knowtation eval, eval set format TBD).
  • Dependency: Stable index + labeled query set over real vault content (often after imports). Do not conflate with import goldens.

3. Governance / proposal evaluation — later

  • Question: Should this proposal merge (policy, safety, quality)?
  • Doc: Lifecycle and kn1_ concurrency: PROPOSAL-LIFECYCLE.md. Requires canister/gateway alignment for any new evaluation_status fields.
  • Import today writes directly to the vault (self-hosted Hub), not through the proposal queue. Agent/human grading (e.g. A–F) belongs here if imports are routed through proposals or a staging inbox—product decision first.

Summary

Layer Tests / tooling When
Import QA Fixture goldens + manual checklist With import phase
Retrieval Future knowtation eval + eval sets After index/search baselines
Proposal eval Lifecycle + Hub/canister After Option B+ spec
File History 5 commits
sha256:87f84653ce4706be8c65b0c4494ed6fb891213cca82db2b1824772cddc41a752 feat(auth): durable MCP OAuth refresh via shared strong sto… Agent minor 56 days ago
sha256:873e30b7fafe601346295f8f4289f388f21d8f715f28584d5481899ba2b714fc Merge pull request #249 from aaronrene/muse-mirror Agent 73 days ago
sha256:d8c648b20a4d53b2673c5c082ee7edfa7b2fc9b11080832da1f38807b6bf940b fix(7C-L1b): route hosted delegation proposals through cani… Human minor 76 days ago
sha256:2827ba9e7632a4b141c50caf1e8f7d77abbc3515be20e7465f2bccb0ac4edf91 fix: repair endpoint now sets has_active_subscription when … Human minor 96 days ago