Skip to content

Observer roBrowser, descoberta por build e robustez do relay - #22

Merged
lavinsky merged 5 commits into
mainfrom
feat/ro-browser-observer-20261021
Oct 28, 2026
Merged

lavinsky merged 5 commits into
mainfrom
feat/ro-browser-observer-20261021

Conversation

@lavinsky

@lavinsky lavinsky commented Oct 21, 2026 •

Copy link
Copy Markdown
Owner

O relay passa a disponibilizar o fluxo verificado para um observer roBrowser, com assinatura ao vivo ou replay, e ganha descoberta de cliente por PE/RTTI, perfis por build e ferramentas opcionais de investigação. A descoberta de memória usa leituras limitadas e o processo mantém exclusividade de acesso à porta do Frida Gadget.

Comparação com main (f311d67): 41 arquivos, 3174 inserções e 257 remoções. Head: 3572e70. Os quatro commits novos publicam as alterações locais que ainda não estavam no GitHub; o commit original deste PR foi preservado.

Commits, em ordem

  1. 51181b9 — feat(relay): add read-only roBrowser observer
    Adiciona observer via socket UNIX privado, seleção de fase login/char/map, histórico limitado e integração ao fluxo já entregue ao OpenKore. Inclui launcher de reinício, documentação e testes. O observer não encaminha comandos do navegador ao jogo.

  2. e003d05 — feat(relay): add build profiles and client discovery tooling
    Extrai endereços nativos para profiles/uaro-f2f25a89.json, com fingerprint e verificação opcional do executável via --client-exe. Acrescenta parser PE/RTTI, descoberta estática, fallback por perfil exato e ranking comportamental offline. Integra wizard opcional, correlação de traces, sondas de execução por hardware e backends experimentais gepard-wrapper/player-vtable; legacy continua padrão. Ajusta CLI, mensagens e writeback, e documenta os resultados e limites já registrados localmente. Preserva inject = true e inject-call = true.

  3. 59180d3 — fix(relay): bound ring scans and remove historical queue fallback
    Extrai validação estrutural dos atores para módulo próprio e pesquisa mappings em janelas sobrepostas de até 1 MiB, mantendo o contexto de pontuação. Remove o endereço histórico da fila de envio: o modo automático aguarda o ring verificado na sessão corrente, ou o operador fornece faixa explícita. Inclui regressões de descoberta e contratos de borda.

  4. d44cac9 — fix(agent): enforce a single relay per Frida gadget port
    Usa lock não bloqueante antes de attach(), rejeita um segundo relay e libera o lock em falhas de inicialização. No encerramento normal, descarrega o script e desanexa a sessão antes de liberar a propriedade. Inclui teste de exclusividade.

  5. 3572e70 — feat(observer): support live subscriptions without history replay
    Acrescenta seletores minúsculos l/c/m para começar no fluxo atual; L/C/M mantêm replay. O launcher configura o socket privado, permite desativá-lo por variável de ambiente e remove pathname obsoleto após verificar ausência de listener. Inclui teste da assinatura sem histórico.

Validação

  • PASS — bash scripts/test-offline.sh: 42 scripts. Executado fora do sandbox porque a primeira tentativa teve criação de sockets locais bloqueada.
  • PASS — python3 scripts/validate-research.py.
  • PASS — python3 scripts/validate-codex.py.
  • PASS — git diff --check.
  • PASS — node --check agent/relay_hook_linux.js.
  • PASS — bash -n run.sh.
  • NOT RUN — cliente real, instrumentação live ou ações em servidor externo nesta preparação do PR.

Limites para revisão

As notas de observação live em docs/CLIENT_DISCOVERY.md e no perfil são registros preexistentes nas alterações locais, não resultados reproduzidos nesta revisão. A verificação do fingerprint no fluxo normal depende de fornecer --client-exe; carregar o perfil padrão isoladamente não verifica o processo conectado. Candidatos comportamentais não são promovidos automaticamente a dispatchers chamáveis. Os backends alternativos permanecem experimentais; o wrapper começa em captura apenas, com disparo explícito e limite de chamadas. O wizard usa Stalker quando acionado: a documentação registra crash no build protegido e recomenda hardware breakpoints para esse build. A cifra continua sem solução demonstrada por estas alterações.

@lavinsky lavinsky changed the title Observer read-only para roBrowser com replay seguro e documentação consolidada Observer roBrowser, descoberta por build e robustez do relay Oct 28, 2026
@lavinsky
lavinsky merged commit 0fca2cc into main Oct 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant