Pular para o conteúdo

Guias

Memória e continuidade

Passe contexto com origem e recupere detalhes quando forem necessários.

Declare a origem da medida

O gate de tokens distingue uso reportado, estimado, informado e indisponível. Ausência de medida não é zero. Consulte o gate antes do próximo bloco; não decida a rotação com um número inventado.

ork gate next <thread> --proximo GO

Três níveis de contexto

O conteúdo crítico entra diretamente no handoff. O importante vira ponteiro com condição de recuperação. O resumível recebe um resumo com proveniência. Cada item mantém origem, localização e hash; mudanças na fonte precisam ser percebidas antes de confiar no contexto antigo.

ork handoff export <thread> --proxima-fase GO
ork recall <thread> --fase CHECK

Memória indisponível

OrkMind é uma integração de memória, não uma autoridade de gate. Quando indisponível, o modo efetivo e a degradação devem ser explícitos. Consulte ork memory status antes de afirmar que o contexto foi persistido ou recuperado.

O ork memory status mostra o regime pedido no manifesto e o efetivo, o tenant, a variável da base, se a DSN está no ambiente (sem imprimir o valor) e o CLI do OrkMind. Em regime files, a degradação sai como modo.files, com a correção para ligar a memória semântica: memory.mode: orkmind e a fonte da DSN no manifesto, em memory.database_url_env ou memory.database_url_file. O ciclo não para por isso: o handoff continua triado em três níveis, e o ork recall continua resolvendo os ponteiros.

ork memory status

A DSN fora do ambiente dos agentes

Com memory.database_url_env, a DSN mora no ambiente do processo e chega ao ambiente de toda sessão de agente que a herda. A segunda fonte tira a DSN de lá: memory.database_url_file aponta o caminho de um arquivo na pasta de segredos do ork, lido no momento do uso.

As duas fontes são exclusivas: declarar database_url_file e database_url_env reprova o manifesto, e o ork nunca cai de uma para a outra. O caminho aceito é ~/.orkastery/segredos/<nome>, sem subpasta; o arquivo é comum, do usuário que roda o ork, com permissão 0600 ou 0400, até 4 KiB e uma linha só com a DSN. Nenhuma pasta do caminho pode ser link simbólico, e cada uso lê o arquivo de novo.

Arquivo ausente, inseguro ou inválido leva o regime a files, com dsn.arquivo-ausente, dsn.arquivo-inseguro ou dsn.arquivo-invalido e a correção. A resposta de um processo filho que repita a DSN ou a senha dela é recusada inteira, com memory.transport.secret. O ork memory status mostra a fonte sem o valor, e o ork doctor avisa sobre a fonte da DSN e sobre a DSN ainda exportada no ambiente de uma sessão despachada.

memory:
  mode: orkmind
  tenant: orkastery
  database_url_file: "~/.orkastery/segredos/orkastery.dsn"

ork memory status

Busca por significado

A busca por tag continua sendo o caminho determinístico: é ela que monta o prompt, o recall e o handoff. A busca por significado é uma superfície separada, que acha por paráfrase o que a tag e a palavra exata não acham. Cada resultado sai marcado deterministico: false, e nada semântico entra no prompt sozinho.

Ela fica desligada até o manifesto declarar o bloco memory.embedding, com provider, modelo, dimensão e o nome da variável da chave, nunca o valor. O índice vetorial é local, derivado do tenant e fora do git; reindexar sem mudança não embeda nada. O texto indexado e cada consulta saem para o provider configurado: use uma chave dedicada, com limite de crédito. A estimativa de tokens e custo não é fatura. Sem embeddings, o motivo é embeddings.*, e o regime orkmind e o recall por tag seguem iguais.

Índice, vetor, FTS e ork memory status usam o mesmo universo da busca: as entradas ativas do tenant nas coleções do ork, sem as que a biblioteca marca com injection_risk. Entrada de outro tenant ou de outra coleção é falha tipada (memory.query.scope-violation), nunca descarte silencioso, e não vai ao embed. Quando a janela de leitura enche, a resposta é memory.query.window-saturated em vez de cortar, e o ork memory index sai 1 sem embedar nada.

O status e o index mostram o universo por coleção e contam, só em número, o que fica fora da busca: entradas com injection_risk, expiradas e de outras coleções, como session e semantic_log. A cobertura é a dos vetores contra esse universo; o aviso de reindexar só aparece quando reindexar resolve, e a entrada fora do índice por desenho é contada à parte.

ork memory status --sondar
ork memory index --dry-run --json
ork memory index
ork memory search --texto "trocar de conta quando acaba a cota" --json