CajaValentia

Software de control para la caja conductual CMC/Valentia. Conserva el programa MATLAB R2011a original, una base depurada y el historial de mejoras experimentales.

Este es software de laboratorio que controla estimulos, recompensas y registro conductual. No se debe operar hardware sin una persona entrenada presente frente a la caja.

Proposito

• Operar tareas conductuales de la caja Valentia.
• Preservar una historia auditable desde el programa original hasta las mejoras actuales.
• Permitir cambios revisables sin mezclar datos de animales ni archivos de sesion con el codigo.

main contiene la base restaurada de ValentiaE: comportamiento previo mas reloj de habituacion y aviso LED final. El codigo historico se conserva para auditoria, no para operar. Antes de ejecutar una tarea, leer el comportamiento real y sus limites.

Estado Actual

Referencia	Uso
main	Base R2011a Restaurada, fuente activa; reloj de habituacion y aviso LED, sin la logica experimental retirada.
v2.0.0-rc.4-discriminacion-validada	Foto historica de V2.4: sonido solo, CSV de 10 columnas y contador de ensayos de cruce. No describe main.
feature/cp-time-aware-sound-only	Cruces Peligrosos en desarrollo; no esta validada ni fusionada.
legacy/	Copia original de fsotres, solo lectura.

La historia y los nombres oficiales viven en docs/version-map.md. V0 es el original; V1 es la base limpia R2011a; V2.4 es una referencia historica. Ninguna de las versiones antiguas es una instruccion de uso diario.

Estructura

Ruta	Contenido
matlab/	Paquete ejecutable actual para MATLAB R2011a.
legacy/	Archivo original V0, solo lectura.
docs/	Manuales, decisiones, arquitectura y bitacoras de validacion.
tests/	Pruebas de logica sin hardware.
handoff/	Paquetes de trabajo acotados para colaboradores.

Colaborar

1. Lee AGENTS.md y la documentacion relevante antes de editar.
2. Crea una rama; no edites main ni una etiqueta de version directamente.
3. Describe primero el cambio conductual y ejecuta las pruebas sin hardware.
4. Para cambios que toquen la caja, documenta version de MATLAB, equipo y resultado de la prueba fisica.

La guia completa esta en CONTRIBUTING.md. El paquete para el rediseño GUIDE esta en handoff/eric-gui-redesign.

Acceso Y Licencia

El acceso al repositorio se concede solo a colaboradores del proyecto. Aun no se ha asignado una licencia de distribucion: no se asume permiso para reutilizar o redistribuir el codigo fuera del equipo sin autorizacion explicita.

Leer Primero

1. Handoff para un agente nuevo.
2. Comportamiento actual y limitaciones.
3. Indice de documentacion.
4. Mapa de versiones.
5. Reglas de seguridad y edicion.
6. Handoff para rediseño GUIDE.

Seguridad

No operar hardware ni probar una version no validada sin una persona entrenada frente a la caja. No subir a Git resultados de sesion, datos de animales ni archivos generados. legacy/ no se limpia ni se modifica.