diff --git a/docs/fleettools/albok.md b/docs/fleettools/albok.md index 9064fb4..b76a018 100644 --- a/docs/fleettools/albok.md +++ b/docs/fleettools/albok.md @@ -4,14 +4,17 @@ **CLI:** `albok` · **MCP (Claude Code):** `albok-mcp`, registered at user scope · **Owner:** `albok-dev` (althing) One searchable store of what the fleet knows: every repo's `persistent-memory.md` (entries, detail -files, archives), the stash, and the library (books by chapter, papers, extracted concepts). Search +files, archives), the stash, the library (books by chapter, papers, extracted concepts), and the operator's own +knowledgebase (his notes vault and his inbox). Search is hybrid (vector + keyword) and LLM-free. ## Access Every nh3-dev shell carries `ALBOK_SERVICE` and `ALBOK_TOKEN` — the shared **`fleet-agents` read -token**: `fleet/*` (memory, stash) and `library/*` (fiction, nonfiction). It reads no personal wing. -A shell older than 2026-10-16 may lack them; open a new one. A handle that needs more grants asks +token**: `fleet/*` (memory, stash), `library/*` (fiction, nonfiction) and the operator's knowledgebase, +`personal/notes` and `personal/inbox` (Prime, 2026-10-19: every agent must be able to read it). Anything classed +`personal`, `adult` or `secret` stays hidden from it; it does not read `personal/agent-feedback` or the sealed wing. +A shell older than 2026-10-19 may lack them; open a new one. A handle that needs more grants asks infra-ops for its own token. ```sh @@ -47,12 +50,14 @@ Nemi, albok's ingester, walks every source hourly on nh3-dev (a user timer, a fe |---|---| | a decision, lesson or state for a repo | write it in that repo's `persistent-memory.md` under `~/development/` (Nemi reads the file on disk; commit it as usual) | | raw material (a transcript, an article) | `/stash` (Claude) or a file in `~/stash/` with its frontmatter | -| a note for the operator's personal inbox (a personal wing: the fleet token cannot read it back) | a markdown file in `/srv/nemi/inbox/` | +| a document for the operator's knowledgebase | a markdown file in `/srv/nemi/inbox/` (wing `personal/inbox`; kept as dropped, never moved; PDFs are coming) | | a book | `scp book.epub lkraven@nh3-dev:/srv/nemi/books/fiction/` (or `nonfiction/`): validated, then shelved into `~/library/` and ingested the same hour, or moved to `rejected/` beside a reason file (`not_epub`, `drm`, `duplicate`, …); `LOG` records every decision | ## When to reach for it -Before you decide something, check whether it was already decided, tried or measured, in this repo +When the operator asks you something his own notes might cover, search his knowledgebase first +(`--wing personal/notes --wing personal/inbox`, or no `--wing` for everything you can read), read several hits whole, +and build the answer from them, citing the object ids. Before you decide something, check whether it was already decided, tried or measured, in this repo or any other. Before you research a game-design, cognition or fiction question, check the library. *Detail:* `~/development/albok/README.md`, `packages/albok-client/README.md` (CLI and MCP),