O loop fechado de auto-aprimoramento

O contorno dos três pacotes

Os três subsistemas vivem em packages/hermes/src/: memory/ (o store com snapshot congelado), learning/ (o kernel reviewAndLearn + o gate), e curator/ (a máquina de estados determinística). Nenhum deles faz IO direto: tudo passa por ports injetados (FsPort, Clock, ModelAdapter) — é o que torna cada um testável e composável com o harness, em vez de um daemon solto.

As constantes, direto do arquivo

O delimitador e os limites de caracteres são clonados do Hermes e ficam fixos no código (não dependem do tokenizador de nenhum modelo):

// Entry delimiter — the section sign on its own line.
export const ENTRY_DELIMITER = '\n§\n';
/** Default character limit for the MEMORY.md store (Hermes default). */
export const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
/** Default character limit for the USER.md store (Hermes default). */
export const DEFAULT_USER_CHAR_LIMIT = 1375;

Este subsistema é um CLONE fiel de tools/memory_tool.py. Os desvios são deliberados: o IO é injetado via FsPort e toda operação falível devolve Result<T,Error> em vez de um dict Python.

reviewAndLearn — o kernel

export const reviewAndLearn = async (summary, deps) => {
  if (summary.trim().length === 0) return ok(emptyOutcome());   // "Nada a salvar."
  const proposed = await deps.proposer(summary);
  if (!proposed.ok) return proposed;                          // erro do proposer → fail-closed
  if (proposed.value.length === 0) return ok(emptyOutcome());
  const acc = { applied: [], rejected: [], failed: [] };
  for (const raw of proposed.value) {
    const stepErr = await processOne(raw, deps, acc);   // valida → gate → aplica
    if (stepErr) return stepErr;                            // erro do gate → fail-closed
  }
  return ok({ applied: acc.applied, rejected: acc.rejected, failed: acc.failed });
};

Três cestas de resultado — applied / rejected / failed — então nada some em silêncio. A saída do proposer é validada com Zod na fronteira (em produção é saída de modelo não-confiável). Um erro do proposer ou do gate falha o passo inteiro fechado; já uma recusa da loja a uma escrita aprovada é registrada em failed, nunca lançada.

scoreThresholdGate — o gate conservador padrão

export const scoreThresholdGate = (min = DEFAULT_REVIEW_SCORE_THRESHOLD) => {
  return async (proposal) => {
    const approved = proposal.score >= min;          // fronteira inclusiva: score === min aprova
    const reason = approved
      ? `score ${proposal.score} ≥ threshold ${min}`
      : `score ${proposal.score} < threshold ${min} (learn only from validated wins)`;
    return ok({ approved, reason });                  // puro + total: ok(verdict) para toda entrada
  };
};

O limiar padrão é 0.7 — a codificação mecânica da regra do hermes-mini-loop: "aprenda só com vitórias validadas". Note que a decisão mora em verdict.approved, não no Result: uma rejeição é um ok(...) normal, não um erro.

Tempo é injetado — nunca Date.now()

O tempo é um Clock injetado — nunca Date.now() (a regra de determinismo do motor, e o que torna os testes de transição reproduzíveis). O curator usa o mesmo Clock com que o store de uso foi construído, então um evento registrado "agora" e uma transição decidida "agora" concordam. Os cortes são now - staleAfterMs e now - archiveAfterMs.

// só curator-managed (createdBy === 'agent'), não-pinned, são considerados
if (record.createdBy !== 'agent') { skipped.push(...); continue; }
if (record.pinned)            { skipped.push({ name, reason: 'pinned' }); continue; }
const to = nextState(record, staleCutoff, archiveCutoff);  // terminal = archived