Skip to content

Releases: nvk/llm-wiki

v0.16.0 — Query Lite and Token Benchmarks

Choose a tag to compare

@nvk nvk released this 10 Jul 01:46

Query Lite

  • Adds one compact, read-only, index-first query protocol shared by Claude Code, Codex, Pi, DS4, portable agents, and a best-effort OpenCode package.
  • Reduces Claude /wiki:query instructions from 12,447 to 3,418 bytes, a 72.54% reduction, and removes edit and shell tools from query mode.
  • Adds explicit-only Codex $wiki-query while keeping full @wiki workflows for research and maintenance.
  • Adds generic pi-wiki-query and isolated pi-ds4-wiki-query launchers with read-only tools and disabled unrelated discovery.

Measured benchmarks and safeguards

  • Adds reproducible Codex app-server, Claude stream-json, and Pi/DS4 benchmark lanes with token, cache, cost, latency, payload, evidence-read, citation, and no-mutation accounting.
  • Adds static context budgets, AB/BA comparisons, and case-file plus fixture-tree SHA-256 gates.
  • A controlled DS4/Pi comparison reduced exact serialized provider payload from 216,640 to 77,338 bytes, a 64.30% reduction, while preserving deterministic quality checks.
  • OpenCode receives generated query packaging, static budgets, and sync tests; live provider/model behavior remains best effort.

Upgrade

  • Claude Code: claude plugin update wiki@llm-wiki, then restart.
  • Codex: codex plugin marketplace upgrade llm-wiki && codex plugin add wiki@llm-wiki, then start a new thread.

v0.15.1 — Codex 0.144 Compatibility

Choose a tag to compare

@nvk nvk released this 09 Jul 22:33

What's New

  • Non-interactive Codex installation — the bootstrap now uses codex plugin add wiki@llm-wiki to materialize and enable the cached plugin instead of writing an incomplete config block.
  • Cache-aware verification — verification checks the installed plugin identity, version, marketplace source, cache path, and the exact wiki:wiki skill exposed to the prompt.
  • Honest scope behavior — Codex 0.144 plugin enablement is user-scoped; unsupported project scope now fails clearly instead of reporting a successful but inactive install.
  • Real clean-home regression test — Codex install and reinstall must resolve @wiki without an interactive /plugins step or a skipped test.
  • Lessons-learned schema fix/wiki:ll raw notes now use type: notes, ingested, and lesson_kind: lessons-learned, matching the lint schema.
  • Fixture repair — the golden wiki now includes its required inbox directories, keeping the full local lint suite green.

Validation

  • Plugin validation: 96 passed
  • Structure validation: 170 passed
  • Local CLI lint: 27 passed
  • Session capture: 17 passed
  • Session concurrency: 10 passed
  • Codex and OpenCode mirror checks passed
  • Codex 0.144 clean-home install, reinstall, cache, and prompt-resolution checks passed

v0.15.0 — Topic Guides

Choose a tag to compare

@nvk nvk released this 06 Jul 21:12

What's New

  • Topic guides instead of scary schemas — user-facing docs now describe schema.md as a human-owned topic guide for local vocabulary, relationships, source boundaries, and conventions.
  • Friendlier adoption helper — added llm-wiki schema adopt to create a starter advisory schema.md; llm-wiki schema adopt --dry-run previews it.
  • Compatibility preservedllm-wiki schema migrate --apply still works as a legacy alias.
  • Librarian wording cleaned up — docs now recommend conventions/topic-guide proposals and keep schema.md human-owned/proposal-only.

Tested

  • ./tests/test-plugin-validate.sh
  • ./tests/test-docs-consistency.sh
  • ./tests/test-structure.sh
  • ./tests/test-local-cli-lint.sh
  • ./tests/test-session-capture.sh
  • ./tests/test-session-concurrency.sh
  • ./tests/test-codex-sync.sh
  • ./tests/test-opencode-sync.sh
  • ./tests/test-codex-runtime.sh (headless local install reached expected first-run /plugins enable/materialization pending state)

v0.14.0 — Default Topic Schemas

Choose a tag to compare

@nvk nvk released this 06 Jul 15:29

What's New

  • Default topic schemas — new topic wikis now include a human-owned advisory schema.md for local vocabulary, relationship verbs, and source boundaries.
  • Safe migration helperllm-wiki schema status|migrate --apply and llm-wiki lint --fix help older wikis add a starter schema without making existing wikis invalid.
  • Proposal-first librarian migration — established wikis can run the librarian schema pass for a proposal, but scans never rewrite schema.md without explicit acceptance.

Validation

  • test-plugin-validate.sh: 95 passed
  • test-docs-consistency.sh: passed
  • test-structure.sh: 170 passed
  • test-local-cli-lint.sh: 26 passed
  • test-session-capture.sh: 17 passed
  • test-codex-sync.sh and test-opencode-sync.sh: passed
  • test-codex-runtime.sh: exits 0; first-time local install may still report interactive /plugins materialization pending

v0.13.0 — Librarian Schema Migration Groundwork

Choose a tag to compare

@nvk nvk released this 06 Jul 14:27

What's New

  • Librarian schema migration groundwork — existing wikis can get an optional librarian schema pass that writes reports/proposals first and never auto-creates schema.md.
  • Docs/version consistency guard — new deterministic test checks README command coverage, manifest version sync, and reference-file allowlists.
  • Stable local lint fixtures — local lint tests now use a deterministic date override so fixture freshness does not fail just because time passed.
  • Release docs cleanup — README now lists previously omitted commands and the release checklist includes the docs consistency gate.

Migration Notes

Existing wikis require no migration. Schema advice is optional and proposal-first: status/resume can suggest a librarian schema pass for established wikis, but normal ingest/query/compile flows continue unchanged.

v0.12.0 — Feedback Curator

Choose a tag to compare

@nvk nvk released this 14 Jun 18:49

What's New

  • Feedback curator — trusted user-prompt hooks now distill high-signal user corrections, preferences, approvals, and plan-acceptance turns into redacted candidates under HUB/.sessions/feedback/.
  • Noise filter — generic acknowledgements like ok, thanks, and cool are ignored by default so the wiki does not learn low-signal chatter.
  • Review workflow — new /wiki:feedback / llm-wiki-session feedback commands list, show, manually capture, and promote candidates.
  • Explicit promotion — selected feedback candidates can be promoted into topic raw/notes/ with a feedback log entry; nothing is auto-promoted.
  • Session digest integration — session digests now include recent feedback candidates for review during rehydration and lessons-learned workflows.

Validation

  • test-plugin-validate.sh — 95 passed
  • test-structure.sh — 168 passed
  • test-local-cli-lint.sh — 22 passed
  • test-session-capture.sh — 17 passed
  • Codex/OpenCode sync checks — OK
  • test-codex-runtime.sh — OK with expected headless local-marketplace materialization skip

v0.11.1 — Session Helper Compatibility

Choose a tag to compare

@nvk nvk released this 14 Jun 17:24

What's New

  • Python 3.9 compatibility fix — the session helper now uses datetime.timezone.utc instead of the Python 3.11-only datetime.UTC, so bundled hooks and manual llm-wiki-session capture work on the system Python shipped with older macOS/Xcode installs.
  • Version refresh — Claude and Codex plugin manifests are bumped to 0.11.1.

Validation

  • test-plugin-validate.sh — 91 passed
  • test-structure.sh — 168 passed
  • test-local-cli-lint.sh — 22 passed
  • test-session-capture.sh — 14 passed
  • Codex/OpenCode sync checks — OK
  • test-codex-runtime.sh — OK with expected headless local-marketplace materialization skip

v0.11.0 — Automated Session Capture

Choose a tag to compare

@nvk nvk released this 14 Jun 17:19

What's New

  • Automated session capture — trusted hooks now capture redacted session checkpoints under HUB/.sessions/ by default.
  • Opt-out switch — run /wiki:session disable or llm-wiki-session disable to write enabled: false; hooks using --if-enabled then no-op.
  • Context rehydration and promotion — session digests can rehydrate future turns, and selected digests can be explicitly promoted into topic raw/notes/.
  • Cross-harness groundwork — Codex hooks are bundled, Claude-shaped hook payloads are tested, and OpenCode/Gemini adapters share the same storage contract.

Validation

  • test-plugin-validate.sh — 91 passed
  • test-structure.sh — 168 passed
  • test-local-cli-lint.sh — 22 passed
  • test-session-capture.sh — 14 passed
  • Codex/OpenCode sync checks — OK

v0.10.2

Choose a tag to compare

@nvk nvk released this 23 May 16:07

Collector production hardening release.

  • Prefer kind-first topic slugs for collection families, e.g. memes-bitcoin, memes-ethereum, and tools-bitcoin.
  • Clarify collect scale boundaries: 500 rows remains large; 501+ is huge.
  • Document bulk media download safeguards: timeouts, file-size caps, content-type checks, and IPv4 retry for hanging media hosts.
  • Sync Claude, Codex, OpenCode, README, and AGENTS protocol docs.

v0.10.1 — Collector Media Downloads

Choose a tag to compare

@nvk nvk released this 23 May 14:58

What's New

  • Collector media downloads/wiki:collect now downloads bounded public binary media into output/assets/collect-<slug>/ by default for media-bearing collections.

Details

  • Records local media paths, byte sizes, formats, SHA-256 hashes, download status, and failed/skipped download reasons in collection catalogs.
  • Keeps --media reference as the explicit no-download opt-out.
  • Keeps binaries out of raw/; raw remains reserved for textual source evidence.