Contribuir

0vas / hyperion

Código, incidencias y contribuciones en un solo lugar.

Abrir repositorio en GitHub

Ver incidenciasNormas de contribución

Hyperion es independiente y está disponible bajo licencia MIT. Las mejoras deben funcionar sin depender de un único proveedor de IA.

Preparar el proyecto

Estas instrucciones son para desarrollo. Para usar Hyperion, empieza por la guía de instalación.

git clone https://github.com/0vas/hyperion.git
cd hyperion
npm ci
npm run check

Requiere Node.js 22.13 o superior. Define primero el comportamiento esperado y una prueba que falle; implementa el cambio y verifica el resultado.

Validar una contribución

npm run check
npx playwright install chromium
npm run test:e2e

Para cambios visuales, comprueba temas claro/oscuro, navegación con teclado y ventanas estrechas. Para protocolo, mantén las reglas compartidas en src/domain/.

Nunca incluyas .hyperion/, respuestas reales, tokens ni trazas privadas en una contribución. Usa datos sintéticos para ejemplos y pruebas.

Editar este sitio

npm --prefix docs/site ci
npm --prefix docs/site run dev

El contenido está en docs/site/, escrito en Markdown. La navegación vive en .vitepress/config.mts. Usa enlaces relativos entre páginas y comprueba el sitio con su prefijo /hyperion/.

npm --prefix docs/site exec -- playwright install chromium
npm --prefix docs/site test

La versión de VitePress está fijada en el lockfile. Se usa la línea 2 en preview, con Vite actualizado; sus cambios se validan de forma independiente a la aplicación.

Normas de contribución · Seguridad

Idiomas y arquitectura

El español conserva las rutas actuales. El inglés vive en en/ con las mismas rutas de página: el selector de idioma mantiene la ubicación. Traduce contenido, navegación y búsqueda; los enlaces técnicos pueden apuntar a fuentes del repositorio en su idioma original.

Para añadir otro idioma, crea sus páginas equivalentes, registra el locale en .vitepress/config.mts y amplía las pruebas de navegación, búsqueda y accesibilidad. Mantén las mismas limitaciones y versiones de instaladores en todas las traducciones.

Las fuentes de Archify y sus instrucciones de regeneración están en docs/architecture/archify. La marca SVG original se encuentra en docs/site/public/brand/.