Conceptos
SOM en diez minutos
Tres sustantivos, un snapshot y un puñado de reglas sobre quién escribe y quién decide. Apréndelos y los schemas se leen solos.
Los tres sustantivos
Story, Asset, Telling
Una historia es un acontecimiento real: crece, se divide y cambia de rumbo, y nadie conoce su forma hasta que termina. Llevar eso a un schema se redujo a tres palabras que los periodistas ya usan.
Story
Lo que ocurre. De qué trata (tags[], story_meaning), en qué punto está (lifecycle, priority), qué espera la redacción (premise), sus fuentes y su credibilidad, y los gates y las marcas de cumplimiento que pesan sobre ella.
story_type: PLANNED, ACTIVE, KILLED, SPIKED, ARCHIVED, ORPHAN.
Asset
Lo que la redacción reúne y produce: VIDEO, SCRIPT, GRAPHIC, TRANSCRIPT y salidas generativas como SUMMARY y SOCIAL_POST. Solo referencias: los medios se quedan en su almacén.
status es solo editorial: READY, IN_PRODUCTION, PREPARED, INVALIDATED. «En vivo» y «emitido» nunca se guardan aquí.
Telling
Un Asset que llega a una audiencia a través de un destino. Sigue a un link —el vínculo de ese Asset con ese destino— y registra cuándo empezó y terminó la exposición.
La situación de cumplimiento pertenece al Telling. El mismo Asset puede estar aprobado en un link y bloqueado en otro en el mismo momento.
Snapshots, nunca deltas
Una historia se publica entera, cada vez
story_ides inmutable. Una revisión es el siguiente snapshot, no una historia nueva.sequence_numberDEBE aumentar yupdated_atDEBE avanzar.- Quien publica vuelve a sellar
originating_system, así que una corrección se atribuye a quien corrige, no a quien creó la historia originalmente. - Un solo escritor crea: el sistema de gestión de historias del medio es dueño de la historia y de su secuencia, nunca el cable de agencia, ni siquiera en un flash.
- Una herramienta que se incorpora tarde, se reinicia o se reconecta tras una caída lee un único objeto y queda al día.
Omitir significa ausente, no sin cambios
Un productor NO DEBE dejar fuera los campos que no modificó. Un escritor que envía solo sus propios campos borra en silencio el trabajo de todos los demás sistemas sobre la historia.
La especificación incluye tools/validate_sequence.py para comprobar exactamente estas propiedades en una serie de snapshots: los errores que ningún mensaje aislado puede revelar.
Ciclo de vida de la historia
Cuatro fases, solo en historias activas
Un bloque lifecycle es obligatorio cuando story_type es ACTIVE y está prohibido en los demás casos: una regla del schema, no una convención. Elige una fase.
DEVELOPING
La historia existe y se está trabajando. Los campos llegan en snapshots sucesivos: una premise con un grado de confianza, las primeras entradas de editorial_source[], los primeros Assets y afirmaciones.
Cada cambio es un nuevo snapshot completo con un sequence_number mayor. Las herramientas que leen la historia vuelven a evaluar con cada uno.
Huérfanas. Un clip que llega sin historia recibe una historia contenedora mínima ORPHAN que lo aloja, con una aserción MATCH que propone la historia real. Al confirmarse, el clip se traslada —mismo asset_id, marcas de tiempo originales— y la contenedora siempre pasa a ARCHIVED. Nunca se elimina, y los consumidores filtran las huérfanas con un único predicado sobre story_type.
Evidencia y afirmaciones
De dónde vienen las cosas y qué se está afirmando
Fuentes y credibilidad
Cada fuente lleva un tipo (WIRE, OFFICIAL, USER_GENERATED, …) y una credibility declarada: TRUSTED, VERIFIED, ENDORSED o UNVERIFIED. La credibilidad es un eje distinto de la autenticidad de los medios.
Autoría
HUMAN o MODEL, con modelo y versión solo para los modelos. Una authenticity_credential C2PA registra present: false en lugar de ocultar su ausencia. La confianza es opcional: no te inventes una para texto libre.
Afirmaciones en revisión
FACT_CHECK (una métrica y un valor), DETECTION o MATCH, cada una con un review en PENDING, CONFIRMED o REJECTED. Las entradas rechazadas se marcan, nunca se eliminan. Ante cualquier desacuerdo, manda la aserción.
Gates y auditoría
Nada llega a una audiencia sin un gate editorial
Una skill declara, la herramienta dueña del executor decide y una persona aprueba. Una aprobación se concede a una versión del texto, así que una reescritura reabre el gate en lugar de heredar la aprobación.
hold
El executor DEBE retener la salida en los campos afectados. Solo la libera una aprobación sobre el mismo alcance: no el paso del tiempo, ni que la marca desaparezca de un snapshot posterior.
flag
Marcar para revisión. Una herramienta puede mostrarla; nada se retiene solo por ella.
inform
Solo informativo. Ninguna acción de bloqueo y ninguna respuesta obligatoria.
Cuando varios gates afectan al mismo hecho en el mismo Telling, solo se sirve si todos los gates lo permiten: basta un hold para que quede retenido. «Gana el más restrictivo» y «el dueño de la historia tiene prioridad» se retiraron en favor de esto. El cumplimiento es fail-closed, y una transformación —recorte, reencuadre, subtítulos incrustados— nunca levanta un hold.
El rastro de gobernanza. Una action de tipo CLEARED, SUPPRESSED, WITHHELD u OVERRIDDEN, sobre un LINK, un ASSET o un TELLING, con un actor y un motivo. Una supresión apunta al Asset retenido, porque la rama que nunca sale al aire nunca recibe un link.
Declarar, luego actuar
SOM transporta contexto. Las skills transportan conocimiento.
Qué es una historia, en qué estado está, qué está retenido y qué aprobado, de dónde vino el material. Igual en todas partes, y sin criterio propio.
Normas editoriales, reglas de cumplimiento, práctica institucional: lo que legítimamente cambia de una redacción a otra. El marco es abierto; tu flujo de trabajo sigue siendo tuyo, y ningún proveedor necesita una copia de tu política.
El silencio es un resultado válido. Una skill que no encuentra nada que declarar no dice nada, y una herramienta demuestra que leyó la historia solo publicando a su vez. Por eso el registro de auditoría es un subproducto de cómo funcionan las escrituras y no una función que alguien añadió después. Cómo funciona el recall →
Principios
Por qué SOM tiene la forma que tiene
Seis principios de trabajo abren la especificación, y son la prueba que todo cambio futuro debe superar.
Alcance de una sola historia
El estándar coordina dentro de una historia. Las relaciones con otras historias viajan como referencias, y ahí termina el alcance.
Mensajes, no organizaciones
SOM describe lo que viaja por el bus. No opina sobre tus mesas, roles ni herramientas: dos flujos de trabajo muy distintos pueden hablar de la misma historia.
Estado afirmado por el medio
Un contexto de la historia dice aquello que su dueño está dispuesto a firmar. Nada en él es una conjetura deducida de varias fuentes.
Coordinación, no consumo
Un campo tiene sentido si otro sistema lo necesita para actuar correctamente. SOM no transporta el contenido y no es un formato de entrega.
Por defecto no; el sí se justifica
Un campo se gana su lugar si sin él se bloquea una integración real. La 1.0 retiró tres campos propuestos exactamente por esa razón.
Crecimiento del vocabulario gobernado
La estructura puede ser permisiva; las palabras que llevan significado, no. La extensión tiene una forma definida, así que los términos del proveedor y los de la redacción comparten mensaje en igualdad de condiciones.
Cómo se comporta
Nada está al mando
Ningún orquestador, ninguna aplicación central. Cada herramienta lee la historia y decide por sí misma.
Las skills declaran, los executors actúan
Una skill enuncia lo que es cierto según una regla que escribió su redacción. Solo actúa la herramienta dueña del executor, y el silencio es un resultado válido.
Un solo escritor crea
El sistema de gestión de historias del medio es dueño de la historia y de su secuencia. Nunca el cable de agencia.
Republicación completa, nunca un delta
Una herramienta que se enciende a mitad de la noche lee un único objeto y lo sabe todo.
Vinculación en el acto editorial
Un medio pasa a formar parte de una historia cuando una persona lo decide, nunca solo porque haya llegado.
Una transformación nunca levanta un hold
Cortar, recortar o reversionar un Asset no puede blanquear su situación de cumplimiento.
Leer no deja rastro
Una herramienta demuestra que leyó algo publicando a su vez, y por eso el registro de auditoría surge de la propia forma en que funcionan las escrituras.
Dónde se detiene el estándar. SOM describe una historia y todo lo que es cierto sobre ella, y nada más. Lo que cada redacción haga con lo que lee es asunto suyo. La 1.0 es un compromiso de estabilidad, no una pretensión de exhaustividad: lo que no está resuelto queda por escrito en el registro abierto ↗.
Glosario
El vocabulario
| Término | Significado |
|---|---|
| Story | Lo que ocurre en el mundo, guardado como un contexto que su medio publicador posee y afirma. Se publica como snapshots completos de story.context identificados por un story_id inmutable. |
| Asset | Una pieza concreta de medios o de trabajo editorial sobre una historia, clasificada por su valor probatorio (PRIMARY / SECONDARY / TERTIARY). Existe se publique algo a partir de ella o no. |
| Telling | El momento en que un Asset llega a una audiencia a través de un destino, con exposure_start / exposure_end inmutables. El estado al aire se deriva de los Tellings. |
| Link | Un Asset vinculado a un destino, con un gate de cumplimiento por destino (PENDING / CLEARED / BLOCKED). |
| Source (TAMS) | Medios direccionados como tams://store/id más un rango de tiempo opcional. SOM hace referencia a Sources, nunca a Flows. |
| Locator | Una referencia a medios fuera de TAMS: store + ref. Una ruta de MAM, una clave de objeto, un id de CMS. |
| Aserción (assertion) | Una afirmación sobre una historia, un Asset, un link o un Telling —FACT_CHECK, DETECTION o MATCH— con procedencia y un estado de revisión. El lugar autorizado de un hecho confirmado. |
| Procedencia (provenance) | Quién o qué es autor de una salida: HUMAN o MODEL. Válida para cualquier autoría, nunca pensada solo para la IA. |
| Gate editorial | Algo que debe resolverse antes de que un Asset o una fase avancen. PENDING / APPROVED / REJECTED. |
| Huérfana (orphan) | Una historia contenedora mínima (story_type: ORPHAN) creada para alojar un clip que llegó sin historia, hasta que se confirma una coincidencia propuesta. |
| Skill | Un archivo de reglas pasivo con la forma de agentskills.io. Declara; nunca actúa y nunca modifica el contenido. |
| Executor | La parte de una herramienta de proveedor que hace recall de skills, publica sus advertencias y decide qué retiene la herramienta. Las herramientas tienen executors; las redacciones no tienen uno central. |
| Instancia configurada | Un archivo de skill genérico con los valores de una casa cargados, vigilando una condición. Una casa ejecuta varias a partir del mismo archivo. |
| Story Archaeology | El método detrás del modelo: rastrear una historia real después de su emisión y registrar cómo se movió realmente su contexto. |
| Extensión | extensions["com.{vendor}.{field}"]: el lugar definido para los campos que el estándar no incluye. Las claves desconocidas se ignoran. |
El glosario completo está en la especificación: spec/glossary.md ↗
Siguiente: el formato de transmisión
Todos los mensajes comparten un envelope. Aquí está cada campo y lo que la conformidad exige de él.