IMPORT-EVALS.md
markdown
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,titlewhere applicable) and body? - How: Golden fixtures under
test/fixtures/import/plustest/import-importers-golden.test.mjsandtest/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 newevaluation_statusfields. - 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
sha256:6a102aafafdfe7e70a24f4e59740200f0ee713ce7915f1b53e9d4ba5ee8b4410
Initial Muse snapshot
Human
83 days ago