Tudo no Wikilayer se apoia na árvore de nós descrita abaixo: cada bloco tem um endereço estável, cada página mostra quais outras páginas apontam para ela, e uma página continua sendo lida como um documento só. É pelo MCP que os agentes chegam à mesma árvore.
Nós
O Wikilayer guarda o texto em uma única árvore. Cada nó tem um título e um corpo em Markdown; uma página contém os blocos que formam as seções dela e fica sob a wiki ou sob outra página, e essa árvore de páginas é a navegação da wiki. O navegador exibe a página para as pessoas, e o MCP expõe os mesmos nós aos agentes.
Os níveis de título vêm da árvore
Um bloco logo abaixo de uma página é renderizado como h2; um bloco abaixo dele, como h3. Um título digitado dentro de um corpo em Markdown não tem nó próprio, por isso as ferramentas o recusam. Cada seção é um bloco à parte, então aparece no sumário da página e pode receber um link direto.
O que os nós oferecem
Cada nó tem um ID estável, um nó pai e um histórico de alterações próprio.
Os links sobrevivem a renomeações
Uma referência block:N usa o ID estável do nó. Renomear, reescrever ou mover esse nó mantém o link intacto.
Os backlinks são automáticos
Como os links apontam para IDs de nós, o Wikilayer consegue listar as páginas que levam a um nó. A lista aparece na página e no documento montado em Markdown dela.
Mover um nó leva junto a subárvore
move_node troca o nó pai de um nó. Os descendentes vão junto, e os níveis de título deles acompanham a nova profundidade. Um sort_key posiciona o nó entre os irmãos sem editar o corpo deles. migrate pode mover uma subárvore para outra wiki quando nenhum link atravessaria o limite entre as wikis.
Cada nó tem seu próprio histórico
Cada nó guarda as próprias versões e o próprio updated_at. Alterar um bloco acrescenta uma entrada do histórico a esse bloco sem mexer nos vizinhos.
A estrutura de tópicos dispensa ler a wiki inteira
get_outline mapeia uma wiki por títulos, IDs e contagens de tokens sem enviar todos os corpos.
Os links conectam ramos
A árvore dá a cada nó um único nó pai. As referências curtas vinculam nós relacionados em outras partes da wiki, e os backlinks mostram as conexões no sentido inverso sem duplicar o conteúdo.
Leitura e exportação
Uma página se lê como um documento só
O navegador exibe uma página com as seções em ordem. get_page_markdown devolve a mesma página a um agente, com um comentário antes de cada nó que leva o ID dele. As wikis públicas também oferecem o documento montado como uma visualização em Markdown.
O conteúdo é portátil
A exportação de uma wiki contém o Markdown, os arquivos e a estrutura dela, e assim o conteúdo pode ficar guardado fora do Wikilayer.