Skip to content

style(bd): nodos cuadrados 60x60, labels independientes, selección dashed-box, fix precedencia #72

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
anlaco merged 3 commits into from
Apr 22, 2026
Merged

style(bd): nodos cuadrados 60x60, labels independientes, selección dashed-box, fix precedencia #72

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1b58dda
docs: TCP API y Red-Lang skill para Fase 4
anlaco Apr 20, 2026
ce64e5f
docs(fase-4): reenmarcar #19/#20/#22 como TCP/USBTMC genérico (sin SCPI)
anlaco Apr 20, 2026
d8128f3
style(bd): nodos cuadrados 60x60, labels independientes fuera del nod…
anlaco Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 27 additions & 30 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Telekino — Contexto para Claude Code
# QTorres — Contexto para Claude Code

> Última actualización: 2026-04-20

Expand All @@ -22,10 +22,10 @@ Estas reglas son inviolables. No importa qué Issue estés implementando ni qué

## Qué es este proyecto

Telekino es una alternativa open source a LabVIEW construida íntegramente en Red-Lang. El usuario construye programas arrastrando bloques y conectándolos con wires, igual que en LabVIEW. Al guardar, Telekino genera un fichero `.qvi` con código Red/View completo que al ejecutarse muestra el Front Panel como una ventana, igual que LabVIEW.
QTorres es una alternativa open source a LabVIEW construida íntegramente en Red-Lang. El usuario construye programas arrastrando bloques y conectándolos con wires, igual que en LabVIEW. Al guardar, QTorres genera un fichero `.qvi` con código Red/View completo que al ejecutarse muestra el Front Panel como una ventana, igual que LabVIEW.

**Nombre:** Telekino (por Torres Quevedo)
**Repositorio:** https://github.com/anlaco/Telekino
**Nombre:** QTorres (por Torres Quevedo)
**Repositorio:** https://github.com/anlaco/QTorres
**Backlog:** https://github.com/users/anlaco/projects/1

## Stack tecnológico
Expand All @@ -43,7 +43,7 @@ Sin dependencias externas. Un solo binario. Funciona en Linux, Windows y macOS.
## Estructura del proyecto

```
Telekino/
QTorres/
├── CLAUDE.md # Este fichero — contexto principal para IA
├── README.md
├── docs/
Expand All @@ -53,11 +53,11 @@ Telekino/
│ ├── PLANNING.md # Decisiones pendientes críticas
│ ├── retos.md # Riesgos y dificultades
│ ├── visual-spec.md # Especificación visual (documento vivo)
│ ├── tipos-de-fichero.md # Mapeo LabVIEW → Telekino
│ ├── tipos-de-fichero.md # Mapeo LabVIEW → QTorres
│ ├── labview-comportamiento.md # Arquitectura LabVIEW: renderizado, modos, estilos
│ └── GTK_ISSUES.md # Bugs del backend GTK en Linux
├── src/
│ ├── telekino.red # Punto de entrada + toolbar + ventana principal
│ ├── qtorres.red # Punto de entrada + toolbar + ventana principal
│ ├── graph/
│ │ ├── model.red # Modelo: make-label, make-node, make-wire, make-fp-item, set-config, find-node-by-id (635 líneas)
│ │ └── blocks.red # Registro de bloques + dialecto block-def — 40 bloques
Expand Down Expand Up @@ -126,20 +126,17 @@ Telekino/
- ~~#64 FP como ventana maestra~~ ✅ (FP=blocking master, BD=no-wait slave, Ctrl+E toggle, títulos sincronizados, current-file en app-model)
- ~~#65 Scroll en BD y FP~~ ✅ (ventanas fijas 900x600, scroll wheel + click scrollbar, límites por contenido real)

**Fase 4 — Hardware (en curso):**
- ~~#19 TCP/IP — bloques básicos cliente~~ ✅ (tcp-open/write/read/close estilo LabVIEW, session-through por connection refnum, verificado con socat)

**Fase 5 — UX y gestión de proyectos (planificado):**
- Splash / Welcome screen (Create New VI, Open Existing, proyectos recientes)
- Project Explorer con formato .qproj (árbol de ficheros, gestión de dependencias)
- Depende de: .qlib (#18) ✅ y FP como ventana maestra (#64) ✅
- **Nota:** Prototipo temprano de `.qproj` existe en `examples/ejemplo.qproj` — sirve como referencia del formato, pero sin tooling de Project Explorer aún

**Próximo paso:** seguir Fase 4 (#20 USBTMC, #21 Serie, #22 Modbus/servidor TCP, #23 DAQ) → Fase 4.5 (integración red-sg) → Fase 5 (UX)
**Próximo paso:** Fase 4 (hardware) → Fase 4.5 (integración red-sg) → Fase 5 (UX)

**Refactor 4B ✅ COMPLETADO (2026-04-17):** `compiler.red` (1255 → 18 líneas orquestador + 5 módulos) y `file-io.red` (939 → 17 líneas orquestador + 4 módulos). Todos los módulos <400 líneas excepto `file-io-serialize.red` (468) por `format-qvi` monolítica. 482/482 tests PASS. Ver `docs/refactor-4b-plan.md` para el plan original.

**Prioridad:** Fase 4 hardware antes que Fase 5 UX. Un Telekino que habla con instrumentos reales es más valioso que uno con undo/redo pulido. La Fase 4.5 (red-sg) se sitúa entre ambas como puente natural de la separación aplicación/toolkit (ver DT-030 y `docs/roadmap-9-10.md`).
**Prioridad:** Fase 4 hardware antes que Fase 5 UX. Un QTorres que habla con instrumentos reales es más valioso que uno con undo/redo pulido. La Fase 4.5 (red-sg) se sitúa entre ambas como puente natural de la separación aplicación/toolkit (ver DT-030 y `docs/roadmap-9-10.md`).

**Nota sobre el fork `anlaco/red`:** Los binarios `red-cli` y `red-view` se compilan desde un fork propio del repositorio Red, mantenido en `/home/alaforga/Anlaco/01-PRODUCTOS/red/` con origen `https://github.com/anlaco/red.git`. Este fork aplica fixes GTK3 (GTK-014, GTK-003 A/B) que upstream no ha cerrado. Ver `docs/GTK_ISSUES.md` para estado de cada bug y sus commits resolutivos en el fork. El fork se sincroniza periódicamente con `red/red` upstream pero se mantiene como copia local para independencia de Red upstream.

Expand Down Expand Up @@ -184,14 +181,14 @@ view layout [
3. **emit** — define qué código Red genera cada bloque al compilar

### DT-005: El .qvi tiene dos secciones
1. `qvi-diagram: [...]` — cabecera gráfica (inerte para Red, usada por Telekino para reconstruir la vista)
1. `qvi-diagram: [...]` — cabecera gráfica (inerte para Red, usada por QTorres para reconstruir la vista)
2. Código Red/View generado — ejecutable directamente con `red mi-vi.qvi`

### DT-010: Runner en memoria (decisión clave)
Run compila en memoria y ejecuta con `do`. Save escribe el `.qvi` al disco. Son independientes.

### DT-011: qvi-diagram es la fuente de verdad
El código generado es un artefacto. Telekino siempre recompila desde `qvi-diagram` al cargar.
El código generado es un artefacto. QTorres siempre recompila desde `qvi-diagram` al cargar.
Un `.qvi` con solo `qvi-diagram` (sin código generado) es válido.

### DT-017: El tipo de VI lo determina el contexto de llamada
Expand All @@ -211,7 +208,7 @@ Prototipo `base-element` + constructores `make-node`, `make-wire`. Patrón idiom
Son independientes. El compilador usa `name`, la UI usa `label/text`.

### DT-027 — CRÍTICO: Concurrencia cooperativa (rate/on-time)
Red no tiene multihilo. Telekino simula concurrencia con timers de Red/View:
Red no tiene multihilo. QTorres simula concurrencia con timers de Red/View:
- While Loop = timer (`face/rate` + `on-time`) que ejecuta una iteración por tick
- Múltiples loops = múltiples timers independientes, Red despacha en round-robin
- Event Structure = timer que comprueba cola de eventos
Expand All @@ -223,7 +220,7 @@ Red no tiene multihilo. Telekino simula concurrencia con timers de Red/View:
El `.qvi` generado **debe compilarse** con `red -c` a ejecutable nativo.
- **PROHIBIDO** en código generado: `do` con bloques dinámicos, `load` de strings, `compose` en runtime
- **PERMITIDO**: `view layout [...]` estático, funciones con nombre, `face/rate` + `on-time`
- `compose` se ejecuta en el compilador de Telekino (al generar), NO en el `.qvi` generado
- `compose` se ejecuta en el compilador de QTorres (al generar), NO en el `.qvi` generado

### DT-029: Error handling progresivo
- **Nivel 0 (Fase 2)**: Error nativo de Red — programa se para. Sin cables de error.
Expand Down Expand Up @@ -256,11 +253,11 @@ qvi-diagram: [
## Flujo de trabajo

### Cómo trabajar un Issue
1. Leer el Issue en GitHub (`gh issue view N --repo anlaco/Telekino`)
1. Leer el Issue en GitHub (`gh issue view N --repo anlaco/QTorres`)
2. Implementar en el módulo correspondiente de `src/`
3. Verificar con los ejemplos de `examples/`
4. Ejecutar los tests (`red-cli tests/run-all.red`) y verificar que pasan
5. Cerrar el Issue cuando esté completo (`gh issue close N --repo anlaco/Telekino`)
5. Cerrar el Issue cuando esté completo (`gh issue close N --repo anlaco/QTorres`)

### Orden de los Issues (backlog)
Trabajar siempre en orden de Fase. No empezar una fase sin completar la anterior.
Expand Down Expand Up @@ -297,14 +294,14 @@ Spec visual: cada tipo implementa su aspecto según `docs/visual-spec.md`.
- #64 FP como ventana maestra — BD bajo demanda (Ctrl+E) ✅
- ~~#65 Scroll en BD y FP~~ ✅ (ventanas fijas 900x600, scrollbars draw-based, límites por contenido)

**Fase 4 — Hardware (en curso):**
- ~~#19 TCP/IP — bloques básicos cliente~~ ✅ (tcp-open/write/read/close estilo LabVIEW, session-through por connection refnum)
**Fase 4 — Hardware:**
- #19 TCP/IP — bloques básicos cliente (tcp-connect/write/read/close)
- #20 USBTMC — acceso genérico a instrumentos USB (/dev/usbtmc*)
- #21 Puerto serie RS-232/RS-485 (Arduino, ESP32)
- #22 Modbus TCP y servidor TCP/IP (depende de #19)
- #23 DAQ analógico (comedi/libcomedi)

> **Nota:** NO se implementan bloques SCPI específicos. SCPI es un protocolo de comandos en texto que se envía como string vía `tcp-write` o `usbtmc-write`. Esto mantiene Telekino genérico y sirve también para Modbus, protocolos propios y cualquier otro protocolo sobre TCP/USB.
> **Nota:** NO se implementan bloques SCPI específicos. SCPI es un protocolo de comandos en texto que se envía como string vía `tcp-write` o `usbtmc-write`. Esto mantiene QTorres genérico y sirve también para Modbus, protocolos propios y cualquier otro protocolo sobre TCP/USB.

**Fase 5 — UX y gestión de proyectos:**
- Splash / Welcome screen (Create New VI, Open Existing, proyectos recientes)
Expand All @@ -316,7 +313,7 @@ Los binarios `red-cli` y `red-view` se compilan desde el fork `https://github.co

## Ollama MCP — Delegación de tareas a modelo local

Telekino tiene un MCP server que conecta con Ollama (modelo local). Ollama tiene cargado automáticamente CLAUDE.md y el skill de Red-Lang como contexto del proyecto.
QTorres tiene un MCP server que conecta con Ollama (modelo local). Ollama tiene cargado automáticamente CLAUDE.md y el skill de Red-Lang como contexto del proyecto.

### Cuándo usar Ollama (herramienta `ollama_delegate`)

Expand Down Expand Up @@ -356,7 +353,7 @@ El contexto se define en `.ollama-context.json` en la raíz del proyecto:
```json
{
"context_files": ["./CLAUDE.md", "./skills/red-lang/SKILL.md"],
"system_prompt": "You are a coding assistant for Telekino..."
"system_prompt": "You are a coding assistant for QTorres..."
}
```

Expand All @@ -372,16 +369,16 @@ red examples/suma-basica.qvi
red-cli tests/run-all.red

# Ejecutar la aplicación completa
red-view src/telekino.red
red-view src/qtorres.red

# Ver Issues pendientes
gh issue list --repo anlaco/Telekino --label "fase-2"
gh issue list --repo anlaco/QTorres --label "fase-2"

# Ver un Issue concreto
gh issue view 14 --repo anlaco/Telekino
gh issue view 14 --repo anlaco/QTorres

# Cerrar un Issue
gh issue close 14 --repo anlaco/Telekino --comment "Implementado en src/..."
gh issue close 14 --repo anlaco/QTorres --comment "Implementado en src/..."
```

## Convenciones de código
Expand Down Expand Up @@ -427,7 +424,7 @@ Cubre sintaxis core, View, Draw, VID, Parse, patrones idiomáticos y gotchas.
| `make-fp-item`, `fp-cluster-fields`, `fp-default-label` | `model.red` | ✅ Movida |
| `find-node-by-id` | `model.red` | ✅ Añadida |
| `set-config` | `model.red` | ✅ Añadida |
| Lógica de `btn-run` (50+ líneas inline) | telekino.red | ⚠️ Pendiente Fase 3 |
| Lógica de `btn-run` (50+ líneas inline) | qtorres.red | ⚠️ Pendiente Fase 3 |

### Dependencia canvas.red <-> panel.red

Expand Down Expand Up @@ -467,9 +464,9 @@ El acoplamiento es **por diseño del dominio** (FP↔BD son una unidad 1:1) y no

### Estado global compartido

`app-model` (definido en telekino.red) es el único modelo compartido. canvas.red, panel.red y telekino.red lo leen y mutan a través de `face/extra`. No hay mecanismo de notificación.
`app-model` (definido en qtorres.red) es el único modelo compartido. canvas.red, panel.red y qtorres.red lo leen y mutan a través de `face/extra`. No hay mecanismo de notificación.

### Plan de corrección (pendiente Fase 3)

1. Centralizar conocimiento de tipos en blocks.red (hints de renderizado)
2. Extraer lógica de `btn-run` a función nombrada en telekino.red
2. Extraer lógica de `btn-run` a función nombrada en qtorres.red
12 changes: 6 additions & 6 deletions docs/ai-reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Referencia de formatos Telekino para agentes de IA
# Referencia de formatos QTorres para agentes de IA

Este documento es una referencia de consumo para agentes de IA que necesiten generar ficheros del ecosistema Telekino. No es documentación interna del proyecto — es el contrato entre Telekino y cualquier modelo que genere ficheros para él.
Este documento es una referencia de consumo para agentes de IA que necesiten generar ficheros del ecosistema QTorres. No es documentación interna del proyecto — es el contrato entre QTorres y cualquier modelo que genere ficheros para él.

**Versión:** 1.1 (solo `.qvi` con tipos numéricos)
**Decisiones relacionadas:** DT-020, DT-021, DT-022, DT-023, DT-024
Expand All @@ -9,10 +9,10 @@ Este documento es una referencia de consumo para agentes de IA que necesiten gen

## Principio fundamental

Todo fichero Telekino tiene dos secciones:
Todo fichero QTorres tiene dos secciones:

1. **Fuente de verdad** — un dialecto Red que describe la estructura gráfica y funcional. Es la única sección que se genera o edita.
2. **Código generado** — código Red ejecutable generado automáticamente por Telekino al guardar. **No se genera por IA.** Telekino lo produce a partir de la sección 1.
2. **Código generado** — código Red ejecutable generado automáticamente por QTorres al guardar. **No se genera por IA.** QTorres lo produce a partir de la sección 1.

Un agente de IA solo trabaja con la sección 1. Nunca genera la sección 2.

Expand Down Expand Up @@ -380,7 +380,7 @@ qvi-diagram: [

## Errores comunes a evitar

1. **No generar la sección 2 (código ejecutable).** Telekino la genera. El agente solo produce `qvi-diagram`.
1. **No generar la sección 2 (código ejecutable).** QTorres la genera. El agente solo produce `qvi-diagram`.
2. **No inventar tipos de nodo.** Usar solo los tipos listados en la tabla de nodos.
3. **Respetar los nombres de puerto exactos.** `'a` y `'b` para bloques math, `'out` para controles, `'in` para indicadores.
4. **Los IDs deben ser únicos** dentro de un mismo `block-diagram`.
Expand All @@ -395,4 +395,4 @@ qvi-diagram: [

## Nota sobre evolución

Este documento refleja el estado actual de Telekino (tipos numéricos). Conforme evolucione, se añadirán tipos de datos (`'boolean`, `'string`, `'array`), estructuras de control (loops, case), bloques genéricos de hardware (TCP/IP, USBTMC, serie, Modbus TCP), y nuevos bloques primitivos.
Este documento refleja el estado actual de QTorres (tipos numéricos). Conforme evolucione, se añadirán tipos de datos (`'boolean`, `'string`, `'array`), estructuras de control (loops, case), bloques genéricos de hardware (TCP/IP, USBTMC, serie, Modbus TCP), y nuevos bloques primitivos.
Loading
Loading