IMPORT-EVALS.md markdown
30 lines 2.2 KB
Raw
sha256:b5f647cb9c409f563d4671fe3fc05ddea01fabfed9b41fc11cb923588e1c1baf mirror: GitHub Phase A durable MCP OAuth (#270) Human minor ⚠ breaking 11 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 4 commits
sha256:b5f647cb9c409f563d4671fe3fc05ddea01fabfed9b41fc11cb923588e1c1baf mirror: GitHub Phase A durable MCP OAuth (#270) Human minor 11 days ago
sha256:d8c648b20a4d53b2673c5c082ee7edfa7b2fc9b11080832da1f38807b6bf940b fix(7C-L1b): route hosted delegation proposals through cani… Human minor 31 days ago
sha256:2827ba9e7632a4b141c50caf1e8f7d77abbc3515be20e7465f2bccb0ac4edf91 fix: repair endpoint now sets has_active_subscription when … Human minor 51 days ago