librian 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,74 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+---
+
+## [0.1.1] - 2026-11-08
+
+### Added
+
+- **`librian add [<folder>]`.** Adds a docs folder without opening the menu:
+  run it inside the docs folder, or pass the path. It counts the markdown
+  files, asks `Add it as "akms_docs"? (Y/n)` and adds the entry. It refuses
+  your home folder and a drive root (exit code 2), says `Already added as …`
+  (exit code 0) for a folder that is already there, and adds nothing when the
+  input ends.
+- **The folder question starts with the current folder.** Start `librian`
+  inside a docs folder and Enter is enough to add it. In your home folder or a
+  drive root the question starts empty.
+
+### Changed
+
+- **Add asks for the folder only.** The Add form with its Name, Exclude and
+  Max bytes rows is gone: the folder is checked (a missing folder is explained
+  and asked again; a folder already added takes you to its entry; a folder
+  without markdown files defaults to No), then one question adds it with the
+  default name. Name, Exclude and Max bytes are changed with **Edit** on the
+  entry, which still opens the form.
+- **Counting files is bounded.** Add, `librian add`, Check and the file counts
+  in the main menu stop at 5,000 files or after 2 seconds and show
+  `5000+ files`, so choosing a huge folder does not hang.
+- **The menu's AI services screen is now called Register.** Its rows and
+  actions are the same: switch Claude Code or Codex on or off, then Apply.
+
+### Removed
+
+- **Runtime → Use a local checkout.** It was for running an unpublished build.
+  Install a built checkout with
+  `npm install --prefix ~/.librian/runtime <path>` instead; the menu still
+  shows it as `linked to <path>` and **Install from npm** switches back.
+
+## [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.