Changelog

Historial de versiones del protocolo ceiba.

v0.5.1 2026-05-14

Hito operativo, no cambio de schema: primera federación productiva bajo el protocolo. NDNS empieza a empujar eventos de comedia confirmados a La Cartelera en tiempo real. Spec sin breaking changes — v0.5.1 documenta la implementación de referencia que cualquier pareja futura puede seguir.

Added §4.4.1 Reference implementation: NDNS → Cartelera

• Nueva sub-sección en whitepaper técnico §6.2.1 y en el spec markdown (ceiba-protocol-spec.md §4.4.1).
• Patrón canónico defense-in-depth: trigger Postgres + pg_net push real-time, cron */5 como red de seguridad, CLI manual on-demand. Los tres caminos convergen en el mismo endpoint con upsert idempotente por (source_platform, source_id).
• Secretos en Supabase Vault (API key + URL destino). Sin valores literales en código ni en logs.
• Documenta los 4 pasos abstractos para registrar parejas futuras: NDNS↔Sociales (cantina/baile), Cartelera↔Sociales (cross-listing).

Changed ceibas.json: cartelera.interconnections[]

• Cartelera ahora declara formalmente la conexión entrante desde NDNS con protocol: "event", scopes: ["events:comedy:upcoming-confirmed"], api_key_required: true, since: "2026-05-14".
• Primer ejemplo público de interconnections[] con scopes v0.5.

v0.5 2026-05-13

Bump aditivo sobre v0.4. Formaliza los tres roles canónicos (operador / contribuidor / dueño-de-entidad), expande los rails de pago a cobertura LATAM + EU + ACH, e introduce entidades federadas: cada entidad puede vivir como dato self-sovereign con su propio /.well-known/entity.json y otorgar acceso a múltiples ceibas vía API keys con scopes. Manifests v0.4 siguen siendo válidos.

Added roles_supported

• Campo nuevo roles_supported: ["operator","contributor","entity-owner"] a nivel ceiba.
• operator — quien corre el directorio/registry de esta ceiba.
• contributor — quien edita entidades/eventos (comunidad).
• entity-owner — quien reclama y controla una entidad dentro de la ceiba.
• Vacío = v0.4 legacy (sin sistema formal de roles). No es breaking.

Added linked_entities (federación entity-aware)

• Campo nuevo linked_entities: [{ entity_uri, scopes, api_key_required, ttl_seconds, relation }].
• Una ceiba puede referenciar entidades self-sovereign (vivas en otra ceiba o standalone) sin duplicar sus datos.
• Scopes estilo OAuth: read:basic, read:events, read:contact, write:events.
• Cache TTL configurable (default 1h); cambios en el entity origen propagan automáticamente.
• Análogo a Wikipedia cross-references: enlazas, no copias.

Added api_keys_emit

• Campo nuevo api_keys_emit: { enabled, issuance_endpoint, scopes_available, rotation_days }.
• Una ceiba puede emitir API keys con scopes específicos para que terceros lean sus entidades de forma federada.
• Issuance endpoint default <api_base>/v1/api-keys. Rotación default 365 días.

Added payment_rails extendidos

• Agregados a v0.4: spei, oxxo, sepa, ach, pix, bank_transfer.
• Total: 16 rails canónicos. Parsers SHOULD emitir warning (no fail) ante valores desconocidos para forward-compat.
• Refleja la realidad multi-rail global del whitepaper: LATAM + EU + USD on/off-ramps.

Changed interconnections con scopes

• interconnections[].scopes + interconnections[].api_key_required opcionales (v0.5).
• Permite declarar federation cross-ceiba con permisos finos sin promover el link a un campo top-level.
• Valor agregado al enum recommended de protocol: federation.

Added docs

• 99_docs/ceiba-0-5-migration.md — guía paso-a-paso para bumpear ceibas v0.4 → v0.5 (additive, no breaking).

v0.4 2026-05-10

Versión consolidada. Reescritura de la capa económica, formalización del boundary público/privado, JSON Schema formal, y nuevo scaffold ejecutable.

Added Capa económica reescrita

• Regla decidible: "una ceiba es un mapa, no un libro de caja". Si el dato existiría sin tu producto, es del commons.
• Tabla explícita de 18 categorías commons vs privado.
• Multi-rail de pagos: stablecoin_usdc, x402, fiat_invoice, lightning, mercadopago, stripe, wise, manual. Sin default jurisdiccional.
• Karma como horas-banco redimible a tipo fijo, no transable persona-a-persona. Escrow obligatorio 100%.

Changed Split de karma

• Antes: 70 / 15 / 15 (contribuidores / operador-semilla / protocolo).
• Ahora: 80 / 20 (contribuidores / commons fund de la ceiba). Operador se paga de su producto, no del pool.

Changed Compliance levels

• Antes: 5 niveles (Seed / Exists / Community / Connected / Ecosystem).
• Ahora: 4 niveles — Seed (L0) / Registered (L1) / Verified (L2) / Validated (L3).

Changed Endpoint canonical

• /.well-known/ceiba → /.well-known/ceiba.json (con extensión .json). El antiguo queda como alias deprecated.

Added JSON Schema formal

• ceiba.schema.json en Draft 2020-12. Validable con cualquier librería estándar.
• Nuevos campos: id, protocol_version, karma, payment_rails, federation, authoritative_types, connector_types, _koa_gen, alpha.

Added Modelo Ciempiés

• Entidades portátiles con conectores tipados (ceiba:performs_at, ceiba:located_at, etc.).
• Status: spec, no implementación de referencia. Roadmap Q3 2026.

Added Scaffold + CLI

• Template completo en 07_tools/koa-gen/scaffold/ceiba-template/ — FastAPI + SQLite + Jinja, listo para L1.
• CLI koa-gen-ceiba init/verify/register en 07_tools/koa-gen/bin/.
• Runbook humano: 99_docs/runbooks/create-new-ceiba.md.
• Runbook agente: scaffold/ceiba-template/AGENTS.md.

Removed

• Tax mandatorio del 15% al protocolo upstream. Cada ceiba decide voluntariamente.
• Level 4 — Ecosystem como compliance separado. Sus behaviors aspiracionales son ahora opt-ins en L3.
• Default jurisdiccional MX en descripción de rails de pago.

Deprecated

• Campo ceiba_version — usar protocol_version. Ambos siguen tolerados.
• Endpoint /.well-known/ceiba sin extensión — usar /.well-known/ceiba.json.

v0.3 2026-04-01

Whitepaper consolidado, modelo ciempiés introducido en concepto. Karma economy formalizado con split 70/15/15 (ahora obsoleto). 7 ceibas activos.

v0.2 2026-03-31

Trust model "ciempiés" diseñado, federation pull-only confirmado, identity en 3 capas (SMS → WebAuthn → social recovery).

v0.1 2026-03-25

Primer draft de la spec. Schema básico de ceiba.json. 5 niveles de compliance. Endpoints /health + /ceiba.json + /.well-known/ceiba.