Libros de jugadas

Buscar y leer

epismo playbook search --query "release review" --category operations
epismo -w acme playbook search "release review" --output table
epismo playbook search --category operations
epismo playbook resource list --kind cli
epismo playbook list --resource-kind cli --resource-ref github:epismoai/cli
epismo playbook get <playbook-id-or-reference>
epismo playbook version list <playbook-id>
epismo playbook version get <playbook-id> <version-id>
epismo playbook version archive <playbook-id> <version-id>

playbook get acepta un UUID o una referencia de playbook como pb:alias y pb:handle/alias, y devuelve el playbook junto con sus sugerencias abiertas en la misma lectura—gratis para un playbook público, una lectura de playbook en los demás casos. La búsqueda admite texto, categoría, tamaño de página y cursor. Omita --query para obtener una lista de catálogo simple ordenada por la actualización más reciente. Use playbook resource list para descubrir referencias de recursos y filtre playbook list con --resource-kind y --resource-ref; no combine estos filtros con una consulta de texto. Las formas equivalentes de URL y de proveedor de GitHub y npm se agrupan juntas. Lea la definición completa, especialmente el esquema de entrada, las sugerencias de recursos y los resultados esperados, antes de utilizar un resultado.

Crear y publicar

Guarde la definición en un archivo y pásela a playbook create:

Al crear en un Espacio, incluido el predeterminado guardado, elija exactamente una opción: --private, --team-ids "$TEAM_ID" (IDs separados por comas o un array JSON) o --access con la configuración completa. En el JSON de --request son private, teamIds y access; no las combine. En el espacio personal pueden omitirse. El acceso de edición del Equipo cubre al creador sin añadir un permiso directo redundante.

{
	"ownerId": "<account-id>",
	"access": { "visibility": "restricted", "grants": { "<user-or-team-uuid>": "editor" } },
	"definition": {
		"schemaVersion": 1,
		"title": "Release review",
		"description": "Review a release before publication.",
		"category": "operations",
		"inputSchema": {
			"type": "object",
			"required": ["repository"],
			"properties": { "repository": { "type": "string" } }
		},
		"steps": [
			{
				"title": "Inspect the change",
				"instructions": "Review scope, tests, risks, and rollback plan.",
				"resourceHints": [
					{ "kind": "document", "ref": "https://example.com/release-policy" }
				],
				"expectedOutputs": [{ "title": "Decision and evidence", "format": "markdown" }]
			}
		]
	}
}

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

Omita las identificaciones para los nuevos pasos. Conserve una ID de cuatro caracteres existente solo para el mismo paso lógico. La publicación crea una versión inmutable; después de un conflicto entre la versión base, obtenga la última versión y combine su intención en lugar de cambiar solo la ID base.

Archive una versión histórica cuando ya no deba estar visible ni disponible para nuevos casos. Los números de versión no se renumeran ni se reutilizan, y la última versión no se puede archivar. Los casos existentes fijados a una versión archivada siguen funcionando.

Borrador

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

Un playbook tiene como máximo un borrador, y solo un playbook existente puede tener uno; use playbook create para la primera versión. --base-revision es la última revisión que leyó (0 para un nuevo borrador); se rechaza un valor obsoleto, al igual que un conflicto de versión base en la publicación. Quien tenga acceso de edición al playbook puede leer y editar el borrador; los lectores públicos y enlaces compartidos no. draft publish acuña una versión del borrador y la descarta en el mismo paso; draft discard lo tira a la basura.

Acceso y referencias

epismo playbook access get <playbook-id>
epismo playbook access set <playbook-id> --access '{"visibility":"public","grants":{"<user-or-team-uuid>":"editor"}}'
epismo playbook owner transfer <playbook-id> --owner-id <workspace-or-user-id>
epismo playbook alias set <playbook-id> <alias> [--owner-id <account-id>]
epismo playbook alias list <playbook-id> [--owner-id <account-id>]
epismo playbook alias delete <alias> [--owner-id <account-id>]
epismo playbook share "$PLAYBOOK_ID"
epismo playbook archive <playbook-id>

Playbooks y Casos tienen una cuenta propietaria de Usuario o Espacio de trabajo (ownerId), que también paga su uso. El propietario personal tiene todos los derechos; los Owners y Admins actuales ejercen esos derechos para un Espacio de trabajo. Los demás miembros necesitan permisos explícitos de usuario o Equipo, o visibilidad pública para leer contenido publicado. La membresía por sí sola no concede acceso. Al eliminar un miembro, se revocan sus permisos directos sobre los recursos propiedad de ese Espacio, incluidos los completados y archivados. Si la eliminación dejara algún recurso sin editor explícito, añada primero otro usuario o equipo editor, incluidos los recursos completados o archivados. Se conservan los permisos sobre recursos personales y de otros Espacios. Los permisos de Equipo y administración dependen de la membresía actual. El SSO obligatorio se aplica a los miembros; los usuarios externos con permisos directos usan la autenticación normal de Epismo. El acceso de Equipo entre espacios verifica el SSO del espacio de participación. Los listados usan permisos explícitos y la visibilidad pública admitida; la propiedad por sí sola no incluye un recurso.

Los lectores pueden leer contenido compartido, pero no editar; los borradores requieren edición. Los editores pueden cambiar contenido y permisos, conservar al menos un editor explícito al cambiar permisos, archivar y restaurar. Transferir la cuenta propietaria, cambiar el mantenedor, eliminar Casos definitivamente y archivar versiones históricas requieren derechos de propietario. assignedTo indica responsabilidad sin conceder acceso. Un nuevo responsable o mantenedor debe tener edición y, en recursos del Espacio, pertenecer a ese Espacio. Reasignar conserva los permisos; transferir la propiedad no añade automáticamente al antiguo propietario como editor.

Solo el propietario actual del playbook o un administrador del espacio de trabajo propietario puede definir o cambiar su alias, y el propietario debe tener un handle público. Comparta la referencia completa pb:handle/alias; pb:alias es una forma de búsqueda local.

Sugerencias

epismo playbook suggestion create <playbook-id> \
  --base-version-id <version-id> --title "Clarify evidence" --content "..."
epismo playbook suggestion list <playbook-id> --statuses open
epismo suggestion list
epismo suggestion list --view inbox
epismo suggestion update <suggestion-id> --title "..." --content "..."
epismo suggestion resolve <suggestion-id> --status applied \
  --result-version-id <new-version-id>

Las Sugerencias pertenecen al Playbook padre actual y no tienen propietario ni permisos históricos independientes. authorId identifica al creador y baseVersionId conserva la referencia de contenido inmutable para evaluar la mejora. La lectura requiere acceso actual al padre; archivarlo oculta sus Sugerencias hasta restaurarlo. Los autores pueden editar sus propuestas abiertas mientras mantengan acceso; los editores actuales del Playbook pueden adoptar o rechazar propuestas. Tras una transferencia, las propuestas existentes siguen los permisos actuales del padre. Publique el resultado antes de marcar la propuesta como aplicada.

suggestion list --view inbox / suggestion list --view sent

playbook list y playbook get por UUID funcionan antes de iniciar sesión para playbooks públicos y cuestan 0 créditos. La búsqueda y las operaciones privadas o de escritura requieren autenticación y usan los precios de Créditos.

La configuración explícita de creación y los cambios de acceso usan access: { visibility, grants }: visibilidad restricted/public y claves UUID de usuarios o equipos, o correos de usuarios registrados, con valores viewer/editor. Los correos se resuelven a UUID antes de guardar; las respuestas usan UUID. Un correo no registrado o roles en conflicto para el mismo usuario resuelto rechazan toda la operación. Cada cambio reemplaza el objeto completo; conserve los permisos ajenos al cambio e incluya el suyo si desea mantenerlo. Los propietarios conservan la gestión independientemente de los permisos. Los responsables y mantenedores no reciben acceso implícito. Los editores pueden consultar y reemplazar permisos, conservar al menos un editor explícito al cambiar permisos, archivar y restaurar. El JSON normal omite mapas privados; los editores pueden obtenerlos con access-get. Consulte Acceso e identidad.

Copie una versión publicada legible para adaptarla de forma independiente. La copia tiene contenido y versiones propios; no hereda permisos, borradores, Casos, sugerencias, alias, estrellas ni historial, y las ediciones nunca se sincronizan. Elija los permisos explícitamente; omita ownerId para usar el Espacio activo o su cuenta personal. copiedFrom registra el origen inmediato y su versión inmutable; sourceAccessible indica si aún puede leerlo. Las listas muestran solo copias legibles. Copiar cuesta lo mismo que crear un Playbook.

epismo playbook copy "$PLAYBOOK_ID" --source-version-id "$VERSION_ID" --private
epismo playbook copies list <playbook-id>

Propiedad, responsabilidad y ciclo de vida

Omita ownerId al crear o copiar para usar el Espacio de trabajo activo, o su cuenta personal si no hay uno seleccionado. La selección explícita también requiere autorización. Cuando hay un Espacio seleccionado, incluido el predeterminado de la conexión, la creación requiere exactamente una opción: private: true, teamIds no vacío o access. En el espacio personal puede omitirse la configuración. El permiso de edición del Equipo cubre al creador sin añadir un permiso directo redundante; se conserva un permiso directo solicitado explícitamente. Mantener o tener asignado un recurso no sustituye los permisos.

Los editores y propietarios pueden archivar y restaurar el Playbook. Liste los archivados sin consulta de texto con archived=true (playbook list --archived o epismo_playbook_search) y restaure con playbook restore o epismo_playbook_restore. Se conservan versiones, permisos y mantenimiento. Los propietarios pueden cambiar al responsable con playbook assign --assigned-to o epismo_playbook_assign, sin conceder acceso. Archivar versiones históricas sigue requiriendo propiedad; la última versión no se puede archivar.

En la vista web de Playbooks archivados, un propietario puede eliminar definitivamente un Playbook archivado solo si ningún Caso lo referencia (incluidos los completados o archivados) y ningún otro Playbook se copió de él. La operación es irreversible. Las operaciones de archivo y restauración de CLI y MCP no realizan una eliminación definitiva.

epismo playbook list --archived
epismo playbook restore <playbook-id>
epismo playbook assign <playbook-id> --assigned-to <user-id>

La asignación de Playbooks usa assignedTo, como la de Casos, y mantiene assignedTo en las respuestas. Use epismo_playbook_assign, playbook assign <playbook-id> --assigned-to <user-id> o PATCH /v1/playbooks/{playbookId}/assignee. Requiere propiedad y edición previa para el destinatario.

epismo playbook list --sharing-scope shared --assigned-to <user-id>
epismo playbook search --query incident --sharing-scope anyone
epismo playbook resource list --kind cli --sharing-scope shared