Pular para o conteúdo
ClickHouse Loom
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Glossário

Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.

Os termos do Loom, em ordem alfabética, cada um definido uma única vez. Os identificadores de código estão entre crases.

Abstain — memory.search retornando abstain=true com um código de motivo em vez do resultado fraco mais próximo, quando o melhor resultado está abaixo do limite de abstenção calibrado para o embedder. Ele separa “nada foi armazenado” de “algo não relacionado obteve pontuação 0.3”. Veja recuperação e ranqueamento.

Actor — a coluna carimbada pelo servidor que indica quem escreveu uma linha: human:<subject> ou process:<subject>, com o tipo extraído do token. Nunca é lida do corpo da requisição. Veja identidades e namespaces.

Agente — o terceiro elemento da tupla de identidade: o nome do programa que escreve e lê (claude-code, support-bot). Ele registra a autoria; não é um limite de leitura: todo membro de um namespace lê as linhas de todos os agentes.

Attestation — as colunas verified_* que registram que uma linha foi verificada. Uma edição as mantém no lugar e as marca como obsoletas; quem lê decide a confiança comparando o hash de conteúdo atestado. Veja histórico e proveniência.

Audit log — loom.audit_log: uma linha com hash de conteúdo por operação auditada, agrupada em checkpoints horários encadeados por hash. As linhas carregam hashes, não conteúdo. Veja auditoria.

Belief revision — a lente de design para o ciclo de vida da memória: Expand (memory.set), Revise (memory.update_by_id), Contract (memory.delete), Reinforce (memory.pin), Refuse (blacklist.add). Veja como uma escrita é avaliada.

Blacklist — substrings ou regexes registradas que recusam escritas correspondentes (422 BLACKLISTED); sweep=true também marca com tombstone as correspondências existentes.

Chunk — um trecho de um documento de conhecimento ou de um arquivo-fonte, armazenado e com embedding separadamente para que a recuperação retorne a passagem em vez do documento inteiro.

Code link — o vínculo de uma memória com uma definição ou arquivo que ela nomeia, acompanhado por renomeações e edições. Seu estado é fresh, moved, changed, unresolved ou missing. Um nome de código que ainda não está no trunk aguarda até memory_code_links_pending_days (14 dias). Veja memórias vinculadas a código.

Code namespace — um namespace do tipo code que contém um repositório git indexado: seus chunks, símbolos, arestas, commits e histórico de PRs. Veja índice de código.

Commit coverage — se todas as camadas do índice processaram um determinado commit; code.index_status(commit=...) responde isso, e code.coverage.watch notifica quando isso se torna verdadeiro. Veja atualidade.

Camada do compilador — fatos do índice de código derivados de um indexador de nível de compilador (SCIP) em vez da camada do parser; arestas de chamada e referências resolvidas por informações de tipo.

Conflict — uma escrita semanticamente próxima de uma memória existente (cosseno ≥ LOOM_CONFLICT_THRESHOLD). Ambas as linhas são marcadas como conflicted e vinculadas entre si; uma pessoa ou agente as resolve. Veja conflitos e recusa.

Consolidation — a passagem em segundo plano que mescla memórias fragmentadas sobre o mesmo assunto e registra a linhagem (memory_belief_sources, support_type='derived_from').

Content hash — content_sha256 do valor de uma memória. Ele deduplica repetições exatas, sustenta a pré-condição if_match_sha256 e ancora as linhas de auditoria.

Context pack — context.pack: um pacote limitado de memória de trabalho, perfil, memórias relevantes, procedimentos e decisões, carregado uma vez no início de uma sessão. Veja busca unificada.

Painel — a aplicação web na raiz do servidor, para pessoas: memória, atividade, fontes, fila de revisão, tarefas, repositórios e configurações. Veja painel.

Decision — um registro de primeira classe de uma escolha (decision.record) com justificativa, alternativas rejeitadas e, depois, seu resultado (decision.outcome). Veja tarefas e decisões.

Entity edge — um vínculo ponderado de coocorrência entre duas entidades em loom.entity_edges, com um intervalo de validade; o grafo que facts.traverse percorre. Veja grafo de entidades.

Erasure saga — a sequência retomável e com falha fechada de etapas que erasure.request executa para remover os dados de um sujeito de todas as tabelas (e dos backends externos configurados), terminando em um censo de resíduos. Veja retenção e apagamento.

Extraction — transformar mensagens de conversa em memórias candidatas (memory.set_from_messages), com um LLM e filtros de qualidade. Veja extração.

Extractor stamp — um hash dos tokens de código dos módulos extratores do índice de código. Uma mudança nele refaz o chunking de todo repositório indexado; comentários e docstrings não contam. Veja arquitetura do índice de código.

FINAL — o modificador do ClickHouse que reduz uma tabela ReplacingMergeTree à versão mais recente por chave no momento da leitura. O Loom lê loom.memory com ele. Veja ClickHouse.

Fence — o token que task.claim retorna junto com um lease; as chamadas posteriores a task.progress, task.heartbeat, task.complete e task.fail devem apresentá-lo, para que um reivindicante expirado não possa escrever.

Grant — uma linha que dá a um sujeito um papel em um namespace (grants.*). Veja tokens e grants.

Tupla de identidade — (org, namespace, agent, user_id, session_id) em toda linha. Os três primeiros são obrigatórios; os dois últimos têm '-' como padrão. Veja identidades e namespaces.

ignored_args — o campo de resposta que nomeia os campos da requisição que o servidor não usou (desconhecidos ou descontinuados), para que um cliente perceba o desvio sem uma falha.

Inbox — uma fila nomeada de tarefas pertencente a um namespace (task.*, inbox.*). Veja tarefas e decisões.

Documento de conhecimento — um documento adicionado com knowledge.add, dividido em chunks e com embedding para recuperação. Distinto de uma memória: é material de referência, não uma crença. Veja documentos de conhecimento.

Learning — um candidato aguardando em loom.learnings_queue pela decisão de uma pessoa (learnings.list, learnings.review): um fato respaldado por vários escritores, promovido à camada compartilhada; um fato originado de uma conversa, promovido a uma linha de memória do namespace; ou uma regra que um bot afirmou sobre si mesmo, promovida ao conhecimento do namespace.

log_comment — a configuração de consulta do ClickHouse que o Loom preenche com a op, o worker ou o comando de CLI chamador, de modo que system.query_log atribua cada instrução.

maturity — o campo stable/experimental declarado por uma op. Uma op experimental que nem o core nem o toolset atomic listam fica fora da listagem all; ela ainda pode ser chamada pelo nome. Veja toolsets do MCP.

Ferramenta MCP — a projeção de uma op no Model Context Protocol, chamada loom_<op> com os pontos substituídos por sublinhados (loom_memory_set), mais algumas ferramentas sintéticas como loom_search e loom_op. Veja MCP.

Memória — uma linha em loom.memory: uma chave, um valor, sua tupla de identidade, tipo, tags, validade e proveniência. Veja memória.

Chave de memória — o identificador legível de uma memória dentro do seu namespace e agente, por convenção <scope>/<kind>/<id>. Uma escrita em uma chave existente a substitui.

Tipo de memória — a espécie de uma memória: semantic, episodic, procedural, preference, profile e outros; o tipo decide se ela recebe embedding e como é buscada.

Mentor hint — uma curta sugestão de uso que o Loom anexa aos resultados ou serve por meio de mentor.brief, indicando a um agente um plano ou uma op que ele não está usando bem.

Namespace — a unidade de armazenamento, compartilhamento e acesso: um workspace nomeado dentro de uma org. Os tipos são memory, code e bench. Veja namespaces e compartilhamento.

Operação (op) — uma entrada declarada no registro (server.operations.registry.ALL_OPERATIONS), servida em POST /v1/<op>, como uma ferramenta MCP e pelos SDKs. Veja referência de operações.

Org — o tenant de nível mais alto; o primeiro elemento da tupla de identidade.

Pinned — uma memória marcada por memory.pin. Uma escrita conflitante com uma memória fixada é rejeitada com 409 PINNED_CONFLICT.

Plane — uma área do produto com suas próprias ops e tabelas: memória, conhecimento, conversa, grafo, código, tracker, runs e tarefas, auditoria.

Procedure — um passo a passo reutilizável (procedure.add / match), armazenado como uma memória do tipo procedural. Veja procedimentos e learnings.

Profile — o contexto permanente de um agente ou usuário (profile.*), carregado primeiro por context.pack.

Projection — uma linha derivada de uma escrita (um embedding, uma aresta de grafo, um resumo). Uma projeção que falha é registrada e tentada novamente (ops.projection_failures.*).

Read scope — read_scope, que limita uma leitura dentro de um namespace: namespace (todas as linhas, o padrão), own_user ou own_session. A claim de um token é um teto que uma requisição pode reduzir, mas não ampliar. Veja identidades e namespaces.

Record — uma memória estruturada validada contra um schema de record registrado (memory_schema.*). Não confundir com um record do tracker.

ReplacingMergeTree (RMT) — o engine do ClickHouse por trás da maioria das tabelas do Loom: uma nova linha de versão substitui a antiga no merge ou na leitura com FINAL, de modo que todo caminho de escrita precisa carregar todas as colunas adiante. Veja ClickHouse.

Residue census — a última etapa de uma erasure saga: uma contagem de linhas vivas no escopo em todas as tabelas que os caminhos de leitura tocam. Qualquer resíduo faz a saga falhar.

Papel — viewer, writer, admin, org_admin, platform_admin, em ordem crescente de privilégio. Cada op declara o mínimo de que precisa.

Run — uma execução de agente, delimitada por run.begin e run.complete, registrando o que ela recuperou e escreveu. Veja execuções.

Sessão — uma conversa ou período de trabalho, o quinto elemento da tupla de identidade; um session brief (session.brief_*) é o resumo salvo dela para retomar depois.

Camada compartilhada — uma linha canônica por (org, namespace, memory_key), promovida a partir das linhas que os agentes escrevem (memory.promote / memory.demote, tabela loom.shared). “Privada” para a outra camada significa não promovida, não oculta.

Source class — a proveniência de uma linha carimbada pelo servidor: asserted, extracted, observed, derived, imported ou external. Uma requisição só pode rebaixá-la.

Camada — qual extrator produziu um fato do índice de código (parser ou compilador); as respostas dizem qual camada as sustenta.

Tombstone — uma linha de versão mais alta que marca uma memória como excluída. memory.restore pode desfazer isso dentro do período de carência; memory.delete não apaga nada fisicamente.

Toolset — a listagem MCP que um cliente solicita (core, coding, atomic, tasks, tracker, readonly, all); ela muda o que é listado, não o que o token pode chamar.

Tracker — o plane que lê os registros de um issue tracker (issues, PRs, execuções de CI) de uma fonte configurada para verificações de duplicatas, bisect e histórico de testes. Veja rastreador.

Trust mode — a política de aceitação que o dono de um inbox define para quem posta; o Loom a armazena e nunca a altera por conta própria.

Valid time — valid_at / valid_to nas memórias (valid_from / valid_to nas entity edges): quando um fato era verdadeiro no mundo. O Loom registra apenas o valid time; não é bitemporal.

Versão — a coluna monotonicamente crescente da qual um ReplacingMergeTree mantém o maior valor; toda escrita de uma memória (inclusive uma exclusão) é uma nova versão.

Worker — um loop de segundo plano supervisionado, registrado como uma linha em server/workers/registry.py (_WORKERS). Veja processos em segundo plano.

Memória de trabalho — blocos de rascunho (working_memory.*) para a tarefa atual: sem embedding, sem ranqueamento, carregados antes da memória durável por context.pack. Veja memória de trabalho e perfis.

Esta página foi útil?