Worktrunk: árboles paralelos, ciclo de vida y análisis del código
Diseña un informe de preparación para Worktrunk sin ejecutar acciones
Crea un ejercicio pequeño sobre ramas, configuración y riesgos pendientes que no apruebe hooks, fusione código ni elimine árboles.
Qué aprenderás
- Reduce incertidumbre antes de añadir autonomía
- Define entrada y salida antes de elegir interfaz
- Las pruebas deben impedir que el informe se convierta en operador
Antes de empezar
- Ramas Git y navegación básica por terminal
- Un repositorio desechable para ejercicios opcionales
Explicar límites del árbol, verificar un primer checkout y revisar comandos antes de automatizar.
Conclusiones clave
- El informe es una propuesta editorial, no una función upstream.
- Desconocido debe conservarse como estado propio.
- Un informe no debe convertirse silenciosamente en ejecutor.
Reduce incertidumbre antes de añadir autonomía
Un proyecto abordable es un informe de preparación, no otro botón de fusión autónoma. Recibe un inventario capturado y un resumen de configuración revisado manualmente; devuelve decisiones pendientes sobre responsable, puerto, revisión de hooks y conservación. Es una propuesta editorial de aprendizaje, no una función incluida ni una hoja de ruta anunciada por Worktrunk.
Empieza con datos sintéticos. La herramienta debe leer únicamente registros proporcionados y escribir un informe: nada de descubrir secretos personales, aprobar comandos, contactar modelos o ejecutar hooks. El modo sin conexión permite revisar resultados y separa la corrección del informe de los peligros de actuar sobre un repositorio real.
Define entrada y salida antes de elegir interfaz
Cada registro necesita rama, ruta, responsable, puerto opcional, revisión de configuración y campos de revisión de tres estados. Desconocido no equivale a falso: no observar limpieza no prueba que haya cambios, y no encontrar riesgos no demuestra seguridad. Separa evidencia ausente de conflictos confirmados, como dos registros con el mismo puerto.
Comienza con texto o JSON legible y comprobable. Un SVG puede mostrar servicios compartidos y responsables sin exigir JavaScript. Three.js solo se justificaría por una interacción espacial concreta; un gráfico pequeño no se vuelve más exacto al hacerlo tridimensional. Una futura vista interactiva debe conservar contenido estático accesible.
Las pruebas deben impedir que el informe se convierta en operador
Usa entradas con puertos repetidos, estado desconocido, rutas parecidas y revisión cambiada. Exige hallazgos deterministas que identifiquen registro y evidencia ausente. Comprueba además que generar el informe no provoque procesos, red, mutación de aprobaciones o eliminación. Son pruebas propuestas para la extensión, distintas del modelo didáctico de aprobación de esta serie.
Una integración posterior puede consumir un inventario documentado tras revisar compatibilidad de versión y rutas. La ejecución debe seguir siendo una acción explícita e independiente del usuario: un informe verde no autoriza fusionar o borrar. El ejercicio enseña modelado de evidencia y límites operativos incluso sin integrar todavía Worktrunk real.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Define registros sintéticos de rama, ruta, responsable y puerto.
- 2
Separa evidencia ausente y conflicto confirmado.
- 3
Prueba resultados deterministas sin acciones externas.
- 4
Revisa compatibilidad antes de integrar el programa real.
Ejemplo para copiar
{
"proposal": true,
"records": [
{
"branch": "demo-review",
"path": "/example/review",
"owner": null,
"port": 3000,
"clean": null,
"configRevision": null
}
],
"findings": [
"responsable no registrado",
"limpieza no observada",
"falta revisión de configuración"
],
"executeActions": false
}Preguntas frecuentes
¿Worktrunk ya incluye esta extensión?
No. Se propone aquí como ejercicio de aprendizaje.
¿Hace falta Three.js?
No. JSON, texto y SVG accesible bastan para las relaciones propuestas.
Fuentes
- Worktrunk / docs/src/content/docs/config.mdFuente verificada 2026-09-14
- Worktrunk / docs/src/content/docs/list.mdFuente verificada 2026-09-14
- Worktrunk / docs/src/content/docs/hook.mdFuente verificada 2026-09-14