mirror of
https://github.com/Ar9av/obsidian-wiki.git
synced 2026-09-14 20:36:34 +08:00
Arnav
aca850937f
Two additions, both optional and additive. `obsidian-wiki eval` scores the query index against a JSONL gold set — recall@1/@3/@5, MRR, intent accuracy, and should_read precision — with --min-recall/--min-mrr/--min-intent as CI gates. Ships a 15-page fixture vault and 26-case gold set; baseline recall@5 0.950, MRR 0.900. The gold set includes paraphrase cases sharing no vocabulary with their target page, so the lexical index's ceiling is measured rather than assumed. Event time adds three optional frontmatter fields: valid_from, valid_until (inclusive), and superseded_by. A page whose window has passed is historical, not wrong — it stays in the vault and in the graph and only drops out of default retrieval, so `--as-of DATE` answers the same question as of any date and `--include-historical` shows the whole history. Structural intents (impact/bridges/hubs/clusters) deliberately ignore the filter: deleting a page still breaks the historical pages linking to it. lint reports temporal_errors (fail) and superseded_dangling (warn). Pages that don't opt in are unaffected and their JSON is unchanged. Also fixes a classify_query bug the eval found on its first run: "what do I know about X", the phrasing wiki-query documents, matched the gap pattern because one alternation collapsed the affirmative and negated forms. Only the negated forms are gap questions now.
Documentation
Everything beyond the README landing page.
| Page | What's in it |
|---|---|
| Installation | pip, git clone, agent-driven setup, Skills CLI, multiple vaults |
| Agent Compatibility | The full agent matrix and per-agent manual setup |
| Skills Reference | All 39 skills, what each does, and its slash command |
| CLI Reference | Every obsidian-wiki subcommand (繁體中文: context packs) |
| Configuration | Every config variable, QMD semantic search, _raw/ staging, GitHub sync |
| Architecture | The four ingest stages, vault structure, what we added to Karpathy's pattern |
| Session Brain | Topic graph over your agent session history |
| Browser Extension | Capture pages into the vault, and fill web forms from it |
| Deployment | Run a vault as a Dockerized memory service agents reach over HTTP/MCP |
| Contributing | Adding skills, keeping the two READMEs in sync |
New here? Read Installation, then Skills Reference.