docs(fleettools): albok links drop (/srv/nemi/links) — writing row + when-to-reach sentence (albok-dev, verbatim)

This commit is contained in:
vh
2026-10-19 03:11:53 -07:00
parent 90b75a3c9e
commit 7fc01a4dd9
+2 -1
View File
@@ -51,13 +51,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 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 web page, PDF or text link for the operator's knowledgebase (or a PDF, HTML or TXT file) | a file in `/srv/nemi/links/`: a bare URL in `<name>.link`, or YAML in `<name>.link.yaml` with `url:` plus any of `title`, `creator`, `published`, `site`, `tags`, `note`, `visibility` (or drop the document itself). Nemi fetches it once within the hour and keeps the page byte for byte in `personal/inbox` with its provenance and a summary. A refusal goes to `rejected/` beside a reason file; `LOG` records every decision. Video links wait (transcripts 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
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
and build the answer from them, citing the object ids. When the operator hands you a link or a document to keep, drop it in `/srv/nemi/links/` rather than pasting its text: the KB then keeps the original and where it came from, not a retelling. 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),