Assets

El plugin Assets gestiona los archivos de una raíz que no son markdown: un PDF, un diagrama, una captura de pantalla, un archivo de datos. Viven en cada carpeta que el Framework (el marco) declara como del plugin (assets/ por defecto), y el plugin los lista, enlaza cada uno a los Blueprints (los planos) y tareas a los que pertenece, encuentra los lugares que lo referencian y lo mueve o elimina a través del anfitrión para que el historial y los enlaces lo sigan. Desactivado por defecto; eidos plugin enable assets lo activa y declara la carpeta.

Enlaces y referencias

Un enlace se declara: este archivo pertenece a estos Blueprints (por su id permanente), estas tareas (por nombre) y estas URL. Los enlaces viven en el índice del plugin, nunca junto al archivo y nunca dentro de un Blueprint. Una referencia se encuentra: el cuerpo de un Blueprint o de una tarea que lleva la ruta del archivo. Las referencias se calculan en cada lectura y no se escriben en ninguna parte. Un archivo sin registro ni referencia se lista igualmente.

En el navegador

• Assets, una actividad en la barra de actividad: las carpetas y sus archivos, con una subida por carpeta y filtros. Los archivos son una tabla bajo /p/assets, con abrir, renombrar y eliminar en una fila.
• Una página por archivo: una imagen mostrada como imagen, un PDF leído en la página con un enlace fuera, cualquier otro archivo como su nombre, tipo y tamaño con Open en el editor externo y Reveal en el gestor de archivos; su título, descripción y enlaces (los Blueprints y tareas ofrecidos mientras escribes), y sus referencias enlazadas a su lugar.
• Attached assets, una vista en la barra lateral auxiliar: los archivos enlazados al Blueprint abierto o que lo referencian, el recuento en su pestaña y una manera de enlazar otro.
• En el editor, el menú de bloques ofrece Image y File desde un selector: ![…](…) incrusta una imagen, […](…) enlaza un archivo, como lo tiene markdown. Una imagen pegada cae en la carpeta de assets y en el texto, escalada a max_image_size al entrar. Quick Open responde archivos por nombre.

En disco

• assets/ (o cualquier carpeta declarada owned_by: "@assets/files"): los archivos mismos, anidados, con los dotfiles ignorados. La raíz →
• .eidos/plugins/assets/index.yaml: un registro por archivo que lo tenga, indexado por su ruta desde la raíz: title, description y links.
• .eidos/plugins/assets/settings.yaml, compartido: max_file_size (megabytes, 6 por defecto), el archivo más grande que la página acepta y add escribe; max_image_size (píxeles, 2000 por defecto, 0 para sin límite), el lado más largo que conserva una imagen.

Desde la terminal

eidos assets                                    # every file per folder, with its links and reference count
eidos assets --for login                        # the files linked to one blueprint; --folder, --json
eidos assets show assets/login-flow.png         # its links (missing where the target is gone) and references
eidos assets add ~/Desktop/login-flow.png --to @login   # copied in; --folder, --name
eidos assets link assets/login-flow.png --to task:rate-limit-the-login-form --drop https://…
eidos assets set assets/login-flow.png --title "Login flow" --name login-flow-v2.png
eidos assets remove assets/login-flow.png

Un enlace es @<blueprint-id>, task:<name> o una URL. set --name mueve el archivo a través del anfitrión (git mv donde Git está activo) y reescribe cada cuerpo de Blueprint y de tarea que nombraba la ruta antigua; remove lo elimina a través del anfitrión y descarta su registro. Nunca renombres ni borres a mano un archivo de una carpeta de assets.

Para adjuntar un diagrama a un Blueprint: añade el archivo, enlázalo (--to @<id>) y enlaza a él desde el cuerpo del Blueprint como enlace relativo donde se discute.

Qué informa la comprobación

assets/link-missing (un enlace a un Blueprint o una tarea que la raíz no tiene) y assets/record-orphaned (un registro de un archivo que desapareció; Drop record lo arregla). Con el plugin desactivado, las carpetas siguen declaradas e intactas, no se lee ningún archivo y ninguna ruta responde.