Releases: MehmetGoekce/llm-wiki
Release list
v1.3.0 — Routing Transparency in Access-Log
Routing transparency. The Access-Log already recorded which pages a query pulled; now it records why each was picked. Loading becomes auditable — not just what loaded, but the index description or grep term that selected it.
Added
- Routing reason in the Access-Log — every
querylog line now carries amatched: "<reason>"field: the matched hub### Indexrouting description / #tag on index routing, or the grep term on the L3 fallback. Shows not just WHICH page loaded but WHY it was selected. statuscache profile now breaks down the most frequentmatched:reasons per hot page, surfacing mis-routing.
Changed
openspec/specs/query.md— REQ-450 line format extended; new REQ-450b defines thematched:reason semantics.
Notes
- Backward compatible: legacy Access-Log lines without
matched:stay valid; the suffix never affects prune/status parsing.
Full diff: v1.2.0...v1.3.0
v1.2.0 — Hub-Index-Routing + LRU-Demote
Two retrieval-scaling mechanisms that keep L2 precise as it grows — the CPU-cache analogy carried through to the index and eviction layers.
Hub-Index-Routing — two-stage query
Each hub page carries an ### Index of routing lines ([[page]] -- description #tags). query reads the cheap index first, opens only the 3 best pages by description, and grep becomes the L3 fallback. ingest maintains the routing line for every page (the wiki's page table).
LRU-Demote — new /wiki prune [--months N]
query logs every full-page read to an append-only Wiki/Reference/Access-Log. prune evicts cold pages (no read in N months, default 6) into the hub ### Archive, marked archived::. Eviction never deletes, renames, or moves a file — incoming [[links]] stay valid, the page is still greppable (L3), and it's re-promoted automatically on re-hit.
Also
- Lint rules 10 (Index Drift) + 11 (Archived-in-Live-Index), both auto-fixable
statushot/cold cache profile; Access-Log templates (Logseq + Obsidian);setup.shscaffolds it- New
openspec/specs/prune.md; updated query/ingest/lint/schema specs
Upgrading
Backward compatible. Run /wiki lint --fix once to backfill routing lines into pre-1.2.0 hubs.
Full changelog: v1.1.1...v1.2.0
v1.1.1 — FAQ, Troubleshooting, Badges
Documentation-only release addressing adoption-friction feedback on v1.1.0.
Added
- README badge row — license, release, stars, top language, last commit
- docs/faq.md — 10 first-time-user questions: paid-plan requirement, L1/L2 rationale, Logseq vs. Obsidian choice, credential safety, wiki-growth thresholds, Karpathy-gist differentiation
- docs/troubleshooting.md — 12 symptom → cause → fix entries across four categories: setup, wiki-app integration, Claude Code integration, wiki growth
- Documentation section in README linking all five doc pages
Notes
No code, schema, or command changes. v1.1.0's 8.0/10 community rating flagged missing onboarding docs, not missing features — this release targets that gap directly.
Full Changelog: v1.1.0...v1.1.1
v1.1.0 — OpenSpec Specifications & Community Infrastructure
What's New
OpenSpec Specifications (162 requirements, 66 scenarios)
Formal EARS requirements (SHALL/MUST/SHOULD) and BDD scenarios (GIVEN/WHEN/THEN) for every part of the system:
| Spec | Covers | Requirements | Scenarios |
|---|---|---|---|
ingest.md |
5-phase source processing | 25 | 10 |
query.md |
Search, synthesis, write-back | 16 | 10 |
lint.md |
9 health checks with auto-fix | 23 | 10 |
schema.md |
Page types, property validation | 30 | 10 |
config.md |
Configuration loading & errors | 18 | 8 |
setup.md |
Interactive installer | 28 | 10 |
l1-l2-routing.md |
L1/L2 boundary decisions | 22 | 8 |
GitHub Community Files
- Issue templates: bug report (with environment checklist), feature request (with area checkboxes)
- PR template: dual-tool testing checklist, commit format reminder
- SECURITY.md: responsible disclosure process
setup.sh Hardening
- Prerequisite checks (python3, git must be installed)
set -eo pipefailfor stricter error handling- Namespace name validation (no special characters)
- Existing wiki pages skipped instead of silently overwritten
- Prompt before overwriting existing
llm-wiki.yml
Full Changelog: v1.0.0...v1.1.0