brahman/docs/changelog/misc.md

Changelog — misc

Entradas que no encajan en otro proyecto (chore, ci, gitignore, etc.).

chore(.gitignore): excluir .claude/ (state local de Claude Code)

Iter 18. Side cleanup tras debugging: .claude/ aparecía en git status cada sesión (contenía scheduled_tasks.lock y settings.local.json, ambos local-only). Excluido para que no se commitee accidentalmente y para que git status quede limpio.

Investigación previa que motivó el cleanup: persiguiendo un supuesto deadlock en drift_check_surfaces_expected_per_record_diffs con eprintlns/macro de log a archivo en drift.rs y run.rs. Conclusión: no hay deadlock — pasa cleanly aislado, en suite nakui-core, y en cargo test --workspace. El "hang" original venía de procesos cargo y test-binaries huérfanos de sesiones anteriores compitiendo por el build lock. Source restaurado, ningún cambio funcional. Memoria project_drift_hang.md reescrita con el playbook correcto.

feat(explorer+daemon): discovery dinámico vía broker + query socket

La UI deja de hardcodear el socket admin: ahora descubre al daemon nouser vía MatchEvent::Available del broker brahman y le consulta sus Mónadas directo, sin pasar por brahman-admin. Cierra el "explorer encuentra al daemon de forma totalmente dinámica" del meta-plan.

Pipeline end-to-end:

• Daemon publica engine Card con service_socket = $XDG_RUNTIME_DIR/nouser-engine.sock y flow.output = monad-list:json.
• Daemon binda un Unix socket en ese path y monta un listener blocking que sirve nouser_card::query::QueryRequest::ListMonads, responde ListMonadsResponse { engine, monads: Vec<MonadView> }.
• Explorer construye un consumer Card con flow.input = monad-list:json vía brahman_sidecar::build_consumer_card, llama await_provider_blocking(card, 3s) y recibe el socket descubierto.
• Cachea ese socket; cada poll (2s) llama nouser_core::engine_socket::client::list_monads(socket, 2s). Fallo de query → invalida cache → próximo tick re-descubre.

Wire types nuevos en nouser_card::query:

• QueryRequest::ListMonads (single variant por ahora).
• ListMonadsResponse { engine: EngineInfo, monads: Vec<MonadView> }.
• MonadView: proyección slim de MonadManifest SIN centroid ni members — la UI no los necesita y eran KB por Mónada que no tenían por qué viajar cada poll.
• transport::default_socket_path() con env override NOUSER_ENGINE_SOCKET.
• Const FLOW_MONAD_LIST = "monad-list", FLOW_TYPE_NAME = "json".

Listener en nouser_core::engine_socket:

• spawn_listener(config, db) arma std::os::unix::net::UnixListener en thread blocking dedicado. Frecuencia esperada (UI cada 2s) no amerita tokio.
• client::list_monads(socket, timeout) — cliente blocking con QueryError tipado (Connect / Io / Serde / Daemon / Timeout / Empty).
• 3 tests integración: roundtrip vacío, Mónadas reales, request inválido devuelve ErrorResponse.

Refactor explorer:

• Drop dep brahman-admin, add deps brahman-sidecar, nouser-card, nouser-core.
• State: socket: Option<PathBuf> cache + snapshot: Option<ListMonadsResponse>
  • socket_source: "discovery"|"cache" (sólo informativo).
• Tick: tick(prior_socket) separado del UI, devuelve un enum TickOutcome::{Ok, DiscoveryFailed, QueryFailed}. Cualquier fallo invalida la cache → re-discovery automática.
• Header reformulado: Engine 'nouser_engine' · N mónada(s) · socket: /... (cache|discovery) · watching: /tmp/x.
• Render pintado de un engine card + Mónadas, sin ya iterar BrokeredCard del admin.

Trade-offs aceptados:

• Polling 2s (no streaming). El broker no empuja cambios de Data cards hoy; agregar streaming requiere extender el protocolo handshake. Para snapshot UI, polling 2s es suficiente.
• Re-descubrimiento full en cada error de query (en lugar de retry con backoff). Discovery es barato (~ms vs broker), no vale la pena la complejidad.

Tests: 10 (nouser-card, +3 query) + 27 (nouser-core, +3 engine_socket)

• 4 (sidecar) verdes. Explorer compila clean.