Skip to Content
Pt BrV1GovernançaCaptura de sessões

Captura de sessões

A captura de sessões permite que uma org colete o que seus membros fazem com ferramentas de IA, para que o Lore depois transforme isso em memória compartilhada da org. Ela vem desligada: nada é capturado até que o owner da org a ligue e reconheça a responsabilidade da org pelos dados.

O que é capturado

  • Harnesses: o Claude Code, o Codex CLI e o GitHub Copilot (o Copilot CLI e o alvo de sessão “Copilot” do VS Code, capturados como um só harness, copilot). Outras ferramentas entram quando seus eventos de captura forem verificados. A org pode limitar a captura a alguns harnesses.
  • Copilot: pastas confiáveis. Os hooks do Lore para o Copilot ficam em ~/.copilot/hooks/lore.json. O Copilot só roda os hooks do próprio repositório numa pasta confiável, mas os hooks do Lore, no nível do usuário, rodam em qualquer pasta.
  • Codex: aprove os hooks. O Codex não roda nenhum hook até você aprová-lo em /hooks (hooks de projeto também exigem uma pasta confiável). O lore hooks install lembra disso, e o lore hooks status avisa quando os hooks do Codex estão instalados mas nunca rodaram.
  • O quê: os turnos de cada sessão (suas mensagens e as respostas da IA), a partir do transcript da própria ferramenta na sua máquina, só nos projetos que a org incluir (comparados pelo remote do git).
  • Quando: no fim de cada turno e quando a sessão termina, pelo lore hook capture. Um lore sync em segundo plano envia o que foi capturado.

A redação acontece na sua máquina

Antes de qualquer coisa ser gravada no spool local ou enviada, o lore remove segredos com as regras do gitleaks e o pacote de regras do próprio Lore, mais as regras que a sua org acrescentar. Nada sem redação sai da sua máquina.

Retenção e quem vê o quê

MembroOwner da org
A política de captura da orgsimsim, e edita
As próprias capturassimsim
Capturas de outros membrosnãosim, com IPs de envio
Apagar capturasas próprias, se a org permitirqualquer uma
O texto das regras de redação da orgsó quantas sãosim

As capturas brutas ficam guardadas pela retenção da org (de 7 a 30 dias, 14 por padrão) e depois são apagadas automaticamente.

A responsabilidade da org

A sua organização decide capturar e é a controladora dos dados dos seus membros. Ela precisa ter uma base legal para a captura, por exemplo sob a LGPD, e informar os seus membros. O Lore fornece os mecanismos: opt-in no nível da org, redação na máquina do membro, retenção limitada e visibilidade. Se a org ativar a destilação, as capturas viram registros de memória na máquina do membro, pela própria ferramenta de IA da org e sob o contrato da org com o fornecedor dela, e aguardam a revisão da org, a menos que ela escolha o contrário.

Para ligar a captura, o owner da org precisa reconhecer essa declaração no painel. Todo membro vê quem reconheceu e quando.

Armazenamento das capturas

As capturas contam no armazenamento do plano da org, numa reserva de capturas: uma fatia do armazenamento do plano separada para as capturas e para os candidatos a memória destilados delas. Namespaces e memória da org não usam essa fatia, e as capturas não usam a deles.

  • Quando o owner liga a captura pela primeira vez, a reserva fica em 20% do armazenamento do plano, ou menos se os namespaces já ocupam mais. O owner pode mudá-la na política de captura, desde que caiba ao lado dos namespaces.
  • A página Captures mostra quanto da reserva está em uso, com um aviso aos 90%.
  • Quando a reserva enche, novas capturas são recusadas, mas nada é apagado. As capturas esperam no spool da máquina de cada membro, o lore hooks status mostra “capture storage full”, e os envios voltam quando a retenção libera espaço ou o owner aumenta a reserva.

Veja Armazenamento e cotas para o pool de armazenamento completo.

Ligando a captura (owner da org)

  1. No painel, abra a página Captures da sua org.
  2. Em Edit capture policy, escolha os projetos (globs como dev.azure.com/acme/*), os harnesses, a retenção, regras de redação extras e se os membros podem apagar as próprias capturas.
  3. Ligue a captura, marque o reconhecimento e salve.

Os membros com os hooks instalados começam a capturar na próxima sessão. O lore hooks install acrescenta os hooks de captura quando a política da org está ligada.

Vendo as suas capturas (todo membro)

No painel, a página Captures da org mostra a política e as suas capturas, turno a turno. Pelo terminal:

lore captures policy --org <sua-org> # a política e a declaração lore captures ls --org <sua-org> # os seus lotes de captura lore captures show <id> --org <sua-org>

O lore hooks status diz se cada uma das suas orgs captura e mostra um aviso uma vez sempre que a política de uma org muda.

Das capturas à memória da org (destilação)

A destilação transforma capturas em registros de memória curtos e atômicos: decisões e seus porquês, fatos não óbvios sobre os sistemas da org, correções e procedimentos que funcionaram. Ela fica desligada até o owner da org ligá-la.

Onde roda. Na máquina de cada membro, depois que as capturas dele são enviadas: o lore sync executa, em modo não interativo, o harness escolhido pela org para ler a captura e propor registros:

  • Claude Code: claude -p, sem ferramentas, sem servidores MCP e sem configurações do projeto.
  • Codex CLI: codex exec --ephemeral --ignore-user-config -s read-only, sem sessão salva, sem hooks nem servidores MCP do usuário, e com sandbox somente leitura numa pasta vazia. Deixe o modelo vazio para usar o padrão do Codex.

O GitHub Copilot não destila: o modo não interativo dele roda os seus hooks e guarda a sessão. As capturas do Copilot são destiladas pelo harness escolhido pela org, como as demais, então uma org que só usa o Copilot pode capturar, mas não destilar.

Não há chave de API para criar: o harness faz login como sempre, e o Lore nunca lê nem guarda as credenciais dele. Os hooks do próprio Lore não fazem nada dentro da chamada, então uma destilação nunca é capturada.

Pré-requisito de TI. A destilação usa o assento do membro no harness escolhido, então ele precisa estar logado na conta da org, não numa conta pessoal. No Claude Code, garanta isso com a configuração gerenciada forceLoginOrgUUID. No Codex, defina forced_login_method = "chatgpt" e forced_chatgpt_workspace_id na configuração gerenciada dele. As duas são distribuídas por MDM, como os hooks gerenciados.

O que a org decide. Na página Captures, o owner define:

  • quais categorias manter e quais descartar;
  • termos bloqueados: nomes, domínios, codinomes ou qualquer outra coisa que nunca pode aparecer num registro (clientes, parceiros, projetos internos). Eles entram no prompt, que instrui o modelo a não mencionar nem os termos nem detalhes que identifiquem a que se referem, e um filtro na máquina do membro e de novo no Registry descarta qualquer registro que cite um deles. A máquina de cada membro precisa dessa lista, então os membros conseguem lê-la;
  • o modelo, quantos registros por chamada e quantos registros existentes são mostrados ao modelo para evitar duplicatas;
  • um teto mensal de caracteres de entrada por membro;
  • revisão: por padrão, todo registro aguarda o owner na página Memory Review. “Gravar direto” é recusado enquanto a org exigir aprovação.

O que o membro vê. Cada lote na página Captures lista os candidatos destilados dele e o estado de cada um. O membro pode descartar os próprios candidatos pendentes: antes da revisão eles ainda são captura dele, não memória da org. Apagar uma captura também descarta os candidatos pendentes dela.

Registros aprovados viram memória comum da org, com o membro capturado como autor e o harness como plataforma, marcados com a tag source:capture. Cada um mantém sua categoria e o projeto em que foi capturado. Ao aprovar, o owner pode corrigir a categoria. Só registros destilados têm essa tag, então From captures na página Memory (ou lore_memory_list com essa tag) mostra exatamente eles. Os registros aprovados permanecem quando a captura expira.

A página Memory Review também mostra, por categoria, quantos registros o owner aprovou e rejeitou nos últimos 30 dias. Uma categoria quase sempre rejeitada é candidata a sair da política.

Status na sua máquina. O lore hooks status mostra, por org, o harness e a versão da destilação, quantos deltas estão na fila e a entrada do mês contra o teto. O lore captures ls mostra o estado de destilação de cada delta. Os deltas esperam cerca de 10 minutos a sessão assentar, e então os turnos de uma sessão são destilados juntos. Um delta sem nada que você tenha digitado é pulado sem chamada.

Ligar a destilação exige reconhecer a versão 2 da declaração de responsabilidade. A captura continua funcionando enquanto o reconhecimento estiver desatualizado; a destilação espera por ele.

Lendo a memória da org

Todo registro tem uma categoria opcional, mostrada no painel com um rótulo simples:

CategoriaRótuloO que guarda
proceduresHow topassos que funcionaram
correctionsPitfallso que parecia certo e estava errado
decisionsDecisionso que foi escolhido e por quê
system-factsFactscomo os sistemas da org realmente se comportam

Registros destilados de capturas também levam o projeto: o repositório em que foram capturados. A página Memory tem três visões:

  • Browse (padrão): registros agrupados por projeto e depois por categoria, com o conteúdo completo. Filtre por projeto, categoria ou origem; cada visão filtrada tem sua própria URL.
  • Página do projeto: tudo o que a org sabe sobre um repositório, por categoria. Uma boa primeira leitura para quem está chegando ao projeto.
  • Overview: uma matriz projeto × categoria com contagens, e o que foi adicionado ou atualizado por categoria nos últimos 7 e 30 dias. Nunca conta nem ranqueia pessoas.

O grafo de wikilinks foi para a aba Graph. Registros destilados de capturas ainda não se ligam entre si, então o grafo mostra poucas arestas.

As ferramentas de IA usam a mesma classificação: lore_memory_store aceita category e project opcionais, e lore_memory_list e lore_memory_search filtram por eles (category: none lista os registros sem categoria).

Registros gravados antes das categorias não têm uma. O owner da org pode preenchê-los uma vez com lore memory reclassify, que roda na máquina do owner, como a destilação.

© 2025 Lore · Built by M1 Cloud