vh/esh-pfi-infrastructure
1
0
Fork 0
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

docs(fleettools): albok fleet-agents token now reads the operator's knowledgebase (personal/notes + personal/inbox), Prime 2026-10-19

Browse Source
This commit is contained in:
vh
2026-10-19 00:22:51 -07:00
parent 78b676bb7f
commit cf4d0ab712
1 changed files with 10 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/fleettools/albok.md
+10 -5
View File
@@ -4,14 +4,17 @@
**CLI:** `albok` · **MCP (Claude Code):** `albok-mcp`, registered at user scope · **Owner:** `albok-dev` (althing) **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 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. is hybrid (vector + keyword) and LLM-free.
## Access ## Access
Every nh3-dev shell carries `ALBOK_SERVICE` and `ALBOK_TOKEN` — the shared **`fleet-agents` read 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. token**: `fleet/*` (memory, stash), `library/*` (fiction, nonfiction) and the operator's knowledgebase,
A shell older than 2026-10-16 may lack them; open a new one. A handle that needs more grants asks `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. infra-ops for its own token.
```sh ```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) | | 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 | | 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 | | 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 ## 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. 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), *Detail:* `~/development/albok/README.md`, `packages/albok-client/README.md` (CLI and MCP),