librian 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+---
+
+## [0.1.0] - 2026-11-08
+
+First release.
+
+### Added
+
+- **Read one section instead of a whole file.** Four MCP tools per docs folder:
+  `list` (files with size and document title, grouped by folder), `outline`
+  (headings with line ranges and sizes), `read` (a whole file, one section or a
+  line range) and `search` (blocks that contain every word of a query, with a
+  one-line excerpt).
+- **No saved index.** Every call checks the files' modification time and size
+  and re-reads only the changed ones, so line ranges always match the files on
+  disk, even while several agents edit the same docs. Nothing is written to the
+  docs folder.
+- **References.** `outline` and `read` take `path`, `path#heading` (heading
+  text or GitHub anchor), `path:start-end` or `path:line`.
+- **Bounded responses.** Each response stays within a byte limit (16000 by
+  default). A large file returns its outline, a large section returns its own
+  text and its subsection outline or one page with a `Continue:` reference, and
+  `search` and `list` say how to get the rest.
+- **Search that works for Korean.** Words made of letters, digits and `_` match
+  at the start of a word; other words match anywhere, since Korean attaches
+  particles to words. Ancestor headings count toward a match.
+- **The `librian` menu.** Run `librian` in a terminal to add, edit, check and
+  remove docs folders, register or unregister librian in Claude Code and Codex
+  (user scope, with a preview of the commands it runs), and install, update or
+  uninstall the runtime in `~/.librian/runtime`. Entries live in
+  `~/.librian/catalog.json`; `LIBRIAN_HOME` moves both.
+- **One server for all folders.** `librian serve --catalog` is what the AI
+  services run: it offers the four tools for each entry, prefixed with the
+  entry name (`akms__read`). `librian serve --root <folder>` serves a single
+  folder with unprefixed tools, for registering by hand.