Skip to content

Releases: MehmetGoekce/llm-wiki

v1.3.0 — Routing Transparency in Access-Log

Choose a tag to compare

@MehmetGoekce MehmetGoekce released this 08 Jun 15:12

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 query log line now carries a matched: "<reason>" field: the matched hub ### Index routing description / #tag on index routing, or the grep term on the L3 fallback. Shows not just WHICH page loaded but WHY it was selected.
  • status cache profile now breaks down the most frequent matched: reasons per hot page, surfacing mis-routing.

Changed

  • openspec/specs/query.md — REQ-450 line format extended; new REQ-450b defines the matched: 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

Choose a tag to compare

@MehmetGoekce MehmetGoekce released this 07 Jun 18:36
602d509

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
  • status hot/cold cache profile; Access-Log templates (Logseq + Obsidian); setup.sh scaffolds 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

Choose a tag to compare

@MehmetGoekce MehmetGoekce released this 18 Apr 06:20

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

Choose a tag to compare

@MehmetGoekce MehmetGoekce released this 10 Apr 20:57

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 pipefail for 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