orch-refine-code

¿Qué hace orch-refine-code?

Actor · acción · objetivo: orch · refine · code. Envoltorio ligero sobre el motor compartido en orch-pipeline.

Cuándo usarlo

• Mismo comportamiento, mejor estructura: extraer módulos, eliminar duplicación, eliminar código muerto, reducir anidamientos, renombrar para mayor claridad.
• Distinguir de sus gemelos: si el comportamiento debe cambiar de alguna manera, esta es la habilidad incorrecta (orch-change-feature / orch-fix-defect).

Configuración de la operación

• Tamaño mínimo predeterminado: estándar — las reestructuraciones afectan múltiples archivos.
• Máscara de fase: 0 → 2 (planificar la reestructuración) → 4 (mantener en verde) → 5 → 6. No se escriben nuevas pruebas de comportamiento; el conjunto de pruebas existente es la red de seguridad.
• Primer movimiento (fase 4): confirmar que las pruebas relevantes existen y están en verde antes de tocar el código; si la cobertura es escasa, agregar primero pruebas de caracterización. Luego reestructurar en pequeños pasos, volviendo a ejecutar las pruebas después de cada uno.

Cómo funciona

1. Ejecutar el motor orch-pipeline con la configuración anterior.
2. Para limpiezas de código muerto/duplicación, delegar en el agente refactor-cleaner (ejecuta knip / depcheck / ts-prune y elimina de forma segura).
3. Detenerse en Puerta 1 (plan de reestructuración) y Puerta 2 (pre-commit).
4. Realizar commit como refactor: — el diff debe ser neutral en cuanto al comportamiento.

Ejemplo

orch-refine-code: extraer el cliente HTTP de NWS del archivo poller.py
→ confirmar pruebas en verde → planificar extracción  [PUERTA 1: aprobar]
→ mover en pequeños pasos, pruebas en verde durante todo el proceso → revisión de código
→ commit refactor:  [PUERTA 2: confirmar]