doction

List the user's workspaces (slug, name, role).

List the members of a workspace (email, display name, role).

List all pages in a workspace as a flat tree (slug, title, depth).

Read a page: title, markdown content and metadata.

Create a markdown page. Returns the generated slug.

Reparent a page. Cheap: the git repo is flat, so no file moves. Omit parent_slug to move it to the root.

Change a page's slug. The old slug keeps resolving through an alias, so existing [[wikilinks]] do not break.

Soft-delete a page; it goes to the trash and can be restored.

Direct children of a page.

Update a page's title and/or content. Slug stays stable.

Git commit history for a page (sha, timestamp, author, message).

Pages that link to this page via [[wikilink]] — incoming edges, one hop. Traverses links, not tags: use related_pages for pages about the same subject, and get_linked_knowledge to walk further than one hop. Read-only.

The wikilink neighbourhood of a page in one call: every page reachable within `depth` hops in either direction, each with its distance, the direction of the hop that reached it (outgoing, incoming, or both when

Neighbor pages ranked by shared-tag overlap. Traverses tags, not links: these pages are about the same subject but need not reference each other. Use list_backlinks or get_linked_knowledge for actual references. Read-only.

Find pages. Hybrid search: the lexical and the vector rankings fused by reciprocal rank, filterable by tag. Returns one entry per page with its best matching passage and which retrievers found it — use this to pick what to read, and get_rag_context to read it. Read-only.

Gather passages to answer from. Returns whole sections with provenance

How the workspace is organised: pages and their subpages, nested. Use it to find where a topic belongs before writing. Read-only.

A page's markdown exactly as stored, frontmatter block included and unmodified, plus its parsed frontmatter and tags. Read this before editing — it is what a write has to preserve. Read-only.

WRITE. Replace one section of a page, or add it if absent, leaving every other byte untouched — no need to send the whole body back, so two agents editing different sections do not overwrite each other. Refuses when the page has more than one heading with that text; pass `level` to disambiguate. Rec…

Hybrid search: the lexical and the vector rankings fused by reciprocal rank. Returns slug, title, score, matched chunk, and which retrievers found it. Identical ordering to the web UI and /api/search. Degrades to full-text search when semantic search is disabled or not yet indexed.

Pages this page should probably link to but doesn't yet: cosine similarity over local page embeddings, or literal title mentions when semantic search is off. Returns slug, title, score and a `mode` field.

Candidate tags for a page: TF-IDF terms that are characteristic of it vs the rest of the workspace, boosting terms already used as tags elsewhere. No embeddings needed.

Retrieval pipe: returns the top-k most relevant chunks with provenance