sof-format

La especificación canónica del formato .sof: la sintaxis con la que se materializa el pensamiento por capas en archivos que cualquier agente lee.

División: SoF Systems · Tipo: spec / formato · Estado: 🟡 estable (canónico)

Qué es

sof-format es la spec del .sof: el contrato del formato de archivo que materializa la doctrina SoF. Define la sintaxis, la línea mágica de dialecto y los dialectos disponibles. Es la referencia normativa — la regla escrita que toda herramienta del ecosistema obedece al leer o escribir un .sof.

Recuerda: el .sof es el formato de archivo, distinto de SoF (la doctrina) y de ShoF (el lenguaje de UI).

Qué hace

• Especifica la línea mágica que abre todo archivo .sof y declara su dialecto y versión.
• Cataloga los dialectos disponibles y qué comportamiento implica cada uno.
• Sirve de contrato entre quien escribe .sof y quien lo lee o lo resuelve.

Por qué cambia el juego

Sin un formato común, cada herramienta y cada agente inventa su propia manera de guardar y pasar contexto — y nada se entiende entre sí. sof-format pone un solo estándar debajo de todo el ecosistema: un archivo que es a la vez legible por humanos y reconstruible por máquinas, con su dialecto declarado en la primera línea. Es la pieza que hace que SoF deje de ser una idea y se vuelva interoperable.

Dónde vive

• Es la spec que implementan el resolver de SoF v5, los visores y _creator.
• Define el contrato que todo .sof del ecosistema FractAIll debe cumplir.

Mapa SoF · capas y componentes

• 1 · Objetivo — fijar un solo estándar para el formato .sof, de modo que toda herramienta y agente lea y escriba el mismo archivo sin inventar su propia manera (componentes: spec canónica, contrato escritor↔lector).
• 2 · Visión — un archivo que es a la vez legible por humanos y reconstruible por máquinas, con su dialecto declarado en la primera línea (componentes: legibilidad humana, reconstrucción por máquina, declaración explícita de dialecto).
• 3 · Estructura — la especificación normativa del .sof: sintaxis, línea mágica de dialecto y catálogo de dialects disponibles (componentes: sintaxis, línea mágica, catálogo de dialectos).
• 4 · Funcionamiento — todo .sof abre con su línea mágica que declara dialecto y versión; cada dialecto cataloga un comportamiento distinto que la herramienta obedece al leer (componentes: parsing de línea mágica, resolución de dialecto, comportamiento por dialecto).
• 5 · Fondo — la regla escrita que sostiene la interoperabilidad; en términos generales, la referencia normativa que implementan otras piezas, sin lógica ejecutable propia (componentes: norma de referencia, base de implementación).
• 6 · Distribución — la implementan el resolver de SoF v5, los visores y _creator; se distribuye como spec/contrato que viaja con el ecosistema SoF y el lenguaje ShoF (componentes: adopción por resolver, visores, _creator).

Lectura fractal: tomá la línea mágica. Su objetivo es que un agente sepa leer el resto del archivo con solo mirar la primera línea; su visión, imitar #!/bin/bash —una marca de apertura universal—; su estructura, una sola línea al tope con dialecto y versión; su funcionamiento, ser leída antes que nada para elegir el modo de parseo; su fondo, el acuerdo de que esa línea es obligatoria; y su distribución, viajar en cada .sof del ecosistema sin excepción.