Mollie's Stitch Studio

Mollie's Stitch Studio es una prueba funcional de la arquitectura más segura para enviar diseños de bordado personalizados a una Brother SE700 sin tener que dejar un Mac encendido.

Para un resumen listo para copiar y pegar para el agente de codificación local de Mollie, consulta MOLLIE_AGENT_HANDOFF.md.

El VPS almacena diseños validados. Una aplicación nativa para iPhone descarga un archivo PES aprobado, encuentra la SE700 en la misma red Wi-Fi y realiza la transferencia local solo después de que Mollie lo confirma.

Lo que funciona ahora

• Diseños de bordado deterministas generados a partir de geometría tipada.

• Compilación real de PES con pyembroidery.

• Decodificación y validación de PES para límites de aro, longitud de puntada, número de puntadas y tamaño de subida.

• Vistas técnicas de puntadas en SVG generadas a partir del PES decodificado.

• Una cola autenticada en el VPS en https://stitch.204.168.230.132.sslip.io.

• Una app compañera nativa de SwiftUI para iPhone con emparejamiento mediante Keychain.

• Detección de la SE700 en la misma red Wi-Fi, verificación exacta de modelo y fijación de certificado.

• ChatGPT puede solicitar una transferencia desde el teléfono sin obtener acceso a la red local ni capacidad de escritura en la máquina.

• Aprobación explícita antes de la subida y verificación de entrega posterior.

• Comportamiento exacto de subida multipart con el XML de Brother pedxml, según las notas de protocolo de código abierto mencionadas en THIRD_PARTY_NOTICES.md.

El backend y la aplicación de iPhone están compilados y probados. Todavía no se ha subido ningún archivo a la máquina física. Eso sigue siendo una acción intencional y debe confirmarse por separado.

Arquitectura

ChatGPT design conversation
          |
          v
typed design recipe -> PES compiler -> decode and validate -> VPS queue
                                                            |
                                                            v
                                                  native iPhone app
                                                            |
                                                   same home Wi-Fi
                                                            |
                                                            v
                                                      Brother SE700

El VPS no puede llegar directamente a una máquina de la red doméstica. El iPhone es el relay local seguro, porque puede acceder tanto por HTTPS por internet como a la SE700 en la red Wi-Fi local. ChatGPT puede dejar una solicitud de transferencia en la cola del VPS, pero solo la app de iPhone en primer plano puede descubrir la máquina y realizar la transferencia después de que Mollie lo confirme.

El PES es un formato binario compilado que contiene comandos ordenados de puntada, salto, modificación, cambio de color y fin. El SVG se usa solo como intermedio editable o revisable. Una imagen normal no es automáticamente un diseño de bordado seguro.

Fiabilidad según el origen del diseño

Estos rangos estiman la calidad de la puntada sin edición manual. La validez del PES y la transferencia local pueden ser deterministas, pero el tejido, la entretela, la aguja, el hilo, a tensión y el aro siguen afectando al resultado físico. Cada nueva clase de diseño debería recibir una prueba de bordado.

Ejecutar el backend localmente

uv sync --python 3.12
export STITCH_STUDIO_PAIRING_TOKEN="replace-with-a-long-random-token"
export STITCH_STUDIO_PUBLIC_BASE_URL="http://127.0.0.1:8900"
export STITCH_STUDIO_DATA_DIRECTORY="$(pwd)/work/jobs"
uv run stitch-studio-api

Ejecuta las comprobaciones:

uv run ruff check .
uv run pytest -q
uv run stitch-studio generated
uv run stitch-machine-status 192.168.1.112

El comando de estado es de solo lectura. No tomes una subida física como una prueba desatendida.

Ejecutar la aplicación de iPhone

El proyecto de Xcode se genera a partir de ios/project.yml con XcodeGen.

cd ios
xcodegen generate
open MolliesStitchStudio.xcodeproj

Para instalarlo en un iPhone real, selecciona un equipo de desarrollo de Apple en Xcode en Signing & Capabilities, conecta el teléfono y ejecuta la aplicación. Este Mac no tiene una identidad de firma de código de Apple válida en este momento, por lo que las fuentes compilan en el Simulador, pero todavía no se pueden instalar en un teléfono físico ni enviarse mediante TestFlight.

El emparejamiento requiere la URL pública del servidor y el token privado que se guarda en el entorno del VPS. El token se almacena en el Llavero del iPhone y no se incluye en el repositorio.

Estado de la integración con ChatGPT

El conector de ChatGPT protegido por OAuth está disponible en:

https://stitch.204.168.230.132.sslip.io/mcp

Implementa Streamable HTTP MCP, registro dinámico de clientes, código de autorización OAuth con PKCE S256, tokens de acceso con ámbito delimitado, tokens de actualización rotación, descubrimiento de recursos protegidos y consultar de consentimiento privada.

Para conectar la cuenta de Mollie:

1. Inicia sesión en la cuenta de ChatGPT de Mollie.

2. Activa el modo de desarrollador en los ajustes de ChatGPT.

3. Añadir MCP Server.

4. Introduce la dirección /mcp mencionada arriba.

5. Introduce la contraseña de conexión privada en la página de consentimiento de Stitch Studio.

6. Entre la nueva conversación y selecciona Mollie's Stitch Studio en Herramientas.

La contraseña de conexión no se almacena en fuente ni en este README. En la Mac de Jake se guarda en Keychain con el nombre Mollies Stitch Studio ChatGPT.

Las herramientas MCP pueden describir los límites de la SE700, listar los dibujos en cola, compilar una flor radial de un solo color con unezos de 3 a 12 pétalos y solicitar una transferencia desde el teléfono. Cada PES creado por una herramienta se decodifica y valida antes de aparecer en la cola del iPhone.

Cuando Mollie pide a ChatGPT que envíe un diseño, el agente debe llamar a request_machine_transfer con el ID del trabajo en cola. La respuesta pone el trabajo en estado send_requested; la cola de iPhone se refresca mientras la app está abierta y etiqueta la solicitud. Mollie sigue abriendo el diseño, revisa la vista previa decodificada, confirma la transferencia y comienza a bordar en la máquina. ChatGPT nunca explora la LAN doméstica y nunca reivindica una transferencia física hasta que el teléfono está a la entrega.

Esta separación impide que una sesión de chat o un proceso remoto del VPS escriban de forma silenciosa en la máquina de bordado.

Seguridad de la transferencia

• La aplicación verifica la firma del PES y la suma de comprobación SHA-256 antes de la detección.

• La detección comprueba que el modelo Brother es 60, el tipo 3 y la versión de pedxml 1.

• La huella del certificado conocido de la SE700 está fijada en el cliente nativo.

• La subida nunca se reenvía automáticamente después de una escritura incierta.

• La aplicación compara la lista de archivos de la máquina antes y después de la subida.

• El VPS sólo marca un trabajo como entregado cuando detecta un archivo nuevo en la máquina.

• El operador selecciona el diseño y comienza a bordar en la máquina.