Notas en el Canvas

Una tarjeta de nota es texto en Markdown guardado en un archivo .md. Sirve para dos cosas a la vez: es tu memoria del proyecto en el tablero, y es el material que los agentes pueden leer y escribir.

Porque es un archivo de verdad, la nota sobrevive a la app: cerrar y reabrir no pierde texto, y cualquier herramienta fuera de Elyra puede leer el mismo archivo.

Dónde quedan los archivos

Las notas no viven dentro del proyecto. Están en una carpeta gestionada por la app, fuera del repositorio, con una ruta por workspace con el formato:

~/.elyra/projetos/<proyecto>/<workspace>/notas/

Los nombres de las carpetas de proyecto y de workspace llevan un sufijo identificador, así que la ruta exacta no es predecible de memoria. La ruta absoluta real es lo que devuelve la línea de comandos en el campo noteFilePath al listar o leer una nota — usa ese valor cuando necesites el archivo en el disco.

Esa decisión tiene un motivo práctico: cuando las notas estaban dentro del repositorio, una limpieza de archivos no versionados (git clean -xdf) se llevaba las notas consigo. Fuera del proyecto, eso no pasa.

Dos consecuencias:

• Workspace remoto por SSH es la excepción. En ese caso la carpeta de notas queda dentro del checkout, en el host remoto. Eso está declarado como temporal, hasta que exista resolución de carpeta personal remota — no cuentes con paridad entre local y SSH para notas.
• El identificador guardado de la nota no es una dirección. La tarjeta guarda una identidad con el formato .elyra/notas/<nombre>.md, que no es dónde está el archivo de hecho. Solo el noteFilePath es la ruta real.

Notas antiguas. Las notas que estaban dentro del proyecto, en las dos carpetas antiguas, se mueven a la carpeta gestionada. La migración corre en el arranque, no sobrescribe un archivo ya existente en el destino (un nombre ocupado recibe un sufijo) y, si falla, deja el archivo donde está para intentarlo de nuevo en el próximo arranque. Es best-effort: un archivo puede quedarse atrás en un fallo.

Crear una nota

Desde la barra de arriba: Añadir Nota › Nota. Con el clic derecho en el fondo: “Agregar aquí” › Nota. Los dos crean la tarjeta y el archivo, y el editor de la nota recién creada recibe el foco automáticamente — puedes empezar a escribir.

Por la línea de comandos, la nota nace ya con contenido:

elyra canvas create note --title "Resumen de la reunión" --content "Primera línea"
elyra canvas create note --content-file ./texto.md

• --content escribe el texto en el archivo al nacer.
• --content-file lee de un archivo, o de - para leer de la entrada estándar. Es el camino para texto con varias líneas — las comillas del shell estropean los saltos de línea.
• Con --title, el archivo nace con ese nombre y el nombre queda fijo.
• Sin --title, el nombre sigue la primera línea del contenido. Mientras no escribas un nombre, la tarjeta muestra “automático”; escribir un nombre lo fija.

El nombre del archivo se sanea: los caracteres inválidos se vuelven -, los nombres reservados del sistema reciben un prefijo y hay un techo de longitud. No tienes que ocuparte de eso.

Editar

El cuerpo de la tarjeta es un editor enriquecido de Markdown, con barra de herramientas y un campo de escritura con la pista “Escribe tu nota…”.

• La grabación se aplaza unos 600 ms después de la última tecla. Por eso, parar de escribir un instante y mirar el archivo en el disco es la forma de confirmar que se guardó.
• Las ediciones hechas fuera de la app aparecen en la tarjeta. La app observa el archivo y refleja lo que cambió.
• Un fallo de lectura bloquea el editor en vez de vaciar el archivo. Si la nota no se puede leer, la tarjeta avisa y ofrece Intentar de nuevo — no se borró nada, y debes comprobar si el archivo se movió o se borró fuera de Elyra.
• Cerrar durante una edición pendiente descarga la grabación aplazada antes de borrar, para no recrear un archivo que debería salir.

Herramientas de la nota

La barra de la nota trae negrita, cursiva, tachado, lista y lista numerada, además de la paleta de colores.

Color de fondo

La paleta ofrece Predeterminado, Amarillo, Verde, Azul, Rosa, Morado y Gris. Elegir Predeterminado limpia el color. El color es una propiedad de la tarjeta, no del texto: no altera el archivo .md y, por lo tanto, no viaja con la nota si abres el archivo en otro lugar.

Buscar dentro de la nota

La barra de búsqueda “Buscar en la nota” destaca y navega por los resultados dentro del cuerpo de la tarjeta, con Anterior, Siguiente y un contador con el formato actual de total, además de “Sin resultados” cuando no hay coincidencia. Esc cierra la búsqueda.

La búsqueda es solo de interfaz y no altera el archivo ni el proceso.

Escribir en una nota por la línea de comandos

Un agente puede leer y escribir la nota sin abrir el editor:

elyra canvas note read <note> [--workspace <selector>] [--json]
elyra canvas note write <note> (--content <text> | --content-file <path|->)
                              [--append] [--workspace <selector>] [--json]

• <note> acepta el id de la tarjeta, el título de la tarjeta o el nombre de la nota.
• Sin --append, el contenido sustituye el archivo entero. Con --append, el texto va al final, después de un salto de línea.
• Sin --json, la lectura imprime el contenido puro de la nota.

Escritura concurrente con el editor. El comando es el escritor más nuevo: el texto que todavía estaba en la grabación aplazada del editor se descarta a propósito, y la tarjeta en pantalla toma el contenido nuevo por el observador de archivo. Antes de escribir en una nota que está abierta, guarda lo que escribiste.

La app tiene que estar abierta. Sin ventana de la aplicación, esas operaciones se rechazan en vez de grabar en un estado que nadie ve.

Límites

• Workspace remoto por SSH. Las notas quedan dentro del checkout en el host remoto, y la migración a la carpeta gestionada no corre en ese caso. No hay paridad entre local y SSH para notas.
• Una nota cuyo archivo desapareció no monta editor ni graba. Es a propósito: evita que el guardado automático recree el archivo vacío por encima de lo que existía. La tarjeta muestra el error, preserva el texto que ya conocía y ofrece Intentar de nuevo.
• Dos tarjetas con el mismo nombre vuelven ambiguo el selector. La línea de comandos te pide usar el id en ese caso — el nombre es comodidad, no dirección única.
• No hay un límite de tamaño documentado para la nota. Una nota grande se lee y se graba entera; no cuentes con truncamiento ni con aviso de “demasiado grande”.