Publicar y compartir un Playbook

La creación produce atómicamente la primera Versión inmutable. La publicación requiere la última versión actual como base.

epismo playbook create --input @playbook.json
epismo playbook get <playbook-id>
epismo playbook version publish <playbook-id> \
  --base-version-id <latest-version-id> --input @next-version.json

Después de un conflicto, vuelva a leer lo último y combine su intención en una nueva Definición.

Iterar primero con un borrador

Publicar directamente está bien para un cambio pequeño y seguro. Para cualquier cosa que necesite algunas pasadas, guárdela como Borrador; nunca crea una Versión, por lo que no hay nada que limpiar si cambia de opinión:

epismo playbook draft get <playbook-id>
epismo playbook draft save <playbook-id> --base-revision 0 --input @draft.json
epismo playbook draft publish <playbook-id>
epismo playbook draft discard <playbook-id>

--base-revision es la última revisión que leyó (0 para un nuevo borrador); un valor obsoleto significa que alguien más se guardó desde entonces: vuelva a leer y volver a intentarlo. Un Playbook tiene un Borrador, visible para cualquiera que ya pueda leerlo. draft publish crea una Versión del contenido actual del Borrador y la descarta en el mismo paso; draft discard lo tira a la basura sin publicar nada.

• ACL: acceso duradero a través de ID de usuario, ID de equipo o público solo para Playbooks.
• Alias: referencia memorable; nunca concede acceso.
• Token compartido: revocable, opcionalmente expira el acceso de lectura sin cambiar la ACL.
• Estrella: ahorro personal y señal de descubrimiento.
• Borrador: contenido inédito y mutable visible para la ACL actual; un token de acciones no lo alcanza.

Antes del acceso público, revise las instrucciones, sugerencias de recursos, URL internas y datos personales. Un caso nunca hereda la visibilidad del Playbook.